utils/plan_generator_11.py

import json
import copy
import re
from collections import defaultdict


def generate_blocks_from_opcodes(opcode_counts, all_block_definitions):
    """
    Generates a dictionary of Scratch-like blocks based on a list of opcodes and a reference block definition,
    and groups all generated block keys by their corresponding opcode.

    Returns:
        tuple: (generated_blocks, opcode_to_keys)
            - generated_blocks: dict of block_key -> block_data
            - opcode_to_keys: dict of opcode -> list of block_keys
    """
    generated_blocks = {}
    opcode_counts_map = {}  # For counting unique suffix per opcode
    opcode_to_keys = {}     # For grouping block keys by opcode

    explicit_menu_links = {
        "motion_goto": [("TO", "motion_goto_menu")],
        "motion_glideto": [("TO", "motion_glideto_menu")],
        "motion_pointtowards": [("TOWARDS", "motion_pointtowards_menu")],
        "sensing_keypressed": [("KEY_OPTION", "sensing_keyoptions")],
        "sensing_of": [("OBJECT", "sensing_of_object_menu")],
        "sensing_touchingobject": [("TOUCHINGOBJECTMENU", "sensing_touchingobjectmenu")],
        "control_create_clone_of": [("CLONE_OPTION", "control_create_clone_of_menu")],
        "sound_play": [("SOUND_MENU", "sound_sounds_menu")],
        "sound_playuntildone": [("SOUND_MENU", "sound_sounds_menu")],
        "looks_switchcostumeto": [("COSTUME", "looks_costume")],
        "looks_switchbackdropto": [("BACKDROP", "looks_backdrops")],
    }

    for item in opcode_counts:
        opcode = item.get("opcode")
        count = item.get("count", 1)

        if opcode == "sensing_istouching": # Handle potential old opcode name
            opcode = "sensing_touchingobject"

        if not opcode or opcode not in all_block_definitions:
            print(f"Warning: Skipping opcode '{opcode}' (missing or not in definitions).")
            continue

        for _ in range(count):
            # Count occurrences per opcode for unique key generation
            opcode_counts_map[opcode] = opcode_counts_map.get(opcode, 0) + 1
            instance_num = opcode_counts_map[opcode]
            main_key = f"{opcode}_{instance_num}"

            # Track the generated key
            opcode_to_keys.setdefault(opcode, []).append(main_key)

            main_block_data = copy.deepcopy(all_block_definitions[opcode])
            # Initialize parent, next, topLevel to None/False. These will be set correctly in generate_plan.
            main_block_data["id"] = main_key # Ensure ID is present
            main_block_data["parent"] = None
            main_block_data["next"] = None
            main_block_data["topLevel"] = False # Default to False, Hat blocks will override
            main_block_data["shadow"] = False

            # Ensure inputs and fields are dictionaries, even if they were None or list in definition
            if "inputs" not in main_block_data or not isinstance(main_block_data["inputs"], dict):
                main_block_data["inputs"] = {}
            if "fields" not in main_block_data or not isinstance(main_block_data["fields"], dict):
                main_block_data["fields"] = {}
            if "sub_stacks" not in main_block_data or not isinstance(main_block_data["sub_stacks"], dict):
                main_block_data["sub_stacks"] = {}


            generated_blocks[main_key] = main_block_data

            # Handle menus (shadow blocks)
            if opcode in explicit_menu_links:
                for input_name, menu_opcode in explicit_menu_links[opcode]:
                    if menu_opcode not in all_block_definitions:
                        continue

                    opcode_counts_map[menu_opcode] = opcode_counts_map.get(menu_opcode, 0) + 1
                    menu_instance_num = opcode_counts_map[menu_opcode]
                    menu_key = f"{menu_opcode}_{menu_instance_num}"

                    opcode_to_keys.setdefault(menu_opcode, []).append(menu_key)

                    menu_block_data = copy.deepcopy(all_block_definitions[menu_opcode])
                    menu_block_data["id"] = menu_key # Ensure ID is present
                    menu_block_data["shadow"] = True
                    menu_block_data["topLevel"] = False
                    menu_block_data["next"] = None # Shadow blocks never have a 'next'
                    menu_block_data["parent"] = main_key # Parent is the main block it's an input for

                    # Ensure inputs and fields are dictionaries for menu blocks too
                    if "inputs" not in menu_block_data or not isinstance(menu_block_data["inputs"], dict):
                        menu_block_data["inputs"] = {}
                    if "fields" not in menu_block_data or not isinstance(menu_block_data["fields"], dict):
                        menu_block_data["fields"] = {}
                    if "sub_stacks" not in menu_block_data or not isinstance(menu_block_data["sub_stacks"], dict):
                        menu_block_data["sub_stacks"] = {}

                    # Link the main block's input to the shadow block's key
                    # This assumes the input structure is [type_code, block_id_or_value]
                    if input_name in main_block_data.get("inputs", {}) and \
                       isinstance(main_block_data["inputs"][input_name], list) and \
                       len(main_block_data["inputs"][input_name]) > 0: # Check for at least type_code
                        # Assuming type code 1 for value input that takes a block
                        main_block_data["inputs"][input_name][1] = menu_key
                    else: # If input not defined as list, or empty, set it
                        main_block_data["inputs"][input_name] = [1, menu_key] # Default to value input type

                    generated_blocks[menu_key] = menu_block_data

    return generated_blocks, opcode_to_keys

