@luma.gl/shadertools 9.0.14 → 9.0.16

package/dist/dist.dev.js

@@ -1247,7 +1247,7 @@ void main() {
   // src/lib/wgsl/get-shader-layout-wgsl.ts
   var import_core = __toESM(require_core(), 1);
 
-  // src/libs/wgsl-reflect/wgsl_reflect.module.js
+  // ../../node_modules/wgsl_reflect/wgsl_reflect.module.js
   var ParseContext = class {
     constructor() {
       this.constants = /* @__PURE__ */ new Map();
@@ -1270,23 +1270,50 @@ void main() {
     evaluateString(context) {
       return this.evaluate(context).toString();
     }
+    search(callback) {
+    }
+    searchBlock(block, callback) {
+      if (block) {
+        callback(_BlockStart.instance);
+        for (const node of block) {
+          if (node instanceof Array) {
+            this.searchBlock(node, callback);
+          } else {
+            node.search(callback);
+          }
+        }
+        callback(_BlockEnd.instance);
+      }
+    }
   };
+  var _BlockStart = class extends Node {
+  };
+  _BlockStart.instance = new _BlockStart();
+  var _BlockEnd = class extends Node {
+  };
+  _BlockEnd.instance = new _BlockEnd();
   var Statement = class extends Node {
     constructor() {
       super();
     }
   };
   var Function = class extends Statement {
-    constructor(name, args, returnType, body) {
+    constructor(name, args, returnType, body, startLine, endLine) {
       super();
+      this.calls = /* @__PURE__ */ new Set();
       this.name = name;
       this.args = args;
       this.returnType = returnType;
       this.body = body;
+      this.startLine = startLine;
+      this.endLine = endLine;
     }
     get astNodeType() {
       return "function";
     }
+    search(callback) {
+      this.searchBlock(this.body, callback);
+    }
   };
   var StaticAssert = class extends Statement {
     constructor(expression) {
@@ -1296,6 +1323,9 @@ void main() {
     get astNodeType() {
       return "staticAssert";
     }
+    search(callback) {
+      this.expression.search(callback);
+    }
   };
   var While = class extends Statement {
     constructor(condition, body) {
@@ -1306,6 +1336,10 @@ void main() {
     get astNodeType() {
       return "while";
     }
+    search(callback) {
+      this.condition.search(callback);
+      this.searchBlock(this.body, callback);
+    }
   };
   var Continuing = class extends Statement {
     constructor(body) {
@@ -1315,6 +1349,9 @@ void main() {
     get astNodeType() {
       return "continuing";
     }
+    search(callback) {
+      this.searchBlock(this.body, callback);
+    }
   };
   var For = class extends Statement {
     constructor(init, condition, increment, body) {
@@ -1327,6 +1364,13 @@ void main() {
     get astNodeType() {
       return "for";
     }
+    search(callback) {
+      var _a2, _b, _c;
+      (_a2 = this.init) === null || _a2 === void 0 ? void 0 : _a2.search(callback);
+      (_b = this.condition) === null || _b === void 0 ? void 0 : _b.search(callback);
+      (_c = this.increment) === null || _c === void 0 ? void 0 : _c.search(callback);
+      this.searchBlock(this.body, callback);
+    }
   };
   var Var = class extends Statement {
     constructor(name, type, storage, access, value) {
@@ -1340,6 +1384,11 @@ void main() {
     get astNodeType() {
       return "var";
     }
+    search(callback) {
+      var _a2;
+      callback(this);
+      (_a2 = this.value) === null || _a2 === void 0 ? void 0 : _a2.search(callback);
+    }
   };
   var Override = class extends Statement {
     constructor(name, type, value) {
@@ -1351,6 +1400,10 @@ void main() {
     get astNodeType() {
       return "override";
     }
+    search(callback) {
+      var _a2;
+      (_a2 = this.value) === null || _a2 === void 0 ? void 0 : _a2.search(callback);
+    }
   };
   var Let = class extends Statement {
     constructor(name, type, storage, access, value) {
@@ -1364,6 +1417,11 @@ void main() {
     get astNodeType() {
       return "let";
     }
+    search(callback) {
+      var _a2;
+      callback(this);
+      (_a2 = this.value) === null || _a2 === void 0 ? void 0 : _a2.search(callback);
+    }
   };
   var Const = class extends Statement {
     constructor(name, type, storage, access, value) {
@@ -1380,6 +1438,11 @@ void main() {
     evaluate(context) {
       return this.value.evaluate(context);
     }
+    search(callback) {
+      var _a2;
+      callback(this);
+      (_a2 = this.value) === null || _a2 === void 0 ? void 0 : _a2.search(callback);
+    }
   };
   var IncrementOperator;
   (function(IncrementOperator2) {
@@ -1404,6 +1467,9 @@ void main() {
     get astNodeType() {
       return "increment";
     }
+    search(callback) {
+      this.variable.search(callback);
+    }
   };
   var AssignOperator;
   (function(AssignOperator2) {
@@ -1422,9 +1488,10 @@ void main() {
   (function(AssignOperator2) {
     function parse(val) {
       const key = val;
-      if (key == "parse")
+      if (key == "parse") {
         throw new Error("Invalid value for AssignOperator");
-      return AssignOperator2[key];
+      }
+      return key;
     }
     AssignOperator2.parse = parse;
   })(AssignOperator || (AssignOperator = {}));
@@ -1438,6 +1505,10 @@ void main() {
     get astNodeType() {
       return "assign";
     }
+    search(callback) {
+      this.variable.search(callback);
+      this.value.search(callback);
+    }
   };
   var Call = class extends Statement {
     constructor(name, args) {
@@ -1448,6 +1519,12 @@ void main() {
     get astNodeType() {
       return "call";
     }
+    search(callback) {
+      for (const node of this.args) {
+        node.search(callback);
+      }
+      callback(this);
+    }
   };
   var Loop = class extends Statement {
     constructor(body, continuing) {
@@ -1480,6 +1557,12 @@ void main() {
     get astNodeType() {
       return "if";
     }
+    search(callback) {
+      this.condition.search(callback);
+      this.searchBlock(this.body, callback);
+      this.searchBlock(this.elseif, callback);
+      this.searchBlock(this.else, callback);
+    }
   };
   var Return = class extends Statement {
     constructor(value) {
@@ -1489,6 +1572,10 @@ void main() {
     get astNodeType() {
       return "return";
     }
+    search(callback) {
+      var _a2;
+      (_a2 = this.value) === null || _a2 === void 0 ? void 0 : _a2.search(callback);
+    }
   };
   var Enable = class extends Statement {
     constructor(name) {
@@ -1499,6 +1586,25 @@ void main() {
       return "enable";
     }
   };
+  var Requires = class extends Statement {
+    constructor(extensions) {
+      super();
+      this.extensions = extensions;
+    }
+    get astNodeType() {
+      return "requires";
+    }
+  };
+  var Diagnostic = class extends Statement {
+    constructor(severity, rule) {
+      super();
+      this.severity = severity;
+      this.rule = rule;
+    }
+    get astNodeType() {
+      return "diagnostic";
+    }
+  };
   var Alias = class extends Statement {
     constructor(name, type) {
       super();
@@ -1549,9 +1655,11 @@ void main() {
     }
   };
   var Struct = class extends Type {
-    constructor(name, members) {
+    constructor(name, members, startLine, endLine) {
       super(name);
       this.members = members;
+      this.startLine = startLine;
+      this.endLine = endLine;
     }
     get astNodeType() {
       return "struct";
@@ -1642,6 +1750,12 @@ void main() {
     get astNodeType() {
       return "createExpr";
     }
+    search(callback) {
+      callback(this);
+      for (const node of this.args) {
+        node.search(callback);
+      }
+    }
   };
   var CallExpr = class extends Expression {
     constructor(name, args) {
@@ -1735,6 +1849,12 @@ void main() {
           throw new Error("Non const function: " + this.name);
       }
     }
+    search(callback) {
+      for (const node of this.args) {
+        node.search(callback);
+      }
+      callback(this);
+    }
   };
   var VariableExpr = class extends Expression {
     constructor(name) {
@@ -1744,6 +1864,19 @@ void main() {
     get astNodeType() {
       return "varExpr";
     }
+    search(callback) {
+      callback(this);
+      if (this.postfix) {
+        this.postfix.search(callback);
+      }
+    }
+    evaluate(context) {
+      const constant = context.constants.get(this.name);
+      if (!constant) {
+        throw new Error("Cannot evaluate node");
+      }
+      return constant.evaluate(context);
+    }
   };
   var ConstExpr = class extends Expression {
     constructor(name, initializer) {
@@ -1769,6 +1902,9 @@ void main() {
       }
       return this.initializer.evaluate(context);
     }
+    search(callback) {
+      this.initializer.search(callback);
+    }
   };
   var LiteralExpr = class extends Expression {
     constructor(value) {
@@ -1791,6 +1927,9 @@ void main() {
     get astNodeType() {
       return "bitcastExpr";
     }
+    search(callback) {
+      this.value.search(callback);
+    }
   };
   var TypecastExpr = class extends Expression {
     constructor(type, args) {
@@ -1804,6 +1943,9 @@ void main() {
     evaluate(context) {
       return this.args[0].evaluate(context);
     }
+    search(callback) {
+      this.searchBlock(this.args, callback);
+    }
   };
   var GroupingExpr = class extends Expression {
     constructor(contents) {
@@ -1816,6 +1958,18 @@ void main() {
     evaluate(context) {
       return this.contents[0].evaluate(context);
     }
+    search(callback) {
+      this.searchBlock(this.contents, callback);
+    }
+  };
+  var ArrayIndex = class extends Expression {
+    constructor(index2) {
+      super();
+      this.index = index2;
+    }
+    search(callback) {
+      this.index.search(callback);
+    }
   };
   var Operator = class extends Expression {
     constructor() {
@@ -1845,6 +1999,9 @@ void main() {
           throw new Error("Unknown unary operator: " + this.operator);
       }
     }
+    search(callback) {
+      this.right.search(callback);
+    }
   };
   var BinaryOperator = class extends Operator {
     constructor(operator, left, right) {
@@ -1888,6 +2045,10 @@ void main() {
           throw new Error(`Unknown operator ${this.operator}`);
       }
     }
+    search(callback) {
+      this.left.search(callback);
+      this.right.search(callback);
+    }
   };
   var SwitchCase = class extends Node {
     constructor() {
@@ -1903,6 +2064,9 @@ void main() {
     get astNodeType() {
       return "case";
     }
+    search(callback) {
+      this.searchBlock(this.body, callback);
+    }
   };
   var Default = class extends SwitchCase {
     constructor(body) {
@@ -1912,6 +2076,9 @@ void main() {
     get astNodeType() {
       return "default";
     }
+    search(callback) {
+      this.searchBlock(this.body, callback);
+    }
   };
   var Argument = class extends Node {
     constructor(name, type, attributes) {
@@ -1933,6 +2100,10 @@ void main() {
     get astNodeType() {
       return "elseif";
     }
+    search(callback) {
+      this.condition.search(callback);
+      this.searchBlock(this.body, callback);
+    }
   };
   var Member = class extends Node {
     constructor(name, type, attributes) {
@@ -2047,6 +2218,7 @@ void main() {
     continue: new TokenType("continue", TokenClass.keyword, "continue"),
     continuing: new TokenType("continuing", TokenClass.keyword, "continuing"),
     default: new TokenType("default", TokenClass.keyword, "default"),
+    diagnostic: new TokenType("diagnostic", TokenClass.keyword, "diagnostic"),
     discard: new TokenType("discard", TokenClass.keyword, "discard"),
     else: new TokenType("else", TokenClass.keyword, "else"),
     enable: new TokenType("enable", TokenClass.keyword, "enable"),
@@ -2064,6 +2236,7 @@ void main() {
     read: new TokenType("read", TokenClass.keyword, "read"),
     read_write: new TokenType("read_write", TokenClass.keyword, "read_write"),
     return: new TokenType("return", TokenClass.keyword, "return"),
+    requires: new TokenType("requires", TokenClass.keyword, "requires"),
     storage: new TokenType("storage", TokenClass.keyword, "storage"),
     switch: new TokenType("switch", TokenClass.keyword, "switch"),
     true: new TokenType("true", TokenClass.keyword, "true"),
@@ -2122,13 +2295,11 @@ void main() {
     hex_float_literal: new TokenType("hex_float_literal", TokenClass.token, /-?0x((([0-9a-fA-F]*\.[0-9a-fA-F]+|[0-9a-fA-F]+\.[0-9a-fA-F]*)((p|P)(\+|-)?[0-9]+f?)?)|([0-9a-fA-F]+(p|P)(\+|-)?[0-9]+f?))/),
     int_literal: new TokenType("int_literal", TokenClass.token, /-?0x[0-9a-fA-F]+|0i?|-?[1-9][0-9]*i?/),
     uint_literal: new TokenType("uint_literal", TokenClass.token, /0x[0-9a-fA-F]+u|0u|[1-9][0-9]*u/),
-    ident: new TokenType("ident", TokenClass.token, /[a-zA-Z][0-9a-zA-Z_]*/),
+    ident: new TokenType("ident", TokenClass.token, /[_a-zA-Z][0-9a-zA-Z_]*/),
     and: new TokenType("and", TokenClass.token, "&"),
     and_and: new TokenType("and_and", TokenClass.token, "&&"),
     arrow: new TokenType("arrow ", TokenClass.token, "->"),
     attr: new TokenType("attr", TokenClass.token, "@"),
-    attr_left: new TokenType("attr_left", TokenClass.token, "[["),
-    attr_right: new TokenType("attr_right", TokenClass.token, "]]"),
     forward_slash: new TokenType("forward_slash", TokenClass.token, "/"),
     bang: new TokenType("bang", TokenClass.token, "!"),
     bracket_left: new TokenType("bracket_left", TokenClass.token, "["),
@@ -2172,6 +2343,63 @@ void main() {
     shift_right_equal: new TokenType("shift_right_equal", TokenClass.token, ">>="),
     shift_left_equal: new TokenType("shift_left_equal", TokenClass.token, "<<=")
   };
+  TokenTypes.simpleTokens = {
+    "@": _a.tokens.attr,
+    "{": _a.tokens.brace_left,
+    "}": _a.tokens.brace_right,
+    ":": _a.tokens.colon,
+    ",": _a.tokens.comma,
+    "(": _a.tokens.paren_left,
+    ")": _a.tokens.paren_right,
+    ";": _a.tokens.semicolon
+  };
+  TokenTypes.literalTokens = {
+    "&": _a.tokens.and,
+    "&&": _a.tokens.and_and,
+    "->": _a.tokens.arrow,
+    "/": _a.tokens.forward_slash,
+    "!": _a.tokens.bang,
+    "[": _a.tokens.bracket_left,
+    "]": _a.tokens.bracket_right,
+    "=": _a.tokens.equal,
+    "==": _a.tokens.equal_equal,
+    "!=": _a.tokens.not_equal,
+    ">": _a.tokens.greater_than,
+    ">=": _a.tokens.greater_than_equal,
+    ">>": _a.tokens.shift_right,
+    "<": _a.tokens.less_than,
+    "<=": _a.tokens.less_than_equal,
+    "<<": _a.tokens.shift_left,
+    "%": _a.tokens.modulo,
+    "-": _a.tokens.minus,
+    "--": _a.tokens.minus_minus,
+    ".": _a.tokens.period,
+    "+": _a.tokens.plus,
+    "++": _a.tokens.plus_plus,
+    "|": _a.tokens.or,
+    "||": _a.tokens.or_or,
+    "*": _a.tokens.star,
+    "~": _a.tokens.tilde,
+    "_": _a.tokens.underscore,
+    "^": _a.tokens.xor,
+    "+=": _a.tokens.plus_equal,
+    "-=": _a.tokens.minus_equal,
+    "*=": _a.tokens.times_equal,
+    "/=": _a.tokens.division_equal,
+    "%=": _a.tokens.modulo_equal,
+    "&=": _a.tokens.and_equal,
+    "|=": _a.tokens.or_equal,
+    "^=": _a.tokens.xor_equal,
+    ">>=": _a.tokens.shift_right_equal,
+    "<<=": _a.tokens.shift_left_equal
+  };
+  TokenTypes.regexTokens = {
+    decimal_float_literal: _a.tokens.decimal_float_literal,
+    hex_float_literal: _a.tokens.hex_float_literal,
+    int_literal: _a.tokens.int_literal,
+    uint_literal: _a.tokens.uint_literal,
+    ident: _a.tokens.ident
+  };
   TokenTypes.storage_class = [
     _a.keywords.function,
     _a.keywords.private,
@@ -2294,7 +2522,7 @@ void main() {
     _a.keywords.bitcast,
     ..._a.any_texture_type
   ];
-  TokenTypes.attribute_name = [_a.tokens.ident, _a.keywords.block];
+  TokenTypes.attribute_name = [_a.tokens.ident, _a.keywords.block, _a.keywords.diagnostic];
   TokenTypes.assignment_operators = [
     _a.tokens.equal,
     _a.tokens.plus_equal,
@@ -2343,8 +2571,9 @@ void main() {
     scanTokens() {
       while (!this._isAtEnd()) {
         this._start = this._current;
-        if (!this.scanToken())
+        if (!this.scanToken()) {
           throw `Invalid syntax at line ${this._line}`;
+        }
       }
       this._tokens.push(new Token(TokenTypes.eof, "", this._line));
       return this._tokens;
@@ -2362,8 +2591,9 @@ void main() {
       if (lexeme == "/") {
         if (this._peekAhead() == "/") {
           while (lexeme != "\n") {
-            if (this._isAtEnd())
+            if (this._isAtEnd()) {
               return true;
+            }
             lexeme = this._advance();
           }
           this._line++;
@@ -2372,8 +2602,9 @@ void main() {
           this._advance();
           let commentLevel = 1;
           while (commentLevel > 0) {
-            if (this._isAtEnd())
+            if (this._isAtEnd()) {
               return true;
+            }
             lexeme = this._advance();
             if (lexeme == "\n") {
               this._line++;
@@ -2395,7 +2626,32 @@ void main() {
           return true;
         }
       }
+      const simpleToken = TokenTypes.simpleTokens[lexeme];
+      if (simpleToken) {
+        this._addToken(simpleToken);
+        return true;
+      }
       let matchType = TokenTypes.none;
+      const isAlpha = this._isAlpha(lexeme);
+      const isUnderscore = lexeme === "_";
+      if (this._isAlphaNumeric(lexeme)) {
+        let nextChar = this._peekAhead();
+        while (this._isAlphaNumeric(nextChar)) {
+          lexeme += this._advance();
+          nextChar = this._peekAhead();
+        }
+      }
+      if (isAlpha) {
+        const matchedType = TokenTypes.keywords[lexeme];
+        if (matchedType) {
+          this._addToken(matchedType);
+          return true;
+        }
+      }
+      if (isAlpha || isUnderscore) {
+        this._addToken(TokenTypes.tokens.ident);
+        return true;
+      }
       for (; ; ) {
         let matchedType = this._findType(lexeme);
         const nextLexeme = this._peekAhead();
@@ -2428,8 +2684,9 @@ void main() {
             }
           }
           if (matchedType === TokenTypes.none) {
-            if (matchType === TokenTypes.none)
+            if (matchType === TokenTypes.none) {
               return false;
+            }
             this._current--;
             this._addToken(matchType);
             return true;
@@ -2438,45 +2695,43 @@ void main() {
           this._current += lookAhead + 1;
         }
         matchType = matchedType;
-        if (this._isAtEnd())
+        if (this._isAtEnd()) {
           break;
+        }
         lexeme += this._advance();
       }
-      if (matchType === TokenTypes.none)
+      if (matchType === TokenTypes.none) {
         return false;
+      }
       this._addToken(matchType);
       return true;
     }
     _findType(lexeme) {
-      for (const name in TokenTypes.keywords) {
-        const type = TokenTypes.keywords[name];
-        if (this._match(lexeme, type.rule)) {
-          return type;
+      for (const name in TokenTypes.regexTokens) {
+        const type2 = TokenTypes.regexTokens[name];
+        if (this._match(lexeme, type2.rule)) {
+          return type2;
         }
       }
-      for (const name in TokenTypes.tokens) {
-        const type = TokenTypes.tokens[name];
-        if (this._match(lexeme, type.rule)) {
-          return type;
-        }
+      const type = TokenTypes.literalTokens[lexeme];
+      if (type) {
+        return type;
       }
       return TokenTypes.none;
     }
     _match(lexeme, rule) {
-      if (typeof rule === "string") {
-        if (rule == lexeme) {
-          return true;
-        }
-      } else {
-        const match = rule.exec(lexeme);
-        if (match && match.index == 0 && match[0] == lexeme)
-          return true;
-      }
-      return false;
+      const match = rule.exec(lexeme);
+      return match && match.index == 0 && match[0] == lexeme;
     }
     _isAtEnd() {
       return this._current >= this._source.length;
     }
+    _isAlpha(c) {
+      return c >= "a" && c <= "z" || c >= "A" && c <= "Z";
+    }
+    _isAlphaNumeric(c) {
+      return c >= "a" && c <= "z" || c >= "A" && c <= "Z" || c == "_" || c >= "0" && c <= "9";
+    }
     _isWhitespace(c) {
       return c == " " || c == "	" || c == "\r";
     }
@@ -2489,8 +2744,9 @@ void main() {
     }
     _peekAhead(offset = 0) {
       offset = offset || 0;
-      if (this._current + offset >= this._source.length)
+      if (this._current + offset >= this._source.length) {
         return "\0";
+      }
       return this._source[this._current + offset];
     }
     _addToken(type) {
@@ -2502,17 +2758,40 @@ void main() {
     constructor() {
       this._tokens = [];
       this._current = 0;
+      this._currentLine = 0;
       this._context = new ParseContext();
+      this._deferArrayCountEval = [];
     }
     parse(tokensOrCode) {
       this._initialize(tokensOrCode);
-      let statements = [];
+      this._deferArrayCountEval.length = 0;
+      const statements = [];
       while (!this._isAtEnd()) {
         const statement = this._global_decl_or_directive();
-        if (!statement)
+        if (!statement) {
           break;
+        }
         statements.push(statement);
       }
+      if (this._deferArrayCountEval.length > 0) {
+        for (const arrayDecl of this._deferArrayCountEval) {
+          const arrayType = arrayDecl["arrayType"];
+          const countNode = arrayDecl["countNode"];
+          if (countNode instanceof VariableExpr) {
+            const variable = countNode;
+            const name = variable.name;
+            const constant = this._context.constants.get(name);
+            if (constant) {
+              try {
+                const count = constant.evaluate(this._context);
+                arrayType.count = count;
+              } catch (e) {
+              }
+            }
+          }
+        }
+        this._deferArrayCountEval.length = 0;
+      }
       return statements;
     }
     _initialize(tokensOrCode) {
@@ -2529,7 +2808,6 @@ void main() {
       this._current = 0;
     }
     _error(token, message) {
-      console.error(token, message);
       return {
         token,
         message,
@@ -2559,24 +2837,29 @@ void main() {
       return false;
     }
     _consume(types, message) {
-      if (this._check(types))
+      if (this._check(types)) {
         return this._advance();
+      }
       throw this._error(this._peek(), message);
     }
     _check(types) {
-      if (this._isAtEnd())
+      if (this._isAtEnd()) {
         return false;
+      }
       const tk = this._peek();
       if (types instanceof Array) {
-        let t = tk.type;
-        let index2 = types.indexOf(t);
+        const t = tk.type;
+        const index2 = types.indexOf(t);
         return index2 != -1;
       }
       return tk.type == types;
     }
     _advance() {
-      if (!this._isAtEnd())
+      var _a2, _b;
+      this._currentLine = (_b = (_a2 = this._peek()) === null || _a2 === void 0 ? void 0 : _a2.line) !== null && _b !== void 0 ? _b : -1;
+      if (!this._isAtEnd()) {
         this._current++;
+      }
       return this._previous();
     }
     _peek() {
@@ -2593,6 +2876,16 @@ void main() {
         this._consume(TokenTypes.tokens.semicolon, "Expected ';'");
         return type;
       }
+      if (this._match(TokenTypes.keywords.diagnostic)) {
+        const directive = this._diagnostic();
+        this._consume(TokenTypes.tokens.semicolon, "Expected ';'");
+        return directive;
+      }
+      if (this._match(TokenTypes.keywords.requires)) {
+        const requires = this._requires_directive();
+        this._consume(TokenTypes.tokens.semicolon, "Expected ';'");
+        return requires;
+      }
       if (this._match(TokenTypes.keywords.enable)) {
         const enable = this._enable_directive();
         this._consume(TokenTypes.tokens.semicolon, "Expected ';'");
@@ -2601,56 +2894,65 @@ void main() {
       const attrs = this._attribute();
       if (this._check(TokenTypes.keywords.var)) {
         const _var = this._global_variable_decl();
-        if (_var != null)
+        if (_var != null) {
           _var.attributes = attrs;
+        }
         this._consume(TokenTypes.tokens.semicolon, "Expected ';'.");
         return _var;
       }
       if (this._check(TokenTypes.keywords.override)) {
         const _override = this._override_variable_decl();
-        if (_override != null)
+        if (_override != null) {
           _override.attributes = attrs;
+        }
         this._consume(TokenTypes.tokens.semicolon, "Expected ';'.");
         return _override;
       }
       if (this._check(TokenTypes.keywords.let)) {
         const _let = this._global_let_decl();
-        if (_let != null)
+        if (_let != null) {
           _let.attributes = attrs;
+        }
         this._consume(TokenTypes.tokens.semicolon, "Expected ';'.");
         return _let;
       }
       if (this._check(TokenTypes.keywords.const)) {
         const _const = this._global_const_decl();
-        if (_const != null)
+        if (_const != null) {
           _const.attributes = attrs;
+        }
         this._consume(TokenTypes.tokens.semicolon, "Expected ';'.");
         return _const;
       }
       if (this._check(TokenTypes.keywords.struct)) {
         const _struct = this._struct_decl();
-        if (_struct != null)
+        if (_struct != null) {
           _struct.attributes = attrs;
+        }
         return _struct;
       }
       if (this._check(TokenTypes.keywords.fn)) {
         const _fn = this._function_decl();
-        if (_fn != null)
+        if (_fn != null) {
           _fn.attributes = attrs;
+        }
         return _fn;
       }
       return null;
     }
     _function_decl() {
-      if (!this._match(TokenTypes.keywords.fn))
+      if (!this._match(TokenTypes.keywords.fn)) {
         return null;
+      }
+      const startLine = this._currentLine;
       const name = this._consume(TokenTypes.tokens.ident, "Expected function name.").toString();
       this._consume(TokenTypes.tokens.paren_left, "Expected '(' for function arguments.");
       const args = [];
       if (!this._check(TokenTypes.tokens.paren_right)) {
         do {
-          if (this._check(TokenTypes.tokens.paren_right))
+          if (this._check(TokenTypes.tokens.paren_right)) {
             break;
+          }
           const argAttrs = this._attribute();
           const name2 = this._consume(TokenTypes.tokens.ident, "Expected argument name.").toString();
           this._consume(TokenTypes.tokens.colon, "Expected ':' for argument type.");
@@ -2667,19 +2969,22 @@ void main() {
       if (this._match(TokenTypes.tokens.arrow)) {
         const attrs = this._attribute();
         _return = this._type_decl();
-        if (_return != null)
+        if (_return != null) {
           _return.attributes = attrs;
+        }
       }
       const body = this._compound_statement();
-      return new Function(name, args, _return, body);
+      const endLine = this._currentLine;
+      return new Function(name, args, _return, body, startLine, endLine);
     }
     _compound_statement() {
       const statements = [];
       this._consume(TokenTypes.tokens.brace_left, "Expected '{' for block.");
       while (!this._check(TokenTypes.tokens.brace_right)) {
         const statement = this._statement();
-        if (statement !== null)
+        if (statement !== null) {
           statements.push(statement);
+        }
       }
       this._consume(TokenTypes.tokens.brace_right, "Expected '}' for block.");
       return statements;
@@ -2687,65 +2992,85 @@ void main() {
     _statement() {
       while (this._match(TokenTypes.tokens.semicolon) && !this._isAtEnd())
         ;
-      if (this._check(TokenTypes.keywords.if))
+      if (this._check(TokenTypes.tokens.attr)) {
+        this._attribute();
+      }
+      if (this._check(TokenTypes.keywords.if)) {
         return this._if_statement();
-      if (this._check(TokenTypes.keywords.switch))
+      }
+      if (this._check(TokenTypes.keywords.switch)) {
         return this._switch_statement();
-      if (this._check(TokenTypes.keywords.loop))
+      }
+      if (this._check(TokenTypes.keywords.loop)) {
         return this._loop_statement();
-      if (this._check(TokenTypes.keywords.for))
+      }
+      if (this._check(TokenTypes.keywords.for)) {
         return this._for_statement();
-      if (this._check(TokenTypes.keywords.while))
+      }
+      if (this._check(TokenTypes.keywords.while)) {
         return this._while_statement();
-      if (this._check(TokenTypes.keywords.continuing))
+      }
+      if (this._check(TokenTypes.keywords.continuing)) {
         return this._continuing_statement();
-      if (this._check(TokenTypes.keywords.static_assert))
+      }
+      if (this._check(TokenTypes.keywords.static_assert)) {
         return this._static_assert_statement();
-      if (this._check(TokenTypes.tokens.brace_left))
+      }
+      if (this._check(TokenTypes.tokens.brace_left)) {
         return this._compound_statement();
+      }
       let result = null;
-      if (this._check(TokenTypes.keywords.return))
+      if (this._check(TokenTypes.keywords.return)) {
         result = this._return_statement();
-      else if (this._check([
+      } else if (this._check([
         TokenTypes.keywords.var,
         TokenTypes.keywords.let,
         TokenTypes.keywords.const
-      ]))
+      ])) {
         result = this._variable_statement();
-      else if (this._match(TokenTypes.keywords.discard))
+      } else if (this._match(TokenTypes.keywords.discard)) {
         result = new Discard();
-      else if (this._match(TokenTypes.keywords.break))
+      } else if (this._match(TokenTypes.keywords.break)) {
         result = new Break();
-      else if (this._match(TokenTypes.keywords.continue))
+      } else if (this._match(TokenTypes.keywords.continue)) {
         result = new Continue();
-      else
+      } else {
         result = this._increment_decrement_statement() || this._func_call_statement() || this._assignment_statement();
-      if (result != null)
+      }
+      if (result != null) {
         this._consume(TokenTypes.tokens.semicolon, "Expected ';' after statement.");
+      }
       return result;
     }
     _static_assert_statement() {
-      if (!this._match(TokenTypes.keywords.static_assert))
+      if (!this._match(TokenTypes.keywords.static_assert)) {
         return null;
-      let expression = this._optional_paren_expression();
+      }
+      const expression = this._optional_paren_expression();
       return new StaticAssert(expression);
     }
     _while_statement() {
-      if (!this._match(TokenTypes.keywords.while))
+      if (!this._match(TokenTypes.keywords.while)) {
         return null;
-      let condition = this._optional_paren_expression();
+      }
+      const condition = this._optional_paren_expression();
+      if (this._check(TokenTypes.tokens.attr)) {
+        this._attribute();
+      }
       const block = this._compound_statement();
       return new While(condition, block);
     }
     _continuing_statement() {
-      if (!this._match(TokenTypes.keywords.continuing))
+      if (!this._match(TokenTypes.keywords.continuing)) {
         return null;
+      }
       const block = this._compound_statement();
       return new Continuing(block);
     }
     _for_statement() {
-      if (!this._match(TokenTypes.keywords.for))
+      if (!this._match(TokenTypes.keywords.for)) {
         return null;
+      }
       this._consume(TokenTypes.tokens.paren_left, "Expected '('.");
       const init = !this._check(TokenTypes.tokens.semicolon) ? this._for_init() : null;
       this._consume(TokenTypes.tokens.semicolon, "Expected ';'.");
@@ -2753,6 +3078,9 @@ void main() {
       this._consume(TokenTypes.tokens.semicolon, "Expected ';'.");
       const increment = !this._check(TokenTypes.tokens.paren_right) ? this._for_increment() : null;
       this._consume(TokenTypes.tokens.paren_right, "Expected ')'.");
+      if (this._check(TokenTypes.tokens.attr)) {
+        this._attribute();
+      }
       const body = this._compound_statement();
       return new For(init, condition, increment, body);
     }
@@ -2765,11 +3093,13 @@ void main() {
     _variable_statement() {
       if (this._check(TokenTypes.keywords.var)) {
         const _var = this._variable_decl();
-        if (_var === null)
+        if (_var === null) {
           throw this._error(this._peek(), "Variable declaration expected.");
+        }
         let value = null;
-        if (this._match(TokenTypes.tokens.equal))
+        if (this._match(TokenTypes.tokens.equal)) {
           value = this._short_circuit_or_expression();
+        }
         return new Var(_var.name, _var.type, _var.storage, _var.access, value);
       }
       if (this._match(TokenTypes.keywords.let)) {
@@ -2778,8 +3108,9 @@ void main() {
         if (this._match(TokenTypes.tokens.colon)) {
           const typeAttrs = this._attribute();
           type = this._type_decl();
-          if (type != null)
+          if (type != null) {
             type.attributes = typeAttrs;
+          }
         }
         this._consume(TokenTypes.tokens.equal, "Expected '=' for let.");
         const value = this._short_circuit_or_expression();
@@ -2791,8 +3122,9 @@ void main() {
         if (this._match(TokenTypes.tokens.colon)) {
           const typeAttrs = this._attribute();
           type = this._type_decl();
-          if (type != null)
+          if (type != null) {
             type.attributes = typeAttrs;
+          }
         }
         this._consume(TokenTypes.tokens.equal, "Expected '=' for const.");
         const value = this._short_circuit_or_expression();
@@ -2803,8 +3135,9 @@ void main() {
     _increment_decrement_statement() {
       const savedPos = this._current;
       const _var = this._unary_expression();
-      if (_var == null)
+      if (_var == null) {
         return null;
+      }
       if (!this._check(TokenTypes.increment_operators)) {
         this._current = savedPos;
         return null;
@@ -2814,20 +3147,24 @@ void main() {
     }
     _assignment_statement() {
       let _var = null;
-      if (this._check(TokenTypes.tokens.brace_right))
+      if (this._check(TokenTypes.tokens.brace_right)) {
         return null;
+      }
       let isUnderscore = this._match(TokenTypes.tokens.underscore);
-      if (!isUnderscore)
+      if (!isUnderscore) {
         _var = this._unary_expression();
-      if (!isUnderscore && _var == null)
+      }
+      if (!isUnderscore && _var == null) {
         return null;
+      }
       const type = this._consume(TokenTypes.assignment_operators, "Expected assignment operator.");
       const value = this._short_circuit_or_expression();
       return new Assign(AssignOperator.parse(type.lexeme), _var, value);
     }
     _func_call_statement() {
-      if (!this._check(TokenTypes.tokens.ident))
+      if (!this._check(TokenTypes.tokens.ident)) {
         return null;
+      }
       const savedPos = this._current;
       const name = this._consume(TokenTypes.tokens.ident, "Expected function name.");
       const args = this._argument_expression_list();
@@ -2838,8 +3175,12 @@ void main() {
       return new Call(name.lexeme, args);
     }
     _loop_statement() {
-      if (!this._match(TokenTypes.keywords.loop))
+      if (!this._match(TokenTypes.keywords.loop)) {
         return null;
+      }
+      if (this._check(TokenTypes.tokens.attr)) {
+        this._attribute();
+      }
       this._consume(TokenTypes.tokens.brace_left, "Expected '{' for loop.");
       const statements = [];
       let statement = this._statement();
@@ -2854,19 +3195,25 @@ void main() {
         statement = this._statement();
       }
       let continuing = null;
-      if (this._match(TokenTypes.keywords.continuing))
+      if (this._match(TokenTypes.keywords.continuing)) {
         continuing = this._compound_statement();
+      }
       this._consume(TokenTypes.tokens.brace_right, "Expected '}' for loop.");
       return new Loop(statements, continuing);
     }
     _switch_statement() {
-      if (!this._match(TokenTypes.keywords.switch))
+      if (!this._match(TokenTypes.keywords.switch)) {
         return null;
+      }
       const condition = this._optional_paren_expression();
+      if (this._check(TokenTypes.tokens.attr)) {
+        this._attribute();
+      }
       this._consume(TokenTypes.tokens.brace_left, "Expected '{' for switch.");
       const body = this._switch_body();
-      if (body == null || body.length == 0)
+      if (body == null || body.length == 0) {
         throw this._error(this._previous(), "Expected 'case' or 'default'.");
+      }
       this._consume(TokenTypes.tokens.brace_right, "Expected '}' for switch.");
       return new Switch(condition, body);
     }
@@ -2875,6 +3222,9 @@ void main() {
       if (this._match(TokenTypes.keywords.case)) {
         const selector = this._case_selectors();
         this._match(TokenTypes.tokens.colon);
+        if (this._check(TokenTypes.tokens.attr)) {
+          this._attribute();
+        }
         this._consume(TokenTypes.tokens.brace_left, "Exected '{' for switch case.");
         const body = this._case_body();
         this._consume(TokenTypes.tokens.brace_right, "Exected '}' for switch case.");
@@ -2882,6 +3232,9 @@ void main() {
       }
       if (this._match(TokenTypes.keywords.default)) {
         this._match(TokenTypes.tokens.colon);
+        if (this._check(TokenTypes.tokens.attr)) {
+          this._attribute();
+        }
         this._consume(TokenTypes.tokens.brace_left, "Exected '{' for switch default.");
         const body = this._case_body();
         this._consume(TokenTypes.tokens.brace_right, "Exected '}' for switch default.");
@@ -2894,12 +3247,12 @@ void main() {
       return cases;
     }
     _case_selectors() {
-      var _a2, _b, _c, _d;
       const selectors = [
-        (_b = (_a2 = this._shift_expression()) === null || _a2 === void 0 ? void 0 : _a2.evaluate(this._context).toString()) !== null && _b !== void 0 ? _b : ""
+        this._shift_expression()
+        //?.evaluate(this._context).toString() ?? "",
       ];
       while (this._match(TokenTypes.tokens.comma)) {
-        selectors.push((_d = (_c = this._shift_expression()) === null || _c === void 0 ? void 0 : _c.evaluate(this._context).toString()) !== null && _d !== void 0 ? _d : "");
+        selectors.push(this._shift_expression());
       }
       return selectors;
     }
@@ -2909,28 +3262,41 @@ void main() {
         return [];
       }
       let statement = this._statement();
-      if (statement == null)
+      if (statement == null) {
         return [];
+      }
       if (!(statement instanceof Array)) {
         statement = [statement];
       }
       const nextStatement = this._case_body();
-      if (nextStatement.length == 0)
+      if (nextStatement.length == 0) {
         return statement;
+      }
       return [...statement, nextStatement[0]];
     }
     _if_statement() {
-      if (!this._match(TokenTypes.keywords.if))
+      if (!this._match(TokenTypes.keywords.if)) {
         return null;
+      }
       const condition = this._optional_paren_expression();
+      if (this._check(TokenTypes.tokens.attr)) {
+        this._attribute();
+      }
       const block = this._compound_statement();
       let elseif = [];
       if (this._match_elseif()) {
+        if (this._check(TokenTypes.tokens.attr)) {
+          this._attribute();
+        }
         elseif = this._elseif_statement(elseif);
       }
       let _else = null;
-      if (this._match(TokenTypes.keywords.else))
+      if (this._match(TokenTypes.keywords.else)) {
+        if (this._check(TokenTypes.tokens.attr)) {
+          this._attribute();
+        }
         _else = this._compound_statement();
+      }
       return new If(condition, block, elseif, _else);
     }
     _match_elseif() {
@@ -2946,13 +3312,17 @@ void main() {
       const block = this._compound_statement();
       elseif.push(new ElseIf(condition, block));
       if (this._match_elseif()) {
+        if (this._check(TokenTypes.tokens.attr)) {
+          this._attribute();
+        }
         this._elseif_statement(elseif);
       }
       return elseif;
     }
     _return_statement() {
-      if (!this._match(TokenTypes.keywords.return))
+      if (!this._match(TokenTypes.keywords.return)) {
         return null;
+      }
       const value = this._short_circuit_or_expression();
       return new Return(value);
     }
@@ -3050,25 +3420,29 @@ void main() {
     _singular_expression() {
       const expr = this._primary_expression();
       const p = this._postfix_expression();
-      if (p)
+      if (p) {
         expr.postfix = p;
+      }
       return expr;
     }
     _postfix_expression() {
       if (this._match(TokenTypes.tokens.bracket_left)) {
         const expr = this._short_circuit_or_expression();
         this._consume(TokenTypes.tokens.bracket_right, "Expected ']'.");
+        const arrayIndex = new ArrayIndex(expr);
         const p = this._postfix_expression();
-        if (p)
-          expr.postfix = p;
-        return expr;
+        if (p) {
+          arrayIndex.postfix = p;
+        }
+        return arrayIndex;
       }
       if (this._match(TokenTypes.tokens.period)) {
         const name = this._consume(TokenTypes.tokens.ident, "Expected member name.");
         const p = this._postfix_expression();
         const expr = new StringExpr(name.lexeme);
-        if (p)
+        if (p) {
           expr.postfix = p;
+        }
         return expr;
       }
       return null;
@@ -3119,12 +3493,14 @@ void main() {
       return new TypecastExpr(type, args);
     }
     _argument_expression_list() {
-      if (!this._match(TokenTypes.tokens.paren_left))
+      if (!this._match(TokenTypes.tokens.paren_left)) {
         return null;
+      }
       const args = [];
       do {
-        if (this._check(TokenTypes.tokens.paren_right))
+        if (this._check(TokenTypes.tokens.paren_right)) {
           break;
+        }
         const arg = this._short_circuit_or_expression();
         args.push(arg);
       } while (this._match(TokenTypes.tokens.comma));
@@ -3144,8 +3520,10 @@ void main() {
       return new GroupingExpr([expr]);
     }
     _struct_decl() {
-      if (!this._match(TokenTypes.keywords.struct))
+      if (!this._match(TokenTypes.keywords.struct)) {
         return null;
+      }
+      const startLine = this._currentLine;
       const name = this._consume(TokenTypes.tokens.ident, "Expected name for struct.").toString();
       this._consume(TokenTypes.tokens.brace_left, "Expected '{' for struct body.");
       const members = [];
@@ -3155,8 +3533,9 @@ void main() {
         this._consume(TokenTypes.tokens.colon, "Expected ':' for struct member type.");
         const typeAttrs = this._attribute();
         const memberType = this._type_decl();
-        if (memberType != null)
+        if (memberType != null) {
           memberType.attributes = typeAttrs;
+        }
         if (!this._check(TokenTypes.tokens.brace_right))
           this._consume(TokenTypes.tokens.comma, "Expected ',' for struct member.");
         else
@@ -3164,32 +3543,37 @@ void main() {
         members.push(new Member(memberName, memberType, memberAttrs));
       }
       this._consume(TokenTypes.tokens.brace_right, "Expected '}' after struct body.");
-      const structNode = new Struct(name, members);
+      const endLine = this._currentLine;
+      const structNode = new Struct(name, members, startLine, endLine);
       this._context.structs.set(name, structNode);
       return structNode;
     }
     _global_variable_decl() {
       const _var = this._variable_decl();
-      if (_var && this._match(TokenTypes.tokens.equal))
+      if (_var && this._match(TokenTypes.tokens.equal)) {
         _var.value = this._const_expression();
+      }
       return _var;
     }
     _override_variable_decl() {
       const _override = this._override_decl();
-      if (_override && this._match(TokenTypes.tokens.equal))
+      if (_override && this._match(TokenTypes.tokens.equal)) {
         _override.value = this._const_expression();
+      }
       return _override;
     }
     _global_const_decl() {
-      if (!this._match(TokenTypes.keywords.const))
+      if (!this._match(TokenTypes.keywords.const)) {
         return null;
+      }
       const name = this._consume(TokenTypes.tokens.ident, "Expected variable name");
       let type = null;
       if (this._match(TokenTypes.tokens.colon)) {
         const attrs = this._attribute();
         type = this._type_decl();
-        if (type != null)
+        if (type != null) {
           type.attributes = attrs;
+        }
       }
       let value = null;
       if (this._match(TokenTypes.tokens.equal)) {
@@ -3212,15 +3596,17 @@ void main() {
       return c;
     }
     _global_let_decl() {
-      if (!this._match(TokenTypes.keywords.let))
+      if (!this._match(TokenTypes.keywords.let)) {
         return null;
+      }
       const name = this._consume(TokenTypes.tokens.ident, "Expected variable name");
       let type = null;
       if (this._match(TokenTypes.tokens.colon)) {
         const attrs = this._attribute();
         type = this._type_decl();
-        if (type != null)
+        if (type != null) {
           type.attributes = attrs;
+        }
       }
       let value = null;
       if (this._match(TokenTypes.tokens.equal)) {
@@ -3229,23 +3615,26 @@ void main() {
       return new Let(name.toString(), type, "", "", value);
     }
     _const_expression() {
-      if (this._match(TokenTypes.const_literal))
+      if (this._match(TokenTypes.const_literal)) {
         return new StringExpr(this._previous().toString());
+      }
       const type = this._type_decl();
       this._consume(TokenTypes.tokens.paren_left, "Expected '('.");
       let args = [];
       while (!this._check(TokenTypes.tokens.paren_right)) {
         args.push(this._const_expression());
-        if (!this._check(TokenTypes.tokens.comma))
+        if (!this._check(TokenTypes.tokens.comma)) {
           break;
+        }
         this._advance();
       }
       this._consume(TokenTypes.tokens.paren_right, "Expected ')'.");
       return new CreateExpr(type, args);
     }
     _variable_decl() {
-      if (!this._match(TokenTypes.keywords.var))
+      if (!this._match(TokenTypes.keywords.var)) {
         return null;
+      }
       let storage = "";
       let access = "";
       if (this._match(TokenTypes.tokens.less_than)) {
@@ -3259,28 +3648,47 @@ void main() {
       if (this._match(TokenTypes.tokens.colon)) {
         const attrs = this._attribute();
         type = this._type_decl();
-        if (type != null)
+        if (type != null) {
           type.attributes = attrs;
+        }
       }
       return new Var(name.toString(), type, storage, access, null);
     }
     _override_decl() {
-      if (!this._match(TokenTypes.keywords.override))
+      if (!this._match(TokenTypes.keywords.override)) {
         return null;
+      }
       const name = this._consume(TokenTypes.tokens.ident, "Expected variable name");
       let type = null;
       if (this._match(TokenTypes.tokens.colon)) {
         const attrs = this._attribute();
         type = this._type_decl();
-        if (type != null)
+        if (type != null) {
           type.attributes = attrs;
+        }
       }
       return new Override(name.toString(), type, null);
     }
+    _diagnostic() {
+      this._consume(TokenTypes.tokens.paren_left, "Expected '('");
+      const severity = this._consume(TokenTypes.tokens.ident, "Expected severity control name.");
+      this._consume(TokenTypes.tokens.comma, "Expected ','");
+      const rule = this._consume(TokenTypes.tokens.ident, "Expected diagnostic rule name.");
+      this._consume(TokenTypes.tokens.paren_right, "Expected ')'");
+      return new Diagnostic(severity.toString(), rule.toString());
+    }
     _enable_directive() {
       const name = this._consume(TokenTypes.tokens.ident, "identity expected.");
       return new Enable(name.toString());
     }
+    _requires_directive() {
+      const extensions = [this._consume(TokenTypes.tokens.ident, "identity expected.").toString()];
+      while (this._match(TokenTypes.tokens.comma)) {
+        const name = this._consume(TokenTypes.tokens.ident, "identity expected.");
+        extensions.push(name.toString());
+      }
+      return new Requires(extensions);
+    }
     _type_alias() {
       const name = this._consume(TokenTypes.tokens.ident, "identity expected.");
       this._consume(TokenTypes.tokens.equal, "Expected '=' for type alias.");
@@ -3315,8 +3723,9 @@ void main() {
         return new Type(type2.toString());
       }
       let type = this._texture_sampler_types();
-      if (type)
+      if (type) {
         return type;
+      }
       if (this._check(TokenTypes.template_types)) {
         let type2 = this._advance().toString();
         let format = null;
@@ -3324,8 +3733,9 @@ void main() {
         if (this._match(TokenTypes.tokens.less_than)) {
           format = this._type_decl();
           access = null;
-          if (this._match(TokenTypes.tokens.comma))
+          if (this._match(TokenTypes.tokens.comma)) {
             access = this._consume(TokenTypes.access_mode, "Expected access_mode for pointer").toString();
+          }
           this._consume(TokenTypes.tokens.greater_than, "Expected '>' for type.");
         }
         return new TemplateType(type2, format, access);
@@ -3337,8 +3747,9 @@ void main() {
         this._consume(TokenTypes.tokens.comma, "Expected ',' for pointer.");
         const decl = this._type_decl();
         let access = null;
-        if (this._match(TokenTypes.tokens.comma))
+        if (this._match(TokenTypes.tokens.comma)) {
           access = this._consume(TokenTypes.access_mode, "Expected access_mode for pointer").toString();
+        }
         this._consume(TokenTypes.tokens.greater_than, "Expected '>' for pointer.");
         return new PointerType(pointer, storage.toString(), decl, access);
       }
@@ -3347,6 +3758,7 @@ void main() {
         let format = null;
         let countInt = -1;
         const array = this._previous();
+        let countNode = null;
         if (this._match(TokenTypes.tokens.less_than)) {
           format = this._type_decl();
           if (this._context.aliases.has(format.name)) {
@@ -3354,21 +3766,32 @@ void main() {
           }
           let count = "";
           if (this._match(TokenTypes.tokens.comma)) {
-            let c = this._shift_expression();
-            count = c.evaluate(this._context).toString();
+            countNode = this._shift_expression();
+            try {
+              count = countNode.evaluate(this._context).toString();
+              countNode = null;
+            } catch (e) {
+              count = "1";
+            }
           }
           this._consume(TokenTypes.tokens.greater_than, "Expected '>' for array.");
           countInt = count ? parseInt(count) : 0;
         }
-        return new ArrayType(array.toString(), attrs, format, countInt);
+        const arrayType = new ArrayType(array.toString(), attrs, format, countInt);
+        if (countNode) {
+          this._deferArrayCountEval.push({ arrayType, countNode });
+        }
+        return arrayType;
       }
       return null;
     }
     _texture_sampler_types() {
-      if (this._match(TokenTypes.sampler_type))
+      if (this._match(TokenTypes.sampler_type)) {
         return new SamplerType(this._previous().toString(), null, null);
-      if (this._match(TokenTypes.depth_texture_type))
+      }
+      if (this._match(TokenTypes.depth_texture_type)) {
         return new SamplerType(this._previous().toString(), null, null);
+      }
       if (this._match(TokenTypes.sampled_texture_type) || this._match(TokenTypes.multisampled_texture_type)) {
         const sampler = this._previous();
         this._consume(TokenTypes.tokens.less_than, "Expected '<' for sampler type.");
@@ -3408,31 +3831,9 @@ void main() {
         }
         attributes.push(attr);
       }
-      while (this._match(TokenTypes.tokens.attr_left)) {
-        if (!this._check(TokenTypes.tokens.attr_right)) {
-          do {
-            const name = this._consume(TokenTypes.attribute_name, "Expected attribute name");
-            const attr = new Attribute(name.toString(), null);
-            if (this._match(TokenTypes.tokens.paren_left)) {
-              attr.value = [
-                this._consume(TokenTypes.literal_or_ident, "Expected attribute value").toString()
-              ];
-              if (this._check(TokenTypes.tokens.comma)) {
-                this._advance();
-                do {
-                  const v = this._consume(TokenTypes.literal_or_ident, "Expected attribute value").toString();
-                  attr.value.push(v);
-                } while (this._match(TokenTypes.tokens.comma));
-              }
-              this._consume(TokenTypes.tokens.paren_right, "Expected ')'");
-            }
-            attributes.push(attr);
-          } while (this._match(TokenTypes.tokens.comma));
-        }
-        this._consume(TokenTypes.tokens.attr_right, "Expected ']]' after attribute declarations");
-      }
-      if (attributes.length == 0)
+      if (attributes.length == 0) {
         return null;
+      }
       return attributes;
     }
   };
@@ -3490,6 +3891,9 @@ void main() {
       super(name, attributes);
       this.members = [];
       this.align = 0;
+      this.startLine = -1;
+      this.endLine = -1;
+      this.inUse = false;
     }
     get isStruct() {
       return true;
@@ -3595,6 +3999,11 @@ void main() {
       this.stage = null;
       this.inputs = [];
       this.outputs = [];
+      this.resources = [];
+      this.startLine = -1;
+      this.endLine = -1;
+      this.inUse = false;
+      this.calls = /* @__PURE__ */ new Set();
       this.name = name;
       this.stage = stage;
     }
@@ -3614,6 +4023,14 @@ void main() {
       this.id = id;
     }
   };
+  var _FunctionResources = class {
+    constructor(node) {
+      this.resources = null;
+      this.inUse = false;
+      this.info = null;
+      this.node = node;
+    }
+  };
   var WgslReflect = class {
     constructor(code) {
       this.uniforms = [];
@@ -3624,7 +4041,9 @@ void main() {
       this.overrides = [];
       this.structs = [];
       this.entry = new EntryFunctions();
+      this.functions = [];
       this._types = /* @__PURE__ */ new Map();
+      this._functions = /* @__PURE__ */ new Map();
       if (code) {
         this.update(code);
       }
@@ -3635,14 +4054,20 @@ void main() {
     update(code) {
       const parser = new WgslParser();
       const ast = parser.parse(code);
+      for (const node of ast) {
+        if (node instanceof Function) {
+          this._functions.set(node.name, new _FunctionResources(node));
+        }
+      }
       for (const node of ast) {
         if (node instanceof Struct) {
           const info = this._getTypeInfo(node, null);
           if (info instanceof StructInfo) {
             this.structs.push(info);
           }
-          continue;
         }
+      }
+      for (const node of ast) {
         if (node instanceof Alias) {
           this.aliases.push(this._getAliasInfo(node));
           continue;
@@ -3701,8 +4126,15 @@ void main() {
           const fragmentStage = this._getAttribute(node, "fragment");
           const computeStage = this._getAttribute(node, "compute");
           const stage = vertexStage || fragmentStage || computeStage;
+          const fn = new FunctionInfo(node.name, stage === null || stage === void 0 ? void 0 : stage.name);
+          fn.startLine = node.startLine;
+          fn.endLine = node.endLine;
+          this.functions.push(fn);
+          this._functions.get(node.name).info = fn;
           if (stage) {
-            const fn = new FunctionInfo(node.name, stage.name);
+            this._functions.get(node.name).inUse = true;
+            fn.inUse = true;
+            fn.resources = this._findResources(node, !!stage);
             fn.inputs = this._getInputs(node.args);
             fn.outputs = this._getOutputs(node.returnType);
             this.entry[stage.name].push(fn);
@@ -3710,16 +4142,180 @@ void main() {
           continue;
         }
       }
+      for (const fn of this._functions.values()) {
+        if (fn.info) {
+          fn.info.inUse = fn.inUse;
+          this._addCalls(fn.node, fn.info.calls);
+        }
+      }
+      for (const u of this.uniforms) {
+        this._markStructsInUse(u.type);
+      }
+      for (const s of this.storage) {
+        this._markStructsInUse(s.type);
+      }
+    }
+    _markStructsInUse(type) {
+      if (type.isStruct) {
+        type.inUse = true;
+        for (const m of type.members) {
+          this._markStructsInUse(m.type);
+        }
+      } else if (type.isArray) {
+        this._markStructsInUse(type.format);
+      } else if (type.isTemplate) {
+        this._markStructsInUse(type.format);
+      } else {
+        const alias = this._getAlias(type.name);
+        if (alias) {
+          this._markStructsInUse(alias);
+        }
+      }
+    }
+    _addCalls(fn, calls) {
+      var _a2;
+      for (const call of fn.calls) {
+        const info = (_a2 = this._functions.get(call.name)) === null || _a2 === void 0 ? void 0 : _a2.info;
+        if (info) {
+          calls.add(info);
+        }
+      }
+    }
+    /// Find a resource by its group and binding.
+    findResource(group, binding) {
+      for (const u of this.uniforms) {
+        if (u.group == group && u.binding == binding) {
+          return u;
+        }
+      }
+      for (const s of this.storage) {
+        if (s.group == group && s.binding == binding) {
+          return s;
+        }
+      }
+      for (const t of this.textures) {
+        if (t.group == group && t.binding == binding) {
+          return t;
+        }
+      }
+      for (const s of this.samplers) {
+        if (s.group == group && s.binding == binding) {
+          return s;
+        }
+      }
+      return null;
+    }
+    _findResource(name) {
+      for (const u of this.uniforms) {
+        if (u.name == name) {
+          return u;
+        }
+      }
+      for (const s of this.storage) {
+        if (s.name == name) {
+          return s;
+        }
+      }
+      for (const t of this.textures) {
+        if (t.name == name) {
+          return t;
+        }
+      }
+      for (const s of this.samplers) {
+        if (s.name == name) {
+          return s;
+        }
+      }
+      return null;
+    }
+    _markStructsFromAST(type) {
+      const info = this._getTypeInfo(type, null);
+      this._markStructsInUse(info);
+    }
+    _findResources(fn, isEntry) {
+      const resources = [];
+      const self = this;
+      const varStack = [];
+      fn.search((node) => {
+        if (node instanceof _BlockStart) {
+          varStack.push({});
+        } else if (node instanceof _BlockEnd) {
+          varStack.pop();
+        } else if (node instanceof Var) {
+          const v = node;
+          if (isEntry && v.type !== null) {
+            this._markStructsFromAST(v.type);
+          }
+          if (varStack.length > 0) {
+            varStack[varStack.length - 1][v.name] = v;
+          }
+        } else if (node instanceof CreateExpr) {
+          const c = node;
+          if (isEntry && c.type !== null) {
+            this._markStructsFromAST(c.type);
+          }
+        } else if (node instanceof Let) {
+          const v = node;
+          if (isEntry && v.type !== null) {
+            this._markStructsFromAST(v.type);
+          }
+          if (varStack.length > 0) {
+            varStack[varStack.length - 1][v.name] = v;
+          }
+        } else if (node instanceof VariableExpr) {
+          const v = node;
+          if (varStack.length > 0) {
+            const varInfo2 = varStack[varStack.length - 1][v.name];
+            if (varInfo2) {
+              return;
+            }
+          }
+          const varInfo = self._findResource(v.name);
+          if (varInfo) {
+            resources.push(varInfo);
+          }
+        } else if (node instanceof CallExpr) {
+          const c = node;
+          const callFn = self._functions.get(c.name);
+          if (callFn) {
+            if (isEntry) {
+              callFn.inUse = true;
+            }
+            fn.calls.add(callFn.node);
+            if (callFn.resources === null) {
+              callFn.resources = self._findResources(callFn.node, isEntry);
+            }
+            resources.push(...callFn.resources);
+          }
+        } else if (node instanceof Call) {
+          const c = node;
+          const callFn = self._functions.get(c.name);
+          if (callFn) {
+            if (isEntry) {
+              callFn.inUse = true;
+            }
+            fn.calls.add(callFn.node);
+            if (callFn.resources === null) {
+              callFn.resources = self._findResources(callFn.node, isEntry);
+            }
+            resources.push(...callFn.resources);
+          }
+        }
+      });
+      return [...new Map(resources.map((r) => [r.name, r])).values()];
     }
     getBindGroups() {
       const groups = [];
       function _makeRoom(group, binding) {
-        if (group >= groups.length)
+        if (group >= groups.length) {
           groups.length = group + 1;
-        if (groups[group] === void 0)
+        }
+        if (groups[group] === void 0) {
           groups[group] = [];
-        if (binding >= groups[group].length)
+        }
+        if (binding >= groups[group].length) {
           groups[group].length = binding + 1;
+        }
       }
       for (const u of this.uniforms) {
         _makeRoom(u.group, u.binding);
@@ -3744,14 +4340,16 @@ void main() {
       return groups;
     }
     _getOutputs(type, outputs = void 0) {
-      if (outputs === void 0)
+      if (outputs === void 0) {
         outputs = [];
+      }
       if (type instanceof Struct) {
         this._getStructOutputs(type, outputs);
       } else {
         const output = this._getOutputInfo(type);
-        if (output !== null)
+        if (output !== null) {
           outputs.push(output);
+        }
       }
       return outputs;
     }
@@ -3781,15 +4379,17 @@ void main() {
       return null;
     }
     _getInputs(args, inputs = void 0) {
-      if (inputs === void 0)
+      if (inputs === void 0) {
         inputs = [];
+      }
       for (const arg of args) {
         if (arg.type instanceof Struct) {
           this._getStructInputs(arg.type, inputs);
         } else {
           const input = this._getInputInfo(arg);
-          if (input !== null)
+          if (input !== null) {
             inputs.push(input);
+          }
         }
       }
       return inputs;
@@ -3800,8 +4400,9 @@ void main() {
           this._getStructInputs(m.type, inputs);
         } else {
           const input = this._getInputInfo(m);
-          if (input !== null)
+          if (input !== null) {
             inputs.push(input);
+          }
         }
       }
     }
@@ -3834,8 +4435,9 @@ void main() {
     }
     _getAlias(name) {
       for (const a of this.aliases) {
-        if (a.name == name)
+        if (a.name == name) {
           return a.type;
+        }
       }
       return null;
     }
@@ -3859,6 +4461,8 @@ void main() {
       if (type instanceof Struct) {
         const s = type;
         const info2 = new StructInfo(s.name, attributes);
+        info2.startLine = s.startLine;
+        info2.endLine = s.endLine;
         for (const m of s.members) {
           const t = this._getTypeInfo(m.type, m.attributes);
           info2.members.push(new MemberInfo(m.name, t, m.attributes));
@@ -3911,8 +4515,9 @@ void main() {
       for (let mi = 0, ml = struct.members.length; mi < ml; ++mi) {
         const member = struct.members[mi];
         const sizeInfo = this._getTypeSize(member);
-        if (!sizeInfo)
+        if (!sizeInfo) {
           continue;
+        }
         (_a2 = this._getAlias(member.type.name)) !== null && _a2 !== void 0 ? _a2 : member.type;
         const align = sizeInfo.align;
         const size = sizeInfo.size;
@@ -3929,12 +4534,14 @@ void main() {
     }
     _getTypeSize(type) {
       var _a2;
-      if (type === null || type === void 0)
+      if (type === null || type === void 0) {
         return null;
+      }
       const explicitSize = this._getAttributeNum(type.attributes, "size", 0);
       const explicitAlign = this._getAttributeNum(type.attributes, "align", 0);
-      if (type instanceof MemberInfo)
+      if (type instanceof MemberInfo) {
         type = type.type;
+      }
       if (type instanceof TypeInfo) {
         const alias = this._getAlias(type.name);
         if (alias !== null) {
@@ -3967,8 +4574,9 @@ void main() {
         const N = arrayType.count;
         const stride = this._getAttributeNum((_a2 = type === null || type === void 0 ? void 0 : type.attributes) !== null && _a2 !== void 0 ? _a2 : null, "stride", this._roundUp(align, size));
         size = N * stride;
-        if (explicitSize)
+        if (explicitSize) {
           size = explicitSize;
+        }
         return new _TypeSize(Math.max(explicitAlign, align), Math.max(explicitSize, size));
       }
       if (type instanceof StructInfo) {
@@ -4005,18 +4613,21 @@ void main() {
     }
     _getAttribute(node, name) {
       const obj = node;
-      if (!obj || !obj["attributes"])
+      if (!obj || !obj["attributes"]) {
         return null;
+      }
       const attrs = obj["attributes"];
       for (let a of attrs) {
-        if (a.name == name)
+        if (a.name == name) {
           return a;
+        }
       }
       return null;
     }
     _getAttributeNum(attributes, name, defaultValue) {
-      if (attributes === null)
+      if (attributes === null) {
         return defaultValue;
+      }
       for (let a of attributes) {
         if (a.name == name) {
           let v = a !== null && a.value !== null ? a.value : defaultValue;
@@ -4076,10 +4687,10 @@ void main() {
     }
     for (const uniform of parsedWGSL.uniforms) {
       const members = [];
-      for (const member of uniform.type.members) {
+      for (const attribute of uniform.type?.members || []) {
         members.push({
-          name: member.name,
-          type: getType(member.type)
+          name: attribute.name,
+          type: getType(attribute.type)
         });
       }
       shaderLayout.bindings.push({
@@ -4099,7 +4710,7 @@ void main() {
         const type = getType(wgslAttribute.type);
         shaderLayout.attributes.push({
           name: wgslAttribute.name,
-          location: wgslAttribute.location,
+          location: Number(wgslAttribute.location),
           type
         });
       }
@@ -7847,17 +8458,11 @@ vec3 geometry_getNormal() {
     printRowMajor: true,
     _cartographicRadians: false
   };
-  globalThis.mathgl = globalThis.mathgl || {
-    config: {
-      ...DEFAULT_CONFIG
-    }
-  };
+  globalThis.mathgl = globalThis.mathgl || { config: { ...DEFAULT_CONFIG } };
   var config = globalThis.mathgl.config;
-  function formatValue(value, {
-    precision = config.precision
-  } = {}) {
+  function formatValue(value, { precision = config.precision } = {}) {
     value = round(value);
-    return "".concat(parseFloat(value.toPrecision(precision)));
+    return `${parseFloat(value.toPrecision(precision))}`;
   }
   function isArray(value) {
     return Array.isArray(value) || ArrayBuffer.isView(value) && !(value instanceof DataView);
@@ -7901,28 +8506,12 @@ vec3 geometry_getNormal() {
   }
 
   // ../../node_modules/@math.gl/core/dist/classes/base/math-array.js
-  function _extendableBuiltin(cls) {
-    function ExtendableBuiltin() {
-      var instance = Reflect.construct(cls, Array.from(arguments));
-      Object.setPrototypeOf(instance, Object.getPrototypeOf(this));
-      return instance;
-    }
-    ExtendableBuiltin.prototype = Object.create(cls.prototype, {
-      constructor: {
-        value: cls,
-        enumerable: false,
-        writable: true,
-        configurable: true
-      }
-    });
-    if (Object.setPrototypeOf) {
-      Object.setPrototypeOf(ExtendableBuiltin, cls);
-    } else {
-      ExtendableBuiltin.__proto__ = cls;
-    }
-    return ExtendableBuiltin;
-  }
-  var MathArray = class extends _extendableBuiltin(Array) {
+  var MathArray = class extends Array {
+    // Common methods
+    /**
+     * Clone the current object
+     * @returns a new copy of this object
+     */
     clone() {
       return new this.constructor().copy(this);
     }
@@ -7942,7 +8531,10 @@ vec3 geometry_getNormal() {
       return targetObject;
     }
     from(arrayOrObject) {
-      return Array.isArray(arrayOrObject) ? this.copy(arrayOrObject) : this.fromObject(arrayOrObject);
+      return Array.isArray(arrayOrObject) ? this.copy(arrayOrObject) : (
+        // @ts-ignore
+        this.fromObject(arrayOrObject)
+      );
     }
     to(arrayOrObject) {
       if (arrayOrObject === this) {
@@ -7953,18 +8545,20 @@ vec3 geometry_getNormal() {
     toTarget(target) {
       return target ? this.to(target) : this;
     }
+    /** @deprecated */
     toFloat32Array() {
       return new Float32Array(this);
     }
     toString() {
       return this.formatString(config);
     }
+    /** Formats string according to options */
     formatString(opts) {
       let string = "";
       for (let i = 0; i < this.ELEMENTS; ++i) {
         string += (i > 0 ? ", " : "") + formatValue(this[i], opts);
       }
-      return "".concat(opts.printTypes ? this.constructor.name : "", "[").concat(string, "]");
+      return `${opts.printTypes ? this.constructor.name : ""}[${string}]`;
     }
     equals(array) {
       if (!array || this.length !== array.length) {
@@ -7988,6 +8582,8 @@ vec3 geometry_getNormal() {
       }
       return true;
     }
+    // Modifiers
+    /** Negates all values in this object */
     negate() {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] = -this[i];
@@ -8005,12 +8601,14 @@ vec3 geometry_getNormal() {
       }
       return this.check();
     }
+    /** Minimal */
     min(vector) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] = Math.min(vector[i], this[i]);
       }
       return this.check();
     }
+    /** Maximal */
     max(vector) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] = Math.max(vector[i], this[i]);
@@ -8051,18 +8649,25 @@ vec3 geometry_getNormal() {
       }
       return this.check();
     }
+    /**
+     * Multiplies all elements by `scale`
+     * Note: `Matrix4.multiplyByScalar` only scales its 3x3 "minor"
+     */
     multiplyByScalar(scalar) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] *= scalar;
       }
       return this.check();
     }
+    // Debug checks
+    /** Throws an error if array length is incorrect or contains illegal values */
     check() {
       if (config.debug && !this.validate()) {
-        throw new Error("math.gl: ".concat(this.constructor.name, " some fields set to invalid numbers'"));
+        throw new Error(`math.gl: ${this.constructor.name} some fields set to invalid numbers'`);
       }
       return this;
     }
+    /** Returns false if the array length is incorrect or contains illegal values */
     validate() {
       let valid = this.length === this.ELEMENTS;
       for (let i = 0; i < this.ELEMENTS; ++i) {
@@ -8070,39 +8675,48 @@ vec3 geometry_getNormal() {
       }
       return valid;
     }
+    // three.js compatibility
+    /** @deprecated */
     sub(a) {
       return this.subtract(a);
     }
+    /** @deprecated */
     setScalar(a) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] = a;
       }
       return this.check();
     }
+    /** @deprecated */
     addScalar(a) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] += a;
       }
       return this.check();
     }
+    /** @deprecated */
     subScalar(a) {
       return this.addScalar(-a);
     }
+    /** @deprecated */
     multiplyScalar(scalar) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] *= scalar;
       }
       return this.check();
     }
+    /** @deprecated */
     divideScalar(a) {
       return this.multiplyByScalar(1 / a);
     }
+    /** @deprecated */
     clampScalar(min, max) {
       for (let i = 0; i < this.ELEMENTS; ++i) {
         this[i] = Math.min(Math.max(this[i], min), max);
       }
       return this.check();
     }
+    /** @deprecated */
     get elements() {
       return this;
     }
@@ -8122,13 +8736,13 @@ vec3 geometry_getNormal() {
   }
   function checkNumber(value) {
     if (!Number.isFinite(value)) {
-      throw new Error("Invalid number ".concat(JSON.stringify(value)));
+      throw new Error(`Invalid number ${JSON.stringify(value)}`);
     }
     return value;
   }
   function checkVector(v, length, callerName = "") {
     if (config.debug && !validateVector(v, length)) {
-      throw new Error("math.gl: ".concat(callerName, " some fields set to invalid numbers'"));
+      throw new Error(`math.gl: ${callerName} some fields set to invalid numbers'`);
     }
     return v;
   }
@@ -8253,19 +8867,29 @@ vec3 geometry_getNormal() {
 
   // ../../node_modules/@math.gl/core/dist/classes/base/matrix.js
   var Matrix = class extends MathArray {
+    // fromObject(object) {
+    //   const array = object.elements;
+    //   return this.fromRowMajor(array);
+    // }
+    // toObject(object) {
+    //   const array = object.elements;
+    //   this.toRowMajor(array);
+    //   return object;
+    // }
+    // TODO better override formatString?
     toString() {
       let string = "[";
       if (config.printRowMajor) {
         string += "row-major:";
         for (let row = 0; row < this.RANK; ++row) {
           for (let col = 0; col < this.RANK; ++col) {
-            string += " ".concat(this[col * this.RANK + row]);
+            string += ` ${this[col * this.RANK + row]}`;
           }
         }
       } else {
         string += "column-major:";
         for (let i = 0; i < this.ELEMENTS; ++i) {
-          string += " ".concat(this[i]);
+          string += ` ${this[i]}`;
         }
       }
       string += "]";
@@ -8274,9 +8898,11 @@ vec3 geometry_getNormal() {
     getElementIndex(row, col) {
       return col * this.RANK + row;
     }
+    // By default assumes row major indices
     getElement(row, col) {
       return this[col * this.RANK + row];
     }
+    // By default assumes row major indices
     setElement(row, col, value) {
       this[col * this.RANK + row] = checkNumber(value);
       return this;
@@ -9042,6 +9668,7 @@ vec3 geometry_getNormal() {
       this[15] = array[15];
       return this.check();
     }
+    // eslint-disable-next-line max-params
     set(m00, m10, m20, m30, m01, m11, m21, m31, m02, m12, m22, m32, m03, m13, m23, m33) {
       this[0] = m00;
       this[1] = m10;
@@ -9061,6 +9688,8 @@ vec3 geometry_getNormal() {
       this[15] = m33;
       return this.check();
     }
+    // accepts row major order, stores as column major
+    // eslint-disable-next-line max-params
     setRowMajor(m00, m01, m02, m03, m10, m11, m12, m13, m20, m21, m22, m23, m30, m31, m32, m33) {
       this[0] = m00;
       this[1] = m10;
@@ -9099,25 +9728,41 @@ vec3 geometry_getNormal() {
       result[15] = this[15];
       return result;
     }
+    // Constructors
+    /** Set to identity matrix */
     identity() {
       return this.copy(IDENTITY_MATRIX);
     }
+    /**
+     *
+     * @param object
+     * @returns self
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     fromObject(object) {
       return this.check();
     }
+    /**
+     * Calculates a 4x4 matrix from the given quaternion
+     * @param quaternion Quaternion to create matrix from
+     * @returns self
+     */
     fromQuaternion(quaternion) {
       fromQuat(this, quaternion);
       return this.check();
     }
+    /**
+     * Generates a frustum matrix with the given bounds
+     * @param view.left - Left bound of the frustum
+     * @param view.right - Right bound of the frustum
+     * @param view.bottom - Bottom bound of the frustum
+     * @param view.top - Top bound of the frustum
+     * @param view.near - Near bound of the frustum
+     * @param view.far - Far bound of the frustum. Can be set to Infinity.
+     * @returns self
+     */
     frustum(view) {
-      const {
-        left,
-        right,
-        bottom,
-        top,
-        near = DEFAULT_NEAR,
-        far = DEFAULT_FAR
-      } = view;
+      const { left, right, bottom, top, near = DEFAULT_NEAR, far = DEFAULT_FAR } = view;
       if (far === Infinity) {
         computeInfinitePerspectiveOffCenter(this, left, right, bottom, top, near);
       } else {
@@ -9125,35 +9770,47 @@ vec3 geometry_getNormal() {
       }
       return this.check();
     }
+    /**
+     * Generates a look-at matrix with the given eye position, focal point,
+     * and up axis
+     * @param view.eye - (vector) Position of the viewer
+     * @param view.center - (vector) Point the viewer is looking at
+     * @param view.up - (vector) Up axis
+     * @returns self
+     */
     lookAt(view) {
-      const {
-        eye,
-        center = [0, 0, 0],
-        up = [0, 1, 0]
-      } = view;
+      const { eye, center = [0, 0, 0], up = [0, 1, 0] } = view;
       lookAt(this, eye, center, up);
       return this.check();
     }
+    /**
+     * Generates a orthogonal projection matrix with the given bounds
+     * from "traditional" view space parameters
+     * @param view.left - Left bound of the frustum
+     * @param view.right number  Right bound of the frustum
+     * @param view.bottom - Bottom bound of the frustum
+     * @param view.top number  Top bound of the frustum
+     * @param view.near - Near bound of the frustum
+     * @param view.far number  Far bound of the frustum
+     * @returns self
+     */
     ortho(view) {
-      const {
-        left,
-        right,
-        bottom,
-        top,
-        near = DEFAULT_NEAR,
-        far = DEFAULT_FAR
-      } = view;
+      const { left, right, bottom, top, near = DEFAULT_NEAR, far = DEFAULT_FAR } = view;
       ortho(this, left, right, bottom, top, near, far);
       return this.check();
     }
+    /**
+     * Generates an orthogonal projection matrix with the same parameters
+     * as a perspective matrix (plus focalDistance)
+     * @param view.fovy Vertical field of view in radians
+     * @param view.aspect Aspect ratio. Typically viewport width / viewport height
+     * @param view.focalDistance Distance in the view frustum used for extent calculations
+     * @param view.near Near bound of the frustum
+     * @param view.far Far bound of the frustum
+     * @returns self
+     */
     orthographic(view) {
-      const {
-        fovy = DEFAULT_FOVY,
-        aspect = DEFAULT_ASPECT,
-        focalDistance = 1,
-        near = DEFAULT_NEAR,
-        far = DEFAULT_FAR
-      } = view;
+      const { fovy = DEFAULT_FOVY, aspect = DEFAULT_ASPECT, focalDistance = 1, near = DEFAULT_NEAR, far = DEFAULT_FAR } = view;
       checkRadians(fovy);
       const halfY = fovy / 2;
       const top = focalDistance * Math.tan(halfY);
@@ -9167,32 +9824,53 @@ vec3 geometry_getNormal() {
         far
       });
     }
+    /**
+     * Generates a perspective projection matrix with the given bounds
+     * @param view.fovy Vertical field of view in radians
+     * @param view.aspect Aspect ratio. typically viewport width/height
+     * @param view.near Near bound of the frustum
+     * @param view.far Far bound of the frustum
+     * @returns self
+     */
     perspective(view) {
-      const {
-        fovy = 45 * Math.PI / 180,
-        aspect = 1,
-        near = 0.1,
-        far = 500
-      } = view;
+      const { fovy = 45 * Math.PI / 180, aspect = 1, near = 0.1, far = 500 } = view;
       checkRadians(fovy);
       perspective(this, fovy, aspect, near, far);
       return this.check();
     }
+    // Accessors
     determinant() {
       return determinant(this);
     }
+    /**
+     * Extracts the non-uniform scale assuming the matrix is an affine transformation.
+     * The scales are the "lengths" of the column vectors in the upper-left 3x3 matrix.
+     * @param result
+     * @returns self
+     */
     getScale(result = [-0, -0, -0]) {
       result[0] = Math.sqrt(this[0] * this[0] + this[1] * this[1] + this[2] * this[2]);
       result[1] = Math.sqrt(this[4] * this[4] + this[5] * this[5] + this[6] * this[6]);
       result[2] = Math.sqrt(this[8] * this[8] + this[9] * this[9] + this[10] * this[10]);
       return result;
     }
+    /**
+     * Gets the translation portion, assuming the matrix is a affine transformation matrix.
+     * @param result
+     * @returns self
+     */
     getTranslation(result = [-0, -0, -0]) {
       result[0] = this[12];
       result[1] = this[13];
       result[2] = this[14];
       return result;
     }
+    /**
+     * Gets upper left 3x3 pure rotation matrix (non-scaling), assume affine transformation matrix
+     * @param result
+     * @param scaleResult
+     * @returns self
+     */
     getRotation(result, scaleResult) {
       result = result || [-0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0, -0];
       scaleResult = scaleResult || [-0, -0, -0];
@@ -9218,6 +9896,12 @@ vec3 geometry_getNormal() {
       result[15] = 1;
       return result;
     }
+    /**
+     *
+     * @param result
+     * @param scaleResult
+     * @returns self
+     */
     getRotationMatrix3(result, scaleResult) {
       result = result || [-0, -0, -0, -0, -0, -0, -0, -0, -0];
       scaleResult = scaleResult || [-0, -0, -0];
@@ -9236,6 +9920,7 @@ vec3 geometry_getNormal() {
       result[8] = this[10] * inverseScale2;
       return result;
     }
+    // Modifiers
     transpose() {
       transpose(this, this);
       return this.check();
@@ -9244,6 +9929,7 @@ vec3 geometry_getNormal() {
       invert(this, this);
       return this.check();
     }
+    // Operations
     multiplyLeft(a) {
       multiply(this, a, this);
       return this.check();
@@ -9252,33 +9938,68 @@ vec3 geometry_getNormal() {
       multiply(this, this, a);
       return this.check();
     }
+    // Rotates a matrix by the given angle around the X axis
     rotateX(radians) {
       rotateX(this, this, radians);
       return this.check();
     }
+    // Rotates a matrix by the given angle around the Y axis.
     rotateY(radians) {
       rotateY(this, this, radians);
       return this.check();
     }
+    /**
+     * Rotates a matrix by the given angle around the Z axis.
+     * @param radians
+     * @returns self
+     */
     rotateZ(radians) {
       rotateZ(this, this, radians);
       return this.check();
     }
+    /**
+     *
+     * @param param0
+     * @returns self
+     */
     rotateXYZ(angleXYZ) {
       return this.rotateX(angleXYZ[0]).rotateY(angleXYZ[1]).rotateZ(angleXYZ[2]);
     }
+    /**
+     *
+     * @param radians
+     * @param axis
+     * @returns self
+     */
     rotateAxis(radians, axis) {
       rotate(this, this, radians, axis);
       return this.check();
     }
+    /**
+     *
+     * @param factor
+     * @returns self
+     */
     scale(factor) {
       scale(this, this, Array.isArray(factor) ? factor : [factor, factor, factor]);
       return this.check();
     }
+    /**
+     *
+     * @param vec
+     * @returns self
+     */
     translate(vector) {
       translate(this, this, vector);
       return this.check();
     }
+    // Transforms
+    /**
+     * Transforms any 2, 3 or 4 element vector. 2 and 3 elements are treated as points
+     * @param vector
+     * @param result
+     * @returns self
+     */
     transform(vector, result) {
       if (vector.length === 4) {
         result = transformMat43(result || [-0, -0, -0, -0], vector, this);
@@ -9287,10 +10008,14 @@ vec3 geometry_getNormal() {
       }
       return this.transformAsPoint(vector, result);
     }
+    /**
+     * Transforms any 2 or 3 element array as point (w implicitly 1)
+     * @param vector
+     * @param result
+     * @returns self
+     */
     transformAsPoint(vector, result) {
-      const {
-        length
-      } = vector;
+      const { length } = vector;
       let out;
       switch (length) {
         case 2:
@@ -9305,6 +10030,12 @@ vec3 geometry_getNormal() {
       checkVector(out, vector.length);
       return out;
     }
+    /**
+     * Transforms any 2 or 3 element array as vector (w implicitly 0)
+     * @param vector
+     * @param result
+     * @returns self
+     */
     transformAsVector(vector, result) {
       let out;
       switch (vector.length) {
@@ -9320,15 +10051,19 @@ vec3 geometry_getNormal() {
       checkVector(out, vector.length);
       return out;
     }
+    /** @deprecated */
     transformPoint(vector, result) {
       return this.transformAsPoint(vector, result);
     }
+    /** @deprecated */
     transformVector(vector, result) {
       return this.transformAsPoint(vector, result);
     }
+    /** @deprecated */
     transformDirection(vector, result) {
       return this.transformAsVector(vector, result);
     }
+    // three.js math API compatibility
     makeRotationX(radians) {
       return this.identity().rotateX(radians);
     }