AI-powered Debugger widget (#4739)

* feat: Add AI-powered debugging widget for Music Blocks projects

Signed-off-by: Om Santosh Suneri <[email protected]>

* importing the aidebugger widget 

Signed-off-by: Om Santosh Suneri <[email protected]>

* Intialising the Class AIDebuggerWidget 

Signed-off-by: Om Santosh Suneri <[email protected]>

* fix: AI Debugger Widget with cross-platform support and PR feedback fixes

- fixed typos
- made debugger available for both Music Blocks and Turtle Blocks
- added environment-specific welcome messages
- fixed all indentation and punctuation issues

* fix: typo

---------

Signed-off-by: Om Santosh Suneri <[email protected]>

Author: omsuneri

js/activity.js

@@ -162,6 +162,7 @@ if (_THIS_IS_MUSIC_BLOCKS_) {
         "widgets/phrasemaker",
         "widgets/arpeggio",
         "widgets/aiwidget",
+        "widgets/aidebugger",
         "widgets/pitchdrummatrix",
         "widgets/rhythmruler",
         "widgets/pitchstaircase",

js/blocks/WidgetBlocks.js

@@ -60,6 +60,9 @@
     MusicKeyboard
    - js/widgets/pitchstaircase.js
     PitchStaircase
+   - js/widgets/aidebugger.js
+    AIDebuggerWidget
+
  */
 
 /* exported setupWidgetBlocks */
@@ -1636,6 +1639,57 @@ function setupWidgetBlocks(activity) {
             return [args[0], 1];
         }
     }
+
+    class AIDebugger extends StackClampBlock {
+        constructor() {
+            super("aidebugger");
+            this.setPalette("widgets", activity);
+            this.parameter = true;
+            this.beginnerBlock(true);
+    
+            this.setHelpString([
+                _("Debug your music blocks project with new possibilities and more understanding."),
+                "documentation",
+                null,
+                "aidebugger"
+            ]);
+    
+            this.formBlock({ name: _("Debugger"), canCollapse: true });
+            this.makeMacro((x, y) => [
+                [0, "aidebugger", x, y, [null, 1]],
+                [1, "print", 0, 0, [0,2,null]],
+                [2, ["text",{"value":"Debugger Initiated"}], 0, 0, [1]]
+            ]);
+        }
+    
+        /**
+             * Handles the flow of data for the sampler block.
+             * @param {any[]} args - The arguments passed to the block.
+             * @param {object} logo - The logo object.
+             * @param {object} turtle - The turtle object.
+             * @param {object} blk - The block object.
+             * @returns {number[]} - The output values.
+             */
+        flow(args, logo, turtle, blk) {
+            if (logo.sample === null) {
+                logo.sample = new AIDebuggerWidget();
+            }
+            logo.inSample = true;
+            logo.sample = new AIDebuggerWidget();
+    
+            const listenerName = "_sampler_" + turtle;
+            logo.setDispatchBlock(blk, turtle, listenerName);
+    
+            const __listener = event => {
+                logo.sample.init(activity);
+            };
+    
+            logo.setTurtleListener(turtle, listenerName, __listener);
+    
+            return [args[0], 1];
+        }
+    }
+
     // Set up blocks if this is Music Blocks environment
     if (_THIS_IS_MUSIC_BLOCKS_) {
         new EnvelopeBlock().setup(activity);
@@ -1661,6 +1715,8 @@ function setupWidgetBlocks(activity) {
         new MatrixCMajorBlock().setup(activity);
         new MatrixBlock().setup(activity);
     }
+    // Set up AIDebugger for both Music Blocks and Turtle Blocks
+    new AIDebugger().setup(activity);
     // Instantiate and set up the StatusBlock
     new StatusBlock().setup(activity);
 }