Testing and bug fixing

Author: mirkosertic

.claude/skills/blockly/SKILL.md

@@ -112,13 +112,19 @@ Colors are Blockly hue values (0–360). Always import — never hardcode a numb
 ## Adding a New Block
 
 1. **Create** `frontend/src/components/blockly/mh_myblock.js` using the pattern above
-2. **Import and register** in `component.js`:
-   - Add `import * as mh_myblock from './mh_myblock.js'` with the other imports
-   - Add `mh_myblock` to the `customBlocks` object
+2. **Import and register** in **all three** files:
+   - `frontend/src/components/blockly/component.js` — add import + entry in `customBlocks`
+   - `frontend/scripts/block-renderer.js` — add import + entry in `customBlocks`
+   - `frontend/scripts/generate-block-docs-simple.js` — add dynamic import in `blockModules` + entry in `customBlocks`
 3. **Toolbox**: automatic — `generateToolbox()` groups by `category` field
 4. **Write unit tests** — REQUIRED for every new block (see below)
-5. **Test** in dev mode: `npm run dev`
-6. **Regenerate docs**: `npm run generate-docs` (see below)
+5. **Test** in dev mode: `npm run dev` or `npm test`
+6. **Regenerate docs** — REQUIRED after every block add/modify/remove:
+   ```bash
+   cd frontend
+   npm run generate-docs
+   ```
+   This regenerates `BLOCKS.md` and all PNG images in `docs/blocks/`. Never skip this step.
 
 ---
 

BLOCKS.md

@@ -1,8 +1,8 @@
 # Blockly Blocks Documentation
 
-**Generated:** 2026-03-05
+**Generated:** 2026-03-06
 
-This documentation covers all 85 blocks used in the Megahub project, including 37 custom blocks and 48 standard Blockly blocks with custom colors.
+This documentation covers all 86 blocks used in the Megahub project, including 38 custom blocks and 48 standard Blockly blocks with custom colors.
 
 Block images are rendered as high-quality PNG screenshots to accurately show all block features including text inputs, checkboxes, and statement blocks.
 
@@ -15,7 +15,7 @@ Block images are rendered as high-quality PNG screenshots to accurately show all
 - [Text](#text) (13 blocks)
 - [Lists](#lists) (12 blocks)
 - [I/O](#i-o) (5 blocks)
-- [LEGO©](#lego-) (2 blocks)
+- [LEGO©](#lego-) (3 blocks)
 - [Gamepad](#gamepad) (5 blocks)
 - [FastLED](#fastled) (4 blocks)
 - [IMU](#imu) (1 blocks)
@@ -691,19 +691,36 @@ Block images are rendered as high-quality PNG screenshots to accurately show all
 
 ## LEGO©
 
+### lego_get_device_mode
+
+![lego_get_device_mode](docs/blocks/lego-/lego_get_device_mode.png)
+
+**Description:** Returns the currently selected mode index of a port
+
+**Message:** `Selected mode of %1`
+
+**Inputs:**
+
+| Name | Type | Check |
+|------|------|-------|
+| PORT | input_value | Any |
+
+---
+
 ### lego_get_mode_dataset
 
 ![lego_get_mode_dataset](docs/blocks/lego-/lego_get_mode_dataset.png)
 
-**Description:** Get a dataset value from the selected mode of a port
+**Description:** Get a dataset value from a specific mode of a port
 
-**Message:** `Get dataset %2 from selected mode of %1`
+**Message:** `Get dataset %3 from mode %2 of %1`
 
 **Inputs:**
 
 | Name | Type | Check |
 |------|------|-------|
 | PORT | input_value | Any |
+| MODE | input_value | Any |
 | DATASET | input_value | Any |
 
 ---
@@ -1222,10 +1239,10 @@ output: %10 to %11`
 
 ## Generation Statistics
 
-- Total blocks: 85
-- Custom Megahub blocks: 37
+- Total blocks: 86
+- Custom Megahub blocks: 38
 - Standard Blockly blocks: 48
-- PNG images generated: 85
+- PNG images generated: 86
 
 ---
 

docs/blocks/algorithms/mh_alg_dr_update.png

@@ -29,6 +29,7 @@ import {definition as mh_imu_value} from '../src/components/blockly/mh_imu_value
 import {definition as ui_show_value} from '../src/components/blockly/ui_show_value.js';
 import {definition as mh_debug_free_heap} from '../src/components/blockly/mh_debug_free_heap.js';
 import {definition as mh_port} from '../src/components/blockly/mh_port.js';
+import {definition as lego_get_device_mode} from '../src/components/blockly/lego_get_device_mode.js';
 import {definition as lego_get_mode_dataset} from '../src/components/blockly/lego_get_mode_dataset.js';
 import {definition as lego_select_mode} from '../src/components/blockly/lego_select_mode.js';
 import {definition as gamepad_gamepad} from '../src/components/blockly/mh_gamepad_gamepad.js';
@@ -115,6 +116,7 @@ const customBlocks = {
   "mh_gamepad_buttonsraw": gamepad_buttonsraw,
   "mh_gamepad_value": gamepad_value,
   "mh_gamepad_connected": gamepad_connected,
+  "lego_get_device_mode": lego_get_device_mode,
   "lego_get_mode_dataset": lego_get_mode_dataset,
   "lego_select_mode": lego_select_mode,
   "mh_fastled_addleds": mh_fastled_addleds,

docs/blocks/lego-/lego_get_device_mode.png

@@ -71,6 +71,7 @@ async function loadBlockDefinitions() {
 		ui_show_value : await import('../src/components/blockly/ui_show_value.js'),
 		mh_debug_free_heap : await import('../src/components/blockly/mh_debug_free_heap.js'),
 		mh_port : await import('../src/components/blockly/mh_port.js'),
+		lego_get_device_mode : await import('../src/components/blockly/lego_get_device_mode.js'),
 		lego_get_mode_dataset : await import('../src/components/blockly/lego_get_mode_dataset.js'),
 		lego_select_mode : await import('../src/components/blockly/lego_select_mode.js'),
 		mh_gamepad_gamepad : await import('../src/components/blockly/mh_gamepad_gamepad.js'),
@@ -230,6 +231,7 @@ async function loadBlockDefinitions() {
 		mh_gamepad_connected : blockModules.mh_gamepad_connected.definition,
 
 		// LEGO blocks
+		lego_get_device_mode : blockModules.lego_get_device_mode.definition,
 		lego_get_mode_dataset : blockModules.lego_get_mode_dataset.definition,
 		lego_select_mode : blockModules.lego_select_mode.definition,
 

docs/blocks/lego-/lego_get_mode_dataset.png

@@ -26,6 +26,7 @@ import { definition as mh_imu_value } from './mh_imu_value.js';
 import { definition as ui_show_value } from './ui_show_value.js';
 import { definition as mh_debug_free_heap } from './mh_debug_free_heap.js';
 import { definition as mh_port } from './mh_port.js';
+import { definition as lego_get_device_mode } from './lego_get_device_mode.js';
 import { definition as lego_get_mode_dataset } from './lego_get_mode_dataset.js';
 import { definition as lego_select_mode } from './lego_select_mode.js';
 import { definition as gamepad_gamepad } from './mh_gamepad_gamepad.js';
@@ -270,6 +271,8 @@ const customBlocks = {
 
     mh_gamepad_connected: gamepad_connected,
 
+    lego_get_device_mode: lego_get_device_mode,
+
     lego_get_mode_dataset: lego_get_mode_dataset,
 
     lego_select_mode: lego_select_mode,