+ hj*Rt^RIHt^RIHtHt!RR4t!RR]4t]!RR]44t]!R R ]44t ]!R R ]44t ]!R R]44t ]!RR]44t ]!RR]44t ]!RR]44t]!RR]44t!RR]4t]!RR]44t]!RR]44t]!RR]44t]!RR ]44t]!R!R"]44t]!R#R$]44t]!R%R&]44t]!R'R(]44t]!R)R*]44t]!R+R,]44t]!R-R.]44t]!R/R0]44t]!R1R2]44t]!R3R4]44t]t ]!R5R6]44t!]!R7R8]44t"]!R9R:]44t#]!R;R<]44t$]!R=R>]44t%]!R?R@]44t&]!RARB]44t']!RCRD]44t(RE#)FaUAST node definitions for MicroBasic. Shape follows the confirmed grammar in docs/reverse_engineering.md plus the manual's documented syntax for constructs whose bytecode we didn't need to special-case at the AST level (e.g. compound assignment desugars to a plain AssignStmt at parse time -- see parser.py -- so there's no AugAssign node). ) annotations) dataclassfieldc]tRt^tRtRtR#)NodezBase class for all AST nodes.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__ro\\thalassa.shore.mbari.org\ProjectLibrary\ESP\FIDO\PumpController\compiler\src\microbasic_compiler\ast_nodes.pyrrs'rrc]tRt^tRtR#)ExprrNr r r r rrrrrrrrc"]tRt^t$R]R&RtR#) IntLiteralintvaluerNr r r r __annotations__rrrrrr Jrrc"]tRt^t$R]R&RtR#) BoolLiteralboolrrNrrrrrrs Krrc"]tRt^"t$R]R&RtR#) StringLiteralstrrrNrrrrr r "rrr c0]tRt^'t$R]R&RtR]R&RtR#)VarRefr!nameN Expr | Noneindexr)r r r r rr&rrrrr#r#'s IE;rr#c,]tRt^-t$R]R&R]R&RtR#)UnaryOpr!oproperandrNrrrrr(r(-s  G Mrr(c6]tRt^3t$R]R&R]R&R]R&RtR#)BinaryOpr!r)rleftrightrNrrrrr,r,3s G J Krr,cB]tRt^:t$RtR]R&]!]R7tR]R&Rt R#) CallzA function call used as an expression, e.g. GetValue(_TEMP, 1). Also doubles as a statement (SetCommand(...), SetConfig(...), Wait(...)) when wrapped in ExprStmt -- see below. r!r$default_factory list[Expr]argsrN) r r r r r rrlistr4rrrrr0r0:s IT2D*2rr0c:]tRt^Et$RtR]R&R]R&R]R&RtR#) IncDecExprz8++x / --x / x++ / x-- used where the result is consumed.r!varr)rprefixrNr r r r r rrrrrr7r7EsB H G Lrr7c]tRt^OtRtR#)StmtrNrrrrr<r<Orrr<c4]tRt^St$]!]R7tR]R&RtR#)Programr1 list[Stmt] statementsrN) r r r r rr5r@rrrrrr>r>Ss"48J 8rr>c"]tRt^Xt$R]R&RtR#)Labelr!r$rNrrrrrBrBXs IrrBc:]tRt^]t$R]R&R]R&RtR]R&RtR#)DimStmtr!r$var_typeNz int | None array_lenr)r r r r rrFrrrrrDrD]s IM Iz rrDc]tRt^dtRtRtR#)OptionExplicitStmtzt`Option Explicit` directive. Accepted and currently a no-op -- codegen doesn't yet enforce declare-before-use. TODO.rNrrrrrHrHds=rrHc0]tRt^jt$RtR]R&R]R&RtR#) AssignStmta Always a plain '=' by the time this reaches codegen -- compound assignment operators (+=, -=, *=, /=, <<=, >>=) are desugared into this (target = target op value) during parsing, since that's confirmed to be exactly how the real compiler treats them (see reverse_engineering.md, batch 3).r#targetrrrNr:rrrrJrJjs N KrrJcV]tRt^ut$R]R&R]R&]!]R7tR]R&RtR ]R &R t R#) IfStmtr conditionr? then_blockr1zlist[tuple[Expr, list[Stmt]]]elseif_clausesNzlist[Stmt] | None else_blockr) r r r r rrr5rPrQrrrrrMrMus(O49$4ON1O$(J!(rrMc"]tRt^}t$R]R&RtR#)GotoStmtr!labelrNrrrrrSrS}rrrSc"]tRt^t$R]R&RtR#) GosubStmtr!rTrNrrrrrVrVrrrVc]tRt^tRtR#) ReturnStmtrNrrrrrXrXrrXc]tRt^tRtR#) TerminateStmtrNrrrrr[r[rYrr[c"]tRt^t$R]R&RtR#)WaitStmtr millisecondsrNrrrrr]r]srr]c4]tRt^t$]!]R7tR]R&RtR#) PrintStmtr1r3r4rN) r r r r rr5r4rrrrrr`r`sT2D*2rr`c&]tRt^t$RtR]R&RtR#)ExprStmtzHA bare call used for side effects, e.g. SetCommand(...), SetConfig(...).r0callrNr:rrrrbrbs R Jrrbc0]tRt^t$RtR]R&R]R&RtR#) IncDecStmtzBare x++ / x-- / ++x / --x as a full statement (result discarded). Compiles to the compact 3-instruction form (LOAD, INC/DEC, STORE) rather than IncDecExpr's 4-instruction consumed form.r!r8r)rNr:rrrreres= H Grrec"]tRt^t$R]R&RtR#)ExitStmtLoopKindkindrNrrrrrgrg Nrrgc"]tRt^t$R]R&RtR#) ContinueStmtrhrirNrrrrrlrlrjrrlcB]tRt^t$RtR]R&]!]R7tR]R&Rt R#) WhileStmtzCovers both `While...End While` and `Do While...Loop` -- confirmed byte-identical, so the parser normalizes both source forms to this node.rrNr1r?bodyrN r r r r r rrr5rorrrrrnrnsPOT2D*2rrncB]tRt^t$RtR]R&]!]R7tR]R&Rt R#) DoUntilStmtz`Do Until ... Loop` -- pre-test, exits when condition becomes true (mirror image of WhileStmt, which exits when condition is false).rrNr1r?rorNrprrrrrrrsNOT2D*2rrrc0]tRt^t$RtR]R&R]R&RtR#)DoLoopWhileStmtzh`Do ... Loop While ` -- post-test, body always runs >= 1 time, loops back while condition is true.r?rorrNrNr:rrrrtrts+ Orrtc0]tRt^t$RtR]R&R]R&RtR#)DoLoopUntilStmtz{`Do ... Loop Until ` -- post-test, body always runs >= 1 time, loops back while condition is false (exits once true).r?rorrNrNr:rrrrvrvs> Orrvc`]tRt^t$RtR]R&R]R&R]R&R]R&]!]R 7tR ]R &R t R #)ForTraditionalStmtzTraditional `For var = init To limit [Step step] ... Next`. Confirmed to allocate two hidden Integer slots (limit, step) and use a step-sign-generic exit test -- see codegen.py.r!r8rinitlimitr%stepr1r?rorNrprrrrxrxs-6 H J K T2D*2rrxc`]tRt^t$RtR]R&R]R&R]R&R]R&]!]R 7tR ]R &R t R #) ForCStyleStmtz`For var = init AndWhile cond [Evaluate stmt] ... Next`. Confirmed: if no Evaluate clause is given, the compiler auto-increments var by 1 each iteration (reverse_engineering.md, batch 3).r!r8rryrNz Stmt | Noneevaluater1r?rorNrprrrr}r}s-9 H JOT2D*2rr}N))r __future__r dataclassesrrrrrrr r#r(r,r0r7r<r>rBrDrHrJrMrSrVrXr[r]r`rbrer!rhrgrlrnrrrtrvrxr}rrrrse#(((  4    $  D  T   d   t   343 3   4  9d9 9 D  !d! !  == =    )T) ) t          D    t  33 3 t         t  4  33 3 3$3 3 d  d  33 3 3D3 3r