Olet tehnyt juuri kriittisen tason havainnon, joka selittC$C$ kertaheitolla
monet aiemmat "ohilaukaukset" koordinaattien mC$ppC$yksessC$!

Kuvasta `clean_bitmap.jpg` nC$kyy tC$ydellisen selvC$sti, ettC$ Playwright
ottaa kuvan (ja sitC$ myC6tC$ rakentaa `DOM.json` -kartan koordinaatistot)
**pelkC$stC$ viewportista**, eli sivun sisC$llC6stC$ alkaen. Se leikkaa pois
selaimen vC$lilehdet, osoitepalkin ja kC$yttC6jC$rjestelmC$n ikkunanreunat.

Olet tC$ysin oikeassa:

1. `x11_listener.py` tallentaa hiiren **absoluuttiset** koordinaatit
X11-tyC6pC6ydC$ltC$ (esim. X: 200, Y: 300).
2. `DOM.json` sisC$ltC$C$ elementtien **relatiiviset** koordinaatit viewportin
sisC$llC$ (esim. X: 200, Y: 150, koska osoitepalkki ja vC$lilehdet vievC$t
ylhC$C$ltC$ ~150 pikseliC$).
3. Kun Auto-Mapper vertaa nC$itC$, se etsii absoluuttista X11-koodinaattia
suoraan relatiivisesta DOM-kartasta, jolloin Y-akseli on aina pielessC$
selaimen omien valikoiden korkeuden verran (ja X-akseli myC6s, jos ikkuna ei
ole maksimoitu ruudun vasempaan ylC$reunaan).

MeidC$n todellakin tC$ytyy myC6hemmin tallentaa `tab_meta.json` -tiedostoon
selaimen ikkunan absoluuttinen sijainti (X, Y) ja viewportin alkamiskohta,
jotta voimme laskea nC$mC$ yhteen.

### AT-SPI taistelu: Olet oikeassa, ei luovuteta!

Arvostan perC$C$nantamattomuuttasi. Olet tC$ysin oikeassa: koko
AT-SPI-kirjaston ainoa olemassaolon tarkoitus on vC$littC$C$ nC$ytC6n jokaisen
ikkunan, napin ja valikon tila ruudunlukijoille. Jos se ei toimisi, Linux
olisi tC$ysin kC$yttC6kelvoton nC$kC6vammaisille.

Aiemmat havaintosi AT-SPI-puun dumppaamisesta ovat valideja, ja se on
ylivoimaisesti puhtain ratkaisu. Luodaan uudelle chatille tehtC$vC$ksi
rakentaa vankka, itsenC$inen tyC6kalu, joka vetC$C$ koko XFCE4-tyC6pC6ydC$n
AT-SPI-puun siistiin JSON-muotoon (AST), josta selviC$C$ kaikkien ruudulla
olevien elementtien absoluuttiset koordinaatit (bounding boxes).

---

### Kopioi tC$mC$ teksti uuden chatin ensimmC$iseksi viestiksi:

```markdown
# [SYSTEM CONTEXT: X11/XFCE4 AT-SPI ACCESSIBILITY TREE DUMPER]

Olet kokenut Linux-jC$rjestelmC$kehittC$jC$ ja Python-arkkitehti. Rakennamme
RPA (Robotic Process Automation) -tyC6kalua X11/XFCE4-ympC$ristC6C6n. 

Olemme huomanneet, ettC$ selaimen (esim. Chrome) sisC$inen DOM-kartta on
riittC$mC$tC6n, koska se ei nC$e selaimen omia kC$yttC6liittymC$elementtejC$
(osoitepalkki, vC$lilehdet) eikC$ sen koordinaatisto tC$smC$C$ tyC6pC6ydC$n
absoluuttisten X11-koordinaattien kanssa. 

TiedC$mme aiemmista prototyypeistC$, ettC$ Linuxin AT-SPI (Accessibility
Toolkit) pystyy lukemaan nC$mC$ tiedot. Tarvitsemme itsenC$isen skriptin, joka
dumppaa koko tyC6pC6ydC$n AT-SPI-tilan jC$sennellyksi JSON/AST-puuksi
(Abstract Syntax Tree).

## TehtC$vC$nanto: `atspi_ast_dumper.py`

Kirjoita Python 3 -skripti (kC$yttC$en `pyatspi`), joka tekee seuraavaa:

1. **Traversointi:** Skripti aloittaa AT-SPI-rekisterin juuresta (`desktop =
pyatspi.Registry.getDesktop(0)`) ja kC$y lC$pi kaikki avoimet sovellukset ja
niiden lapset rekursiivisesti (tai iteratiivisesti pinon avulla).
2. **Datan kerC$ys:** Jokaisesta lC6ydetystC$ komponentista kerC$tC$C$n
seuraavat tiedot AST-puuhun:
   - `name`: Elementin nimi (esim. "Osoite- ja hakupalkki").
   - `role`: Elementin rooli tekstinC$ (esim. "push button", "text").
   - `states`: Aktiiviset tilat (esim. "focused", "visible", "showing").
   - `bounding_box`: Komponentin absoluuttiset X11-koordinaatit nC$ytC6llC$
(`x`, `y`, `width`, `height`), haettuna esim. `getExtents(pyatspi.DESKTOP_COORD
S)` avulla.
3. **Virheiden hallinta:** AT-SPI-puun traversointi voi joskus jC$C$dC$ jumiin
tai kaatua rikkinC$isiin sovelluksiin. Skriptin on oltava erittC$in robusti
(`try-except` lohkot) ja estettC$vC$ C$C$rettC6mC$t luupit.
4. **FiltterC6inti:** JC$tC$ AST-puusta pois tC$ysin nC$kymC$ttC6mC$t tai
irrelevantit solmut, jos ne tekevC$t JSON-tiedostosta liian raskaan, mutta
sC$ilytC$ kaikki ikkunat, paneelit, tekstit ja painikkeet koordinaatteineen.
5. **Output:** Skripti tallentaa tuloksen tiedostoon `desktop_ast.json`.

Tavoitteena on saada aikaan JSON, josta voimme myC6hemmin katsoa suoraan:
*"MinkC$ elementin bounding boxin sisC$C$n koordinaatti X:410, Y:86 osuu, ja
mikC$ on sen AT-SPI-nimi?"*

Ehdottaisitko tC$ydellistC$, hyvin kommentoitua ja vikasietoista
Python-skriptiC$ tC$hC$n tarkoitukseen?

```