aboutsummaryrefslogtreecommitdiffstats
path: root/core/ast.moon
blob: a25d1cd2b0a6e80d3cd2bd27bbfa30f406eceff6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
----
-- AST Node Interface.
--
-- implemented by `Value` and `Cell`.
--
-- @classmod AST

--- members
-- @section members

  --- evaluate this AST Node.
  --
  -- Evaluate this node and return a `Result`.
  --
  -- @function eval
  -- @tparam Scope scope the scope to evaluate in
  -- @treturn Result the evaluation result

  --- quote this AST Node, preserving its identity.
  --
  --- Returns a mutable copy of this Node that shares its identity.
  --
  -- @function quote
  -- @treturn AST

  --- create a clone with its own identity.
  --
  -- creates a clone of this Cell with its own identity by prepending a `parent`
  -- Tag (and cloning all child expressions recursively).
  --
  -- @function clone
  -- @tparam Tag parent
  -- @treturn AST

  --- stringify this AST Node.
  --
  -- Should return the exact string this node was parsed from (if it was parsed).
  --
  -- @function stringify
  -- @treturn string the exact string this Node was parsed from