@m2c2kit/core 0.3.28 → 0.3.29

package/LICENSE

@@ -1,21 +1,13 @@
-MIT License
+Copyright 2023 Scott T. Yabiku
 
-Copyright (c) 2023 Scott T. Yabiku
+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
 
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
+    http://www.apache.org/licenses/LICENSE-2.0
 
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+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

@@ -1,6 +1,6 @@
 # @m2c2kit/core
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![License: Apache-2.0](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://opensource.org/license/apache-2-0)
 [![CI/CD](https://github.com/m2c2-project/m2c2kit/actions/workflows/ci.yml/badge.svg)](https://github.com/m2c2-project/m2c2kit/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/@m2c2kit/core.svg)](https://www.npmjs.com/package/@m2c2kit/core)
 

package/dist/index.d.ts

@@ -1846,7 +1846,9 @@ declare class Game implements Activity {
     /**
      * Adds a scene to the game.
      *
-     * @remarks A scene, and its children nodes, cannot be presented unless it has been added to the game object.
+     * @remarks A scene, and its children nodes, cannot be presented unless it
+     * has been added to the game object. A scene can be added to the game
+     * only once.
      *
      * @param scene
      */
@@ -4195,6 +4197,8 @@ declare enum LabelHorizontalAlignmentMode {
 }
 
 interface LabelOptions extends M2NodeOptions, DrawableOptions, TextOptions {
+    /** Text to be displayed. Tags for bold, italic, and underline are supported, e.g., `<b><u>Bold and underline</u></b>`. */
+    text?: string;
     /** Horizontal alignment of label text. see {@link LabelHorizontalAlignmentMode}. Default is LabelHorizontalAlignmentMode.center  */
     horizontalAlignmentMode?: LabelHorizontalAlignmentMode;
     /** Maximum width of label text before wrapping occurs. Default is the canvas width */
@@ -4226,13 +4230,19 @@ declare class Label extends M2Node implements IDrawable, IText, LabelOptions {
     private builder?;
     private _fontPaint?;
     private _backgroundPaint?;
+    private _underlinePaint?;
     private localizedFontSize;
     private localizedFontName;
     private localizedFontNames;
+    private plainText;
+    private styleSegments;
+    private underlinedRanges;
+    private currentBuilderPosition;
     /**
      * Single or multi-line text formatted and rendered on the screen.
      *
-     * @remarks Label (in contrast to TextLine) has enhanced text support for line wrapping, centering/alignment, and background colors.
+     * @remarks Label (in contrast to TextLine) has enhanced text support for
+     * line wrapping, centering/alignment, and background colors.
      *
      * @param options - {@link LabelOptions}
      */
@@ -4263,6 +4273,19 @@ declare class Label extends M2Node implements IDrawable, IText, LabelOptions {
         suppressEvents?: boolean;
     };
     initialize(): void;
+    /**
+     * Parses text with formatting tags and returns plain text and style segments.
+     * Supports <b> for bold, <i> for italics, and <u> for underline.
+     * Properly handles nested tags like <b><u>bold and underlined</u></b>.
+     * Throws errors for malformed tags, but treats unknown tags as plain text.
+     *
+     * @param text - The text with formatting tags
+     * @returns The parsed text result
+     * @throws Error if tags are improperly nested or unclosed
+     */
+    private parseFormattedText;
+    private addTextWithStylesToParagraphBuilder;
+    private addTextWithStyle;
     /**
      * Determines the M2Font objects that need to be ready in order to draw
      * the Label.
@@ -4303,6 +4326,8 @@ declare class Label extends M2Node implements IDrawable, IText, LabelOptions {
     private set backgroundPaint(value);
     private get fontPaint();
     private set fontPaint(value);
+    private get underlinePaint();
+    private set underlinePaint(value);
     /**
      * Duplicates a node using deep copy.
      *
@@ -4316,6 +4341,7 @@ declare class Label extends M2Node implements IDrawable, IText, LabelOptions {
     duplicate(newName?: string): Label;
     update(): void;
     draw(canvas: Canvas): void;
+    private drawUnderlines;
     warmup(canvas: Canvas): void;
 }
 
@@ -5341,4 +5367,5 @@ declare class WebGlInfo {
     static dispose(): void;
 }
 
-export { Action, type Activity, type ActivityCallbacks, type ActivityEvent, type ActivityEventListener, type ActivityKeyValueData, type ActivityLifecycleEvent, type ActivityResultsEvent, ActivityType, type BrowserImage, type BrowserImageDataReadyEvent, type CallbackOptions, CanvasKitHelpers, ColorfulMutablePath, Composite, type CompositeEvent, type CompositeOptions, Constants, ConstraintType, type Constraints, CustomAction, type CustomActionOptions, type DefaultParameter, Dimensions, type DomPointerDownEvent, type DrawableOptions, type EasingFunction, Easings, Equal, Equals, EventStore, EventStoreMode, FadeAlphaAction, type FadeAlphaActionOptions, type FontAsset, type FontData, FontManager, Game, type GameData, type GameEvent, type GameOptions, type GameParameters, type GlobalVariables, GroupAction, I18n, type I18nDataReadyEvent, type IDataStore, type IDrawable, type IText, ImageManager, Label, LabelHorizontalAlignmentMode, type LabelOptions, type Layout, LayoutConstraint, LegacyTimer, type LocaleSvg, type M2ColorfulPath, type M2DragEvent, type M2Event, type M2EventListener, M2EventType, type M2Image, M2ImageStatus, type M2KeyboardEvent, M2Node, type M2NodeAddChildEvent, type M2NodeConstructor, type M2NodeEvent, type M2NodeEventListener, M2NodeFactory, type M2NodeNewEvent, type M2NodeOptions, type M2NodePropertyChangeEvent, type M2NodeRemoveChildEvent, M2NodeType, type M2Path, type M2PointerEvent, type M2Sound, M2SoundStatus, M2c2KitHelpers, MoveAction, type MoveActionOptions, MutablePath, NoneTransition, PlayAction, type PlayActionOptions, type Plugin, type PluginEvent, type Point, RandomDraws, type RectOptions, RepeatAction, RepeatForeverAction, type RgbaColor, RotateAction, ScaleAction, type ScaleActionOptions, Scene, type SceneOptions, type ScenePresentEvent, SceneTransition, type ScoringSchema, SequenceAction, Shape, type ShapeOptions, ShapeType, type Size, SlideTransition, type SlideTransitionOptions, type SoundAsset, SoundManager, SoundPlayer, type SoundPlayerOptions, SoundRecorder, type SoundRecorderOptions, type SoundRecorderResults, Sprite, type SpriteOptions, Story, type StoryOptions, type StringInterpolationMap, type TapEvent, type TextAndFont, TextLine, type TextLineOptions, type TextLocalizationResult, type TextOptions, type TextWithFontCustomization, Timer, Transition, TransitionDirection, TransitionType, type Translation, type TranslationConfiguration, type TranslationOptions, type TrialData, type TrialSchema, Uuid, WaitAction, type WaitActionOptions, WebColors, WebGlInfo, handleInterfaceOptions };
+export { Action, ActivityType, CanvasKitHelpers, ColorfulMutablePath, Composite, Constants, ConstraintType, CustomAction, Dimensions, Easings, Equal, Equals, EventStore, EventStoreMode, FadeAlphaAction, FontManager, Game, GroupAction, I18n, ImageManager, Label, LabelHorizontalAlignmentMode, LayoutConstraint, LegacyTimer, M2EventType, M2ImageStatus, M2Node, M2NodeFactory, M2NodeType, M2SoundStatus, M2c2KitHelpers, MoveAction, MutablePath, NoneTransition, PlayAction, RandomDraws, RepeatAction, RepeatForeverAction, RotateAction, ScaleAction, Scene, SceneTransition, SequenceAction, Shape, ShapeType, SlideTransition, SoundManager, SoundPlayer, SoundRecorder, Sprite, Story, TextLine, Timer, Transition, TransitionDirection, TransitionType, Uuid, WaitAction, WebColors, WebGlInfo, handleInterfaceOptions };
+export type { Activity, ActivityCallbacks, ActivityEvent, ActivityEventListener, ActivityKeyValueData, ActivityLifecycleEvent, ActivityResultsEvent, BrowserImage, BrowserImageDataReadyEvent, CallbackOptions, CompositeEvent, CompositeOptions, Constraints, CustomActionOptions, DefaultParameter, DomPointerDownEvent, DrawableOptions, EasingFunction, FadeAlphaActionOptions, FontAsset, FontData, GameData, GameEvent, GameOptions, GameParameters, GlobalVariables, I18nDataReadyEvent, IDataStore, IDrawable, IText, LabelOptions, Layout, LocaleSvg, M2ColorfulPath, M2DragEvent, M2Event, M2EventListener, M2Image, M2KeyboardEvent, M2NodeAddChildEvent, M2NodeConstructor, M2NodeEvent, M2NodeEventListener, M2NodeNewEvent, M2NodeOptions, M2NodePropertyChangeEvent, M2NodeRemoveChildEvent, M2Path, M2PointerEvent, M2Sound, MoveActionOptions, PlayActionOptions, Plugin, PluginEvent, Point, RectOptions, RgbaColor, ScaleActionOptions, SceneOptions, ScenePresentEvent, ScoringSchema, ShapeOptions, Size, SlideTransitionOptions, SoundAsset, SoundPlayerOptions, SoundRecorderOptions, SoundRecorderResults, SpriteOptions, StoryOptions, StringInterpolationMap, TapEvent, TextAndFont, TextLineOptions, TextLocalizationResult, TextOptions, TextWithFontCustomization, Translation, TranslationConfiguration, TranslationOptions, TrialData, TrialSchema, WaitActionOptions };

package/dist/index.js

@@ -4976,11 +4976,17 @@ const M2FontStatus = {
   /** Font has fully finished loading and is ready to use. */
   Ready: "Ready"};
 
+const TAG_NAME = {
+  UNDERLINE: "u",
+  ITALIC: "i",
+  BOLD: "b"
+};
 class Label extends M2Node {
   /**
    * Single or multi-line text formatted and rendered on the screen.
    *
-   * @remarks Label (in contrast to TextLine) has enhanced text support for line wrapping, centering/alignment, and background colors.
+   * @remarks Label (in contrast to TextLine) has enhanced text support for
+   * line wrapping, centering/alignment, and background colors.
    *
    * @param options - {@link LabelOptions}
    */
@@ -5005,6 +5011,10 @@ class Label extends M2Node {
     // public getter/setter is below
     this._localize = true;
     this.localizedFontNames = [];
+    this.plainText = "";
+    this.styleSegments = [];
+    this.underlinedRanges = [];
+    this.currentBuilderPosition = 0;
     handleInterfaceOptions(this, options);
     if (options.horizontalAlignmentMode) {
       this.horizontalAlignmentMode = options.horizontalAlignmentMode;
@@ -5056,14 +5066,14 @@ class Label extends M2Node {
       this.fontColor[2],
       this.fontColor[3]
     );
-    let textForParagraph;
+    let textAfterLocalization;
     const i18n = this.game.i18n;
     if (i18n && this.localize !== false) {
       const textLocalization = i18n.getTextLocalization(
         this.text,
         this.interpolation
       );
-      textForParagraph = textLocalization.text;
+      textAfterLocalization = textLocalization.text;
       this.localizedFontSize = textLocalization.fontSize;
       this.localizedFontName = textLocalization.fontName;
       this.localizedFontNames = textLocalization.fontNames ?? [];
@@ -5076,8 +5086,13 @@ class Label extends M2Node {
         );
       }
     } else {
-      textForParagraph = this.text;
+      textAfterLocalization = this.text;
     }
+    this.currentBuilderPosition = 0;
+    this.underlinedRanges = [];
+    const parsedText = this.parseFormattedText(textAfterLocalization);
+    this.plainText = parsedText.plainText;
+    this.styleSegments = parsedText.styleSegments;
     if (this.fontName && this.fontNames) {
       throw new Error("cannot specify both fontName and fontNames");
     }
@@ -5117,36 +5132,39 @@ class Label extends M2Node {
     } else {
       this.backgroundPaint.setColor(this.canvasKit.Color(0, 0, 0, 0));
     }
-    this.builder.pushPaintStyle(
-      {
-        fontFamilies: requiredFonts.map((font) => font.fontName),
-        fontSize: (this.localizedFontSize ?? this.fontSize) * m2c2Globals.canvasScale,
-        // set default values for below properties as well.
-        fontStyle: {
-          weight: this.canvasKit.FontWeight.Normal,
-          width: this.canvasKit.FontWidth.Normal,
-          slant: this.canvasKit.FontSlant.Oblique
-        },
-        // Normal font style
-        decoration: 0,
-        // No decoration
-        decorationThickness: 1,
-        // Default decoration thickness
-        decorationStyle: this.canvasKit.DecorationStyle.Solid,
-        // Solid decoration style
-        heightMultiplier: -1,
-        // Providing -1, rather than 1.0, gives default height multiplier
-        halfLeading: false,
-        // Default half leading
-        letterSpacing: 0,
-        // Default letter spacing
-        wordSpacing: 0
-        // Default word spacing
+    if (!this._underlinePaint) {
+      this._underlinePaint = new this.canvasKit.Paint();
+    }
+    this.underlinePaint.setColor(this.fontPaint.getColor());
+    this.underlinePaint.setAlphaf(this.absoluteAlpha);
+    this.underlinePaint.setStyle(this.canvasKit.PaintStyle.Fill);
+    this.underlinePaint.setAntiAlias(true);
+    const defaultStyle = {
+      fontFamilies: requiredFonts.map((font) => font.fontName),
+      fontSize: (this.localizedFontSize ?? this.fontSize) * m2c2Globals.canvasScale,
+      fontStyle: {
+        weight: this.canvasKit.FontWeight.Normal,
+        width: this.canvasKit.FontWidth.Normal,
+        slant: this.canvasKit.FontSlant.Upright
       },
+      // Normal font style
+      decoration: 0,
+      // No decoration
+      decorationThickness: 1,
+      // Default decoration thickness
+      decorationStyle: this.canvasKit.DecorationStyle.Solid,
+      heightMultiplier: -1,
+      // Providing -1, rather than 1.0, gives default height multiplier
+      halfLeading: false,
+      letterSpacing: 0,
+      wordSpacing: 0
+    };
+    this.builder.pushPaintStyle(
+      defaultStyle,
       this.fontPaint,
       this.backgroundPaint
     );
-    this.builder.addText(textForParagraph);
+    this.addTextWithStylesToParagraphBuilder(defaultStyle);
     if (this.paragraph) {
       this.paragraph.delete();
     }
@@ -5174,6 +5192,185 @@ class Label extends M2Node {
     this.size.height = this.paragraph.getHeight() / m2c2Globals.canvasScale;
     this.needsInitialization = false;
   }
+  /**
+   * Parses text with formatting tags and returns plain text and style segments.
+   * Supports <b> for bold, <i> for italics, and <u> for underline.
+   * Properly handles nested tags like <b><u>bold and underlined</u></b>.
+   * Throws errors for malformed tags, but treats unknown tags as plain text.
+   *
+   * @param text - The text with formatting tags
+   * @returns The parsed text result
+   * @throws Error if tags are improperly nested or unclosed
+   */
+  parseFormattedText(text) {
+    let plainText = "";
+    const styleChanges = [];
+    const tagStack = [];
+    const validTags = /* @__PURE__ */ new Set([
+      TAG_NAME.UNDERLINE,
+      TAG_NAME.BOLD,
+      TAG_NAME.ITALIC
+    ]);
+    const tagPattern = /<\/?([^>]+)>/g;
+    let lastIndex = 0;
+    let plainIndex = 0;
+    let match = null;
+    const getPosition = (index) => {
+      let line = 1;
+      let column = 1;
+      for (let i = 0; i < index; i++) {
+        if (text[i] === "\n") {
+          line++;
+          column = 1;
+        } else {
+          column++;
+        }
+      }
+      return `line ${line}, column ${column}`;
+    };
+    while ((match = tagPattern.exec(text)) !== null) {
+      const fullTag = match[0];
+      const tagName = match[1];
+      const isClosing = fullTag.charAt(1) === "/";
+      const position = getPosition(match.index);
+      if (!validTags.has(tagName)) {
+        const beforeTag2 = text.substring(lastIndex, match.index);
+        plainText += beforeTag2;
+        plainIndex += beforeTag2.length;
+        plainText += fullTag;
+        plainIndex += fullTag.length;
+        lastIndex = match.index + fullTag.length;
+        continue;
+      }
+      const beforeTag = text.substring(lastIndex, match.index);
+      plainText += beforeTag;
+      plainIndex += beforeTag.length;
+      if (isClosing) {
+        if (tagStack.length === 0) {
+          throw new Error(
+            `Label has closing tag </${tagName}> at ${position} without matching opening tag. Text is: ${text}`
+          );
+        }
+        const lastOpenTag = tagStack.pop();
+        if (lastOpenTag !== tagName) {
+          throw new Error(
+            `Label has improperly nested tags at ${position}. Expected </${lastOpenTag}> but found </${tagName}>. Tags must be properly nested. Text is: ${text}`
+          );
+        }
+        styleChanges.push({
+          position: plainIndex,
+          style: tagName,
+          isStart: false
+        });
+      } else {
+        tagStack.push(tagName);
+        styleChanges.push({
+          position: plainIndex,
+          style: tagName,
+          isStart: true
+        });
+      }
+      lastIndex = match.index + fullTag.length;
+    }
+    plainText += text.substring(lastIndex);
+    if (tagStack.length > 0) {
+      throw new Error(
+        `Label has unclosed format tags: <${tagStack.join(">, <")}>. All tags must be closed. Text is: ${text}`
+      );
+    }
+    const activeStyles = /* @__PURE__ */ new Set();
+    const segments = [];
+    let lastPosition = 0;
+    styleChanges.sort((a, b) => a.position - b.position);
+    for (const change of styleChanges) {
+      if (change.position > lastPosition && activeStyles.size > 0) {
+        segments.push({
+          start: lastPosition,
+          end: change.position,
+          styles: new Set(activeStyles)
+          // Create a copy of the current styles
+        });
+      }
+      if (change.isStart) {
+        activeStyles.add(change.style);
+      } else {
+        activeStyles.delete(change.style);
+      }
+      lastPosition = change.position;
+    }
+    return {
+      plainText,
+      styleSegments: segments
+    };
+  }
+  addTextWithStylesToParagraphBuilder(defaultStyle) {
+    if (this.styleSegments.length === 0) {
+      if (!this.builder) {
+        throw new Error("ParagraphBuilder is undefined");
+      }
+      this.builder.addText(this.plainText);
+    } else {
+      let lastIndex = 0;
+      for (const segment of this.styleSegments) {
+        if (segment.start > lastIndex) {
+          this.addTextWithStyle(
+            this.plainText.substring(lastIndex, segment.start),
+            defaultStyle
+          );
+        }
+        const styleModifiers = {};
+        if (segment.styles.has(TAG_NAME.BOLD)) {
+          styleModifiers.fontStyle = {
+            ...defaultStyle.fontStyle,
+            weight: this.canvasKit.FontWeight.Bold
+          };
+        }
+        if (segment.styles.has(TAG_NAME.ITALIC)) {
+          styleModifiers.fontStyle = {
+            ...styleModifiers.fontStyle || defaultStyle.fontStyle,
+            slant: this.canvasKit.FontSlant.Italic
+          };
+        }
+        if (segment.styles.has(TAG_NAME.UNDERLINE)) {
+          styleModifiers.underline = true;
+        }
+        this.addTextWithStyle(
+          this.plainText.substring(segment.start, segment.end),
+          defaultStyle,
+          styleModifiers
+        );
+        lastIndex = segment.end;
+      }
+      if (lastIndex < this.plainText.length) {
+        this.addTextWithStyle(
+          this.plainText.substring(lastIndex),
+          defaultStyle
+        );
+      }
+    }
+  }
+  // Helper to apply style and add text
+  addTextWithStyle(text, defaultStyle, styleModifiers = {}) {
+    if (!text) return;
+    const style = {
+      ...defaultStyle,
+      ...styleModifiers
+    };
+    if (styleModifiers.underline) {
+      const currentPosition = this.currentBuilderPosition;
+      this.underlinedRanges.push({
+        start: currentPosition,
+        end: currentPosition + text.length
+      });
+    }
+    if (!this.builder) {
+      throw new Error("ParagraphBuilder is undefined");
+    }
+    this.builder.pushPaintStyle(style, this.fontPaint, this.backgroundPaint);
+    this.builder.addText(text);
+    this.currentBuilderPosition += text.length;
+    this.builder.pop();
+  }
   /**
    * Determines the M2Font objects that need to be ready in order to draw
    * the Label.
@@ -5214,7 +5411,9 @@ class Label extends M2Node {
       this.builder,
       this._fontPaint,
       // use backing field since it may be undefined
-      this._backgroundPaint
+      this._backgroundPaint,
+      // use backing field since it may be undefined
+      this._underlinePaint
       // use backing field since it may be undefined
     ]);
   }
@@ -5395,6 +5594,15 @@ class Label extends M2Node {
   set fontPaint(fontPaint) {
     this._fontPaint = fontPaint;
   }
+  get underlinePaint() {
+    if (!this._underlinePaint) {
+      throw new Error("underlinePaint cannot be undefined");
+    }
+    return this._underlinePaint;
+  }
+  set underlinePaint(underlinePaint) {
+    this._underlinePaint = underlinePaint;
+  }
   /**
    * Duplicates a node using deep copy.
    *
@@ -5442,10 +5650,42 @@ class Label extends M2Node {
         throw new Error("no paragraph");
       }
       canvas.drawParagraph(this.paragraph, x, y);
+      if (this.underlinedRanges.length > 0) {
+        this.drawUnderlines(canvas, this.paragraph, x, y);
+      }
       canvas.restore();
     }
     super.drawChildren(canvas);
   }
+  drawUnderlines(canvas, paragraph, x, y) {
+    const drawScale = m2c2Globals.canvasScale / this.absoluteScale;
+    for (const range of this.underlinedRanges) {
+      const positions = paragraph.getRectsForRange(
+        range.start,
+        range.end,
+        this.canvasKit.RectHeightStyle.Max,
+        this.canvasKit.RectWidthStyle.Tight
+      );
+      for (const rect of positions) {
+        const rectHeight = rect.rect[3] - rect.rect[1];
+        const underlineVerticalOffset = -rectHeight * 0.08 * drawScale * this.absoluteScale;
+        const lineThickness = rectHeight * 0.04 * drawScale * this.absoluteScale;
+        canvas.drawRect(
+          [
+            x + rect.rect[0],
+            // left
+            y + rect.rect[3] + underlineVerticalOffset,
+            // bottom of text + offset
+            x + rect.rect[2],
+            // right
+            y + rect.rect[3] + underlineVerticalOffset + lineThickness
+            // bottom of text + offset + thickness
+          ],
+          this.underlinePaint
+        );
+      }
+    }
+  }
   warmup(canvas) {
     const i18n = this.game.i18n;
     if (i18n && this.localize !== false) {
@@ -7253,7 +7493,7 @@ function getDefaultExportFromCjs (x) {
 }
 
 function getAugmentedNamespace(n) {
-  if (n.__esModule) return n;
+  if (Object.prototype.hasOwnProperty.call(n, '__esModule')) return n;
   var f = n.default;
 	if (typeof f == "function") {
 		var a = function a () {
@@ -9220,11 +9460,18 @@ class Game {
   /**
    * Adds a scene to the game.
    *
-   * @remarks A scene, and its children nodes, cannot be presented unless it has been added to the game object.
+   * @remarks A scene, and its children nodes, cannot be presented unless it
+   * has been added to the game object. A scene can be added to the game
+   * only once.
    *
    * @param scene
    */
   addScene(scene) {
+    if (this.scenes.includes(scene)) {
+      console.warn(
+        `Game.addScene(): scene ${scene.toString()} has already been added to the game. This will cause unpredictable behavior. This warning will become an error in a future release.`
+      );
+    }
     scene.game = this;
     scene.needsInitialization = true;
     this.scenes.push(scene);
@@ -12271,7 +12518,7 @@ class Story {
   }
 }
 
-console.log("\u26AA @m2c2kit/core version 0.3.28 (622f7241)");
+console.log("\u26AA @m2c2kit/core version 0.3.29 (d1ad307f)");
 
 export { Action, ActivityType, CanvasKitHelpers, ColorfulMutablePath, Composite, Constants, ConstraintType, CustomAction, Dimensions, Easings, Equal, Equals, EventStore, EventStoreMode, FadeAlphaAction, FontManager, Game, GroupAction, I18n, ImageManager, Label, LabelHorizontalAlignmentMode, LayoutConstraint, LegacyTimer, M2EventType, M2ImageStatus, M2Node, M2NodeFactory, M2NodeType, M2SoundStatus, M2c2KitHelpers, MoveAction, MutablePath, NoneTransition, PlayAction, RandomDraws, RepeatAction, RepeatForeverAction, RotateAction, ScaleAction, Scene, SceneTransition, SequenceAction, Shape, ShapeType, SlideTransition, SoundManager, SoundPlayer, SoundRecorder, Sprite, Story, TextLine, Timer, Transition, TransitionDirection, TransitionType, Uuid, WaitAction, WebColors, WebGlInfo, handleInterfaceOptions };
 //# sourceMappingURL=index.js.map