Riscrivere BeeLadybug da zero: dall'engine di gioco al Debugger Universale

BeeLadybug 🐞

Universal telemetry and visual inspection overlay.

BeeLadybug non è un semplice widget Canvas: è un debugger open source ultraleggero che riceve pacchetti dati grezzi da qualsiasi sorgente (giochi Canvas 2D, pagine DOM, bot headless, processi Python e pipeline AI) e li visualizza in un'unica console scura in Shadow DOM.

Il Core non sa cosa sta monitorando. Riceve solo dati grezzi.

---

Perché questa struttura

Il file storico di BeeLadybug era strettamente accoppiato al motore di gioco (entità, hitbox, ctx.drawOverlay). Un approccio che non scala quando si vuole ispezionare un sito HTML o un modello Python. Il progetto è stato quindi ripensato da zero su due livelli distinti:

Strato	Responsabilità
src/core/	Orologio fittizio, buffer, grafici, overlay cyberpunk
src/adapters/	Traduttori. Convertono un mondo specifico in chiamate sendData()

L'overlay non è disegnato sul Canvas: è un pannello HTML isolato in Shadow DOM che funziona sopra un gioco, sopra una pagina web o da solo all'interno di una sandbox.

text
bee-ladybug/
├── src/
│   ├── index.js                 # API pubblica
│   ├── core/
│   │   ├── BeeLadybugCore.js    # stato, clock, sendData
│   │   └── UIOverlay.js         # console scura + sparkline
│   └── adapters/
│       ├── CanvasAdapter.js     # prossimamente: hitbox e giochi
│       ├── WebDOMAdapter.js     # prossimamente: layout HTML
│       └── python/
│           └── PythonBridge.js  # futuro: WebSocket → sendData
├── examples/
│   └── core-sandbox.js          # demo senza adapter
├── index.html
├── package.json
└── README.md