parser: split `AIntExpr` and `ADecIntExpr`
[nit.git] / src / parser / parser_nodes.nit
index 36c5ceb..c9db2fa 100644 (file)
@@ -1,8 +1,5 @@
 # This file is part of NIT ( http://www.nitlanguage.org ).
 #
-# Copyright 2008-2009 Jean Privat <jean@pryen.org>
-# Copyright 2009 Jean-Sebastien Gelinas <calestar@gmail.com>
-#
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
 
 # AST nodes of the Nit language
 # Was previously based on parser_abs.nit.
-package parser_nodes
+module parser_nodes
 
-import mmloader
+import location
 
-# Root of the AST hierarchy
+# Root of the AST class-hierarchy
 abstract class ANode
-       var _location: nullable Location
-       # Location is set during AST building. Once built, location cannon be null
-       # However, manual instanciated nodes may need mode care
+       var _location: nullable Location = null
+
+       # Location is set during AST building. Once built, location cannon be null.
+       # However, manual instantiated nodes may need more care.
        fun location: Location do return _location.as(not null)
+
+       # The location of the important part of the node (identifier or whatever)
+       fun hot_location: Location do return location
+
+       # Display a message for the colored location of the node
+       fun debug(message: String)
+       do
+               print "{hot_location} {self.class_name}: {message}\n{hot_location.colored_line("0;32")}"
+       end
+
+       # Parent of the node in the AST
+       var parent: nullable ANode = null
+
+       # Protect form invalid instantiation of nodes
+       private init do end
+
+       # Replace a child with an other node in the AST
+       private fun replace_child(old_child: ANode, new_child: nullable ANode) is abstract
+
+       # Detach a node from its parent
+       # Aborts if the node is not detashable. use `replace_with` instead
+       # REQUIRE: parent != null
+       # REQUIRE: is_detachable
+       # ENDURE: parent == null
+       fun detach
+       do
+               assert parent != null
+               parent.replace_child(self, null)
+               parent = null
+       end
+
+       # Replace itself with an other node in the AST
+       # REQUIRE: parent != null
+       # ENSURE: node.parent == old(parent)
+       # ENSURE: parent == null
+       fun replace_with(node: ANode)
+       do
+               assert parent != null
+               parent.replace_child(self, node)
+               parent = null
+       end
+
+       # Visit all nodes in order.
+       # Thus, call `v.enter_visit(e)` for each child `e`
+       fun visit_all(v: Visitor) is abstract
+end
+
+# A sequence of nodes
+# There is a specifc class (instead of a using Array) to track the parent/child relation when nodes are added or removed
+class ANodes[E: ANode]
+       super Sequence[E]
+       private var parent: ANode
+       private var items = new Array[E]
+       redef fun iterator do return items.iterator
+       redef fun length do return items.length
+       redef fun is_empty do return items.is_empty
+       redef fun push(e)
+       do
+               hook_add(e)
+               items.push(e)
+       end
+       redef fun pop
+       do
+               var res = items.pop
+               hook_remove(res)
+               return res
+       end
+       redef fun unshift(e)
+       do
+               hook_add(e)
+               items.unshift(e)
+       end
+       redef fun shift
+       do
+               var res = items.shift
+               hook_remove(res)
+               return res
+       end
+       redef fun has(e)
+       do
+               return items.has(e)
+       end
+       redef fun [](index)
+       do
+               return items[index]
+       end
+       redef fun []=(index, e)
+       do
+               hook_remove(self[index])
+               hook_add(e)
+               items[index]=e
+       end
+       redef fun remove_at(index)
+       do
+               hook_remove(items[index])
+               items.remove_at(index)
+       end
+       private fun hook_add(e: E)
+       do
+               #assert e.parent == null
+               e.parent = parent
+       end
+       private fun hook_remove(e: E)
+       do
+               assert e.parent == parent
+               e.parent = null
+       end
+
+       # Used in parent contructor to fill elements
+       private fun unsafe_add_all(nodes: Collection[Object])
+       do
+               var parent = self.parent
+               for n in nodes do
+                       assert n isa E
+                       add n
+                       n.parent = parent
+               end
+       end
+
+       private fun replace_child(old_child: ANode, new_child: nullable ANode): Bool
+       do
+               var parent = self.parent
+               for i in [0..length[ do
+                       if self[i] == old_child then
+                               if new_child != null then
+                                       assert new_child isa E
+                                       self[i] = new_child
+                                       new_child.parent = parent
+                               else
+                                       self.remove_at(i)
+                               end
+                               return true
+                       end
+               end
+               return false
+       end
+
+       private fun visit_all(v: Visitor)
+       do
+               for n in self do v.enter_visit(n)
+       end
 end
 
 # Ancestor of all tokens
+# A token is a node that has a `text` but no children.
 abstract class Token
-special ANode
+       super ANode
+
+       # The raw content on the token
+       fun text: String is abstract
+       fun text=(text: String) is abstract
+
+       # The previous token in the Lexer.
+       # May have disapeared in the AST
+       var prev_token: nullable Token
+
+       # The next token in the Lexer.
+       # May have disapeared in the AST
+       var next_token: nullable Token
+
+       redef fun to_s: String do
+               return "'{text}'"
+       end
+
+       redef fun visit_all(v: Visitor) do end
+       redef fun replace_child(old_child: ANode, new_child: nullable ANode) do end
 end
 
 # Ancestor of all productions
+# A production is a node without text but that usually has children.
 abstract class Prod
-special ANode
+       super ANode
+
        fun location=(l: Location) do _location = l
+
+       # All the annotations attached directly to the node
+       readable writable var _n_annotations: nullable AAnnotations = null
+
+       redef fun replace_with(n: ANode)
+       do
+               super
+               assert n isa Prod
+               if n._location == null then n._location = _location
+       end
 end
+
+# Abstract standard visitor on the AST
+abstract class Visitor
+       # What the visitor do when a node is visited
+       # Concrete visitors should implement this method.
+       # @toimplement
+       protected fun visit(e: ANode) is abstract
+
+       # Ask the visitor to visit a given node.
+       # Usually automatically called by visit_all* methods.
+       # This method should not be redefined
+       fun enter_visit(e: nullable ANode)
+       do
+               if e == null then return
+               var old = _current_node
+               _current_node = e
+               visit(e)
+               _current_node = old
+       end
+
+       # The current visited node
+       readable writable var _current_node: nullable ANode = null
+end
+
+# Token of end of line (basically `\n`)
 class TEol
-special Token
+       super Token
+       redef fun to_s
+       do
+               return "end of line"
+       end
 end
+
+# Token of a line of comments
+# Starts with the `#` and contains the final end-of-line (if any)
 class TComment
-special Token
+       super Token
+end
+
+# A token associated with a keyword
+abstract class TokenKeyword
+       super Token
+       redef fun to_s
+       do
+               return "keyword '{text}'"
+       end
 end
 class TKwpackage
-special Token
+       super TokenKeyword
+end
+class TKwmodule
+       super TokenKeyword
 end
 class TKwimport
-special Token
+       super TokenKeyword
 end
 class TKwclass
-special Token
+       super TokenKeyword
 end
 class TKwabstract
-special Token
+       super TokenKeyword
 end
 class TKwinterface
-special Token
-end
-class TKwuniversal
-special Token
+       super TokenKeyword
 end
-class TKwspecial
-special Token
+class TKwenum
+       super TokenKeyword
 end
 class TKwend
-special Token
+       super TokenKeyword
 end
 class TKwmeth
-special Token
+       super TokenKeyword
 end
 class TKwtype
-special Token
-end
-class TKwattr
-special Token
+       super TokenKeyword
 end
 class TKwinit
-special Token
+       super TokenKeyword
 end
 class TKwredef
-special Token
+       super TokenKeyword
 end
 class TKwis
-special Token
+       super TokenKeyword
 end
 class TKwdo
-special Token
+       super TokenKeyword
 end
 class TKwreadable
-special Token
+       super TokenKeyword
 end
 class TKwwritable
-special Token
+       super TokenKeyword
 end
 class TKwvar
-special Token
+       super TokenKeyword
 end
 class TKwintern
-special Token
+       super TokenKeyword
 end
 class TKwextern
-special Token
+       super TokenKeyword
+end
+class TKwpublic
+       super TokenKeyword
 end
 class TKwprotected
-special Token
+       super TokenKeyword
 end
 class TKwprivate
-special Token
+       super TokenKeyword
 end
 class TKwintrude
-special Token
+       super TokenKeyword
 end
 class TKwif
-special Token
+       super TokenKeyword
 end
 class TKwthen
-special Token
+       super TokenKeyword
 end
 class TKwelse
-special Token
+       super TokenKeyword
 end
 class TKwwhile
-special Token
+       super TokenKeyword
+end
+class TKwloop
+       super TokenKeyword
 end
 class TKwfor
-special Token
+       super TokenKeyword
 end
 class TKwin
-special Token
+       super TokenKeyword
 end
 class TKwand
-special Token
+       super TokenKeyword
 end
 class TKwor
-special Token
+       super TokenKeyword
+end
+class TKwimplies
+       super TokenKeyword
 end
 class TKwnot
-special Token
+       super TokenKeyword
 end
 class TKwreturn
-special Token
+       super TokenKeyword
 end
 class TKwcontinue
-special Token
+       super TokenKeyword
 end
 class TKwbreak
-special Token
+       super TokenKeyword
 end
 class TKwabort
-special Token
+       super TokenKeyword
 end
 class TKwassert
-special Token
+       super TokenKeyword
 end
 class TKwnew
-special Token
+       super TokenKeyword
 end
 class TKwisa
-special Token
+       super TokenKeyword
 end
 class TKwonce
-special Token
+       super TokenKeyword
 end
 class TKwsuper
-special Token
+       super TokenKeyword
 end
 class TKwself
-special Token
+       super TokenKeyword
 end
 class TKwtrue
-special Token
+       super TokenKeyword
 end
 class TKwfalse
-special Token
+       super TokenKeyword
 end
 class TKwnull
-special Token
+       super TokenKeyword
 end
 class TKwas
-special Token
-end
-class TKwwith
-special Token
+       super TokenKeyword
 end
 class TKwnullable
-special Token
+       super TokenKeyword
 end
 class TKwisset
-special Token
+       super TokenKeyword
 end
 class TKwlabel
-special Token
+       super TokenKeyword
+end
+class TKwdebug
+       super Token
 end
 class TOpar
-special Token
+       super Token
 end
 class TCpar
-special Token
+       super Token
 end
 class TObra
-special Token
+       super Token
 end
 class TCbra
-special Token
+       super Token
 end
 class TComma
-special Token
+       super Token
 end
 class TColumn
-special Token
+       super Token
 end
 class TQuad
-special Token
+       super Token
 end
 class TAssign
-special Token
+       super Token
+end
+
+# A token associated with an operator (and other lookalike symbols)
+abstract class TokenOperator
+       super Token
+       redef fun to_s
+       do
+               return "operator '{text}'"
+       end
 end
 class TPluseq
-special Token
+       super TokenOperator
 end
 class TMinuseq
-special Token
+       super TokenOperator
 end
 class TDotdotdot
-special Token
+       super TokenOperator
 end
 class TDotdot
-special Token
+       super TokenOperator
 end
 class TDot
-special Token
+       super TokenOperator
 end
 class TPlus
-special Token
+       super TokenOperator
 end
 class TMinus
-special Token
+       super TokenOperator
 end
 class TStar
-special Token
+       super TokenOperator
 end
 class TSlash
-special Token
+       super TokenOperator
 end
 class TPercent
-special Token
+       super TokenOperator
 end
 class TEq
-special Token
+       super TokenOperator
 end
 class TNe
-special Token
+       super TokenOperator
 end
 class TLt
-special Token
+       super TokenOperator
 end
 class TLe
-special Token
+       super TokenOperator
+end
+class TLl
+       super TokenOperator
 end
 class TGt
-special Token
+       super TokenOperator
 end
 class TGe
-special Token
+       super TokenOperator
+end
+class TGg
+       super TokenOperator
 end
 class TStarship
-special Token
+       super TokenOperator
 end
+class TBang
+       super TokenOperator
+end
+class TAt
+       super Token
+end
+
+# A class (or formal type) identifier. They start with an uppercase.
 class TClassid
-special Token
+       super Token
+       redef fun to_s
+       do
+               do return "type identifier '{text}'"
+       end
 end
+
+# A standard identifier (variable, method...). They start with a lowercase. 
 class TId
-special Token
+       super Token
+       redef fun to_s
+       do
+               do return "identifier '{text}'"
+       end
 end
+
+# An attribute identifier. They start with an underscore.
 class TAttrid
-special Token
+       super Token
+       redef fun to_s
+       do
+               do return "attribute '{text}'"
+       end
+end
+
+# A token of a literal value (string, integer, etc).
+abstract class TokenLiteral
+       super Token
+       redef fun to_s
+       do
+               do return "literal value '{text}'"
+       end
 end
 class TNumber
-special Token
+       super TokenLiteral
 end
 class TFloat
-special Token
+       super TokenLiteral
 end
 class TChar
-special Token
+       super TokenLiteral
 end
 class TString
-special Token
+       super TokenLiteral
 end
 class TStartString
-special Token
+       super TokenLiteral
 end
 class TMidString
-special Token
+       super TokenLiteral
 end
 class TEndString
-special Token
+       super TokenLiteral
+end
+
+# A malformed string
+class TBadString
+       super Token
+       redef fun to_s
+       do
+               do return "malformed string {text}"
+       end
+end
+
+# A malformed char
+class TBadChar
+       super Token
+       redef fun to_s
+       do
+               do return "malformed character {text}"
+       end
 end
+
+class TExternCodeSegment
+       super Token
+end
+
+# A end of file
 class EOF
-special Token
-private init noinit do end
+       super Token
+       redef fun to_s
+       do
+               return "end of file"
+       end
 end
+
+# A mark of an error
 class AError
-special EOF
-private init noinit do end
+       super EOF
+end
+class ALexerError
+       super AError
+end
+class AParserError
+       super AError
 end
 
+# The main node of a Nit source-file
 class AModule
-special Prod
-    readable writable var _n_packagedecl: nullable APackagedecl = null
-    readable writable var _n_imports: List[AImport] = new List[AImport]
-    readable writable var _n_classdefs: List[AClassdef] = new List[AClassdef]
-end
-class APackagedecl
-special Prod
-    readable writable var _n_doc: nullable ADoc = null
-    readable writable var _n_kwpackage: TKwpackage
-    readable writable var _n_id: TId
-end
-class AImport special Prod end
+       super Prod
+
+       readable writable var _n_moduledecl: nullable AModuledecl = null
+       readable var _n_imports: ANodes[AImport] = new ANodes[AImport](self)
+       readable var _n_extern_code_blocks: ANodes[AExternCodeBlock] = new ANodes[AExternCodeBlock](self)
+       readable var _n_classdefs: ANodes[AClassdef] = new ANodes[AClassdef](self)
+end
+
+# The declaration of the module with the documentation, name, and annotations
+class AModuledecl
+       super Prod
+       readable writable var _n_doc: nullable ADoc = null
+       readable writable var _n_kwmodule: TKwmodule
+       readable writable var _n_name: AModuleName
+end
+
+# A import clause of a module
+abstract class AImport
+       super Prod
+end
+
+# A standard import clause. eg `import x`
 class AStdImport
-special AImport
-    readable writable var _n_visibility: AVisibility
-    readable writable var _n_kwimport: TKwimport
-    readable writable var _n_id: TId
+       super AImport
+       readable writable var _n_visibility: AVisibility
+       readable writable var _n_kwimport: TKwimport
+       readable writable var _n_name: AModuleName
 end
+
+# The special import clause of the kernel module. eg `import end`
 class ANoImport
-special AImport
-    readable writable var _n_visibility: AVisibility
-    readable writable var _n_kwimport: TKwimport
-    readable writable var _n_kwend: TKwend
+       super AImport
+       readable writable var _n_visibility: AVisibility
+       readable writable var _n_kwimport: TKwimport
+       readable writable var _n_kwend: TKwend
+end
+
+# A visibility modifier
+#
+# The public visibility is an empty production (no keyword).
+#
+# Note: even if some visibilities are only valid on some placse (for instance, no `protected` class or no `intrude` method)
+# the parser has no such a restriction, therefore the semantic phases has to check that the visibilities make sense.
+abstract class AVisibility
+       super Prod
 end
-class AVisibility special Prod end
 class APublicVisibility
-special AVisibility
+       super AVisibility
 end
 class APrivateVisibility
-special AVisibility
-    readable writable var _n_kwprivate: TKwprivate
+       super AVisibility
+       readable writable var _n_kwprivate: TKwprivate
 end
 class AProtectedVisibility
-special AVisibility
-    readable writable var _n_kwprotected: TKwprotected
+       super AVisibility
+       readable writable var _n_kwprotected: TKwprotected
 end
 class AIntrudeVisibility
-special AVisibility
-    readable writable var _n_kwintrude: TKwintrude
+       super AVisibility
+       readable writable var _n_kwintrude: TKwintrude
 end
-class AClassdef special Prod end
+
+# A class definition
+# While most definition are `AStdClassdef`
+# There is tow special case of class definition
+abstract class AClassdef super Prod
+       readable var _n_propdefs: ANodes[APropdef] = new ANodes[APropdef](self)
+end
+
+# A standard class definition with a name, superclasses and properties
 class AStdClassdef
-special AClassdef
-    readable writable var _n_doc: nullable ADoc = null
-    readable writable var _n_kwredef: nullable TKwredef = null
-    readable writable var _n_visibility: AVisibility
-    readable writable var _n_classkind: AClasskind
-    readable writable var _n_id: nullable TClassid = null
-    readable writable var _n_formaldefs: List[AFormaldef] = new List[AFormaldef]
-    readable writable var _n_superclasses: List[ASuperclass] = new List[ASuperclass]
-    readable writable var _n_propdefs: List[APropdef] = new List[APropdef]
+       super AClassdef
+       readable writable var _n_doc: nullable ADoc = null
+       readable writable var _n_kwredef: nullable TKwredef = null
+       readable writable var _n_visibility: AVisibility
+       readable writable var _n_classkind: AClasskind
+       readable writable var _n_id: nullable TClassid = null
+       readable var _n_formaldefs: ANodes[AFormaldef] = new ANodes[AFormaldef](self)
+       readable writable var _n_extern_code_block: nullable AExternCodeBlock = null
+       readable var _n_superclasses: ANodes[ASuperclass] = new ANodes[ASuperclass](self)
+       readable writable var _n_kwend: TKwend
+       redef fun hot_location do return n_id.location
 end
+
+# The implicit class definition of the implicit main method
 class ATopClassdef
-special AClassdef
-    readable writable var _n_propdefs: List[APropdef] = new List[APropdef]
+       super AClassdef
 end
+
+# The implicit class definition of the top-level methods
 class AMainClassdef
-special AClassdef
-    readable writable var _n_propdefs: List[APropdef] = new List[APropdef]
+       super AClassdef
+end
+
+# The modifier for the kind of class (abstract, interface, etc.)
+abstract class AClasskind
+       super Prod
 end
-class AClasskind special Prod end
 class AConcreteClasskind
-special AClasskind
-    readable writable var _n_kwclass: TKwclass
+       super AClasskind
+       readable writable var _n_kwclass: TKwclass
 end
 class AAbstractClasskind
-special AClasskind
-    readable writable var _n_kwabstract: TKwabstract
-    readable writable var _n_kwclass: TKwclass
+       super AClasskind
+       readable writable var _n_kwabstract: TKwabstract
+       readable writable var _n_kwclass: TKwclass
 end
 class AInterfaceClasskind
-special AClasskind
-    readable writable var _n_kwinterface: TKwinterface
+       super AClasskind
+       readable writable var _n_kwinterface: TKwinterface
+end
+class AEnumClasskind
+       super AClasskind
+       readable writable var _n_kwenum: TKwenum
 end
-class AUniversalClasskind
-special AClasskind
-    readable writable var _n_kwuniversal: TKwuniversal
+class AExternClasskind
+       super AClasskind
+       readable writable var _n_kwextern: TKwextern
+       readable writable var _n_kwclass: nullable TKwclass = null
 end
+
+# The definition of a formal generic parameter type. eg `X: Y`
 class AFormaldef
-special Prod
-    readable writable var _n_id: TClassid
-    readable writable var _n_type: nullable AType = null
+       super Prod
+       readable writable var _n_id: TClassid
+       # The bound of the parameter type
+       readable writable var _n_type: nullable AType = null
 end
+
+# A super-class. eg `super X`
 class ASuperclass
-special Prod
-    readable writable var _n_kwspecial: TKwspecial
-    readable writable var _n_type: AType
+       super Prod
+       readable writable var _n_kwsuper: TKwsuper
+       readable writable var _n_type: AType
 end
-class APropdef special Prod
-    readable writable var _n_doc: nullable ADoc = null
+
+# The definition of a property
+abstract class APropdef
+       super Prod
+       readable writable var _n_doc: nullable ADoc = null
 end
+
+# A definition of an attribute
+# For historical reason, old-syle and new-style attributes use the same `ANode` sub-class
 class AAttrPropdef
-special APropdef
-    readable writable var _n_kwredef: nullable TKwredef = null
-    readable writable var _n_visibility: AVisibility
-    readable writable var _n_kwattr: nullable TKwattr = null
-    readable writable var _n_kwvar: nullable TKwvar = null
-    readable writable var _n_id: TAttrid
-    readable writable var _n_type: nullable AType = null
-    readable writable var _n_readable: nullable AAble = null
-    readable writable var _n_writable: nullable AAble = null
-    readable writable var _n_expr: nullable AExpr = null
-end
-class AMethPropdef
-special APropdef
-    readable writable var _n_kwredef: nullable TKwredef = null
-    readable writable var _n_visibility: nullable AVisibility
-    readable writable var _n_methid: nullable AMethid = null
-    readable writable var _n_signature: nullable ASignature
+       super APropdef
+       readable writable var _n_kwredef: nullable TKwredef = null
+       readable writable var _n_visibility: AVisibility
+       readable writable var _n_kwvar: TKwvar
+
+       # The identifier for an old-style attribute (null if new-style)
+       readable writable var _n_id: nullable TAttrid
+
+       # The identifier for a new-style attribute (null if old-style)
+       readable writable var _n_id2: nullable TId
+
+       readable writable var _n_type: nullable AType = null
+       readable writable var _n_readable: nullable AAble = null
+       readable writable var _n_writable: nullable AAble = null
+
+       # The initial value, if any
+       readable writable var _n_expr: nullable AExpr = null
+       redef fun hot_location
+       do
+               if n_id != null then return n_id.location else return n_id2.location
+       end
 end
+
+# A definition of all kind of method (including constructors)
+abstract class AMethPropdef
+       super APropdef
+       readable writable var _n_kwredef: nullable TKwredef = null
+       readable writable var _n_visibility: nullable AVisibility
+       readable writable var _n_methid: nullable AMethid = null
+       readable writable var _n_signature: nullable ASignature
+       redef fun hot_location
+       do
+               if n_methid != null then
+                       return n_methid.location
+               else
+                       return location
+               end
+       end
+end
+
+# A method marked abstract
+# *deferred* is a old synonynmous of *abstract* that comes from PRM, that comes from Eiffel.
 class ADeferredMethPropdef
-special AMethPropdef
-    readable writable var _n_kwmeth: TKwmeth
+       super AMethPropdef
+       readable writable var _n_kwmeth: TKwmeth
 end
+
+# A method marked intern
 class AInternMethPropdef
-special AMethPropdef
-    readable writable var _n_kwmeth: TKwmeth
+       super AMethPropdef
+       readable writable var _n_kwmeth: TKwmeth
+end
+
+# A method of a constructor marked extern
+abstract class AExternPropdef
+       super AMethPropdef
+       readable writable var _n_extern: nullable TString = null
+       readable writable var _n_extern_calls: nullable AExternCalls = null
+       readable writable var _n_extern_code_block: nullable AExternCodeBlock = null
 end
+
+# A method marked extern
 class AExternMethPropdef
-special AMethPropdef
-    readable writable var _n_kwmeth: TKwmeth
-    readable writable var _n_extern: nullable TString = null
+       super AExternPropdef
+       readable writable var _n_kwmeth: TKwmeth
 end
+
+# A method with a body
 class AConcreteMethPropdef
-special AMethPropdef
-    readable writable var _n_kwmeth: nullable TKwmeth
-    readable writable var _n_block: nullable AExpr = null
+       super AMethPropdef
+       readable writable var _n_kwmeth: nullable TKwmeth
+       readable writable var _n_block: nullable AExpr = null
+end
+
+# A constructor
+abstract class AInitPropdef
+       super AMethPropdef
 end
+
+# A constructor with a body
 class AConcreteInitPropdef
-special AConcreteMethPropdef
-    readable writable var _n_kwinit: TKwinit
+       super AConcreteMethPropdef
+       super AInitPropdef
+       readable writable var _n_kwinit: TKwinit
+       redef fun hot_location do return n_kwinit.location
 end
+
+# A constructor marked extern (defined with the `new` keyword)
+class AExternInitPropdef
+       super AExternPropdef
+       super AInitPropdef
+       readable writable var _n_kwnew: TKwnew
+end
+
+# The implicit main method
 class AMainMethPropdef
-special AConcreteMethPropdef
+       super AConcreteMethPropdef
 end
+
+# Declaration of callbacks for extern methods
+class AExternCalls
+       super Prod
+       readable writable var _n_kwimport: TKwimport
+       readable var _n_extern_calls: ANodes[AExternCall] = new ANodes[AExternCall](self)
+end
+abstract class AExternCall
+       super Prod
+end
+abstract class APropExternCall
+       super AExternCall
+end
+class ALocalPropExternCall
+       super APropExternCall
+       readable writable var _n_methid: AMethid
+end
+class AFullPropExternCall
+       super APropExternCall
+       readable writable var _n_type: AType
+       readable writable var _n_dot: nullable TDot = null
+       readable writable var _n_methid: AMethid
+end
+class AInitPropExternCall
+       super APropExternCall
+       readable writable var _n_type: AType
+end
+class ASuperExternCall
+       super AExternCall
+       readable writable var _n_kwsuper: TKwsuper
+end
+abstract class ACastExternCall
+       super AExternCall
+end
+class ACastAsExternCall
+       super ACastExternCall
+       readable writable var _n_from_type: AType
+       readable writable var _n_dot: nullable TDot = null
+       readable writable var _n_kwas: TKwas
+       readable writable var _n_to_type: AType
+end
+class AAsNullableExternCall
+       super ACastExternCall
+       readable writable var _n_type: AType
+       readable writable var _n_kwas: TKwas
+       readable writable var _n_kwnullable: TKwnullable
+end
+class AAsNotNullableExternCall
+       super ACastExternCall
+       readable writable var _n_type: AType
+       readable writable var _n_kwas: TKwas
+       readable writable var _n_kwnot: TKwnot
+       readable writable var _n_kwnullable: TKwnullable
+end
+
+# A definition of a virtual type
 class ATypePropdef
-special APropdef
-    readable writable var _n_kwredef: nullable TKwredef = null
-    readable writable var _n_visibility: AVisibility
-    readable writable var _n_kwtype: TKwtype
-    readable writable var _n_id: TClassid
-    readable writable var _n_type: AType
+       super APropdef
+       readable writable var _n_kwredef: nullable TKwredef = null
+       readable writable var _n_visibility: AVisibility
+       readable writable var _n_kwtype: TKwtype
+       readable writable var _n_id: TClassid
+       readable writable var _n_type: AType
 end
-class AAble special Prod
-    readable writable var _n_kwredef: nullable TKwredef = null
+
+# A `writable` or `readable` modifier
+abstract class AAble
+       super Prod
+       readable writable var _n_visibility: nullable AVisibility = null
+       readable writable var _n_kwredef: nullable TKwredef = null
 end
+
+# A `readable` modifier
 class AReadAble
-special AAble
-    readable writable var _n_kwreadable: TKwreadable
+       super AAble
+       readable writable var _n_kwreadable: TKwreadable
 end
+
+# A `writable` modifier
 class AWriteAble
-special AAble
-    readable writable var _n_kwwritable: TKwwritable
+       super AAble
+       readable writable var _n_kwwritable: TKwwritable
+end
+
+# The identifier of a method in a method declaration.
+# There is a specific class because of operator and setters.
+abstract class AMethid
+       super Prod
 end
-class AMethid special Prod end
 class AIdMethid
-special AMethid
-    readable writable var _n_id: TId
+       super AMethid
+       readable writable var _n_id: TId
 end
 class APlusMethid
-special AMethid
-    readable writable var _n_plus: TPlus
+       super AMethid
+       readable writable var _n_plus: TPlus
 end
 class AMinusMethid
-special AMethid
-    readable writable var _n_minus: TMinus
+       super AMethid
+       readable writable var _n_minus: TMinus
 end
 class AStarMethid
-special AMethid
-    readable writable var _n_star: TStar
+       super AMethid
+       readable writable var _n_star: TStar
 end
 class ASlashMethid
-special AMethid
-    readable writable var _n_slash: TSlash
+       super AMethid
+       readable writable var _n_slash: TSlash
 end
 class APercentMethid
-special AMethid
-    readable writable var _n_percent: TPercent
+       super AMethid
+       readable writable var _n_percent: TPercent
 end
 class AEqMethid
-special AMethid
-    readable writable var _n_eq: TEq
+       super AMethid
+       readable writable var _n_eq: TEq
 end
 class ANeMethid
-special AMethid
-    readable writable var _n_ne: TNe
+       super AMethid
+       readable writable var _n_ne: TNe
 end
 class ALeMethid
-special AMethid
-    readable writable var _n_le: TLe
+       super AMethid
+       readable writable var _n_le: TLe
 end
 class AGeMethid
-special AMethid
-    readable writable var _n_ge: TGe
+       super AMethid
+       readable writable var _n_ge: TGe
 end
 class ALtMethid
-special AMethid
-    readable writable var _n_lt: TLt
+       super AMethid
+       readable writable var _n_lt: TLt
 end
 class AGtMethid
-special AMethid
-    readable writable var _n_gt: TGt
+       super AMethid
+       readable writable var _n_gt: TGt
+end
+class ALlMethid
+       super AMethid
+       readable writable var _n_ll: TLl
+end
+class AGgMethid
+       super AMethid
+       readable writable var _n_gg: TGg
 end
 class ABraMethid
-special AMethid
-    readable writable var _n_obra: TObra
-    readable writable var _n_cbra: TCbra
+       super AMethid
+       readable writable var _n_obra: TObra
+       readable writable var _n_cbra: TCbra
 end
 class AStarshipMethid
-special AMethid
-    readable writable var _n_starship: TStarship
+       super AMethid
+       readable writable var _n_starship: TStarship
 end
 class AAssignMethid
-special AMethid
-    readable writable var _n_id: TId
-    readable writable var _n_assign: TAssign
+       super AMethid
+       readable writable var _n_id: TId
+       readable writable var _n_assign: TAssign
 end
 class ABraassignMethid
-special AMethid
-    readable writable var _n_obra: TObra
-    readable writable var _n_cbra: TCbra
-    readable writable var _n_assign: TAssign
+       super AMethid
+       readable writable var _n_obra: TObra
+       readable writable var _n_cbra: TCbra
+       readable writable var _n_assign: TAssign
 end
+
+# A signature in a method definition. eg `(x,y:X,z:Z):T`
 class ASignature
-special Prod
-    readable writable var _n_params: List[AParam] = new List[AParam]
-    readable writable var _n_type: nullable AType = null
-    readable writable var _n_closure_decls: List[AClosureDecl] = new List[AClosureDecl]
+       super Prod
+       readable writable var _n_opar: nullable TOpar = null
+       readable var _n_params: ANodes[AParam] = new ANodes[AParam](self)
+       readable writable var _n_cpar: nullable TCpar = null
+       readable writable var _n_type: nullable AType = null
 end
+
+# A parameter definition in a signature. eg `x:X`
 class AParam
-special Prod
-    readable writable var _n_id: TId
-    readable writable var _n_type: nullable AType = null
-    readable writable var _n_dotdotdot: nullable TDotdotdot = null
-end
-class AClosureDecl
-special Prod
-    readable writable var _n_kwwith: TKwwith
-    readable writable var _n_kwbreak: nullable TKwbreak = null
-    readable writable var _n_id: TId
-    readable writable var _n_signature: ASignature
-    readable writable var _n_expr: nullable AExpr = null
+       super Prod
+       readable writable var _n_id: TId
+       readable writable var _n_type: nullable AType = null
+       readable writable var _n_dotdotdot: nullable TDotdotdot = null
 end
+
+# A static type. eg `nullable X[Y]`
 class AType
-special Prod
-    readable writable var _n_kwnullable: nullable TKwnullable = null
-    readable writable var _n_id: TClassid
-    readable writable var _n_types: List[AType] = new List[AType]
+       super Prod
+       readable writable var _n_kwnullable: nullable TKwnullable = null
+
+       # The name of the class or of the formal type
+       readable writable var _n_id: TClassid
+
+       # Type arguments for a generic type
+       readable var _n_types: ANodes[AType] = new ANodes[AType](self)
 end
+
+# A label at the end of a block or in a break/continue statement. eg `label x`
 class ALabel
-special Prod
-    readable writable var _n_kwlabel: TKwlabel
-    readable writable var _n_id: TId
+       super Prod
+       readable writable var _n_kwlabel: TKwlabel
+       readable writable var _n_id: TId
 end
-class AExpr special Prod end
+
+# Expression and statements
+# From a AST point of view there is no distinction between statement and expressions (even if the parser has to distinguish them)
+abstract class AExpr
+       super Prod
+end
+
+# A sequence of AExpr (usually statements)
+# The last AExpr gives the value of the whole block
 class ABlockExpr
-special AExpr
-    readable writable var _n_expr: List[AExpr] = new List[AExpr]
+       super AExpr
+       readable var _n_expr: ANodes[AExpr] = new ANodes[AExpr](self)
+       readable writable var _n_kwend: nullable TKwend = null
 end
+
+# A declaration of a local variable. eg `var x: X = y`
 class AVardeclExpr
-special AExpr
-    readable writable var _n_kwvar: TKwvar
-    readable writable var _n_id: TId
-    readable writable var _n_type: nullable AType = null
-    readable writable var _n_assign: nullable TAssign = null
-    readable writable var _n_expr: nullable AExpr = null
+       super AExpr
+       readable writable var _n_kwvar: TKwvar
+       readable writable var _n_id: TId
+       readable writable var _n_type: nullable AType = null
+       readable writable var _n_assign: nullable TAssign = null
+
+       # The initial value, if any
+       readable writable var _n_expr: nullable AExpr = null
 end
+
+# A `return` statement. eg `return x`
 class AReturnExpr
-special AExpr
-    readable writable var _n_kwreturn: TKwreturn
-    readable writable var _n_expr: nullable AExpr = null
+       super AExpr
+       readable writable var _n_kwreturn: nullable TKwreturn = null
+       readable writable var _n_expr: nullable AExpr = null
 end
-class ALabelable
-special Prod
-    readable writable var _n_label: nullable ALabel = null
+
+# Something that has a label.
+abstract class ALabelable
+       super Prod
+       readable writable var _n_label: nullable ALabel = null
 end
+
+# A `break` statement.
 class ABreakExpr
-special AExpr
-special ALabelable
-    readable writable var _n_kwbreak: TKwbreak
-    readable writable var _n_expr: nullable AExpr = null
+       super AExpr
+       super ALabelable
+       readable writable var _n_kwbreak: TKwbreak
+       readable writable var _n_expr: nullable AExpr = null
 end
+
+# An `abort` statement
 class AAbortExpr
-special AExpr
-    readable writable var _n_kwabort: TKwabort
+       super AExpr
+       readable writable var _n_kwabort: TKwabort
 end
+
+# A `continue` statement
 class AContinueExpr
-special AExpr
-special ALabelable
-    readable writable var _n_kwcontinue: TKwcontinue
-    readable writable var _n_expr: nullable AExpr = null
+       super AExpr
+       super ALabelable
+       readable writable var _n_kwcontinue: nullable TKwcontinue = null
+       readable writable var _n_expr: nullable AExpr = null
 end
+
+# A `do` statement
 class ADoExpr
-special AExpr
-special ALabelable
-    readable writable var _n_kwdo: TKwdo
-    readable writable var _n_block: nullable AExpr = null
+       super AExpr
+       super ALabelable
+       readable writable var _n_kwdo: TKwdo
+       readable writable var _n_block: nullable AExpr = null
 end
+
+# A `if` statement
 class AIfExpr
-special AExpr
-    readable writable var _n_kwif: TKwif
-    readable writable var _n_expr: AExpr
-    readable writable var _n_then: nullable AExpr = null
-    readable writable var _n_else: nullable AExpr = null
+       super AExpr
+       readable writable var _n_kwif: TKwif
+       readable writable var _n_expr: AExpr
+       readable writable var _n_then: nullable AExpr = null
+       readable writable var _n_else: nullable AExpr = null
 end
+
+# A `if` expression
 class AIfexprExpr
-special AExpr
-    readable writable var _n_kwif: TKwif
-    readable writable var _n_expr: AExpr
-    readable writable var _n_kwthen: TKwthen
-    readable writable var _n_then: AExpr
-    readable writable var _n_kwelse: TKwelse
-    readable writable var _n_else: AExpr
+       super AExpr
+       readable writable var _n_kwif: TKwif
+       readable writable var _n_expr: AExpr
+       readable writable var _n_kwthen: TKwthen
+       readable writable var _n_then: AExpr
+       readable writable var _n_kwelse: TKwelse
+       readable writable var _n_else: AExpr
 end
+
+# A `while` statement
 class AWhileExpr
-special AExpr
-special ALabelable
-    readable writable var _n_kwwhile:  TKwwhile
-    readable writable var _n_expr: AExpr
-    readable writable var _n_kwdo: TKwdo
-    readable writable var _n_block: nullable AExpr = null
+       super AExpr
+       super ALabelable
+       readable writable var _n_kwwhile:  TKwwhile
+       readable writable var _n_expr: AExpr
+       readable writable var _n_kwdo: TKwdo
+       readable writable var _n_block: nullable AExpr = null
 end
+
+# A `loop` statement
+class ALoopExpr
+       super AExpr
+       super ALabelable
+       readable writable var _n_kwloop: TKwloop
+       readable writable var _n_block: nullable AExpr = null
+end
+
+# A `for` statement
 class AForExpr
-special AExpr
-special ALabelable
-    readable writable var _n_kwfor: TKwfor
-    readable writable var _n_id: TId
-    readable writable var _n_expr: AExpr
-    readable writable var _n_kwdo: TKwdo
-    readable writable var _n_block: nullable AExpr = null
+       super AExpr
+       super ALabelable
+       readable writable var _n_kwfor: TKwfor
+       readable var _n_ids: ANodes[TId] = new ANodes[TId](self)
+       readable writable var _n_expr: AExpr
+       readable writable var _n_kwdo: TKwdo
+       readable writable var _n_block: nullable AExpr = null
 end
+
+# An `assert` statement
 class AAssertExpr
-special AExpr
-    readable writable var _n_kwassert: TKwassert
-    readable writable var _n_id: nullable TId = null
-    readable writable var _n_expr: AExpr
+       super AExpr
+       readable writable var _n_kwassert: TKwassert
+       readable writable var _n_id: nullable TId = null
+       readable writable var _n_expr: AExpr
+       readable writable var _n_else: nullable AExpr = null
 end
-class AAssignFormExpr
-special AExpr
-    readable writable var _n_assign: TAssign
-    readable writable var _n_value: AExpr
+
+# Whatever is a simple assignment. eg `= something`
+abstract class AAssignFormExpr
+       super AExpr
+       readable writable var _n_assign: TAssign
+       readable writable var _n_value: AExpr
 end
-class AReassignFormExpr
-special AExpr
-    readable writable var _n_assign_op: AAssignOp
-    readable writable var _n_value: AExpr
+
+# Whatever is a combined assignment. eg `+= something`
+abstract class AReassignFormExpr
+       super AExpr
+       readable writable var _n_assign_op: AAssignOp
+       readable writable var _n_value: AExpr
 end
+
+# A `once` expression. eg `once x`
 class AOnceExpr
-special AProxyExpr
-    readable writable var _n_kwonce: TKwonce
+       super AProxyExpr
+       readable writable var _n_kwonce: TKwonce
 end
-class ASendExpr
-special AExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_closure_defs: List[AClosureDef] = new List[AClosureDef]
+
+# A polymorphic invocation of a method
+# The form of the invocation (name, arguments, etc) are specific
+abstract class ASendExpr
+       super AExpr
+       # The receiver of the method invocation
+       readable writable var _n_expr: AExpr
 end
-class ABinopExpr
-special ASendExpr
-    readable writable var _n_expr2: AExpr
+
+# A binary operation on a method
+abstract class ABinopExpr
+       super ASendExpr
+       # The second operand of the operation
+       # Note: the receiver (`n_expr`) is the first operand
+       readable writable var _n_expr2: AExpr
 end
-class ABoolExpr
-special AExpr
+
+# Something that is boolean expression
+abstract class ABoolExpr
+       super AExpr
 end
+
+# A `or` expression 
 class AOrExpr
-special ABoolExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_expr2: AExpr
+       super ABoolExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_expr2: AExpr
 end
+
+# A `and` expression
 class AAndExpr
-special ABoolExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_expr2: AExpr
+       super ABoolExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_expr2: AExpr
 end
+
+# A `or else` expression
+class AOrElseExpr
+       super ABoolExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_expr2: AExpr
+end
+
+# A `implies` expression
+class AImpliesExpr
+       super ABoolExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_expr2: AExpr
+end
+
+# A `not` expression
 class ANotExpr
-special ABoolExpr
-    readable writable var _n_kwnot: TKwnot
-    readable writable var _n_expr: AExpr
+       super ABoolExpr
+       readable writable var _n_kwnot: TKwnot
+       readable writable var _n_expr: AExpr
 end
+
+# A `==` expression
 class AEqExpr
-special ABinopExpr
-end
-class AEeExpr
-special ABoolExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_expr2: AExpr
+       super ABinopExpr
 end
+
+# A `!=` expression
 class ANeExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `<` expression
 class ALtExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `<=` expression
 class ALeExpr
-special ABinopExpr
+       super ABinopExpr
+end
+
+# A `<<` expression
+class ALlExpr
+       super ABinopExpr
 end
+
+# A `>` expression
 class AGtExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `>=` expression
 class AGeExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `>>` expression
+class AGgExpr
+       super ABinopExpr
+end
+
+# A type-ckeck expression. eg `x isa T`
 class AIsaExpr
-special ABoolExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_type: AType
+       super ABoolExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_type: AType
 end
+
+# A `+` expression
 class APlusExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `-` expression
 class AMinusExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `<=>` expression
 class AStarshipExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `*` expression
 class AStarExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `/` expression
 class ASlashExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A `%` expression
 class APercentExpr
-special ABinopExpr
+       super ABinopExpr
 end
+
+# A unary minus expression. eg `-x`
 class AUminusExpr
-special ASendExpr
-    readable writable var _n_minus: TMinus
+       super ASendExpr
+       readable writable var _n_minus: TMinus
 end
+
+# An explicit instantiation. eg `new T`
 class ANewExpr
-special AExpr
-    readable writable var _n_kwnew: TKwnew
-    readable writable var _n_type: AType
-    readable writable var _n_id: nullable TId = null
-    readable writable var _n_args: List[AExpr] = new List[AExpr]
+       super AExpr
+       readable writable var _n_kwnew: TKwnew
+       readable writable var _n_type: AType
+
+       # The name of the named-constructor, if any
+       readable writable var _n_id: nullable TId = null
+       readable writable var _n_args: AExprs
 end
-class AAttrFormExpr
-special AExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_id: TAttrid
+
+# Whatever is a old-style attribute access
+abstract class AAttrFormExpr
+       super AExpr
+
+       # The receiver of the attribute
+       readable writable var _n_expr: AExpr
+
+       # The name of the attribute
+       readable writable var _n_id: TAttrid
 end
+
+# The read of an attribute. eg `x._a`
 class AAttrExpr
-special AAttrFormExpr
+       super AAttrFormExpr
 end
+
+# The assignment of an attribute. eg `x._a=y`
 class AAttrAssignExpr
-special AAttrFormExpr
-special AAssignFormExpr
+       super AAttrFormExpr
+       super AAssignFormExpr
 end
-class ACallFormExpr
-special ASendExpr
-    readable writable var _n_id: TId
-    readable writable var _n_args: List[AExpr] = new List[AExpr]
+
+# Whatever looks-like a call with a standard method and any number of arguments.
+abstract class ACallFormExpr
+       super ASendExpr
+
+       # The name of the method
+       readable writable var _n_id: TId
+
+       # The arguments of the call
+       readable writable var _n_args: AExprs
 end
+
+# A complex setter call (standard or brackets)
+abstract class ASendReassignFormExpr
+       super ASendExpr
+       super AReassignFormExpr
+end
+
+# A complex attribute assignment. eg `x._a+=y`
 class AAttrReassignExpr
-special AExpr
-special AAttrFormExpr
-special AReassignFormExpr
+       super AAttrFormExpr
+       super AReassignFormExpr
 end
+
+# A call with a standard method-name and any number of arguments. eg `x.m(y)`. OR just a simple id
+# Note: because the parser cannot distinguish a variable read with a method call with an implicit receiver and no arguments, it always returns a `ACallExpr`.
+# Semantic analysis have to transform them to instance of `AVarExpr`.
 class ACallExpr
-special ACallFormExpr
+       super ACallFormExpr
 end
+
+# A setter call with a standard method-name and any number of arguments. eg `x.m(y)=z`. OR just a simple assignment.
+# Note: because the parser cannot distinguish a variable write with a setter call with an implicit receiver and no arguments, it always returns a `ACallAssignExpr`.
+# Semantic analysis have to transform them to instance of `AVarAssignExpr`.
 class ACallAssignExpr
-special ACallFormExpr
-special AAssignFormExpr
+       super ACallFormExpr
+       super AAssignFormExpr
 end
+
+# A complex setter call with a standard method-name and any number of arguments. eg `x.m(y)+=z`. OR just a simple complex assignment.
+# Note: because the parser cannot distinguish a variable write with a compex setter call with an implicit receiver and no arguments, it always returns a `ACallReassignExpr`.
+# Semantic analysis have to transform them to instance of `AVarReassignExpr`.
 class ACallReassignExpr
-special AExpr
-special ACallFormExpr
-special AReassignFormExpr
+       super ACallFormExpr
+       super ASendReassignFormExpr
 end
+
+# A call to `super`. OR a call of a super-constructor
 class ASuperExpr
-special AExpr
-    readable writable var _n_qualified: nullable AQualified = null
-    readable writable var _n_kwsuper: TKwsuper
-    readable writable var _n_args: List[AExpr] = new List[AExpr]
+       super AExpr
+       readable writable var _n_qualified: nullable AQualified = null
+       readable writable var _n_kwsuper: TKwsuper
+       readable writable var _n_args: AExprs
 end
+
+# A call to the `init` constructor.
+# Note: because `init` is a keyword and not a `TId`, the explicit call to init cannot be a ACallFormExpr.
 class AInitExpr
-special ASendExpr
-    readable writable var _n_kwinit: TKwinit
-    readable writable var _n_args: List[AExpr] = new List[AExpr]
+       super ASendExpr
+       readable writable var _n_kwinit: TKwinit
+       readable writable var _n_args: AExprs
 end
-class ABraFormExpr
-special ASendExpr
-    readable writable var _n_args: List[AExpr] = new List[AExpr]
+
+# Whatever looks-like a call of the brackets `[]` operator.
+abstract class ABraFormExpr
+       super ASendExpr
+       readable writable var _n_args: AExprs
 end
+
+# A call of the brackets operator. eg `x[y,z]`
 class ABraExpr
-special ABraFormExpr
+       super ABraFormExpr
 end
+
+# A setter call of the bracket operator. eg `x[y,z]=t`
 class ABraAssignExpr
-special ABraFormExpr
-special AAssignFormExpr
+       super ABraFormExpr
+       super AAssignFormExpr
 end
-class AVarFormExpr
-special AExpr
-    readable writable var _n_id: TId
+
+# Whatever is an access to a local variable
+abstract class AVarFormExpr
+       super AExpr
+       readable writable var _n_id: TId
 end
+
+# A complex setter call of the bracket operator. eg `x[y,z]+=t`
 class ABraReassignExpr
-special ABraFormExpr
-special AReassignFormExpr
-end
-class AClosureCallExpr
-special AExpr
-    readable writable var _n_id: TId
-    readable writable var _n_args: List[AExpr] = new List[AExpr]
-    readable writable var _n_closure_defs: List[AClosureDef] = new List[AClosureDef]
+       super ABraFormExpr
+       super ASendReassignFormExpr
 end
+
+# A local variable read access.
+# The parser cannot instantiate them, see `ACallExpr`.
 class AVarExpr
-special AVarFormExpr
+       super AVarFormExpr
 end
+
+# A local variable simple assigment access
+# The parser cannot instantiate them, see `ACallAssignExpr`.
 class AVarAssignExpr
-special AVarFormExpr
-special AAssignFormExpr
+       super AVarFormExpr
+       super AAssignFormExpr
 end
+
+# A local variable complex assignment access
+# The parser cannot instantiate them, see `ACallReassignExpr`.
 class AVarReassignExpr
-special AVarFormExpr
-special AReassignFormExpr
+       super AVarFormExpr
+       super AReassignFormExpr
 end
-class ARangeExpr
-special AExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_expr2: AExpr
+
+# A literal range, open or closed
+abstract class ARangeExpr
+       super AExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_expr2: AExpr
 end
+
+# A closed literal range. eg `[x..y]`
 class ACrangeExpr
-special ARangeExpr
+       super ARangeExpr
+       readable writable var _n_obra: TObra
+       readable writable var _n_cbra: TCbra
 end
+
+# An open literal range. eg `[x..y[`
 class AOrangeExpr
-special ARangeExpr
+       super ARangeExpr
+       readable writable var _n_obra: TObra
+       readable writable var _n_cbra: TObra
 end
+
+# A literal array. eg. `[x,y,z]`
 class AArrayExpr
-special AExpr
-    readable writable var _n_exprs: List[AExpr] = new List[AExpr]
+       super AExpr
+       readable writable var _n_exprs: AExprs
 end
+
+# A read of `self` 
 class ASelfExpr
-special AExpr
-    readable writable var _n_kwself: nullable TKwself
+       super AExpr
+       readable writable var _n_kwself: nullable TKwself
 end
+
+# When there is no explicit receiver, `self` is implicit
 class AImplicitSelfExpr
-special ASelfExpr
+       super ASelfExpr
 end
+
+# A `true` boolean literal constant
 class ATrueExpr
-special ABoolExpr
-    readable writable var _n_kwtrue: TKwtrue
+       super ABoolExpr
+       readable writable var _n_kwtrue: TKwtrue
 end
+# A `false` boolean literal constant
 class AFalseExpr
-special ABoolExpr
-    readable writable var _n_kwfalse: TKwfalse
+       super ABoolExpr
+       readable writable var _n_kwfalse: TKwfalse
 end
+# A `null` literal constant
 class ANullExpr
-special AExpr
-    readable writable var _n_kwnull: TKwnull
+       super AExpr
+       readable writable var _n_kwnull: TKwnull
 end
+# An integer literal
 class AIntExpr
-special AExpr
-    readable writable var _n_number: TNumber
+       super AExpr
 end
+# An integer literal in decimal format
+class ADecIntExpr
+       super AIntExpr
+       readable writable var _n_number: TNumber
+end
+# A float literal
 class AFloatExpr
-special AExpr
-    readable writable var _n_float: TFloat
+       super AExpr
+       readable writable var _n_float: TFloat
 end
+# A character literal
 class ACharExpr
-special AExpr
-    readable writable var _n_char: TChar
+       super AExpr
+       readable writable var _n_char: TChar
 end
-class AStringFormExpr
-special AExpr
+# A string literal
+abstract class AStringFormExpr
+       super AExpr
+       readable writable var _n_string: Token
 end
+
+# A simple string. eg. `"abc"`
 class AStringExpr
-special AStringFormExpr
-    readable writable var _n_string: TString
+       super AStringFormExpr
 end
+
+# The start of a superstring. eg `"abc{`
 class AStartStringExpr
-special AStringFormExpr
-    readable writable var _n_string: TStartString
+       super AStringFormExpr
 end
+
+# The middle of a superstring. eg `}abc{`
 class AMidStringExpr
-special AStringFormExpr
-    readable writable var _n_string: TMidString
+       super AStringFormExpr
 end
+
+# The end of a superstrng. eg `}abc"`
 class AEndStringExpr
-special AStringFormExpr
-    readable writable var _n_string: TEndString
+       super AStringFormExpr
 end
+
+# A superstring literal. eg `"a{x}b{y}c"`
+# Each part is modelized a sequence of expression. eg. `["a{, x, }b{, y, }c"]`
 class ASuperstringExpr
-special AExpr
-    readable writable var _n_exprs: List[AExpr] = new List[AExpr]
+       super AExpr
+       readable var _n_exprs: ANodes[AExpr] = new ANodes[AExpr](self)
 end
+
+# A simple parenthesis. eg `(x)`
 class AParExpr
-special AProxyExpr
+       super AProxyExpr
+       readable writable var _n_opar: TOpar
+       readable writable var _n_cpar: TCpar
 end
-class AProxyExpr
-special AExpr
-    readable writable var _n_expr: AExpr
+
+# Whatevej just contains (and mimic) an other expression
+abstract class AProxyExpr
+       super AExpr
+       readable writable var _n_expr: AExpr
 end
+
+# A type cast. eg `x.as(T)`
 class AAsCastExpr
-special AExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_kwas: TKwas
-    readable writable var _n_type: AType
+       super AExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_kwas: TKwas
+       readable writable var _n_opar: nullable TOpar = null
+       readable writable var _n_type: AType
+       readable writable var _n_cpar: nullable TCpar = null
 end
+
+# A as-not-null cast. eg `x.as(not null)`
 class AAsNotnullExpr
-special AExpr
-    readable writable var _n_expr: AExpr
-    readable writable var _n_kwas: TKwas
-    readable writable var _n_kwnot: TKwnot
-    readable writable var _n_kwnull: TKwnull
+       super AExpr
+       readable writable var _n_expr: AExpr
+       readable writable var _n_kwas: TKwas
+       readable writable var _n_opar: nullable TOpar = null
+       readable writable var _n_kwnot: TKwnot
+       readable writable var _n_kwnull: TKwnull
+       readable writable var _n_cpar: nullable TCpar = null
 end
+
+# A is-set check of old-style attributes. eg `isset x._a`
 class AIssetAttrExpr
-special AAttrFormExpr
-    readable writable var _n_kwisset: TKwisset
+       super AAttrFormExpr
+       readable writable var _n_kwisset: TKwisset
+end
+
+# A list of expression separated with commas (arguments for instance)
+abstract class AExprs
+       super Prod 
+       readable var _n_exprs: ANodes[AExpr] = new ANodes[AExpr](self)
+end
+
+class ADebugTypeExpr
+       super AExpr
+       readable writable var _n_kwdebug: TKwdebug
+       readable writable var _n_kwtype: TKwtype
+       readable writable var _n_expr: AExpr
+       readable writable var _n_type: AType
+end
+
+# A simple list of expressions
+class AListExprs
+       super AExprs
+end
+
+# A list of expressions enclosed in parentheses
+class AParExprs
+       super AExprs
+       readable writable var _n_opar: TOpar
+       readable writable var _n_cpar: TCpar
+end
+
+# A list of expressions enclosed in brackets
+class ABraExprs
+       super AExprs
+       readable writable var _n_obra: TObra
+       readable writable var _n_cbra: TCbra
+end
+
+# A complex assignment operator. eg `+=`
+abstract class AAssignOp
+       super Prod
 end
-class AAssignOp special Prod end
 class APlusAssignOp
-special AAssignOp
-    readable writable var _n_pluseq: TPluseq
+       super AAssignOp
+       readable writable var _n_pluseq: TPluseq
 end
 class AMinusAssignOp
-special AAssignOp
-    readable writable var _n_minuseq: TMinuseq
+       super AAssignOp
+       readable writable var _n_minuseq: TMinuseq
 end
-class AClosureDef
-special ALabelable
-    readable writable var _n_kwwith: TKwwith
-    readable writable var _n_id: List[TId] = new List[TId]
-    readable writable var _n_kwdo: TKwdo
-    readable writable var _n_expr: nullable AExpr = null
+
+class AModuleName
+       super Prod
+       readable writable var _n_quad: nullable TQuad = null
+       readable var _n_path: ANodes[TId] = new ANodes[TId](self)
+       readable writable var _n_id: TId
+end
+class AInLanguage
+       super Prod
+       readable writable var _n_kwin: TKwin
+       readable writable var _n_string: TString
+end
+class AExternCodeBlock
+       super Prod
+       readable writable var _n_in_language: nullable AInLanguage = null
+       readable writable var _n_extern_code_segment: TExternCodeSegment
 end
 class AQualified
-special Prod
-    readable writable var _n_id: List[TId] = new List[TId]
-    readable writable var _n_classid: nullable TClassid = null
+       super Prod
+       readable writable var _n_quad: nullable TQuad = null
+       readable var _n_id: ANodes[TId] = new ANodes[TId](self)
+       readable writable var _n_classid: nullable TClassid = null
 end
+
+# A documentation of a definition
+# It contains the block of comments just above the declaration
 class ADoc
-special Prod
-    readable writable var _n_comment: List[TComment] = new List[TComment]
+       super Prod
+       readable var _n_comment: ANodes[TComment] = new ANodes[TComment](self)
+end
+
+class AAnnotations
+       super Prod
+       readable writable var _n_at: nullable TAt = null
+       readable writable var _n_opar: nullable TOpar = null
+       readable var _n_items: ANodes[AAnnotation] = new ANodes[AAnnotation](self)
+       readable writable var _n_cpar: nullable TCpar = null
+end
+class AAnnotation
+       super Prod
+       readable writable var _n_atid: AAtid
+       readable writable var _n_opar: nullable TOpar = null
+       readable var _n_args: ANodes[AAtArg] = new ANodes[AAtArg](self)
+       readable writable var _n_cpar: nullable TCpar = null
+end
+abstract class AAtArg
+       super Prod
+end
+class ATypeAtArg
+       super AAtArg
+       readable writable var _n_type: AType
+end
+class AExprAtArg
+       super AAtArg
+       readable writable var _n_expr: AExpr
+end
+class AAtAtArg
+       super AAtArg
+end
+abstract class AAtid
+       super Prod
+       readable writable var _n_id: Token
+end
+class AIdAtid
+       super AAtid
+end
+class AKwexternAtid
+       super AAtid
+end
+class AKwinternAtid
+       super AAtid
+end
+class AKwreadableAtid
+       super AAtid
+end
+class AKwwritableAtid
+       super AAtid
+end
+class AKwimportAtid
+       super AAtid
 end
 
+# The root of the AST
 class Start
-special Prod
-    readable writable var _n_base: nullable AModule
-    readable writable var _n_eof: EOF
+       super Prod
+       readable writable var _n_base: nullable AModule
+       readable writable var _n_eof: EOF
+       init(n_base: nullable AModule, n_eof: EOF)
+       do
+               self._n_base = n_base
+               self._n_eof = n_eof
+       end
 end