add types for error.js

Author: saschanaz

lib/error.js

@@ -1,4 +1,5 @@
 /** @import { Base } from "./productions/base.js" */
+/** @import { Source } from "./tokeniser.js" */
 
 /**
  * @param {string} text
@@ -8,6 +9,10 @@ function lastLine(text) {
   return splitted[splitted.length - 1];
 }
 
+/**
+ * @param {string} base
+ * @param {string} target
+ */
 function appendIfExist(base, target) {
   let result = base;
   if (target) {
@@ -37,10 +42,10 @@ function contextAsText(node) {
  *
  * @typedef {ReturnType<typeof error>} WebIDLErrorData
  *
- * @param {string} message error message
- * @param {*} position
+ * @param {Source} source
+ * @param {number} position
  * @param {*} current
- * @param {*} message
+ * @param {string} message error message
  * @param {"Syntax" | "Validation"} kind error type
  * @param {WebIDL2ErrorOptions=} options
  */

lib/tokeniser.js

@@ -125,6 +125,7 @@ const reserved = [
 
 /**
  * @typedef {ReturnType<typeof tokenise>[number]} Token
+ * @typedef {Token[] & { name?: string }} Source
  * @param {string} str
  */
 function tokenise(str) {
@@ -235,7 +236,7 @@ function tokenise(str) {
 export class Tokeniser {
   /** @type {Base} */
   current;
-  /** @type {Token[] & { name?: string }} */
+  /** @type {Source} */
   source;
 
   /**