# Consolidated block definitions from all JSON files
all_block_definitions = {
    # motion_block.json
    "motion_movesteps": {
        "block_name": "move () steps", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_movesteps",
        "functionality": "Moves the sprite forward by the specified number of steps in the direction it is currently facing. A positive value moves it forward, and a negative value moves it backward.",
        "inputs": {"STEPS": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_turnright": {
        "block_name": "turn right () degrees", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_turnright",
        "functionality": "Turns the sprite clockwise by the specified number of degrees.",
        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_turnleft": {
        "block_name": "turn left () degrees", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_turnleft",
        "functionality": "Turns the sprite counter-clockwise by the specified number of degrees.",
        "inputs": {"DEGREES": [1, [4, "15"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_goto": {
        "block_name": "go to ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_goto",
        "functionality": "Moves the sprite to a specified location, which can be a random position or at the mouse pointer or another to the sprite.",
        "inputs": {"TO": [1, "motion_goto_menu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_goto_menu": {
        "block_name": "go to menu", "block_type": "Motion", "block_shape": "Reporter Block", "op_code": "motion_goto_menu",
        "functionality": "Menu for go to block.",
        "inputs": {}, "fields": {"TO": ["_random_", None]}, "shadow": True, "topLevel": False
    },
    "motion_gotoxy": {
        "block_name": "go to x: () y: ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_gotoxy",
        "functionality": "Moves the sprite to the specified X and Y coordinates on the stage.",
        "inputs": {"X": [1, [4, "0"]], "Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_glideto": {
        "block_name": "glide () secs to ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_glideto",
        "functionality": "Glides the sprite smoothly to a specified location (random position, mouse pointer, or another sprite) over a given number of seconds.",
        "inputs": {"SECS": [1, [4, "1"]], "TO": [1, "motion_glideto_menu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_glideto_menu": {
        "block_name": "glide to menu", "block_type": "Motion", "block_shape": "Reporter Block", "op_code": "motion_glideto_menu",
        "functionality": "Menu for glide to block.",
        "inputs": {}, "fields": {"TO": ["_random_", None]}, "shadow": True, "topLevel": False
    },
    "motion_glidesecstoxy": {
        "block_name": "glide () secs to x: () y: ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_glidesecstoxy",
        "functionality": "Glides the sprite smoothly to the specified X and Y coordinates over a given number of seconds.",
        "inputs": {"SECS": [1, [4, "1"]], "X": [1, [4, "0"]], "Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_pointindirection": {
        "block_name": "point in direction ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_pointindirection",
        "functionality": "Sets the sprite's direction to a specified angle in degrees (0 = up, 90 = right, 180 = down, -90 = left).",
        "inputs": {"DIRECTION": [1, [8, "90"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_pointtowards": {
        "block_name": "point towards ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_pointtowards",
        "functionality": "Points the sprite towards the mouse pointer or another specified sprite.",
        "inputs": {"TOWARDS": [1, "motion_pointtowards_menu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_pointtowards_menu": {
        "block_name": "point towards menu", "block_type": "Motion", "block_shape": "Reporter Block", "op_code": "motion_pointtowards_menu",
        "functionality": "Menu for point towards block.",
        "inputs": {}, "fields": {"TOWARDS": ["_mouse_", None]}, "shadow": True, "topLevel": False
    },
    "motion_changexby": {
        "block_name": "change x by ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_changexby",
        "functionality": "Changes the sprite's X-coordinate by the specified amount, moving it horizontally.",
        "inputs": {"DX": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_setx": {
        "block_name": "set x to ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_setx",
        "functionality": "Sets the sprite's X-coordinate to a specific value, placing it at a precise horizontal position.",
        "inputs": {"X": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_changeyby": {
        "block_name": "change y by ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_changeyby",
        "functionality": "Changes the sprite's Y-coordinate by the specified amount, moving it vertically.",
        "inputs": {"DY": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_sety": {
        "block_name": "set y to ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_sety",
        "functionality": "Sets the sprite's Y-coordinate to a specific value, placing it at a precise vertical position.",
        "inputs": {"Y": [1, [4, "0"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_ifonedgebounce": {
        "block_name": "if on edge, bounce", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_ifonedgebounce",
        "functionality": "Reverses the sprite's direction if it touches the edge of the stage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_setrotationstyle": {
        "block_name": "set rotation style ()", "block_type": "Motion", "block_shape": "Stack Block", "op_code": "motion_setrotationstyle",
        "functionality": "Determines how the sprite rotates: 'left-right' (flips horizontally), 'don't rotate' (stays facing one direction), or 'all around' (rotates freely).",
        "inputs": {}, "fields": {"STYLE": ["left-right", None]}, "shadow": False, "topLevel": True
    },
    "motion_xposition": {
        "block_name": "(x position)", "block_type": "Motion", "block_shape": "Reporter Block", "op_code": "motion_xposition",
        "functionality": "Reports the current X-coordinate of the sprite.[NOTE: not used in stage/backdrops]",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_yposition": {
        "block_name": "(y position)", "block_type": "Motion", "block_shape": "Reporter Block", "op_code": "motion_yposition",
        "functionality": "Reports the current Y coordinate of the sprite on the stage.[NOTE: not used in stage/backdrops]",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "motion_direction": {
        "block_name": "(direction)", "block_type": "Motion", "block_shape": "Reporter Block", "op_code": "motion_direction",
        "functionality": "Reports the current direction of the sprite in degrees (0 = up, 90 = right, 180 = down, -90 = left).[NOTE: not used in stage/backdrops]",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_distanceto": { # Added sensing_distanceto
        "block_name": "(distance to ())", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_distanceto",
        "functionality": "Reports the distance from the sprite to the mouse-pointer or another specified sprite.",
        "inputs": {}, "fields": {"TARGET": ["_mouse_", None]}, "shadow": False, "topLevel": True
    },
    "sensing_distanceto_menu": { # Added sensing_distanceto_menu (though its use is now commented out in parse_reporter_or_value)
        "block_name": "distance to menu", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_distanceto_menu",
        "functionality": "Menu for distance to block.",
        "inputs": {}, "fields": {"TARGET": ["_mouse_", None]}, "shadow": True, "topLevel": False
    },

    # control_block.json
    "control_wait": {
        "block_name": "wait () seconds", "block_type": "Control", "block_shape": "Stack Block", "op_code": "control_wait",
        "functionality": "Pauses the script for a specified duration.",
        "inputs": {"DURATION": [1, [5, "1"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "control_repeat": {
        "block_name": "repeat ()", "block_type": "Control", "block_shape": "C-Block", "op_code": "control_repeat",
        "functionality": "Repeats the blocks inside it a specified number of times.",
        "inputs": {"TIMES": [1, [6, "10"]]}, "fields": {}, "shadow": False, "topLevel": True, "sub_stacks": {"SUBSTACK": [2, None]}
    },
    "control_forever": {
        "block_name": "forever", "block_type": "Control", "block_shape": "C-Block", "op_code": "control_forever",
        "functionality": "Continuously runs the blocks inside it.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True, "sub_stacks": {"SUBSTACK": [2, None]}
    },
    "control_if": {
        "block_name": "if <> then", "block_type": "Control", "block_shape": "C-Block", "op_code": "control_if",
        "functionality": "Executes the blocks inside it only if the specified boolean condition is true. [NOTE: it takes boolean blocks as input]",
        "inputs": {"CONDITION": [2, None]}, "fields": {}, "shadow": False, "topLevel": True, "sub_stacks": {"SUBSTACK": [2, None]}
    },
    "control_if_else": {
        "block_name": "if <> then else", "block_type": "Control", "block_shape": "C-Block", "op_code": "control_if_else",
        "functionality": "Executes one set of blocks if the specified boolean condition is true, and a different set of blocks if the condition is false. [NOTE: it takes boolean blocks as input]",
        "inputs": {"CONDITION": [2, None]}, "fields": {}, "shadow": False, "topLevel": True, "sub_stacks": {"SUBSTACK": [2, None], "SUBSTACK2": [2, None]}
    },
    "control_wait_until": {
        "block_name": "wait until <>", "block_type": "Control", "block_shape": "Stack Block", "op_code": "control_wait_until",
        "functionality": "Pauses the script until the specified boolean condition becomes true. [NOTE: it takes boolean blocks as input]",
        "inputs": {"CONDITION": [2, None]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "control_repeat_until": {
        "block_name": "repeat until <>", "block_type": "Control", "block_shape": "C-Block", "op_code": "control_repeat_until",
        "functionality": "Repeats the blocks inside it until the specified boolean condition becomes true. [NOTE: it takes boolean blocks as input] ",
        "inputs": {"CONDITION": [2, None]}, "fields": {}, "shadow": False, "topLevel": True, "sub_stacks": {"SUBSTACK": [2, None]}
    },
    "control_stop": {
        "block_name": "stop [v]", "block_type": "Control", "block_shape": "Cap Block", "op_code": "control_stop",
        "functionality": "Halts all scripts, only the current script, or other scripts within the same sprite. Its shape can dynamically change based on the selected option.",
        "inputs": {}, "fields": {"STOP_OPTION": ["all", None]}, "shadow": False, "topLevel": True, "mutation": {"tagName": "mutation", "children": [], "hasnext": "false"}
    },
    "control_start_as_clone": {
        "block_name": "When I Start as a Clone", "block_type": "Control", "block_shape": "Hat Block", "op_code": "control_start_as_clone",
        "functionality": "This Hat block initiates the script when a clone of the sprite is created. It defines the behavior of individual clones.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "control_create_clone_of": {
        "block_name": "create clone of ()", "block_type": "Control", "block_shape": "Stack Block", "op_code": "control_create_clone_of",
        "functionality": "Generates a copy, or clone, of a specified sprite (or 'myself' for the current sprite).",
        "inputs": {"CLONE_OPTION": [1, "control_create_clone_of_menu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "control_create_clone_of_menu": {
        "block_name": "create clone of menu", "block_type": "Control", "block_shape": "Reporter Block", "op_code": "control_create_clone_of_menu",
        "functionality": "Menu for create clone of block.",
        "inputs": {}, "fields": {"CLONE_OPTION": ["_myself_", None]}, "shadow": True, "topLevel": False
    },
    "control_delete_this_clone": {
        "block_name": "delete this clone", "block_type": "Control", "block_shape": "Cap Block", "op_code": "control_delete_this_clone",
        "functionality": "Removes the clone that is executing it from the stage.",
        "inputs":None, "fields": {}, "shadow": False, "topLevel": True
    },

    # data_block.json
    "data_setvariableto": {
        "block_name": "set [my variable v] to ()", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_setvariableto",
        "functionality": "Assigns a specific value (number, string, or boolean) to a variable.",
        "inputs": {"VALUE": [1, [10, "0"]]}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True
    },
    "data_changevariableby": {
        "block_name": "change [my variable v] by ()", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_changevariableby",
        "functionality": "Increases or decreases a variable's numerical value by a specified amount.",
        "inputs": {"VALUE": [1, [4, "1"]]}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True
    },
    "data_showvariable": {
        "block_name": "show variable [my variable v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_showvariable",
        "functionality": "Makes a variable's monitor visible on the stage.",
        "inputs": {}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True
    },
    "data_hidevariable": {
        "block_name": "hide variable [my variable v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_hidevariable",
        "functionality": "Hides a variable's monitor from the stage.",
        "inputs": {}, "fields": {"VARIABLE": ["my variable", "`jEk@4|i[#Fk?(8x)AV.-my variable"]}, "shadow": False, "topLevel": True
    },
    "data_addtolist": {
        "block_name": "add () to [my list v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_addtolist",
        "functionality": "Appends an item to the end of a list.",
        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_deleteoflist": {
        "block_name": "delete () of [my list v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_deleteoflist",
        "functionality": "Removes an item from a list by its index or by selecting 'all' items.",
        "inputs": {"INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_deletealloflist": {
        "block_name": "delete all of [my list v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_deletealloflist",
        "functionality": "Removes all items from a list.",
        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_insertatlist": {
        "block_name": "insert () at () of [my list v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_insertatlist",
        "functionality": "Inserts an item at a specific position within a list.",
        "inputs": {"ITEM": [1, [10, "thing"]], "INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_replaceitemoflist": {
        "block_name": "replace item () of [my list v] with ()", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_replaceitemoflist",
        "functionality": "Replaces an item at a specific position in a list with a new value.",
        "inputs": {"INDEX": [1, [7, "1"]], "ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_itemoflist": {
        "block_name": "(item (2) of [myList v])", "block_type": "Data", "block_shape": "Reporter Block", "op_code": "data_itemoflist",
        "functionality": "Reports the item located at a specific position in a list.",
        "inputs": {"INDEX": [1, [7, "1"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_itemnumoflist": {
        "block_name": "(item # of [Dog] in [myList v])", "block_type": "Data", "block_shape": "Reporter Block", "op_code": "data_itemnumoflist",
        "functionality": "Reports the index number of the first occurrence of a specified item in a list. If the item is not found, it reports 0.",
        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_lengthoflist": {
        "block_name": "(length of [myList v])", "block_type": "Data", "block_shape": "Reporter Block", "op_code": "data_lengthoflist",
        "functionality": "Provides the total number of items contained in a list.",
        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_listcontainsitem": {
        "block_name": "<[my list v] contains ()?>", "block_type": "Data", "block_shape": "Boolean Block", "op_code": "data_listcontainsitem",
        "functionality": "Checks if a list includes a specific item.",
        "inputs": {"ITEM": [1, [10, "thing"]]}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_showlist": {
        "block_name": "show list [my list v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_showlist",
        "functionality": "Makes a list's monitor visible on the stage.",
        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_hidelist": {
        "block_name": "hide list [my list v]", "block_type": "Data", "block_shape": "Stack Block", "op_code": "data_hidelist",
        "functionality": "Hides a list's monitor from the stage.",
        "inputs": {}, "fields": {"LIST": ["MY_LIST", "o6`kIhtT{xWH+rX(5d,A"]}, "shadow": False, "topLevel": True
    },
    "data_variable": { # This is a reporter block for a variable's value
        "block_name": "[variable v]", "block_type": "Data", "block_shape": "Reporter Block", "op_code": "data_variable",
        "functionality": "Provides the current value stored in a variable.",
        "inputs": {}, "fields": {"VARIABLE": ["my variable", None]}, "shadow": True, "topLevel": False
    },
    "data_list": { # Added this block definition
        "block_name": "[list v]", "block_type": "Data", "block_shape": "Reporter Block", "op_code": "data_list",
        "functionality": "Reports the entire content of a specified list. When clicked in the editor, it displays the list as a monitor.",
        "inputs": {}, "fields": {"LIST": ["my list", None]}, "shadow": True, "topLevel": False
    },

    # event_block.json
    "event_whenflagclicked": {
        "block_name": "when green flag pressed", "block_type": "Events", "op_code": "event_whenflagclicked", "block_shape": "Hat Block",
        "functionality": "This Hat block initiates the script when the green flag is clicked, serving as the common starting point for most Scratch projects.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "event_whenkeypressed": {
        "block_name": "when () key pressed", "block_type": "Events", "op_code": "event_whenkeypressed", "block_shape": "Hat Block",
        "functionality": "This Hat block initiates the script when a specified keyboard key is pressed.",
        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": False, "topLevel": True
    },
    "event_whenthisspriteclicked": {
        "block_name": "when this sprite clicked", "block_type": "Events", "op_code": "event_whenthisspriteclicked", "block_shape": "Hat Block",
        "functionality": "This Hat block starts the script when the sprite itself is clicked.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "event_whenbackdropswitchesto": {
        "block_name": "when backdrop switches to ()", "block_type": "Events", "op_code": "event_whenbackdropswitchesto", "block_shape": "Hat Block",
        "functionality": "This Hat block triggers the script when the stage backdrop changes to a specified backdrop.",
        "inputs": {}, "fields": {"BACKDROP": ["backdrop1", None]}, "shadow": False, "topLevel": True
    },
    "event_whengreaterthan": {
        "block_name": "when () > ()", "block_type": "Events", "op_code": "event_whengreaterthan", "block_shape": "Hat Block",
        "functionality": "This Hat block starts the script when a certain value (e.g., loudness from a microphone, or the timer) exceeds a defined threshold.",
        "inputs": {"VALUE": [1, [4, "10"]]}, "fields": {"WHENGREATERTHANMENU": ["LOUDNESS", None]}, "shadow": False, "topLevel": True
    },
    "event_whenbroadcastreceived": {
        "block_name": "when I receive ()", "block_type": "Events", "op_code": "event_whenbroadcastreceived", "block_shape": "Hat Block",
        "functionality": "This Hat block initiates the script upon the reception of a specific broadcast message. This mechanism facilitates indirect communication between sprites or the stage.",
        "inputs": {}, "fields": {"BROADCAST_OPTION": ["message1", "5O!nei;S$!c!=hCT}0:a"]}, "shadow": False, "topLevel": True
    },
    "event_broadcast": {
        "block_name": "broadcast ()", "block_type": "Events", "block_shape": "Stack Block", "op_code": "event_broadcast",
        "functionality": "Sends a broadcast message throughout the Scratch program, activating any 'when I receive ()' blocks that are set to listen for that message, enabling indirect communication.",
        "inputs": {"BROADCAST_INPUT": [1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "event_broadcastandwait": {
        "block_name": "broadcast () and wait", "block_type": "Events", "block_shape": "Stack Block", "op_code": "event_broadcastandwait",
        "functionality": "Sends a broadcast message and pauses the current script until all other scripts activated by that broadcast have completed their execution, ensuring sequential coordination.",
        "inputs": {"BROADCAST_INPUT": [1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]}, "fields": {}, "shadow": False, "topLevel": True
    },

    # looks_block.json
    "looks_sayforsecs": {
        "block_name": "say () for () seconds", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_sayforsecs",
        "functionality": "Displays a speech bubble containing specified text for a set duration.",
        "inputs": {"MESSAGE": [1, [10, "Hello!"]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_say": {
        "block_name": "say ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_say",
        "functionality": "Displays a speech bubble with the specified text indefinitely until another 'say' or 'think' block is activated.",
        "inputs": {"MESSAGE": [1, [10, "Hello!"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_thinkforsecs": {
        "block_name": "think () for () seconds", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_thinkforsecs",
        "functionality": "Displays a thought bubble containing specified text for a set duration.",
        "inputs": {"MESSAGE": [1, [10, "Hmm..."]], "SECS": [1, [4, "2"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_think": {
        "block_name": "think ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_think",
        "functionality": "Displays a thought bubble with the specified text indefinitely until another 'say' or 'think' block is activated.",
        "inputs": {"MESSAGE": [1, [10, "Hmm..."]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_switchcostumeto": {
        "block_name": "switch costume to ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_switchcostumeto",
        "functionality": "Alters the sprite's appearance to a designated costume.",
        "inputs": {"COSTUME": [1, "looks_costume"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_costume": {
        "block_name": "costume menu", "block_type": "Looks", "block_shape": "Reporter Block", "op_code": "looks_costume",
        "functionality": "Menu for switch costume to block.",
        "inputs": {}, "fields": {"COSTUME": ["costume1", None]}, "shadow": True, "topLevel": False
    },
    "looks_nextcostume": {
        "block_name": "next costume", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_nextcostume",
        "functionality": "Switches the sprite's costume to the next one in its costume list. If it's the last costume, it cycles back to the first.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_switchbackdropto": {
        "block_name": "switch backdrop to ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_switchbackdropto",
        "functionality": "Changes the stage's backdrop to a specified backdrop.",
        "inputs": {"BACKDROP": [1, "looks_backdrops"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_backdrops": {
        "block_name": "backdrop menu", "block_type": "Looks", "block_shape": "Reporter Block", "op_code": "looks_backdrops",
        "functionality": "Menu for switch backdrop to block.",
        "inputs": {}, "fields": {"BACKDROP": ["backdrop1", None]}, "shadow": True, "topLevel": False
    },
    "looks_switchbackdroptowait": {
        "block_name": "switch backdrop to () and wait", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_switchbackdroptowait",
        "functionality": "Changes the stage's backdrop to a specified backdrop and pauses the script until any 'When backdrop switches to' scripts for that backdrop have finished.",
        "inputs": {"BACKDROP": [1, "looks_backdrops"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_nextbackdrop": {
        "block_name": "next backdrop", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_nextbackdrop",
        "functionality": "Switches the stage's backdrop to the next one in its backdrop list. If it's the last backdrop, it cycles back to the first.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_changesizeby": {
        "block_name": "change size by ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_changesizeby",
        "functionality": "Changes the sprite's size by a specified percentage. Positive values make it larger, negative values make it smaller.",
        "inputs": {"CHANGE": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_setsizeto": {
        "block_name": "set size to () %", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_setsizeto",
        "functionality": "Sets the sprite's size to a specific percentage of its original size.",
        "inputs": {"SIZE": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_changeeffectby": {
        "block_name": "change () effect by ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_changeeffectby",
        "functionality": "Changes a visual effect on the sprite by a specified amount (e.g., color, fisheye, whirl, pixelate, mosaic, brightness, ghost).",
        "inputs": {"CHANGE": [1, [4, "25"]]}, "fields": {"EFFECT": ["COLOR", None]}, "shadow": False, "topLevel": True
    },
    "looks_seteffectto": {
        "block_name": "set () effect to ()", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_seteffectto",
        "functionality": "Sets a visual effect on the sprite to a specific value.",
        "inputs": {"VALUE": [1, [4, "0"]]}, "fields": {"EFFECT": ["COLOR", None]}, "shadow": False, "topLevel": True
    },
    "looks_cleargraphiceffects": {
        "block_name": "clear graphic effects", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_cleargraphiceffects",
        "functionality": "Removes all visual effects applied to the sprite.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_show": {
        "block_name": "show", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_show",
        "functionality": "Makes the sprite visible on the stage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_hide": {
        "block_name": "hide", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_hide",
        "functionality": "Makes the sprite invisible on the stage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "looks_gotofrontback": {
        "block_name": "go to () layer", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_gotofrontback",
        "functionality": "Moves the sprite to the front-most or back-most layer of other sprites on the stage.",
        "inputs": {}, "fields": {"FRONT_BACK": ["front", None]}, "shadow": False, "topLevel": True
    },
    "looks_goforwardbackwardlayers": {
        "block_name": "go () layers", "block_type": "Looks", "block_shape": "Stack Block", "op_code": "looks_goforwardbackwardlayers",
        "functionality": "Moves the sprite forward or backward a specified number of layers in relation to other sprites.",
        "inputs": {"NUM": [1, [7, "1"]]}, "fields": {"FORWARD_BACKWARD": ["forward", None]}, "shadow": False, "topLevel": True
    },
    "looks_costumenumbername": {
        "block_name": "(costume ())", "block_type": "Looks", "block_shape": "Reporter Block", "op_code": "looks_costumenumbername",
        "functionality": "Reports the current costume's number or name.",
        "inputs": {}, "fields": {"NUMBER_NAME": ["number", None]}, "shadow": False, "topLevel": True
    },
    "looks_backdropnumbername": {
        "block_name": "(backdrop ())", "block_type": "Looks", "block_shape": "Reporter Block", "op_code": "looks_backdropnumbername",
        "functionality": "Reports the current backdrop's number or name.",
        "inputs": {}, "fields": {"NUMBER_NAME": ["number", None]}, "shadow": False, "topLevel": True
    },
    "looks_size": {
        "block_name": "(size)", "block_type": "Looks", "block_shape": "Reporter Block", "op_code": "looks_size",
        "functionality": "Reports the current size of the sprite as a percentage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },

    # operator_block.json
    "operator_add": {
        "block_name": "(() + ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_add",
        "functionality": "Adds two numerical values.",
        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_subtract": {
        "block_name": "(() - ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_subtract",
        "functionality": "Subtracts the second numerical value from the first.",
        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_multiply": {
        "block_name": "(() * ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_multiply",
        "functionality": "Multiplies two numerical values.",
        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_divide": {
        "block_name": "(() / ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_divide",
        "functionality": "Divides the first numerical value by the second.",
        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_random": {
        "block_name": "(pick random () to ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_random",
        "functionality": "Generates a random integer within a specified inclusive range.",
        "inputs": {"FROM": [1, [4, "1"]], "TO": [1, [4, "10"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_gt": {
        "block_name": "<() > ()>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_gt",
        "functionality": "Checks if the first value is greater than the second.",
        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_lt": {
        "block_name": "<() < ()>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_lt",
        "functionality": "Checks if the first value is less than the second.",
        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_equals": {
        "block_name": "<() = ()>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_equals",
        "functionality": "Checks if two values are equal.",
        "inputs": {"OPERAND1": [1, [10, ""]], "OPERAND2": [1, [10, "50"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_and": {
        "block_name": "<<> and <>>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_and",
        "functionality": "Returns 'true' if both provided Boolean conditions are 'true'.",
        "inputs": {"OPERAND1": [2, None], "OPERAND2": [2, None]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_or": {
        "block_name": "<<> or <>>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_or",
        "functionality": "Returns 'true' if at least one of the provided Boolean conditions is 'true'.",
        "inputs": {"OPERAND1": [2, None], "OPERAND2": [2, None]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_not": {
        "block_name": "<not <>>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_not",
        "functionality": "Returns 'true' if the provided Boolean condition is 'false', and 'false' if it is 'true'.",
        "inputs": {"OPERAND": [2, None]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_join": {
        "block_name": "(join ()())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_join",
        "functionality": "Concatenates two strings or values into a single string.",
        "inputs": {"STRING1": [1, [10, "apple "]], "STRING2": [1, [10, "banana"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_letterof": {
        "block_name": "letter () of ()", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_letterof",
        "functionality": "Reports the character at a specific numerical position within a string.",
        "inputs": {"LETTER": [1, [6, "1"]], "STRING": [1, [10, "apple"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_length": {
        "block_name": "(length of ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_length",
        "functionality": "Reports the total number of characters in a given string.",
        "inputs": {"STRING": [1, [10, "apple"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_contains": {
        "block_name": "<() contains ()?>", "block_type": "operator", "block_shape": "Boolean Block", "op_code": "operator_contains",
        "functionality": "Checks if one string contains another string.",
        "inputs": {"STRING1": [1, [10, "apple"]], "STRING2": [1, [10, "a"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_mod": {
        "block_name": "(() mod ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_mod",
        "functionality": "Reports the remainder when the first number is divided by the second.",
        "inputs": {"NUM1": [1, [4, ""]], "NUM2": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_round": {
        "block_name": "(round ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_round",
        "functionality": "Rounds a numerical value to the nearest integer.",
        "inputs": {"NUM": [1, [4, ""]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "operator_mathop": {
        "block_name": "(() of ())", "block_type": "operator", "block_shape": "Reporter Block", "op_code": "operator_mathop",
        "functionality": "Performs various mathematical functions (e.g., absolute value, square root, trigonometric functions).",
        "inputs": {"NUM": [1, [4, ""]]}, "fields": {"OPERATOR": ["abs", None]}, "shadow": False, "topLevel": True
    },

    # sensing_block.json
    "sensing_touchingobject": {
        "block_name": "<touching [edge v]?>", "block_type": "Sensing", "op_code": "sensing_touchingobject", "block_shape": "Boolean Block",
        "functionality": "Checks if its sprite is touching the mouse-pointer, edge, or another specified sprite.",
        "inputs": {"TOUCHINGOBJECTMENU": [1, "sensing_touchingobjectmenu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_touchingobjectmenu": {
        "block_name": "touching object menu", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_touchingobjectmenu",
        "functionality": "Menu for touching object block.",
        "inputs": {}, "fields": {"TOUCHINGOBJECTMENU": ["_mouse_", None]}, "shadow": True, "topLevel": False
    },
    "sensing_touchingcolor": {
        "block_name": "<touching color ()?>", "block_type": "Sensing", "op_code": "sensing_touchingcolor", "block_shape": "Boolean Block",
        "functionality": "Checks whether its sprite is touching a specified color.",
        "inputs": {"COLOR": [1, [9, "#55b888"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_coloristouchingcolor": {
        "block_name": "<color () is touching ()?>", "block_type": "Sensing", "op_code": "sensing_coloristouchingcolor", "block_shape": "Boolean Block",
        "functionality": "Checks whether a specific color on its sprite is touching another specified color on the stage or another sprite.",
        "inputs": {"COLOR1": [1, [9, "#d019f2"]], "COLOR2": [1, [9, "#2b0de3"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_askandwait": {
        "block_name": "Ask () and Wait", "block_type": "Sensing", "block_shape": "Stack Block", "op_code": "sensing_askandwait",
        "functionality": "Displays an input box with specified text at the bottom of the screen, allowing users to input text, which is stored in the 'Answer' block.",
        "inputs": {"QUESTION": [1, [10, "What's your name?"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_answer": {
        "block_name": "(answer)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_answer",
        "functionality": "Holds the most recent text inputted using the 'Ask () and Wait' block.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_keypressed": {
        "block_name": "<key () pressed?>", "block_type": "Sensing", "op_code": "sensing_keypressed", "block_shape": "Boolean Block",
        "functionality": "Checks if a specified keyboard key is currently being pressed.",
        "inputs": {"KEY_OPTION": [1, "sensing_keyoptions"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_keyoptions": {
        "block_name": "key options menu", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_keyoptions",
        "functionality": "Menu for key pressed block.",
        "inputs": {}, "fields": {"KEY_OPTION": ["space", None]}, "shadow": True, "topLevel": False
    },
    "sensing_mousedown": {
        "block_name": "<mouse down?>", "block_type": "Sensing", "op_code": "sensing_mousedown", "block_shape": "Boolean Block",
        "functionality": "Checks if the computer mouse's primary button is being clicked while the cursor is over the stage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_mousex": {
        "block_name": "(mouse x)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_mousex",
        "functionality": "Reports the mouse-pointer’s current X position on the stage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_mousey": {
        "block_name": "(mouse y)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_mousey",
        "functionality": "Reports the mouse-pointer’s current Y position on the stage.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_setdragmode": {
        "block_name": "set drag mode [draggable v]", "block_type": "Sensing", "block_shape": "Stack Block", "op_code": "sensing_setdragmode",
        "functionality": "Sets whether the sprite can be dragged by the mouse on the stage.",
        "inputs": {}, "fields": {"DRAG_MODE": ["draggable", None]}, "shadow": False, "topLevel": True
    },
    "sensing_loudness": {
        "block_name": "(loudness)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_loudness",
        "functionality": "Reports the loudness of noise received by a microphone on a scale of 0 to 100.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_timer": {
        "block_name": "(timer)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_timer",
        "functionality": "Reports the elapsed time since Scratch was launched or the timer was reset, increasing by 1 every second.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_resettimer": {
        "block_name": "Reset Timer", "block_type": "Sensing", "block_shape": "Stack Block", "op_code": "sensing_resettimer",
        "functionality": "Sets the timer’s value back to 0.0.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_of": {
        "block_name": "(() of ())", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_of",
        "functionality": "Reports a specified value (e.g., x position, direction, costume number) of a specified sprite or the Stage to be accessed in current sprite or stage.",
        "inputs": {"OBJECT": [1, "sensing_of_object_menu"]}, "fields": {"PROPERTY": ["backdrop #", None]}, "shadow": False, "topLevel": True
    },
    "sensing_of_object_menu": {
        "block_name": "of object menu", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_of_object_menu",
        "functionality": "Menu for of block.",
        "inputs": {}, "fields": {"OBJECT": ["_stage_", None]}, "shadow": True, "topLevel": False
    },
    "sensing_current": {
        "block_name": "(current ())", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_current",
        "functionality": "Reports the current local year, month, date, day of the week, hour, minutes, or seconds.",
        "inputs": {}, "fields": {"CURRENTMENU": ["YEAR", None]}, "shadow": False, "topLevel": True
    },
    "sensing_dayssince2000": {
        "block_name": "(days since 2000)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_dayssince2000",
        "functionality": "Reports the number of days (and fractions of a day) since 00:00:00 UTC on January 1, 2000.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sensing_username": {
        "block_name": "(username)", "block_type": "Sensing", "block_shape": "Reporter Block", "op_code": "sensing_username",
        "functionality": "Reports the username of the user currently logged into Scratch. If no user is logged in, it reports nothing.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },

    # sound_block.json
    "sound_playuntildone": {
        "block_name": "play sound () until done", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_playuntildone",
        "functionality": "Plays a specified sound and pauses the script's execution until the sound has completed.",
        "inputs": {"SOUND_MENU": [1, "sound_sounds_menu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_sounds_menu": {
        "block_name": "sound menu", "block_type": "Sound", "block_shape": "Reporter Block", "op_code": "sound_sounds_menu",
        "functionality": "Menu for sound blocks.",
        "inputs": {}, "fields": {"SOUND_MENU": ["Meow", None]}, "shadow": True, "topLevel": False
    },
    "sound_play": {
        "block_name": "start sound ()", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_play",
        "functionality": "Initiates playback of a specified sound without pausing the script, allowing other actions to proceed concurrently.",
        "inputs": {"SOUND_MENU": [1, "sound_sounds_menu"]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_stopallsounds": {
        "block_name": "stop all sounds", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_stopallsounds",
        "functionality": "Stops all currently playing sounds.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_changeeffectby": {
        "block_name": "change () effect by ()", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_changeeffectby",
        "functionality": "Changes the project's sound effect by a specified amount.",
        "inputs": {"VALUE": [1, [4, "10"]]}, "fields": {"EFFECT": ["PITCH", None]}, "shadow": False, "topLevel": True
    },
    "sound_seteffectto": {
        "block_name": "set () effect to ()", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_seteffectto",
        "functionality": "Sets the sound effect to a specific value.",
        "inputs": {"VALUE": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_cleareffects": {
        "block_name": "clear sound effects", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_cleareffects",
        "functionality": "Removes all sound effects applied to the sprite.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_changevolumeby": {
        "block_name": "change volume by ()", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_changevolumeby",
        "functionality": "Changes the project's sound volume by a specified amount.",
        "inputs": {"VOLUME": [1, [4, "-10"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_setvolumeto": {
        "block_name": "set volume to () %", "block_type": "Sound", "block_shape": "Stack Block", "op_code": "sound_setvolumeto",
        "functionality": "Sets the sound volume to a specific percentage (0-100).",
        "inputs": {"VOLUME": [1, [4, "100"]]}, "fields": {}, "shadow": False, "topLevel": True
    },
    "sound_volume": {
        "block_name": "(volume)", "block_type": "Sound", "block_shape": "Reporter Block", "op_code": "sound_volume",
        "functionality": "Reports the current volume level of the sprite.",
        "inputs": {}, "fields": {}, "shadow": False, "topLevel": True
    },
    "procedures_definition": {
        "block_name": "define [my custom block]",
        "block_type": "My Blocks",
        "op_code": "procedures_definition",
        "block_shape": "Hat Block",
        "functionality": "This Hat block serves as the definition header for a custom block's script.",
        "inputs": {}, # Changed to empty dict
        "fields": {},
        "shadow": False,
        "topLevel": True,
        "sub_stacks": {"SUBSTACK": [2, None]} # Custom blocks can have a substack
    },
    "procedures_call": {
        "block_name": "[my custom block]",
        "block_type": "My Blocks",
        "block_shape": "Stack Block",
        "op_code": "procedures_call",
        "functionality": "Executes the script defined by a corresponding 'define' Hat block.",
        "inputs": {}, # Changed to empty dict
        "fields": {},
        "shadow": False,
        "topLevel": True
    }
}

def unparen(s):
    s = s.strip()
    # keep peeling off *all* matching outer parens
    while True:
        m = re.fullmatch(r"\((.*)\)", s)
        if not m:
            break
        s = m.group(1).strip()
    return s

def _register_block(opcode, parent_key, is_shadow, pick_key_func, all_blocks_dict, inputs=None, fields=None, sub_stacks=None):
    """
    Helper to create and register a block in the all_blocks_dict.
    It uses pick_key_func to get a unique ID.
    Parent, next, and topLevel are NOT set here for main blocks; they are handled in generate_plan.
    For shadow blocks, parent is set here.
    """
    key = pick_key_func(opcode)
    block_data = copy.deepcopy(all_block_definitions[opcode])
    block_data["id"] = key
    block_data["parent"] = parent_key if is_shadow else None # Only set parent for shadow blocks here
    block_data["next"] = None # Default, will be set in generate_plan
    block_data["topLevel"] = not is_shadow # Shadow blocks are not top-level
    block_data["shadow"] = is_shadow

    # Ensure inputs, fields, and sub_stacks are dictionaries
    if "inputs" not in block_data or not isinstance(block_data["inputs"], dict):
        block_data["inputs"] = {}
    if "fields" not in block_data or not isinstance(block_data["fields"], dict):
        block_data["fields"] = {}
    if "sub_stacks" not in block_data or not isinstance(block_data["sub_stacks"], dict):
        block_data["sub_stacks"] = {}

    if inputs:
        for inp_name, inp_val in inputs.items():
            # If the input is a block, ensure it's stored as a block ID reference
            if isinstance(inp_val, dict) and inp_val.get("kind") == "block":
                block_data["inputs"][inp_name] = [2, inp_val["block"]] # Type 2 for block input
            elif isinstance(inp_val, dict) and inp_val.get("kind") == "value":
                # For literal values, store as type 1 and the value itself
                # Need to map to Scratch's internal value types if necessary, e.g., [4, "10"] for number
                # For simplicity, we'll use a generic type 1 and the value for now.
                # A more robust solution would map `type` from parse_reporter_or_value to Scratch's internal codes.
                block_data["inputs"][inp_name] = [1, str(inp_val["value"])] # Store as string for now
            else:
                block_data["inputs"][inp_name] = inp_val # Fallback for other formats

    if fields:
        block_data["fields"].update(fields)

    if sub_stacks:
        block_data["sub_stacks"].update(sub_stacks)

    all_blocks_dict[key] = block_data
    return key

def _auto_balance(text):
    # if there are more "(" than ")", append the missing ")"
    diff = text.count("(") - text.count(")")
    if diff > 0:
        text = text + ")"*diff
    # same for square brackets
    diff = text.count("[") - text.count("]")
    if diff > 0:
        text = text + "]"*diff
    return text

def strip_outer_angle_brackets(text):
    """
    Strip exactly one balanced pair of outer <...> brackets, only if they wrap the whole string.
    """
    text = text.strip()
    if text.startswith("<") and text.endswith(">"):
        depth = 0
        for i, char in enumerate(text):
            if char == '<':
                depth += 1
            elif char == '>':
                depth -= 1
                if depth == 0 and i == len(text) - 1:
                    return text[1:-1].strip()
        # If we exit the loop and depth is 0, it means the outer brackets were balanced and wrapped the whole string
        if depth == 0:
            return text[1:-1].strip()
    return text

def extract_condition_balanced(stmt):
    # 1. Remove "if" and "then"
    stmt = stmt.strip()
    if stmt.lower().startswith("if "):
        stmt = stmt[3:].strip()
    if stmt.lower().startswith("repeat until"):
        stmt = stmt[12:].strip()
    if stmt.lower().startswith("wait until "):
        stmt = stmt[11:].strip()
    if stmt.lower().endswith(" then"):
        stmt = stmt[:-5].strip()

    # Helper to detect and strip single outer balanced angle brackets
    def unwrap_balanced(s):
        if s.startswith("<") and s.endswith(">"):
            depth = 0
            for i in range(len(s)):
                if s[i] == "<":
                    depth += 1
                elif s[i] == ">":
                    depth -= 1
                    if depth == 0 and i < len(s) - 1:
                        return s  # Early balance → not a single outer wrapper
            if depth == 0:
                return s[1:-1].strip()
        return s

    # Recursively simplify things like <not <x>> to not <x>
    def simplify(s):
        s = unwrap_balanced(s)
        s = s.strip()

        # Match <not <...>> pattern
        m = re.fullmatch(r"not\s*<(.+)>", s, re.IGNORECASE)
        if m:
            inner = m.group(1).strip()
            inner = simplify(inner)
            return f"not <{inner}>"

        # Match comparison operators like <(x position) < (100)>
        # This part might be redundant if the main parser handles it, but good for internal consistency
        m_comp = re.fullmatch(r"<\s*\(([^<>]+?)\)\s*([<>=])\s*\(([^<>]+?)\)\s*>", stmt)
        if m_comp:
            return f"({m_comp.group(1).strip()}) {m_comp.group(2)} ({m_comp.group(3).strip()})"

        return s

    return simplify(stmt)

# Nested helper for parsing reporters or values
def parse_reporter_or_value(text, parent_key, pick_key_func, all_generated_blocks):
    #print (f"text recived at parse_reporter_or_value  _auto_balance here:----------------->: {text}")
    text = _auto_balance(text.strip())
    #text = unparen(text.strip())
    print (f"text recived at parse_reporter_or_value unparen here:----------------->: {text}")
    text = strip_outer_angle_brackets(text)
    # Check for numeric literal (including parenthesized numbers like "(0)" or "(10)")
    print (f"text recived at parse_reporter_or_value here:----------------->: {text}")

    m_num = re.fullmatch(r"\(?\s*(-?\d+(\.\d+)?)\s*\)?", text)
    if m_num:
        val_str = m_num.group(1)
        return {"kind": "value", "value": float(val_str) if '.' in val_str else int(val_str)}

    # Variable reporter: [score v], [health v], etc.
    m_var = re.fullmatch(r"\[([^\]]+)\s*v\]", text)
    if m_var:
        var_name = m_var.group(1).strip()
        block_id = _register_block("data_variable", parent_key, True, pick_key_func, all_generated_blocks,
                                   fields={"VARIABLE": [var_name, None]})
        return {"kind": "block", "block": block_id}

    # Now catch other bracketed values as literal strings
    if text.startswith('[') and text.endswith(']'):
        return {"kind": "value", "value": text[1:-1]}

    # --- Reporter Blocks ---

    # (x position), (y position), (direction), (mouse x), (mouse y), (loudness), (timer), (days since 2000), (username), (answer), (size), (volume)
    simple_reporters = {
        "x position": "motion_xposition",
        "y position": "motion_yposition",
        "direction": "motion_direction",
        "mouse x": "sensing_mousex",
        "mouse y": "sensing_mousey",
        "loudness": "sensing_loudness",
        "timer": "sensing_timer",
        "days since 2000": "sensing_dayssince2000",
        "username": "sensing_username",
        "answer": "sensing_answer",
        "size": "looks_size",
        "volume": "sound_volume"
    }
    # Check for simple reporters, potentially with outer parentheses
    m_simple_reporter = re.fullmatch(r"\((.+?)\)", text)
    if m_simple_reporter:
        inner_text = m_simple_reporter.group(1).strip()
        if inner_text in simple_reporters:
            block_id = _register_block(simple_reporters[inner_text], parent_key, False, pick_key_func, all_generated_blocks)
            return {"kind": "block", "block": block_id}
    # Also check for simple reporters without parentheses (e.g., if passed directly)
    if text in simple_reporters:
        block_id = _register_block(simple_reporters[text], parent_key, False, pick_key_func, all_generated_blocks)
        return {"kind": "block", "block": block_id}


    # Variable reporter: [score v] or (score) or just "score"
    m_var = re.fullmatch(r"\[([^\]]+)\s*v\]", text)
    if m_var:
        var_name = m_var.group(1).strip()
        block_id = _register_block("data_variable", parent_key, True, pick_key_func, all_generated_blocks, fields={"VARIABLE": [var_name, None]})
        return {"kind": "block", "block": block_id}
    m_paren_var = re.fullmatch(r"\(([^)]+)\)", text)
    if m_paren_var:
        potential_var_name = m_paren_var.group(1).strip()
        # Ensure it's not a simple reporter already handled, or a number
        if potential_var_name not in simple_reporters and not re.fullmatch(r"-?\d+(\.\d+)?", potential_var_name):
            block_id = _register_block("data_variable", parent_key, True, pick_key_func, all_generated_blocks, fields={"VARIABLE": [potential_var_name, None]})
            return {"kind": "block", "block": block_id}
    # Handle plain variable names like "score", "number 1", "total score"
    if re.fullmatch(r"[a-zA-Z_][a-zA-Z0-9_ ]*", text): # Allow spaces for "number 1" etc.
        # Exclude known simple reporters that don't have 'v' or parentheses
        if text not in simple_reporters:
            block_id = _register_block("data_variable", parent_key, True, pick_key_func, all_generated_blocks, fields={"VARIABLE": [text, None]})
            return {"kind": "block", "block": block_id}


    # List reporter: [my list v]
    m_list_reporter = re.fullmatch(r"\[([^\]]+)\s*v\]", text)
    if m_list_reporter:
        list_name = m_list_reporter.group(1).strip()
        block_id = _register_block("data_list", parent_key, True, pick_key_func, all_generated_blocks, fields={"LIST": [list_name, None]})
        return {"kind": "block", "block": block_id}


    # (pick random () to ()) (operator_random)
    m = re.search(r"pick random \((.+?)\) to \((.+?)\)", text)
    if m:
        min_val_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks) # Parent will be set later
        max_val_obj = parse_reporter_or_value(m.group(2).strip(), parent_key, pick_key_func, all_generated_blocks) # Parent will be set later
        inputs = {"FROM": min_val_obj, "TO": max_val_obj}
        block_id = _register_block("operator_random", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        # Set parents for nested inputs
        if min_val_obj.get("kind") == "block": all_generated_blocks[min_val_obj["block"]]["parent"] = block_id
        if max_val_obj.get("kind") == "block": all_generated_blocks[max_val_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # (join ()()) (operator_join) - handle both [] and () for inputs

    #m = re.search(r"join\s+(\[.+?\]|\(.+?\))\s+(\[.+?\]|\(.+?\))", text) # Try (val) (val)
    m = re.search(r"join\s+(\[.+?\]|\(.+?\))\s*(\[.+?\]|\(.+?\))", text)
    if m:
        part1_txt = m.group(1).strip()
        part2_txt = m.group(2).strip()
        str1_obj = parse_reporter_or_value(part1_txt, parent_key, pick_key_func, all_generated_blocks)
        str2_obj = parse_reporter_or_value(part2_txt, parent_key, pick_key_func, all_generated_blocks)
        inputs = {"STRING1": str1_obj, "STRING2": str2_obj}
        block_id = _register_block("operator_join", parent_key, False,
                                pick_key_func, all_generated_blocks,
                                inputs=inputs)
        # set parents if nested blocks
        for obj in (str1_obj, str2_obj):
            if obj.get("kind") == "block":
                all_generated_blocks[obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # letter () of () (operator_letterof) - handle both [] and () for inputs
    m = re.search(r"letter \((.+?)\) of \((.+?)\)", text)
    if not m:
        m = re.search(r"letter \((.+?)\) of \[(.+?)\]", text)
    if m:
        index_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        string_val_obj = parse_reporter_or_value(m.group(2).strip(), parent_key, pick_key_func, all_generated_blocks)
        inputs = {"LETTER": index_obj, "STRING": string_val_obj}
        block_id = _register_block("operator_letterof", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        if index_obj.get("kind") == "block": all_generated_blocks[index_obj["block"]]["parent"] = block_id
        if string_val_obj.get("kind") == "block": all_generated_blocks[string_val_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # (length of ()) (operator_length) - handle both [] and () for inputs
    #m = re.search(r"length of \((.+?)\)", text)
    m = re.search(r"length of\s*(?:\((.+?)\)|\[(.+?)\])", text)
    if not m:
        m = re.search(r"length of \[([^\]]+)\s*v\]", text)
    if m:
        arg_txt = (m.group(1) or m.group(2)).strip()
        list_or_string_val_obj = parse_reporter_or_value(arg_txt, parent_key, pick_key_func, all_generated_blocks)
        #list_or_string_val_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        inputs = {"STRING": list_or_string_val_obj}
        block_id = _register_block("operator_length", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        if list_or_string_val_obj.get("kind") == "block": all_generated_blocks[list_or_string_val_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}


    # (() mod ()) (operator_mod)
    # m = re.search(r"\((.+?)\)\s*mod\s*\((.+?)\)", text)
    m = re.search(r"\[([^\]]+)\s*v\]\s*mod\s*\(?\s*(.+?)\s*\)?", text)
    if m:
        num1_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        num2_obj = parse_reporter_or_value(m.group(2).strip(), parent_key, pick_key_func, all_generated_blocks)
        inputs = {"NUM1": num1_obj, "NUM2": num2_obj}
        block_id = _register_block("operator_mod", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        if num1_obj.get("kind") == "block": all_generated_blocks[num1_obj["block"]]["parent"] = block_id
        if num2_obj.get("kind") == "block": all_generated_blocks[num2_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # (round ()) (operator_round)
    m = re.search(r"round \((.+?)\)", text)
    if m:
        num_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        inputs = {"NUM": num_obj}
        block_id = _register_block("operator_round", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        if num_obj.get("kind") == "block": all_generated_blocks[num_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # (() of ()) (operator_mathop) - handle variable for function type
    m = re.search(r"\[([^\]]+)\s*v\] of \((.+?)\)", text) # e.g. [sqrt v] of ((x pos) * (x pos))
    if m:
        func_type = m.group(1).strip()
        value_obj = parse_reporter_or_value(m.group(2).strip(), parent_key, pick_key_func, all_generated_blocks)
        inputs = {"NUM": value_obj}
        fields = {"OPERATOR": [func_type.upper(), None]}
        block_id = _register_block("operator_mathop", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs, fields=fields)
        if value_obj.get("kind") == "block": all_generated_blocks[value_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}
    # Also handle direct string for function type (e.g., "abs of (x)")
    m = re.search(r"([a-zA-Z]+)\s*of\s*\((.+?)\)", text)
    if m:
        func_type = m.group(1).strip()
        value_obj = parse_reporter_or_value(m.group(2).strip(), parent_key, pick_key_func, all_generated_blocks)
        inputs = {"NUM": value_obj}
        fields = {"OPERATOR": [func_type.upper(), None]}
        block_id = _register_block("operator_mathop", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs, fields=fields)
        if value_obj.get("kind") == "block": all_generated_blocks[value_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}


    # Arithmetic operations: (() + ()), (() - ()), (() * ()), (() / ())
    # This regex is designed to handle nested parentheses correctly.
    # It looks for an opening parenthesis, then non-parenthesis characters or balanced parentheses,
    # followed by an operator, and then the second operand.
    # This is a simplified approach; a full-fledged parser would use a stack.
    # arithmetic_match = re.search(r"\((.+?)\)\s*([+\-*/])\s*\((.+?)\)", text)
    # arithmetic_match = re.search(r"\(?\s*(.+?)\s*\)?\s*([\+\-\*/])\s*\(?\s*(.+?)\s*\)?", text)
    # if not arithmetic_match:
    #     # Try to match without outer parentheses for the operands, but still with an operator
    #     arithmetic_match = re.search(r"(.+?)\s*([+\-*/])\s*(.+)", text)

    # if arithmetic_match:
    #     op1_str = arithmetic_match.group(1).strip()
    #     operator_symbol = arithmetic_match.group(2).strip()
    #     op2_str = arithmetic_match.group(3).strip()
    #     print()
    #     op1_obj = parse_reporter_or_value(op1_str, parent_key, pick_key_func, all_generated_blocks)
    #     op2_obj = parse_reporter_or_value(op2_str, parent_key, pick_key_func, all_generated_blocks)

    #     opcode_map = {'+': 'operator_add', '-': 'operator_subtract', '*': 'operator_multiply', '/': 'operator_divide'}
    #     inputs = {"NUM1": op1_obj, "NUM2": op2_obj}
    #     block_id = _register_block(opcode_map[operator_symbol], parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
    #     if op1_obj.get("kind") == "block": all_generated_blocks[op1_obj["block"]]["parent"] = block_id
    #     if op2_obj.get("kind") == "block": all_generated_blocks[op2_obj["block"]]["parent"] = block_id
    #     return {"kind": "block", "block": block_id}
    _strip_outer = re.compile(r"^\s*(?P<open>[\(\[]+)\s*(?P<inner>.*\S\s*(?P=open)\s*$", re.VERBOSE)
    _expr = re.compile(r"^\s*(?P<left>[^\s\(\)\[\]]+)\s*(?P<op>[+\-*/])\s*(?P<right>[^\s\(\)\[\]]+)\s*$", re.VERBOSE)
    #m_art = re.compile(r"\(?\s*([^\s()]+)\s*\)?\s*([+\-*/])\s*\(?\s*([^\s()]+)\s*\)?", re.VERBOSE)
    if text:
        expr = text
        # strip *all* matching layers of () or []
        while True:
            m = _strip_outer.match(expr)
            if not m:
                break
            expr = m.group("inner")

        # now match the core "left op right"
        m = _expr.match(expr)
        if not m:
            return None

        left_str   = m.group("left")
        operator   = m.group("op")
        right_str  = m.group("right")

        # your existing parse & block‑creation logic
        op1_obj = parse_reporter_or_value(left_str,  parent_key, pick_key_func, all_generated_blocks)
        op2_obj = parse_reporter_or_value(right_str, parent_key, pick_key_func, all_generated_blocks)

        opcode_map = {
            '+': 'operator_add',
            '-': 'operator_subtract',
            '*': 'operator_multiply',
            '/': 'operator_divide',
        }
        inputs = {"NUM1": op1_obj, "NUM2": op2_obj}
        block_id = _register_block(
            opcode_map[operator], parent_key, False,
            pick_key_func, all_generated_blocks,
            inputs=inputs
        )

        if op1_obj.get("kind") == "block":
            all_generated_blocks[op1_obj["block"]]["parent"] = block_id
        if op2_obj.get("kind") == "block":
            all_generated_blocks[op2_obj["block"]]["parent"] = block_id

        return {"kind": "block", "block": block_id}


    # (costume ()) (looks_costumenumbername) - handle with or without 'v'
    m = re.search(r"costume \((.+?)\)", text)
    if not m:
        m = re.search(r"costume \[([^\]]+)\s*v\]", text)
    if m:
        option = m.group(1).strip()
        fields = {"NUMBER_NAME": [option, None]}
        block_id = _register_block("looks_costumenumbername", parent_key, False, pick_key_func, all_generated_blocks, fields=fields)
        return {"kind": "block", "block": block_id}

    # (backdrop ()) (looks_backdropnumbername) - handle with or without 'v'
    m = re.search(r"backdrop \((.+?)\)", text)
    if not m:
        m = re.search(r"backdrop \[([^\]]+)\s*v\]", text)
    if m:
        option = m.group(1).strip()
        fields = {"NUMBER_NAME": [option, None]}
        block_id = _register_block("looks_backdropnumbername", parent_key, False, pick_key_func, all_generated_blocks, fields=fields)
        return {"kind": "block", "block": block_id}

    # (distance to ()) (sensing_distanceto) - handle with or without 'v'
    m = re.search(r"distance to \((.+?)\)", text)
    if not m:
        m = re.search(r"distance to \[([^\]]+)\s*v\]", text)
    if m:
        target = m.group(1).strip()
        if target == "mouse-pointer": target_val = "_mouse_"
        elif target == "edge": target_val = "_edge_"
        else: target_val = target

        # This block has a dropdown FIELD, not an input that links to a shadow block
        fields = {"TARGET": [target_val, None]}
        block_id = _register_block("sensing_distanceto", parent_key, False, pick_key_func, all_generated_blocks, fields=fields)
        return {"kind": "block", "block": block_id}

    # (current ()) (sensing_current) - handle with or without 'v'
    m = re.search(r"current \((.+?)\)", text)
    if not m:
        m = re.search(r"current \[([^\]]+)\s*v\]", text)
    if m:
        unit = m.group(1).strip()
        fields = {"CURRENTMENU": [unit.upper(), None]}
        block_id = _register_block("sensing_current", parent_key, False, pick_key_func, all_generated_blocks, fields=fields)
        return {"kind": "block", "block": block_id}

    # (() of ()) (sensing_of) - Corrected logic
    #m = re.search(r"\((.+?)\)\s*of\s*(?:\((.+?)\)|\[(.+?)\s*v\])", text)
    m = re.search(r"\((.+?)\)\s*of\s*(?:\((.+?)\)|\[(.+?)\s*v\])", text)
    if m:
        prop_str = m.group(1).strip()
        obj = (m.group(2) or m.group(3)).strip()

        prop_map = {
            "x position": "x position", "y position": "y position", "direction": "direction",
            "costume #": "costume number", "costume name": "costume name", "size": "size",
            "volume": "volume", "backdrop #": "backdrop number", "backdrop name": "backdrop name"
        }
        property_value = prop_map.get(prop_str, prop_str)

        if obj.lower() == "stage": obj_val = "_stage_"
        elif obj.lower() == "myself": obj_val = "_myself_"
        else: obj_val = obj

        # Create the sensing_of_object_menu shadow block
        object_menu_id = _register_block("sensing_of_object_menu", parent_key, True, pick_key_func, all_generated_blocks, fields={"OBJECT": [obj_val, None]})

        # Create the main sensing_of block
        inputs = {"OBJECT": {"kind": "block", "block": object_menu_id}} # Link input to the shadow block ID
        fields = {"PROPERTY": [property_value, None]} # PROPERTY is a field of the main block

        block_id = _register_block("sensing_of", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs, fields=fields)
        all_generated_blocks[object_menu_id]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # (item (index) of [list v]) (data_itemoflist)
    m = re.search(r"item \((.+?)\) of \((.+?)\)", text)
    if not m:
        m = re.search(r"item \((.+?)\) of \[([^\]]+)\s*v\]", text)
    if m:
        index_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        list_name = m.group(2).strip()

        # Create data_list shadow block for the list name
        list_block_id = _register_block("data_list", parent_key, True, pick_key_func, all_generated_blocks, fields={"LIST": [list_name, None]})

        inputs = {"INDEX": index_obj, "LIST": {"kind": "block", "block": list_block_id}}
        fields = {} # No fields in data_itemoflist itself for the list name
        block_id = _register_block("data_itemoflist", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs, fields=fields)
        if index_obj.get("kind") == "block": all_generated_blocks[index_obj["block"]]["parent"] = block_id
        all_generated_blocks[list_block_id]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # (item # of [item] in [list v]) (data_itemnumoflist)
    m = re.search(r"item # of \((.+?)\) in \((.+?)\)", text)
    if not m:
        m = re.search(r"item # of \[([^\]]+)\] in \[([^\]]+)\s*v\]", text)
    if m:
        item_obj = parse_reporter_or_value(m.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        list_name = m.group(2).strip()

        # Create data_list shadow block for the list name
        list_block_id = _register_block("data_list", parent_key, True, pick_key_func, all_generated_blocks, fields={"LIST": [list_name, None]})

        inputs = {"ITEM": item_obj, "LIST": {"kind": "block", "block": list_block_id}}
        fields = {} # No fields in data_itemnumoflist itself for the list name
        block_id = _register_block("data_itemnumoflist", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs, fields=fields)
        if item_obj.get("kind") == "block": all_generated_blocks[item_obj["block"]]["parent"] = block_id
        all_generated_blocks[list_block_id]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    raise ValueError(f"Can't parse reporter or value: {text}")

def parse_condition(stmt, parent_key, pick_key_func, all_generated_blocks):
    """
    Parse Scratch-style boolean conditions, handling comparisons (<, =, >),
    boolean operators (and, or, not), and other sensing conditions.
    """
    s = stmt.strip()
    s = extract_condition_balanced(s)
    s_lower = s.lower()
    print (f"text recived at parse_condition here:----------------->: {s_lower}")
    # 1) Boolean NOT: `not <...>`
    m_not = re.fullmatch(r"\s*(?:<\s*)?not\s+(.+?)(?:\s*>)?\s*", s_lower, re.IGNORECASE)
    if m_not:
        inner = m_not.group(1).strip()
        inner_obj = parse_condition(inner, parent_key, pick_key_func, all_generated_blocks)
        bid = _register_block("operator_not", parent_key, False, pick_key_func, all_generated_blocks,
                              inputs={"OPERAND": inner_obj})
        if inner_obj.get("kind") == "block":
            all_generated_blocks[inner_obj["block"]]["parent"] = bid
        return {"kind": "block", "block": bid}

    # 2) Boolean AND / OR
    m_andor = re.fullmatch(r"\s*(.+?)\s+(and|or)\s+(.+?)\s*", s_lower, re.IGNORECASE)
    if m_andor:
        cond1_obj = parse_condition(m_andor.group(1).strip(), parent_key, pick_key_func, all_generated_blocks)
        cond2_obj = parse_condition(m_andor.group(3).strip(), parent_key, pick_key_func, all_generated_blocks)
        op_block = 'operator_and' if m_andor.group(2).lower() == 'and' else 'operator_or'
        inputs = {"OPERAND1": cond1_obj, "OPERAND2": cond2_obj}
        block_id = _register_block(op_block, parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        if cond1_obj.get("kind") == "block": all_generated_blocks[cond1_obj["block"]]["parent"] = block_id
        if cond2_obj.get("kind") == "block": all_generated_blocks[cond2_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}


    # 1a) Comparisons with explicit angle wrappers: < (...) op (...) >
    m = re.fullmatch(
        r"\s*<\s*(.+?)\s*(?P<op><|=|>)\s*(.+?)\s*>\s*",
        s,
        re.VERBOSE
    )
    if m:
        left_txt, right_txt = m.group(1), m.group(3)
        operand1_obj = parse_reporter_or_value(unparen(left_txt), parent_key, pick_key_func, all_generated_blocks)
        operand2_obj = parse_reporter_or_value(unparen(right_txt), parent_key, pick_key_func, all_generated_blocks)
        op_map = {'<': 'operator_lt', '=': 'operator_equals', '>': 'operator_gt'}

        inputs = {"OPERAND1": operand1_obj, "OPERAND2": operand2_obj}
        block_id = _register_block(op_map[m.group('op')], parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        # Set parents for nested inputs
        if operand1_obj.get("kind") == "block": all_generated_blocks[operand1_obj["block"]]["parent"] = block_id
        if operand2_obj.get("kind") == "block": all_generated_blocks[operand2_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # 1b) Simple comparisons without angle wrappers: A op B
    m_simple = re.fullmatch(r"\s*(.+?)\s*(?P<op><|=|>)\s*(.+?)\s*", s)
    if m_simple:
        left_txt, right_txt = m_simple.group(1), m_simple.group(3)
        operand1_obj = parse_reporter_or_value(unparen(left_txt), parent_key, pick_key_func, all_generated_blocks)
        operand2_obj = parse_reporter_or_value(unparen(right_txt), parent_key, pick_key_func, all_generated_blocks)
        op_map = {'<': 'operator_lt', '=': 'operator_equals', '>': 'operator_gt'}

        inputs = {"OPERAND1": operand1_obj, "OPERAND2": operand2_obj}
        block_id = _register_block(op_map[m_simple.group('op')], parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        if operand1_obj.get("kind") == "block": all_generated_blocks[operand1_obj["block"]]["parent"] = block_id
        if operand2_obj.get("kind") == "block": all_generated_blocks[operand2_obj["block"]]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # 4) Contains: <[list v] contains [item]?>
    m = re.fullmatch(r"\s*\[(.+?)\]\s+contains\s+\[(.+?)\]\?\s*", s)
    if m:
        list_name = m.group(1).strip()
        item_val = {"kind": "value", "value": m.group(2).strip()} # Item can be a value or a block

        # Create the data_list reporter block
        list_block_id = _register_block("data_list", parent_key, True, pick_key_func, all_generated_blocks, fields={"LIST": [list_name, None]})

        inputs = {"LIST": {"kind": "block", "block": list_block_id}, "ITEM": item_val}
        block_id = _register_block("data_listcontainsitem", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        all_generated_blocks[list_block_id]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # 5) Touching object: <touching [edge v]?>
    m_touch = re.fullmatch(r"""
    \s* # leading space
    (?:<\s*)?              # optional '<'
    touching               # literal
    \s*\[\s*
    (?P<sprite>[^\]]+?)    # capture the sprite name
    \s*v\]\?               # close the [sprite v]?
    (?:\s*>)?              # optional '>'
    """, s_lower, re.IGNORECASE | re.VERBOSE)
    if m_touch:
        sprite = m_touch.group('sprite').strip()
        val = {'mouse-pointer':'_mouse_', 'edge':'_edge_'}.get(sprite, sprite)

        mid = _register_block(
            "sensing_touchingobjectmenu", parent_key, True, pick_key_func, all_generated_blocks,
            fields={"TOUCHINGOBJECTMENU":[val, None]}
        )
        bid = _register_block(
            "sensing_touchingobject", parent_key, False, pick_key_func, all_generated_blocks,
            inputs={"TOUCHINGOBJECTMENU":{"kind": "block", "block": mid}} # Link input to the shadow block ID
        )
        all_generated_blocks[mid]["parent"] = bid
        return {"kind":"block","block":bid}

    # 6) Touching color: <touching color [#rrggbb]?>
    m = re.search(r"touching color \[(#[0-9A-Fa-f]{6})\]\?", s_lower)
    if m:
        inputs = {"COLOR": {"kind": "value", "value": m.group(1)}}
        block_id = _register_block("sensing_touchingcolor", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        return {"kind": "block", "block": block_id}

    # 7) Color is touching color: <color [#rggbb] is touching [#rrggbb]?>
    m = re.search(r"color \[(#[0-9A-Fa-f]{6})\] is touching \[(#[0-9A-Fa-f]{6})\]\?", s_lower)
    if m:
        inputs = {"COLOR1": {"kind": "value", "value": m.group(1)}, "COLOR2": {"kind": "value", "value": m.group(2)}}
        block_id = _register_block("sensing_coloristouchingcolor", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        return {"kind": "block", "block": block_id}

    # 8) Key pressed: <key [key v] pressed?>
    m = re.search(r"key \[([^\]]+)\s*v\] pressed\?", s_lower)
    if m:
        option = m.group(1).strip()
        menu_block_id = _register_block("sensing_keyoptions", parent_key, True, pick_key_func, all_generated_blocks, fields={"KEY_OPTION": [option, None]})

        inputs = {"KEY_OPTION": {"kind": "block", "block": menu_block_id}}
        block_id = _register_block("sensing_keypressed", parent_key, False, pick_key_func, all_generated_blocks, inputs=inputs)
        all_generated_blocks[menu_block_id]["parent"] = block_id
        return {"kind": "block", "block": block_id}

    # 9) Mouse down?: mouse down?
    if s_lower == "mouse down?":
        block_id = _register_block("sensing_mousedown", parent_key, False, pick_key_func, all_generated_blocks)
        return {"kind": "block", "block": block_id}

    val_obj = parse_reporter_or_value(unparen(stmt), parent_key, pick_key_func, all_generated_blocks)
    if val_obj:
        return val_obj

    raise ValueError(f"Can't parse condition: {stmt}")

def classify(line):
    """
    Classifies a pseudo-code line into its corresponding Scratch opcode and block type.
    Order of checks matters: more specific patterns should come before more general ones.
    """
    l = line.lower().strip()

    # Ignore comments
    if l.startswith("//"): return None, None

    # Hat Blocks (most specific first)
    if re.match(r"when green flag click(ed)?", l): return "event_whenflagclicked", "hat"
    if re.match(r"when (.+?) key press(ed)?", l): return "event_whenkeypressed", "hat"
    if re.match(r"when this sprite click(ed)?", l): return "event_whenthisspriteclicked", "hat"
    if l.startswith("when backdrop switches to"): return "event_whenbackdropswitchesto", "hat"
    if l.startswith("when ") and " > (" in l: return "event_whengreaterthan", "hat"
    if l.startswith("when i receive"): return "event_whenbroadcastreceived", "hat"
    if re.match(r"when i start as a clo(ne)?", l): return "control_start_as_clone", "hat"
    if l.startswith("define "): return "procedures_definition", "hat"
    if l.startswith("procedure "): return "procedures_definition", "hat" # For "procedure moveBall"

    # Motion Blocks
    if l.startswith("go to x:"): return "motion_gotoxy", "stack"
    # IMPORTANT: More specific glide block before less specific one
    if l.startswith("glide ") and " secs to x:" in l: return "motion_glidesecstoxy", "stack"
    if l.startswith("glide ") and " secs to " in l: return "motion_glideto", "stack"
    if l.startswith("move "): return "motion_movesteps", "stack"
    if l.startswith("turn right "): return "motion_turnright", "stack"
    if l.startswith("turn left "): return "motion_turnleft", "stack"
    if l.startswith("go to "): return "motion_goto", "stack"
    if l.startswith("point in direction"): return "motion_pointindirection", "stack"
    if l.startswith("point towards"): return "motion_pointtowards", "stack"
    if l.startswith("change x by"): return "motion_changexby", "stack"
    if re.match(r"set x to\s*\(.+\)", l): return "motion_setx", "stack" # Specific for set x
    if l.startswith("change y by"): return "motion_changeyby", "stack"
    if re.match(r"set y to\s*\(.+\)", l): return "motion_sety", "stack" # Specific for set y
    #if re.match(r"if on edge, bounce( off edge)?", l): return "motion_ifonedgebounce", "stack"
    if re.match(r"if on edge,\s*bounc(e)?(\s+off\s+edge)?", l.strip(), re.IGNORECASE): return "motion_ifonedgebounce", "stack"
    if re.match(r"bounce off edg(e)?", l): return "motion_ifonedgebounce", "stack" # Alias
    if l.startswith("set rotation style"): return "motion_setrotationstyle", "stack"


    # Looks Blocks
    if l.startswith("say ") and " for " in l: return "looks_sayforsecs", "stack"
    if l.startswith("say "): return "looks_say", "stack"
    if l.startswith("think ") and " for " in l: return "looks_thinkforsecs", "stack"
    if l.startswith("think "): return "looks_think", "stack"
    if l.startswith("switch costume to"): return "looks_switchcostumeto", "stack"
    if re.match(r"next costum(e)?", l): return "looks_nextcostume", "stack"
    if l.startswith("switch backdrop to ") and " and wait" in l: return "looks_switchbackdroptowait", "stack"
    if l.startswith("switch backdrop to"): return "looks_switchbackdropto", "stack"
    if l == "next backdrop": return "looks_nextbackdrop", "stack"
    if l.startswith("change size by"): return "looks_changesizeby", "stack"
    if l.startswith("set size to"): return "looks_setsizeto", "stack"
    # Updated regex for change/set effect by/to
    if re.match(r"change\s*(\[.+?v\]|\(.+?\))?\s*effect by", l): return "looks_changeeffectby", "stack"
    if re.match(r"set\s*(\[.+?v\]|\(.+?\))?\s*effect to", l): return "looks_seteffectto", "stack"
    if l == "clear graphic effects": return "looks_cleargraphiceffects", "stack"
    if l == "show": return "looks_show", "stack"
    if l == "hide": return "looks_hide", "stack"
    if l.startswith("go to ") and " layer" in l: return "looks_gotofrontback", "stack"
    if l.startswith("go ") and " layers" in l: return "looks_goforwardbackwardlayers", "stack"

    # Sound Blocks
    if re.match(r"play sound (.+?) until do(ne)?", l): return "sound_playuntildone", "stack"
    if l.startswith("start sound "): return "sound_play", "stack"
    if l == "stop all sounds": return "sound_stopallsounds", "stack"
    if l.startswith("change volume by"): return "sound_changevolumeby", "stack"
    if l.startswith("set volume to"): return "sound_setvolumeto", "stack"

    # Event Blocks (broadcasts)
    if l.startswith("broadcast ") and " and wait" in l: return "event_broadcastandwait", "stack"
    if l.startswith("broadcast "): return "event_broadcast", "stack"

    # Control Blocks
    if re.match(r"wait (.+?) seconds", l): return "control_wait", "stack"
    if l.startswith("wait until <"): return "control_wait_until", "stack"
    if l.startswith("repeat ("): return "control_repeat", "c_block"
    if l == "forever": return "control_forever", "c_block"
    if l.startswith("if <") and " then else" in l: return "control_if_else", "c_block"
    if l.startswith("if <"): return "control_if", "c_block"
    if l.startswith("repeat until <"): return "control_repeat_until", "c_block"
    # Updated regex for stop block to handle different options
    if re.match(r"stop \[(all|this script|other scripts in sprite)\s*v\]", l): return "control_stop", "cap"
    if l.startswith("create clone of"): return "control_create_clone_of", "stack"
    if l == "delete this clone": return "control_delete_this_clone", "cap"

    # Data Blocks
    if l.startswith("set [") and " to " in l: return "data_setvariableto", "stack"
    if l.startswith("change [") and " by " in l: return "data_changevariableby", "stack"
    if l.startswith("show variable"): return "data_showvariable", "stack"
    if l.startswith("hide variable"): return "data_hidevariable", "stack"
    if l.startswith("add ") and " to [" in l: return "data_addtolist", "stack"
    # Updated regex for delete of list
    if re.match(r"delete \((.+?)\) of \[([^\]]+)\s*v\]", l): return "data_deleteoflist", "stack"
    if l.startswith("delete all of [" ): return "data_deletealloflist", "stack"
    if l.startswith("insert ") and " at " in l: return "data_insertatlist", "stack"
    if l.startswith("replace item ") and " of [" in l: return "data_replaceitemoflist", "stack"
    if l.startswith("show list"): return "data_showlist", "stack"
    if l.startswith("hide list"): return "data_hidelist", "stack"

    # Sensing Blocks
    if re.match(r"ask (.+?) and wai(t)?", l): return "sensing_askandwait", "stack"
    if l == "reset timer": return "sensing_resettimer", "stack"
    if l.startswith("set drag mode"): return "sensing_setdragmode", "stack"

    # Custom Blocks (procedures_call) - specific rule for "call"
    if l.startswith("call "):
        return "procedures_call", "stack"

    # Custom Blocks (procedures_call) - LAST RESORT (generic match)
    # This should be the very last check for stack-type blocks to avoid conflicts.
    # It tries to match anything that looks like a function call with or without arguments.
    custom_block_match = re.match(r"([a-zA-Z_][a-zA-Z0-9_ ]*)(?:\s*\((.+?)\))*\s*$", l)
    if custom_block_match:
        # Before returning, ensure it's not a known simple reporter or variable name
        # that might have been missed or is being used standalone.
        # This is a heuristic; a full parser would be more robust.
        potential_name = custom_block_match.group(1).strip()
        if potential_name not in ["x position", "y position", "direction", "mouse x", "mouse y", "loudness", "timer", "days since 2000", "username", "answer", "size", "volume"] and \
           not re.fullmatch(r"\[[^\]]+\]", potential_name) and \
           not re.fullmatch(r"\[[^\]]+\]\s*v", potential_name):
            return "procedures_call", "stack"


    raise ValueError(f"Unknown statement: {line!r}")

def generate_plan(generated_input, opcode_keys, pseudo_code):
    """
    Build a nested “plan” tree from:
      • generated_input: dict of block_key -> block_data (pre-generated block definitions)
      • opcode_keys:    dict of opcode -> list of block_keys (in order)
      • pseudo_code:    a multiline string, indented with two‑space levels

    Returns:
        { "flow": [ ... list of block dictionaries ... ] }
    """
    # helper: pick next unused block_key for an opcode
    ptrs = defaultdict(int)
    def pick_key(opcode):
        lst = opcode_keys.get(opcode, [])
        idx = ptrs[opcode]
        if idx >= len(lst):
            # Fallback: if no more pre-generated keys, create a new one.
            # This should ideally not happen if initial_opcode_counts is comprehensive
            ptrs[opcode] += 1
            return f"{opcode}_{idx + 1}"
        ptrs[opcode] += 1
        return lst[idx]

    all_generated_blocks = {} # This will store the final, structured blocks

    # Populate all_generated_blocks with initial blocks, ensuring they have IDs
    for key, block_data in generated_input.items():
        all_generated_blocks[key] = copy.deepcopy(block_data)
        all_generated_blocks[key]["id"] = key # Ensure ID is set

    # Stack stores (indent, owner_block_id, last_block_in_current_linear_chain_id)
    # owner_block_id: The ID of the C-block or Hat block that owns the current substack.
    # last_block_in_current_linear_chain_id: The ID of the last block added to the *current linear sequence* within this substack.
    stack = [(-2, None, None)] # Sentinel: (indent, owner_block_id, last_block_in_current_linear_chain_id)
                               # Using -2 for initial indent to be less than any valid indent (0 or more)

    top_level_script_keys = []

    lines = pseudo_code.splitlines()
    i = 0
    while i < len(lines):
        raw_line = lines[i]
        stripped_line = raw_line.strip()

        # Skip empty lines and comments
        if not stripped_line or stripped_line.startswith("//"):
            i += 1
            continue

        current_indent = (len(raw_line) - len(raw_line.lstrip())) // 2

        # Handle 'else' and 'end' first, as they control scope
        if stripped_line.lower() == "else":
            # Pop the 'then' substack's scope
            popped_indent, popped_owner_key, popped_last_block_in_chain = stack.pop()
            if popped_last_block_in_chain:
                all_generated_blocks[popped_last_block_in_chain]["next"] = None

            # The 'if-else' block (popped_owner_key) is the owner.
            # This 'else' must belong to the current owner on top of the stack (which should be the if-else block)
            # Ensure the current_owner_block_id is indeed an if-else block
            if popped_owner_key and all_generated_blocks[popped_owner_key]["op_code"] == "control_if_else":
                # Push a new scope for the 'else' substack, with the same owner.
                stack.append((current_indent, popped_owner_key, None)) # New scope for 'else' part, no last block yet
            else:
                # Error: 'else' without a preceding 'if' or incorrect nesting
                print(f"Error: 'else' found without a corresponding 'if-else' block at line {i+1}")
                # Attempt to recover by treating it as a regular block or skipping
                stack.append((popped_indent, popped_owner_key, popped_last_block_in_chain)) # Put back what was popped
            i += 1
            continue

        if stripped_line.lower() == "end":
            # Pop the current substack's scope
            popped_indent, popped_owner_key, popped_last_block_in_chain = stack.pop()
            if popped_last_block_in_chain:
                all_generated_blocks[popped_last_block_in_chain]["next"] = None

            # If the popped scope had an owner (C-block or procedure definition),
            # and its substack input isn't already filled, set it to None (empty substack).
            if popped_owner_key:
                owner_block = all_generated_blocks[popped_owner_key]
                if owner_block["block_shape"] == "C-Block" or owner_block["op_code"] == "procedures_definition":
                    # Determine which substack this 'end' is closing
                    # This logic needs to be smarter for if-else
                    if owner_block["op_code"] == "control_if_else":
                        # If we just popped the 'then' branch (SUBSTACK)
                        # and SUBSTACK2 is not yet set, then this 'end' closes SUBSTACK.
                        # If SUBSTACK2 was already set, this 'end' closes SUBSTACK2.
                        # This is tricky without explicit markers. We assume 'else' is always followed by 'end' for its substack.
                        # If SUBSTACK is filled and SUBSTACK2 is not, then this 'end' closes SUBSTACK.
                        # If SUBSTACK2 is filled, this 'end' closes SUBSTACK2.
                        # If neither is filled, it's an empty 'then' branch.
                        if owner_block["sub_stacks"].get("SUBSTACK") and not owner_block["sub_stacks"].get("SUBSTACK2"):
                            # This 'end' closes the first substack (then branch)
                            pass # Already handled by the stack logic
                        elif owner_block["sub_stacks"].get("SUBSTACK2"):
                            # This 'end' closes the second substack (else branch)
                            pass # Already handled by the stack logic
                        else: # Neither substack was filled, meaning an empty 'then' branch
                            # This should have been caught when the substack was initiated.
                            # For now, ensure it's not set to a block ID if it was empty.
                            if "SUBSTACK" in owner_block["sub_stacks"] and owner_block["sub_stacks"]["SUBSTACK"] is None:
                                pass # Already None
                            if "SUBSTACK2" in owner_block["sub_stacks"] and owner_block["sub_stacks"]["SUBSTACK2"] is None:
                                pass # Already None
                    elif not owner_block["sub_stacks"].get("SUBSTACK"): # Only set if not already set by a block
                        owner_block["sub_stacks"]["SUBSTACK"] = None # No blocks in substack
            i += 1
            continue

        # Adjust stack based on indentation for regular blocks
        # Pop scopes whose indentation is greater than or equal to the current line's indentation
        while len(stack) > 1 and stack[-1][0] >= current_indent:
            popped_indent, popped_owner_key, popped_last_block_in_chain = stack.pop()
            if popped_last_block_in_chain:
                all_generated_blocks[popped_last_block_in_chain]["next"] = None # Terminate the chain

        # Get the current active scope from the stack
        current_scope_indent, current_owner_block_id, last_block_in_current_chain = stack[-1]

        # Classify the statement and create the block
        stmt_for_parse = stripped_line.rstrip("then").strip()
        opcode, ntype = classify(stmt_for_parse)

        if opcode is None: # Should not happen if classify is robust
            i += 1
            continue

        # Create the new block (and register it in all_generated_blocks)
        # _register_block now only sets parent for shadow/input blocks; main block parent/next/topLevel set here.
        key = pick_key(opcode)
        # Ensure the block exists in all_generated_blocks before trying to access it
        if key not in all_generated_blocks:
            # If not pre-generated, create a basic entry. This is a fallback.
            all_generated_blocks[key] = copy.deepcopy(all_block_definitions.get(opcode, {}))
            all_generated_blocks[key]["id"] = key
            all_generated_blocks[key]["inputs"] = all_generated_blocks[key].get("inputs", {})
            all_generated_blocks[key]["fields"] = all_generated_blocks[key].get("fields", {})
            all_generated_blocks[key]["sub_stacks"] = all_generated_blocks[key].get("sub_stacks", {})

        info = all_generated_blocks[key]

        # Set parent, next, and topLevel for the main script blocks
        if ntype == "hat":
            info["parent"] = None
            info["topLevel"] = True
            top_level_script_keys.append(key)
            # Push a new scope for the children of this hat block.
            stack.append((current_indent, key, None)) # New scope: owner is this hat, no last block yet
        else: # Stack block or C-block (that is part of a linear sequence)
            if last_block_in_current_chain:
                # This block's parent is the previous block in the chain
                info["parent"] = last_block_in_current_chain
                all_generated_blocks[last_block_in_current_chain]["next"] = key
            else:
                # This is the first block in a new linear chain (e.g., first block inside a forever loop)
                # Its parent is the owner of the current scope (the C-block or Hat block)
                info["parent"] = current_owner_block_id

                # If the owner is a C-block or procedure definition, link its SUBSTACK input
                if current_owner_block_id and (all_generated_blocks[current_owner_block_id]["block_shape"] == "C-Block" or all_generated_blocks[current_owner_block_id]["op_code"] == "procedures_definition"):
                    owner_block = all_generated_blocks[current_owner_block_id]
                    if owner_block["op_code"] == "control_if_else":
                        # If SUBSTACK is already set, this means we are starting SUBSTACK2 (else part)
                        if owner_block["sub_stacks"].get("SUBSTACK") and not owner_block["sub_stacks"].get("SUBSTACK2"):
                            owner_block["sub_stacks"]["SUBSTACK2"] = key
                        else: # This should be the first substack (then part)
                            owner_block["sub_stacks"]["SUBSTACK"] = key
                    elif not owner_block["sub_stacks"].get("SUBSTACK"): # Only set if not already set by a block
                        owner_block["sub_stacks"]["SUBSTACK"] = key
                elif current_owner_block_id and all_generated_blocks[current_owner_block_id]["block_shape"] == "Hat Block":
                    # If the owner is a Hat block, this is its first child
                    all_generated_blocks[current_owner_block_id]["next"] = key

            info["topLevel"] = False
            info["next"] = None # Default, will be overwritten if there's a next block

            # If it's a C-block or define block, it also starts a new inner scope
            if ntype == "c_block" or opcode == "procedures_definition":
                # Update the current scope's last_block_in_current_chain to this C-block
                stack[-1] = (current_scope_indent, current_owner_block_id, key)
                # Push a new scope for the C-block's substack
                stack.append((current_indent, key, None)) # New scope: owner is this C-block, no last block yet
            else:
                # For regular stack blocks, just update the last_block_in_current_chain for the current scope
                stack[-1] = (current_scope_indent, current_owner_block_id, key)

        # Parse inputs and fields (this part remains largely the same, but ensure parse_reporter_or_value/parse_condition
        # are passed the *newly created block's ID* as the parent_key for nested inputs)
        # Numeric inputs (e.g., move (10) steps, wait (1) seconds)
        if opcode == "motion_movesteps":
            m = re.search(r"move\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*steps", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["STEPS"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "motion_turnright" or opcode == "motion_turnleft":
            m = re.search(r"turn\s*(?:right|left)?\s*\(.*?\)\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*degrees", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["DEGREES"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "motion_gotoxy":
            m_x = re.search(r"x:\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            m_y = re.search(r"y:\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m_x: info["inputs"]["X"] = {"kind": "value", "value": float(m_x.group(1)) if '.' in m_x.group(1) else int(m_x.group(1))}
            if m_y: info["inputs"]["Y"] = {"kind": "value", "value": float(m_y.group(1)) if '.' in m_y.group(1) else int(m_y.group(1))}
        elif opcode == "motion_glidesecstoxy":
            m_secs = re.search(r"glide\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*secs", stmt_for_parse, re.IGNORECASE)
            m_x    = re.search(r"x:\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            m_y    = re.search(r"y:\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m_secs: info["inputs"]["SECS"] = {"kind": "value", "value": float(m_secs.group(1)) if '.' in m_secs.group(1) else int(m_secs.group(1))}
            if m_x:    info["inputs"]["X"]    = {"kind": "value", "value": float(m_x.group(1))    if '.' in m_x.group(1)    else int(m_x.group(1))}
            if m_y:    info["inputs"]["Y"]    = {"kind": "value", "value": float(m_y.group(1))    if '.' in m_y.group(1)    else int(m_y.group(1))}
        elif opcode == "motion_pointindirection":
            m = re.search(r"direction\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["DIRECTION"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode in ["motion_changexby", "motion_changeyby"]:
            m = re.search(r"by\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["DX" if opcode == "motion_changexby" else "DY"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode in ["motion_setx", "motion_sety"]:
            m = re.search(r"(?:set x to|set y to)\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["X" if opcode == "motion_setx" else "Y"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "looks_changesizeby":
            m = re.search(r"by\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["CHANGE"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "looks_setsizeto":
            m = re.search(r"to\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*%", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["SIZE"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode in ["looks_changeeffectby", "sound_changeeffectby"]:
            m = re.search(r"by\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["CHANGE" if opcode == "looks_changeeffectby" else "VALUE"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode in ["looks_seteffectto", "sound_setvolumeto"]:
            m = re.search(r"to\s*\(\s*(-?\d+(\.\d+)?)\s*\)(?:\s*%)?", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["VALUE" if opcode == "looks_seteffectto" else "VOLUME"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "looks_goforwardbackwardlayers":
            m = re.search(r"go\s*(?:forward|backward)\s*\(\s*(-?\d+)\s*\)\s*layers", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["NUM"] = {"kind": "value", "value": int(m.group(1))}
        elif opcode == "control_wait":
            m = re.search(r"wait\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*seconds", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["DURATION"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "control_repeat":
            m = re.search(r"repeat\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["TIMES"] = {"kind": "value", "value": int(m.group(1))}
        elif opcode == "data_changevariableby":
            m = re.search(r"by\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["VALUE"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}
        elif opcode == "data_deleteoflist":
            m = re.search(r"delete\s*\((.+?)\)\s*of", stmt_for_parse, re.IGNORECASE)
            if m:
                val_str = m.group(1).strip()
                if val_str.isdigit():
                    info["inputs"]["INDEX"] = {"kind": "value", "value": int(val_str)}
                else:
                    info["inputs"]["INDEX"] = {"kind": "menu", "option": val_str}
        elif opcode == "data_insertatlist":
            m_item = re.search(r"insert\s*\[([^\]]+)\]\s*at", stmt_for_parse, re.IGNORECASE)
            m_index = re.search(r"at\s*\(\s*(-?\d+)\s*\)\s*of", stmt_for_parse, re.IGNORECASE)
            if m_item: info["inputs"]["ITEM"] = {"kind": "value", "value": m_item.group(1).strip()}
            if m_index: info["inputs"]["INDEX"] = {"kind": "value", "value": int(m_index.group(1))}
        elif opcode == "data_replaceitemoflist":
            m_index = re.search(r"replace item\s*\(\s*(-?\d+)\s*\)\s*of", stmt_for_parse, re.IGNORECASE)
            m_item = re.search(r"with\s*\[([^\]]+)\]", stmt_for_parse, re.IGNORECASE)
            if m_index: info["inputs"]["INDEX"] = {"kind": "value", "value": int(m_index.group(1))}
            if m_item: info["inputs"]["ITEM"] = {"kind": "value", "value": m_item.group(1).strip()}
        elif opcode == "event_whengreaterthan":
            m = re.search(r">\s*\(\s*(-?\d+(\.\d+)?)\s*\)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["VALUE"] = {"kind": "value", "value": float(m.group(1)) if '.' in m.group(1) else int(m.group(1))}

        # String inputs
        elif opcode == "looks_sayforsecs":
            m = re.search(r"say\s*\[([^\]]+)\]\s*for\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*seconds", stmt_for_parse, re.IGNORECASE)
            if m:
                info["inputs"]["MESSAGE"] = {"kind": "value", "value": m.group(1).strip()}
                info["inputs"]["SECS"] = {"kind": "value", "value": float(m.group(2)) if '.' in m.group(2) else int(m.group(2))}
        elif opcode == "looks_say":
            m = re.search(r"say\s*(.+)", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["MESSAGE"] = parse_reporter_or_value(m.group(1).strip(), key, pick_key, all_generated_blocks)
        elif opcode == "looks_thinkforsecs":
            m = re.search(r"think\s*\[([^\]]+)\]\s*for\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*seconds", stmt_for_parse, re.IGNORECASE)
            if m:
                info["inputs"]["MESSAGE"] = {"kind": "value", "value": m.group(1).strip()}
                info["inputs"]["SECS"] = {"kind": "value", "value": float(m.group(2)) if '.' in m.group(2) else int(m.group(2))}
        elif opcode == "looks_think":
            m = re.search(r"think\s*\[([^\]]+)\]", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["MESSAGE"] = {"kind": "value", "value": m.group(1).strip()}
        elif opcode == "sensing_askandwait":
            m = re.search(r"ask\s*\[([^\]]+)\]\s*and wait", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["QUESTION"] = {"kind": "value", "value": m.group(1).strip()}
        elif opcode == "data_addtolist":
            m = re.search(r"add\s*\[([^\]]+)\]\s*to", stmt_for_parse, re.IGNORECASE)
            if m: info["inputs"]["ITEM"] = {"kind": "value", "value": m.group(1).strip()}
        elif opcode == "data_setvariableto":
            m_var = re.search(r"set\s*\[([^\]]+)\s*v\]\s*to\s*(.+)", stmt_for_parse, re.IGNORECASE)
            if m_var:
                var_name = m_var.group(1).strip()
                value_str = m_var.group(2).strip()
                info["fields"]["VARIABLE"] = [var_name, None]
                print(f"the datasetvariable: {value_str}")
                info["inputs"]["VALUE"] = parse_reporter_or_value(value_str, key, pick_key, all_generated_blocks)

        # Dropdown/Menu inputs (UPDATED)
        elif opcode == "motion_goto":
            m = re.search(r"go to\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                if option == "random position": option_val = "_random_"
                elif option == "mouse-pointer": option_val = "_mouse_"
                else: option_val = option

                menu_block_id = _register_block("motion_goto_menu", key, True, pick_key, all_generated_blocks, fields={"TO": [option_val, None]})
                info["inputs"]["TO"] = {"kind": "block", "block": menu_block_id}
        elif opcode == "motion_glideto":
            m_secs = re.search(r"glide\s*\(\s*(-?\d+(\.\d+)?)\s*\)\s*secs to\s*(?:\[([^\]]+)\s*v\]|\((.+?)\))", stmt_for_parse, re.IGNORECASE)
            if m_secs:
                info["inputs"]["SECS"] = {"kind": "value", "value": float(m_secs.group(1)) if '.' in m_secs.group(1) else int(m_secs.group(1))}
                # Use group 3 for [random position v] or group 4 for (random position)
                option = (m_secs.group(3) or m_secs.group(4)).strip()
                if option == "random position": option_val = "_random_"
                elif option == "mouse-pointer": option_val = "_mouse_"
                else: option_val = option

                menu_block_id = _register_block("motion_glideto_menu", key, True, pick_key, all_generated_blocks, fields={"TO": [option_val, None]})
                info["inputs"]["TO"] = {"kind": "block", "block": menu_block_id}
        elif opcode == "motion_pointtowards":
            m = re.search(r"point towards\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                if option == "mouse-pointer": option_val = "_mouse_"
                else: option_val = option

                menu_block_id = _register_block("motion_pointtowards_menu", key, True, pick_key, all_generated_blocks, fields={"TOWARDS": [option_val, None]})
                info["inputs"]["TOWARDS"] = {"kind": "block", "block": menu_block_id}
        elif opcode == "sensing_keypressed":
            m = re.search(r"key \[([^\]]+)\s*v\] pressed\?", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                menu_block_id = _register_block("sensing_keyoptions", key, True, pick_key, all_generated_blocks, fields={"KEY_OPTION": [option, None]})
                info["inputs"]["KEY_OPTION"] = {"kind": "block", "block": menu_block_id}
        elif opcode == "sensing_touchingobject":
            m = re.search(r"touching \[([^\]]+)\s*v\]\?", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                if option == "mouse-pointer": option_val = "_mouse_"
                elif option == "edge": option_val = "_edge_"
                else: option_val = option

                menu_block_id = _register_block("sensing_touchingobjectmenu", key, True, pick_key, all_generated_blocks, fields={"TOUCHINGOBJECTMENU": [option_val, None]})
                info["inputs"]["TOUCHINGOBJECTMENU"] = {"kind": "block", "block": menu_block_id}
        elif opcode == "control_create_clone_of":
            m = re.search(r"create clone of\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                if option == "myself": option_val = "_myself_"
                else: option_val = option

                menu_block_id = _register_block("control_create_clone_of_menu", key, True, pick_key, all_generated_blocks, fields={"CLONE_OPTION": [option_val, None]})
                info["inputs"]["CLONE_OPTION"] = {"kind": "block", "block": menu_block_id}
        elif opcode in ["sound_playuntildone", "sound_play"]:
            m = re.search(r"(?:play sound|start sound)\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                menu_block_id = _register_block("sound_sounds_menu", key, True, pick_key, all_generated_blocks, fields={"SOUND_MENU": [option, None]})
                info["inputs"]["SOUND_MENU"] = {"kind": "block", "block": menu_block_id}
        elif opcode == "looks_switchcostumeto":
            m = re.search(r"switch costume to\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                menu_block_id = _register_block("looks_costume", key, True, pick_key, all_generated_blocks, fields={"COSTUME": [option, None]})
                info["inputs"]["COSTUME"] = {"kind": "block", "block": menu_block_id}
        elif opcode in ["looks_switchbackdropto", "looks_switchbackdroptowait"]:
            m = re.search(r"switch backdrop to\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                menu_block_id = _register_block("looks_backdrops", key, True, pick_key, all_generated_blocks, fields={"BACKDROP": [option, None]})
                info["inputs"]["BACKDROP"] = {"kind": "block", "block": menu_block_id}
        elif opcode in ["event_broadcast", "event_broadcastandwait"]:
            m = re.search(r"broadcast\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m:
                option = m.group(1).strip()
                # Broadcast input doesn't use a separate menu block in definitions, it's a direct menu field in the input.
                # So, it should be [1, [11, "message1", "id"]] or [1, [12, "message1"]]
                # For now, let's keep it simple as [1, [11, option, None]] or similar if the definition allows.
                # The `all_block_definitions` has `[1, [11, "message1", "5O!nei;S$!c!=hCT}0:a"]]`
                # Let's use that format, but without the specific ID for now.
                info["inputs"]["BROADCAST_INPUT"] = {"kind": "value", "value": option} # Store as a value for now

        # Conditional inputs (Boolean blocks)
        elif opcode in ["control_if", "control_if_else", "control_wait_until", "control_repeat_until"]:
            #cond_match_str = stmt_for_parse.replace("if <", "").replace("> then else", "").replace("> then", "").replace("wait until <", "").replace("repeat until <", "").strip()
            cond_match_str = extract_condition_balanced(stmt_for_parse)
            print(f"The cond match text here:---->{cond_match_str}")
            if cond_match_str:
                # Pass current block's key as parent for nested condition
                #info["inputs"]["CONDITION"] = parse_condition(cond_match_str, key, pick_key, all_generated_blocks)
                condition_obj = parse_condition(cond_match_str, key, pick_key, all_generated_blocks)
                info["inputs"]["CONDITION"] = condition_obj
                # Ensure the parent of the condition block is set to this control block
                if condition_obj.get("kind") == "block":
                    all_generated_blocks[condition_obj["block"]]["parent"] = key
                
        elif opcode in ["operator_and", "operator_or", "operator_not", "operator_contains",
                        "sensing_touchingcolor", "sensing_coloristouchingcolor", "sensing_mousedown"]:
            pass


        # Fields parsing
        if "VARIABLE" in info["fields"]:
            m = re.search(r"\[([^\]]+)\s*v\]", stmt_for_parse)
            if m:
                var_name = m.group(1).strip()
                info["fields"]["VARIABLE"] = [var_name, None]
        if "LIST" in info["fields"]:
            m = re.search(r"(?:to|of|in)\s*\[([^\]]+)\s*v\]", stmt_for_parse)
            if m: info["fields"]["LIST"] = [m.group(1), None]
        if "STOP_OPTION" in info["fields"]:
            m = re.search(r"stop \[([^\]]+)\s*v\]", stmt_for_parse)
            if m: info["fields"]["STOP_OPTION"] = [m.group(1), None]
        if "STYLE" in info["fields"]:
            m = re.search(r"set rotation style \[([^\]]+)\s*v\]", stmt_for_parse)
            if m: info["fields"]["STYLE"] = [m.group(1), None]
        if "DRAG_MODE" in info["fields"]:
            m = re.search(r"set drag mode \[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["DRAG_MODE"] = [m.group(1), None]
        if "EFFECT" in info["fields"] and opcode in ["looks_changeeffectby", "looks_seteffectto", "sound_changeeffectby", "sound_seteffectto"]:
            m = re.search(r"(?:change|set)\s*\[([^\]]+)\s*v\] effect", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["EFFECT"] = [m.group(1).upper(), None]
        if "NUMBER_NAME" in info["fields"] and opcode in ["looks_costumenumbername", "looks_backdropnumbername"]:
            m = re.search(r"(?:costume|backdrop)\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["NUMBER_NAME"] = [m.group(1), None]
        if "FRONT_BACK" in info["fields"] and opcode == "looks_gotofrontback":
            m = re.search(r"go to\s*\[([^\]]+)\s*v\] layer", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["FRONT_BACK"] = [m.group(1), None]
        if "FORWARD_BACKWARD" in info["fields"] and opcode == "looks_goforwardbackwardlayers":
            m = re.search(r"go\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["FORWARD_BACKWARD"] = [m.group(1), None]
        if "OPERATOR" in info["fields"] and opcode == "operator_mathop":
            m = re.search(r"\[([^\]]+)\s*v\] of", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["OPERATOR"] = [m.group(1).upper(), None]
        if "CURRENTMENU" in info["fields"] and opcode == "sensing_current":
            m = re.search(r"current\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["CURRENTMENU"] = [m.group(1).upper(), None]
        if "PROPERTY" in info["fields"] and opcode == "sensing_of":
            m = re.search(r"\((.+?)\) of", stmt_for_parse, re.IGNORECASE)
            if m:
                prop = m.group(1).strip()
                prop_map = {
                    "x position": "x position", "y position": "y position", "direction": "direction",
                    "costume #": "costume number", "costume name": "costume name", "size": "size",
                    "volume": "volume", "backdrop #": "backdrop number", "backdrop name": "backdrop name"
                }
                info["fields"]["PROPERTY"] = [prop_map.get(prop, prop), None]
        if "WHENGREATERTHANMENU" in info["fields"] and opcode == "event_whengreaterthan":
            m = re.search(r"when\s*\[([^\]]+)\s*v\] >", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["WHENGREATERTHANMENU"] = [m.group(1).upper(), None]
        if "KEY_OPTION" in info["fields"] and opcode == "event_whenkeypressed": # For event_whenkeypressed hat block's field
            m = re.search(r"when\s*\[([^\]]+)\s*v\] key pressed", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["KEY_OPTION"] = [m.group(1), None]
        if "BACKDROP" in info["fields"] and opcode == "event_whenbackdropswitchesto": # For event_whenbackdropswitchesto hat block's field
            m = re.search(r"when backdrop switches to\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["BACKDROP"] = [m.group(1), None]
        if "BROADCAST_OPTION" in info["fields"] and opcode == "event_whenbroadcastreceived": # For event_whenbroadcastreceived hat block's field
            m = re.search(r"when i receive\s*\[([^\]]+)\s*v\]", stmt_for_parse, re.IGNORECASE)
            if m: info["fields"]["BROADCAST_OPTION"] = [m.group(1), None]

        # Custom block specific parsing
        if opcode == "procedures_definition":
            proc_def_match = re.match(r"(?:define|procedure)\s+([a-zA-Z_][a-zA-Z0-9_ ]*)(?:\s*\((.+?)\))?", stmt_for_parse, re.IGNORECASE)
            if proc_def_match:
                proc_name = proc_def_match.group(1).strip()
                args_str = proc_def_match.group(2)
                info["procedure_name"] = proc_name
                info["is_custom_definition"] = True

                mutation_block = {
                    "tagName": "mutation",
                    "children": [],
                    "proccode": proc_name,
                    "argumentids": [],
                    "argumentnames": [],
                    "argumentdefaults": [],
                    "warp": False # Assuming non-warp by default
                }
                if args_str:
                    args = [arg.strip() for arg in args_str.split(',')]
                    for arg in args:
                        arg_id = f"%s" # Scratch uses %s for string args, %n for number args
                        # For simplicity, we'll just use a generic ID for now, or match Scratch's pattern
                        # For the plan, we just need the names and order.
                        mutation_block["argumentids"].append(arg_id)
                        mutation_block["argumentnames"].append(arg)
                        mutation_block["argumentdefaults"].append("")

                info["mutation"] = mutation_block

        elif opcode == "procedures_call":
            call_match = re.match(r"(?:call\s+)?([a-zA-Z_][a-zA-Z0-9_ ]*)(?:\s*\((.+?)\))*\s*$", stmt_for_parse, re.IGNORECASE)
            if call_match:
                custom_block_name = call_match.group(1).strip()
                args_str = call_match.group(2)
                info["custom_block_name"] = custom_block_name

                info["mutation"] = {
                    "tagName": "mutation",
                    "children": [],
                    "proccode": custom_block_name,
                    "argumentids": [],
                    "argumentnames": [],
                    "warp": False
                }

                if args_str:
                    args = [arg.strip() for arg in args_str.split(',')]
                    for idx, arg_val_str in enumerate(args):
                        arg_input_name = f"argument_name_{idx+1}"
                        info["mutation"]["argumentids"].append(arg_input_name) # Use the input name as argument ID
                        info["mutation"]["argumentnames"].append(f"arg{idx+1}") # Placeholder name for mutation

                        info["inputs"][arg_input_name] = parse_reporter_or_value(arg_val_str, key, pick_key, all_generated_blocks) # Pass current block's key

        i += 1 # Move to the next line

    # Final pass to ensure last blocks have next: None (already handled by stack pops)
    # The build_script_flow function will correctly traverse the linked list.
    while len(stack) > 1: # Keep the initial sentinel
        popped_indent, popped_owner_key, popped_last_block_in_chain = stack.pop()
        if popped_last_block_in_chain:
            all_generated_blocks[popped_last_block_in_chain]["next"] = None

    # Construct the final flow output based on the collected top-level keys
    print(f"[ALL OPCODE BLCOKS KEY ]:\n---\n {json.dumps(all_generated_blocks, indent=1)}\n---\n")
    with open("all_generated_blocks.json", "w") as f:
        json.dump(all_generated_blocks, f, indent=2)
    # Recursively build the block structure for each top-level script
    def build_script_flow(current_block_key, visited=None):
        if visited is None:
            visited = set()

        script_flow = []
        current_iter_key = current_block_key

        while current_iter_key:
            # Detect cyclic reference
            if current_iter_key in visited:
                script_flow.append({
                    "block_key": current_iter_key,
                    "opcode": "control_stop",
                    "type": "statement",
                    "inputs": {},
                    "fields": {},
                    "comment": "Cycle detected, stopping recursion"
                })
                break

            visited.add(current_iter_key)
            block = all_generated_blocks.get(current_iter_key)
            if not block:
                break  # Should not happen if keys are correct

            output_block = {
                "block_key": block["id"],
                "opcode": block["op_code"],
                "type": block["block_shape"].replace(" Block", "").lower().replace("c-", "c_"),
                "inputs": {},
                "fields": {},
                "shadow": block.get("shadow"),
                "topLevel": block.get("topLevel"),
                "parent": block.get("parent"),
                "next": block.get("next")
            }

            # Handle all input types
            for inp_name, inp_val in block.get("inputs", {}).items():
                if inp_name in ["SUBSTACK", "SUBSTACK2"]:
                    if inp_val and inp_val in all_generated_blocks: # Direct block ID for substacks
                        output_block["inputs"][inp_name] = build_script_flow(inp_val, visited.copy())
                    else:
                        output_block["inputs"][inp_name] = [] # Empty substack
                elif isinstance(inp_val, dict) and inp_val.get("kind") == "block":
                    # Recursively build nested reporter/boolean blocks
                    nested_block_key = inp_val["block"]
                    if nested_block_key in all_generated_blocks:
                        output_block["inputs"][inp_name] = build_script_flow(nested_block_key, visited.copy())
                    else:
                        output_block["inputs"][inp_name] = inp_val # Keep original if not found (shouldn't happen)
                elif isinstance(inp_val, dict) and inp_val.get("kind") == "value":
                    output_block["inputs"][inp_name] = inp_val["value"] # Extract the value
                else:
                    output_block["inputs"][inp_name] = inp_val

            for field_name, field_val in block.get("fields", {}).items():
                output_block["fields"][field_name] = field_val

            if block.get("custom_block_name"):
                output_block["custom_block_name"] = block["custom_block_name"]

            if block.get("procedure_name"):
                output_block["procedure_name"] = block["procedure_name"]
                output_block["is_custom_definition"] = True
                if "mutation" in block: # Include mutation for custom definitions
                    output_block["mutation"] = block["mutation"]


            script_flow.append(output_block)

            # Proceed to the next block in sequence
            next_key = block.get("next")
            if next_key in visited:
                script_flow.append({
                    "block_key": next_key,
                    "opcode": "control_stop",
                    "type": "statement",
                    "inputs": {},
                    "fields": {},
                    "comment": "Cycle detected in 'next' pointer"
                })
                break

            current_iter_key = next_key

        return script_flow

    final_flow_output = []
    for key in top_level_script_keys:
        final_flow_output.extend(build_script_flow(key))
    return {"flow": final_flow_output}

# Example input with opcodes for the initial generation
# initial_opcode_counts = [
#     {"opcode":"event_whenflagclicked","count":1},
#     {"opcode":"motion_gotoxy","count":1},
#     {"opcode":"motion_xposition","count":1},
#     {"opcode":"motion_setx","count":1},
#     {"opcode":"control_forever","count":1},
#     {"opcode":"control_if","count":2},
#     {"opcode":"control_stop","count":1},
#     {"opcode":"operator_lt","count":1},
#     {"opcode":"sensing_touchingobject","count":1},
#     {"opcode":"event_broadcast","count":1},
#     {"opcode":"data_setvariableto","count":2},
#     {"opcode":"data_showvariable","count":2},
#     {"opcode":"data_variable","count":4}, # For [score v], [speed v], [Sprite1 v], [Game Over v]
#     {"opcode":"motion_pointtowards_menu", "count":1}, # For mouse-pointer menu
#     {"opcode":"motion_glideto_menu", "count":1}, # For random position menu
#     {"opcode":"motion_goto_menu", "count":1}, # For random position menu
#     {"opcode":"sensing_touchingobjectmenu", "count":1}, # For Sprite1 menu
# ]
initial_opcode_counts = [
    {"opcode":"event_whenflagclicked","count":1},
    {"opcode":"motion_gotoxy","count":1},
    {"opcode":"motion_xposition","count":1},
    {"opcode":"motion_setx","count":1},
    {"opcode":"control_forever","count":1},
    {"opcode":"control_if","count":1},
    {"opcode":"control_stop","count":1},
    {"opcode":"operator_lt","count":1},
    {"opcode":"sensing_touchingobject","count":1},
    #{"opcode":"sensing_touchingobjectmenu","count":1},
    {"opcode":"event_broadcast","count":1},
    {"opcode":"data_setvariableto","count":1},
    {"opcode":"data_showvariable","count":2},
]

# initial_opcode_counts = [
#     {"opcode":"event_whenflagclicked","count":1},
#     {"opcode":"motion_gotoxy","count":1},
#     {"opcode":"motion_glidesecstoxy","count":2}, # Increased count
#     {"opcode":"motion_xposition","count":3}, # Used multiple times in conditions
#     {"opcode":"motion_setx","count":1},
#     {"opcode":"control_forever","count":1},
#     {"opcode":"control_if","count":2}, # Two if blocks
#     {"opcode":"control_stop","count":2}, # stop all v, stop this script v
#     {"opcode":"operator_lt","count":1}, # Used in condition
#     {"opcode":"sensing_touchingobject","count":2}, # Used in condition, and for if on edge, bounce
#     {"opcode":"sensing_touchingobjectmenu","count":2}, # Menu for touchingobject
#     {"opcode":"event_broadcast","count":2}, # broadcast [Game Over v], broadcast [jump v]
#     {"opcode":"data_setvariableto","count":3}, # set [score v] to (1), set [speed v] to (1), set [other sprite X v] to ( (x position) of [Sprite2 v] )
#     {"opcode":"data_showvariable","count":2}, # show variable [score v], show variable [speed v]
#     {"opcode":"operator_add","count":2}, # For set [var] to ((var) + (val)), (number 1) + (number 2)
#     {"opcode":"data_variable","count":10}, # Increased count for general variables
#     {"opcode":"looks_sayforsecs","count":2}, # For "say [Hello!] for (2) seconds", say [You win!] for (2) seconds
#     {"opcode":"looks_say","count":2}, # For "say [Hello! v]", say [Welcome to my game! v]
#     {"opcode":"motion_movesteps","count":3}, # For "move (10) steps"
#     {"opcode":"control_wait","count":3}, # For "wait (0.1) seconds", wait (0.5) seconds, wait (1) seconds
#     {"opcode":"motion_changeyby","count":2}, # For "change y by (10)"
#     {"opcode":"motion_pointindirection","count":1}, # For "point in direction (90)"
#     {"opcode":"event_whenkeypressed","count":3}, # For "when [space v] key pressed", when [up arrow v] key pressed, when [right arrow v] key pressed, when [left arrow v] key pressed
#     {"opcode":"control_repeat","count":2}, # For "repeat (10)"
#     {"opcode":"event_whenthisspriteclicked","count":2}, # For "when this sprite clicked"
#     {"opcode":"looks_costumenumbername","count":1}, # For "(costume [name v])"
#     {"opcode":"operator_join","count":3}, # For "join [Hello ] (answer)", join (length of [shopping list v]) [ items in the list.], join [Hello, ] (username)
#     {"opcode":"sensing_answer","count":1}, # For "(answer)"
#     {"opcode":"looks_hide","count":2}, # For "hide"
#     {"opcode":"control_create_clone_of","count":2}, # For "create clone of [myself v]"
#     {"opcode":"control_start_as_clone","count":2}, # For "when I start as a clone"
#     {"opcode":"operator_random","count":1}, # For "pick random -240 to 240"
#     {"opcode":"motion_ifonedgebounce","count":2}, # For "if on edge, bounce"
#     {"opcode":"operator_gt","count":2}, # For "if <(score) > (10)> then", if <(item # of [Dog] in [myList v])> (0)> then
#     {"opcode":"control_if_else","count":1}, # For "if <(score) > (10)> then else"
#     {"opcode":"sound_play","count":2}, # Changed from sound_start to sound_play
#     {"opcode":"sensing_loudness","count":2}, # For "(loudness)"
#     {"opcode":"event_whengreaterthan","count":1}, # For "when [loudness v] > (70)"
#     {"opcode":"control_repeat_until","count":1}, # For "repeat until <touching [edge v]?>"
#     {"opcode":"looks_cleargraphiceffects","count":1}, # For "clear graphic effects"
#     {"opcode":"looks_changeeffectby","count":2}, # For "change [color v] effect by (50)", change [fisheye v] effect by (5)
#     {"opcode":"looks_seteffectto","count":1}, # For "set [ghost v] effect to (75)"
#     {"opcode":"looks_setsizeto","count":2}, # Increased count
#     {"opcode":"looks_changesizeby","count":1}, # For "change size by (5)"
#     {"opcode":"looks_nextcostume","count":2}, # For "next costume"
#     {"opcode":"looks_switchbackdroptowait","count":1}, # For "switch backdrop to [game over v] and wait"
#     {"opcode":"looks_nextbackdrop","count":1}, # For "next backdrop"
#     {"opcode":"sound_playuntildone","count":2}, # For "play sound [fanfare v] until done"
#     {"opcode":"sound_stopallsounds","count":2}, # For "stop all sounds"
#     {"opcode":"sound_changevolumeby","count":1}, # For "change volume by (-5)"
#     {"opcode":"sound_setvolumeto","count":1}, # For "set volume to (50) %"
#     {"opcode":"sensing_resettimer","count":2}, # For "reset timer"
#     {"opcode":"sensing_setdragmode","count":2}, # For "set drag mode [not draggable v]"
#     {"opcode":"data_addtolist","count":2}, # Increased count
#     {"opcode":"data_deleteoflist","count":1}, # For "delete (all) of [my list v]"
#     {"opcode":"data_insertatlist","count":1}, # For "insert [orange] at (2) of [fruits v]"
#     {"opcode":"data_replaceitemoflist","count":1}, # For "replace item (1) of [colors v] with [blue]"
#     {"opcode":"data_listcontainsitem","count":1}, # For "<[inventory v] contains [key]?>"
#     {"opcode":"data_itemoflist","count":1}, # For "(item (2) of [myList v])"
#     {"opcode":"data_lengthoflist","count":2}, # For "(length of [shopping list v])"
#     {"opcode":"data_itemnumoflist","count":1}, # For "(item # of [Dog] in [myList v])"
#     {"opcode":"sensing_touchingcolor","count":1}, # For "<touching color [#FF0000]?>"
#     {"opcode":"sensing_coloristouchingcolor","count":1}, # For "<color [#00FF00] is touching [#FF0000]?>"
#     {"opcode":"operator_and","count":1}, # For "<<mouse down?> and <touching [mouse-pointer]?> >"
#     {"opcode":"operator_or","count":1}, # For "<<key [left arrow v] pressed?> or <key [a v] pressed?>>"
#     {"opcode":"operator_not","count":1}, # For "<not <touching [Sprite2 v]?>>"
#     {"opcode":"operator_contains","count":1}, # For "<[answer] contains [yes]?>"
#     {"opcode":"procedures_call","count":1}, # For "jump (50)"
#     {"opcode":"procedures_definition","count":1}, # For "define jump (height)"
#     {"opcode":"sensing_of","count":1}, # For "(x position) of [Sprite2 v]"
#     {"opcode":"sensing_current","count":1}, # For "(current [hour v])"
#     {"opcode":"sensing_mousex","count":1}, # For "(mouse x)"
#     {"opcode":"sensing_mousey","count":1}, # For "(mouse y)"
#     {"opcode":"operator_subtract","count":1}, # For "((10) - (4))"
#     {"opcode":"operator_multiply","count":1}, # For "(6) * (7)"
#     {"opcode":"operator_divide","count":1}, # For "((20) / (5))"
#     {"opcode":"data_list","count":1}, # For "[my list v]"
#     {"opcode":"looks_gotofrontback","count":1}, # For "go to [front v] layer"
#     {"opcode":"looks_goforwardbackwardlayers","count":1}, # For "go [forward v] (1) layers"
#     {"opcode":"sound_sounds_menu","count":2}, # For sound menus
#     {"opcode":"motion_goto_menu","count":1}, # For motion_goto menu
#     {"opcode":"motion_glideto_menu","count":1}, # For motion_glideto menu
#     {"opcode":"motion_pointtowards_menu","count":1}, # For motion_pointtowards menu
#     {"opcode":"sensing_keyoptions","count":1}, # For sensing_keypressed menu
#     {"opcode":"sensing_of_object_menu","count":1}, # For sensing_of menu
#     {"opcode":"control_create_clone_of_menu","count":1}, # For control_create_clone_of menu
#     {"opcode":"looks_costume","count":1}, # For looks_switchcostumeto menu
#     {"opcode":"looks_backdrops","count":1}, # For looks_switchbackdropto menu
#     {"opcode":"sensing_distanceto","count":1} # Added sensing_distanceto
# ]

# Generate the initial blocks and get the opcode_occurrences
generated_output_json, initial_opcode_occurrences = generate_blocks_from_opcodes(initial_opcode_counts, all_block_definitions)
with open("generated_output_json.json", "w") as f:
    json.dump(generated_output_json, f, indent=2)

pseudo_code_examples = ["""
when green flag clicked
    set [score v] to (1)
    go to x: (240) y: (-135)
    set [speed v] to (1)
    show variable [score v]
    show variable [speed v]
    forever
        if <((x position)) < (-235)> then
            set x to (240)
        end
        if <touching [Sprite1 v]?> then
            broadcast [Game Over v]
            stop [all v]
        end
    end
end
""",]
# pseudo_code_examples = [
#     """
# when green flag clicked
#   go to x: (0) y: (0)
#   point in direction (90)
#   move (50) steps
# end
#     """,
#     """
# when [right arrow v] key pressed
#   turn right (15) degrees
# end
#     """,
#     """
# when this sprite clicked
#   go to [mouse-pointer v]
#     """,
#     """
# when green flag clicked
#   glide (2) secs to x: (150) y: (-100)
#   glide (2) secs to x: (-150) y: (100)
# end
#     """,
#     """
# when green flag clicked
#   forever
#     point towards [mouse-pointer v]
#     move (5) steps
#   end
# end
#     """,
#     """
# when [right arrow v] key pressed
#   change x by (10)
# end
#     """,
#     """
# when green flag clicked
#   set x to (0)
#   set y to (0)
# end
#     """,
#     """
# when [up arrow v] key pressed
#   change y by (10)
# end
#     """,
#     """
# when green flag clicked
#   forever
#     move (10) steps
#     if on edge, bounce
#   end
# end
#     """,
#     """
# when green flag clicked
#   set rotation style [left-right v]
#   forever
#     move (10) steps
#     if on edge, bounce
#   end
# end
#     """,
#     # From looks_block.json
#     """
# when green flag clicked
#    say [Grr] for (3) seconds
#    say [Have you seen my honey? v] for (3) seconds
# end
#     """,
#     """
# when green flag clicked
#    say [Welcome to my game! v]
#    wait (2) seconds
#    say [nothing]
# end
#     """,
#     """
# when this sprite clicked
#    think [What should I do? v] for (2) seconds
# end
#     """,
#     """
# when I receive [correct answer v]
#    think [That's right! v]
#    wait (1) seconds
#    think [good v]
# end
#     """,
#     """
# when I receive [explosion v]
#    repeat (5)
#      next costume
#    end
#    hide
# end
#     """,
#     """
# when green flag clicked
#    forever
#      next costume
#      wait (0.2) seconds
#    end
# end
#     """,
#     """
# when green flag clicked
#    switch backdrop to [start screen v]
# end
#     """,
#     """
# broadcast [game over v]
#    switch backdrop to [game over v] and wait
#    stop [all v]
# end
#     """,
#     """
# when [space v] key pressed
#    next backdrop
# end
#     """,
#     """
# when green flag clicked
#    repeat (10)
#      change size by (5)
#      wait (0.1) seconds
#    end
# end
#     """,
#     """
# when green flag clicked
#    set size to (50) %
#    wait (1) seconds
#    set size to (100) %
# end
#     """,
#     """
# when green flag clicked
#    forever
#      change [color v] effect by (5)
#      wait (0.1) seconds
#   end
# end
#     """,
#     """
# when green flag clicked
#    set [ghost v] effect to (75)
# end
#     """,
#     """
# when green flag clicked
#    change [color v] effect by (50)
#    wait (2) seconds
#    clear graphic effects
# end
#     """,
#     """
# when green flag clicked
#    hide
# when I receive [start game v]
#    show
# end
#     """,
#     """
# when green flag clicked
#    hide
# end
#     """,
#     """
# when green flag clicked
#    go to [front v] layer
# end
#     """,
#     """
# when this sprite clicked
#   go [forward v] (1) layers
# end
#     """,
#     """
# say join [I am costume ] (costume [name v])
#     """,
#     """
# say join [Current backdrop: ] (backdrop [name v]) for (2) seconds
#     """,
#     """
# set size to ( (size) + (10) )
#     """,
#     # From sound_block.json
#     """
# when backdrop switches to [winning screen v]
#   play sound [fanfare v] until done
#   say [You won!] for (2) seconds
# end
#     """,
#     """
# forever
#    play sound [Music v] until done
# end
#     """,
#     """
# when this sprite clicked
#    start sound [Pop v]
#    change [score v] by (1)
# end
#     """,
#     """
# when I receive [game over v]
#    stop all sounds
# end
#     """,
#     """
# when [down arrow v] key pressed
#    change volume by (-5)
# end
#     """,
#     """
# when green flag clicked
#    set volume to (50) %
# end
#     """,
#     """
# say join [Current volume: ] (volume)
#     """,
#     # From event_block.json
#     """
# when green flag clicked
#   go to x: (0) y: (0)
#   say [Hello!] for (2) seconds
# end
#     """,
#     """
# when [space v] key pressed
#   repeat (10)
#     change y by (10)
#     wait (0.1) seconds
#     change y by (-10)
#   end
# end
#     """,
#     """
# when [right arrow v] key pressed
#   point in direction (90)
#   move (10) steps
# end
#     """,
#     """
# when this sprite clicked
#   say [Ouch!] for (1) seconds
#   change [score v] by (-1)
# end
#     """,
#     """
# when backdrop switches to [game over v]
#   stop [all v]
# end
#     """,
#     """
# when [loudness v] > (70)
#   start sound [scream v]
# end
#     """,
#     """
# when I receive [start game v]
#   show
#   go to x: (0) y: (0)
# end
#     """,
#     """
# when I receive [game over v]
#   set score to 0
#   stop [all v]
# end
#     """,
#     """
# if <key [space v] pressed?> then
#   broadcast [jump v]
# end
#     """,
#     """
# broadcast [initialize sprites v] and wait
#   say [Game Started!] for (2) seconds
#     """,
#     # From control_block.json
#     """
# say [Hello!] for (1) seconds
#    wait (0.5) seconds
#    say [Goodbye!] for (1) seconds
#     """,
#     """
# when green flag clicked
#   repeat (10)
#     move (10) steps
#     wait (0.1) seconds
#   end
# end
#     """,
#     """
# when green flag clicked
#   forever
#     move (5) steps
#     if on edge, bounce
#   end
# end
#     """,
#     """
# forever
#   if <touching [color (red) v]?> then
#     stop [this script v]
#   end
# end
#     """,
#     """
# if <(score) > (10)> then
#   say [You win!] for (2) seconds
# else
#   say [Keep trying!] for (2) seconds
# end
#     """,
#     """
# repeat until <touching [edge v]?>
#   move (5) steps
# end
#     """,
#     """
# if <(health) = (0)> then
#   stop [all v]
# end
#     """,
#     """
# when I start as a clone
#   wait until <touching [edge v]?>
#   delete this clone
# end
#     """,
#     """
# when I start as a clone
#   go to x: (pick random -240 to 240) y: (pick random -180 to 180)
#   show
#   forever
#     move (10) steps
#     if on edge, bounce
#   end
# end
#     """,
#     """
# when I start as a clone
#    wait (5) seconds
#    delete this clone
# end
#     """,
#     """
# when green flag clicked
#    hide
#    forever
#      create clone of [myself v]
#      wait (1) seconds
#    end
#     """,
#     # From data_block.json
#     """
# when green flag clicked
#   set [score v] to (0)
#   set [player name v] to [Guest]
# end
#     """,
#     """
# when this sprite clicked
#   change [score v] by (1)
# end
#     """,
#     """
# when green flag clicked
#   add [apple] to [shopping list v]
#   add [banana] to [shopping list v]
# end
#     """,
#     """
# when green flag clicked
#   delete (all) of [my list v]
# end
#     """,
#     """
# insert [orange] at (2) of [fruits v]
#     """,
#     """
# replace item (1) of [colors v] with [blue]
#     """,
#     """
# when green flag clicked
#   show variable [score v]
# end
#     """,
#     """
# when I receive [game over v]
#   hide variable [score v]
# end
#     """,
#     """
# when green flag clicked
#   show list [shopping list v]
# end
#     """,
#     """
# when I receive [game over v]
#   hide list [shopping list v]
# end
#     """,
#     """
# say ([score v]) for (2) seconds
#     """,
#     """
# say ([my list v])
#     """,
#     """
# say (item (2) of [myList v]) for 2 seconds
#     """,
#     """
# say join (length of [shopping list v]) [ items in the list.]
#     """,
#     """
# if <(item # of [Dog] in [myList v])> (0)> then
#   say join [Dog found at position ] (item # of [Dog] in [my list v])
# end
#     """,
#     # From reporter_blocks.json (some already covered by other categories)
#     """
# when green flag clicked
#   say (x position) for (2) seconds
# end
#     """,
#     """
# set [worms v] to (y position)
#     """,
#     """
# when green flag clicked
#   say (direction) for (2) seconds
# end
#     """,
#     """
# say join [I am costume ] (costume [name v])
#     """,
#     """
# set size to ( (size) + (10) )
#     """,
#     """
# say join [Current backdrop: ] (backdrop [name v]) for (2) seconds
#     """,
#     """
# say join [Current volume: ] (volume)
#     """,
#     """
# if <(distance to [Sprite2 v]) < (50)> then
#   say [Too close!]
# end
#     """,
#     """
# ask [What is your name?] and wait
#   say join [Hello ] (answer)
#     """,
#     """
# go to x: (mouse x) y: (mouse y)
#     """,
#     """
# if <(mouse y) < (0)> then
#   say [Below center]
# end
#     """,
#     """
# when green flag clicked
#   forever
#     if <(loudness) > (30)> then
#       start sound [pop v]
# end
#     """,
#     """
# when green flag clicked
#   reset timer
#   say join [Time elapsed: ] (timer)
# end
#     """,
#     """
# set [other sprite X v] to ( (x position) of [Sprite2 v] )
#     """,
#     """
# say join [The current hour is ] (current [hour v])
#     """,
#     """
# say join [Days passed: ] (days since 2000)
#     """,
#     """
# say join [Hello, ] (username)
#     """,
#     """
# set [total v] to ( number 1 + number 2 )
#     """,
#     """
# set [difference v] to ( (number 1) - (number 2) )
#     """,
#     """
# set [area v] to ( (length) * (width) )
#     """,
#     """
# set [average v] to ( ([total score v]) / ([number of students v]) )
#     """,
#     """
# go to x: (pick random -240 to 240) y: (pick random -180 to 180)
#     """,
#     """
# say (join [Hello ][World!])
#     """,
#     """
# say (letter (1) of [apple])
#     """,
#     """
# say (length of [banana])
#     """,
#     """
# if <([number v] mod (2) = (0))> then
#   say [Even number]
# end
#     """,
#     """
# set [rounded score v] to (round (score))
#     """,
#     """
# set [distance v] to ([sqrt v] of ( ( (x position) * (x position) ) + ( (y position) * (y position) ) ))
#     """,
#     # From boolean_blocks.json (conditions already covered by parse_condition)
#     """
# if <(score) < (10)> then
#   say [Keep trying!]
# end
#     """,
#     """
# if <(answer) = (5)> then
#   say [Correct!]
# end
#     """,
#     """
# if <([health v]) > (0)> then
#   move (10) steps
# else
#   stop [all v]
# end
#     """,
#     """
# if <<mouse down?> and <touching [mouse-pointer]?>> then
#   say [You're clicking me!]
# end
#     """,
#     """
# if <<key [left arrow v] pressed?> or <key [a v] pressed?>> then
#   change x by (-10)
# end
#     """,
#     """
# if <not <touching [Sprite2 v]?>> then
#   say [I'm safe!]
# end
#     """,
#     """
# if <[answer] contains [yes]?> then
#   say [Great!]
# end
#     """,
#     """
# if <touching [Sprite v]?> then
#    broadcast [Game Over v]
# end
#     """,
#     """
# if <touching [edge v]?> then
#   bounce off edge
# end
#     """,
#     """
# if <touching color [#FF0000]?> then
#   change [health v] by (-1)
# end
#     """,
#     """
# if <color [#00FF00] is touching [#FF0000]?> then
#   say [Collision!]
# end
#     """,
#     """
# forever
#   if <key [space v] pressed?> then
#     broadcast [shoot v]
#   end
# end
#     """,
#     """
# if <mouse down?> then
#   go to mouse-pointer
# end
#     """,
#     """
# if <[inventory v] contains [key]?> then
#   say [You have the key!]
# end
#     """,
#     # Custom block example
#     """
# define jump (height)
#   change y by (height)
#   wait (0.5) seconds
#   change y by (0 - (height))
# end

# when green flag clicked
#   jump (50)
# end
#     """,
#     # User's custom procedure example
#     """
# // Define custom procedure "moveBall"
# procedure moveBall
#     change x by vx
#     change y by vy

#     if (x position > 240) or (x position < -240) then
#         vx = -vx

#     if (y position > 180) or (y position < -180) then
#         vy = -vy
# end procedure

# // Main program
# when green flag clicked
# set x position to 0
# set y position to 0
# set vx to 5
# set vy to 4

# forever
#     call moveBall
#     wait 0.02 seconds
# end forever
#     """
# ]
# #

test=[
"""
when green flag clicked
    go to [random position v]
""",
"""
when green flag clicked
    glide (1) secs to ([random position v])
""",
"""
when green flag clicked
    point towards [mouse-pointer v]
""",
"""
when green flag clicked
    if <key [space v] pressed?> then
        broadcast [shoot v]
    end
""",
"""
when green flag clicked
    create clone of [myself v]
""",
"""
when green flag clicked
    play sound [Meow v] until done
""",
"""
when green flag clicked
    set [score v] to ((backdrop) of [Stage v])
""",
"""
when green flag clicked
    switch costume to [costume1 v]
""",
"""
when green flag clicked
    switch backdrop to [backdrop1 v]
"""
]
txt=""
trace=""
# Process each example and print the plan
for i, pseudo_code_input in enumerate(pseudo_code_examples):
    print(f"\n--- Processing Example {i+1} --- \n {pseudo_code_input} ---")
    #print(pseudo_code_input.strip())
    try:
        # Regenerate blocks and opcode_occurrences for each run to ensure fresh keys
        # This is important because pick_key uses a defaultdict that persists state.
        generated_output_json, initial_opcode_occurrences = generate_blocks_from_opcodes(initial_opcode_counts, all_block_definitions)
        plan = generate_plan(generated_output_json, initial_opcode_occurrences, pseudo_code_input)
        #print(json.dumps(plan, indent=2))
        txt += str(plan) + "     \n"
    except Exception as e:
        #print(f"Error processing example: {e}")
        import traceback
        #traceback.print_exc()
        trace += f"Processing Example {i+1}  \n"+str(e) +"  "+str(pseudo_code_input)+" \n"

with open("all_analysis.txt", "w", encoding="utf-8") as f:
    f.write(txt)

with open("all_analysis_trace.txt", "w", encoding="utf-8") as f:
    f.write(trace)