From c25731ea2062b46fc8102ddd69c190125592ccbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jens=20M=C3=B6nig?= <jens@moenig.org>
Date: Tue, 20 Feb 2024 13:01:58 +0100
Subject: [PATCH] added showScriptBalloonAt() and closePopUps() API methods

---
 HISTORY.md    |  2 ++
 snap.html     |  4 ++--
 src/api.js    | 19 ++++++++++++++++++-
 src/blocks.js | 11 ++++++++++-
 4 files changed, 32 insertions(+), 4 deletions(-)

diff --git a/HISTORY.md b/HISTORY.md
index f4e2edc45f..4c343b2fa8 100755
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -4,10 +4,12 @@
 
 * **New Features:**
     * new "Lirin" costume series, thanks, Meghan and Brian!
+    * new showScriptBalloonAt() and closePopUps() API methods
 
 2024-02-20
 * new dev version for v9.2.7
 * added new Lirin costumes, thanks, Brian and Meghan!
+* api: added showScriptBalloonAt() and closePopUps() API methods
 
 ## 9.2.6:
 * **Notable Changes:**
diff --git a/snap.html b/snap.html
index 63eccbf041..0c7f47f213 100755
--- a/snap.html
+++ b/snap.html
@@ -16,7 +16,7 @@
         <script src="src/morphic.js?version=2024-02-12"></script>
         <script src="src/symbols.js?version=2024-01-24"></script>
         <script src="src/widgets.js?version=2023-05-24"></script>
-        <script src="src/blocks.js?version=2024-01-23"></script>
+        <script src="src/blocks.js?version=2024-02-20"></script>
         <script src="src/threads.js?version=2024-01-15"></script>
         <script src="src/objects.js?version=2024-01-15"></script>
         <script src="src/scenes.js?version=2022-10-29"></script>
@@ -33,7 +33,7 @@
         <script src="src/store.js?version=2023-07-27"></script>
         <script src="src/locale.js?version=2024-02-12"></script>
         <script src="src/cloud.js?version=2023-04-12"></script>
-        <script src="src/api.js?version=2024-02-12"></script>
+        <script src="src/api.js?version=2024-02-20"></script>
         <script src="src/sha512.js?version=2019-06-27"></script>
         <script src="src/FileSaver.min.js?version=2019-06-27"></script>
         <script>
diff --git a/src/api.js b/src/api.js
index cd12797636..d6489a5258 100644
--- a/src/api.js
+++ b/src/api.js
@@ -46,7 +46,7 @@ detect, isSnapObject, VariableFrame*/
 
 // Global stuff ////////////////////////////////////////////////////////
 
-modules.api = '2024-February-12';
+modules.api = '2024-February-20';
 
 // IDE_Morph external communication API
 /*
@@ -311,6 +311,23 @@ IDE_Morph.prototype.unflashSpriteScripts = function (name) {
     this.spriteNamed(name).scripts.unflash();
 };
 
+IDE_Morph.prototype.showScriptBalloonAt = function (contents, charIdx, name) {
+    // popup a balloon at the innermost block of the scripts of the sprite
+    // indicated by name or the current sprite or stage if none that corresponds
+    // to the index of the text given the current codification mapping, and
+    // display the given contents, which can be a string, number, costume,
+    // morph, canvas, list, table etc. (anything first-class in Snap!)
+    var scripts = this.spriteNamed(name).scripts;
+    // scripts.unflash();
+    // scripts.flashCodeIdx(charIdx, contents);
+    scripts.balloonCodeIdx(charIdx, contents);
+};
+
+IDE_Morph.prototype.closePopUps = function () {
+    // remove all pop-up menus and balloons, if any
+    this.world().hand.destroyTemporaries();
+};
+
 IDE_Morph.prototype.unsavedChanges = function () {
     return this.hasUnsavedEdits();
 };
diff --git a/src/blocks.js b/src/blocks.js
index eded010aef..acf3801d7d 100644
--- a/src/blocks.js
+++ b/src/blocks.js
@@ -161,7 +161,7 @@ SVG_Costume, embedMetadataPNG, ThreadManager, snapEquals*/
 
 // Global stuff ////////////////////////////////////////////////////////
 
-modules.blocks = '2024-January-23';
+modules.blocks = '2024-February-20';
 
 var SyntaxElementMorph;
 var BlockMorph;
@@ -9287,6 +9287,15 @@ ScriptsMorph.prototype.unflash = function () {
 
 };
 
+ScriptsMorph.prototype.balloonCodeIdx = function (idx, contents) {
+    // highlight the innermost block located in the textual code indicated
+    // by the given character index. Optional color string, form "r,g,b[,a]".
+    var block = this.blockAtIdx(idx);
+    if (block) {
+        block.showBubble(contents);
+    }
+};
+
 // ArgMorph //////////////////////////////////////////////////////////
 
 /*