lang: parser, ast, interfaces: Implement include as

This adds support for `include as <identifier>` type statements which in
addition to pulling in any defined resources, it also makes the contents
of the scope of the class available to the scope of the include
statement, but prefixed by the identifier specified.

This makes passing data between scopes much more powerful, and it also
allows classes to return useful classes for subsequent use.

This also improves the SetScope procedure and adds to the Ordering
stage. It's unclear if the current Ordering stage can handle all code,
or if there exist corner-cases which are valid code, but which would
produce a wrong or imprecise topological sort.

Some extraneous scoping bugs still exist, which expose certain variables
that we should not depend on in future code.

Co-authored-by: Samuel Gélineau <gelisam@gmail.com>

lang/interfaces/ast.go

@@ -235,7 +235,7 @@ type Data struct {
 // from the variables, which could actually contain lambda functions.
 type Scope struct {
 	Variables map[string]Expr
-	Functions map[string]Expr // the Expr will usually be an *ExprFunc
+	Functions map[string]Expr // the Expr will usually be an *ExprFunc (actually it's usually (or always) an *ExprSingleton, which wraps an *ExprFunc now)
 	Classes   map[string]Stmt
 
 	Chain []Node // chain of previously seen node's

lang/interfaces/const.go

@@ -28,6 +28,12 @@ const (
 	// also used with `ModuleSep` for scoped variables like `$foo.bar.baz`.
 	VarPrefix = "$"
 
+	// BareSymbol is the character used primarily for imports to specify
+	// that we want to import the entire contents and flatten them into our
+	// current scope. It should probably be removed entirely to force
+	// explicit imports.
+	BareSymbol = "*"
+
 	// PanicResKind is the kind string used for the panic resource.
 	PanicResKind = "_panic"
 )