links-notation 0.27.0 → 0.28.0

package/dist/index.js

@@ -235,9 +235,16 @@ function unescapeReference(reference) {
   }
   return reading.value;
 }
+function referenceQuote(raw) {
+  if (typeof raw !== "string" || !QUOTES.includes(raw[0]))
+    return null;
+  const reading = readReference(raw, 0);
+  return reading !== null && reading.length === raw.length ? raw[0] : null;
+}
 
 // src/Link.js
 class Link {
+  #rawId = null;
   constructor(id = null, values = null) {
     this.id = id;
     if (values !== null && values !== undefined) {
@@ -249,6 +256,18 @@ class Link {
       this.values = [];
     }
   }
+  get rawId() {
+    return this.#rawId;
+  }
+  set rawId(raw) {
+    if (raw !== null && raw !== undefined && typeof raw !== "string") {
+      throw new TypeError("rawId must be a string or null");
+    }
+    this.#rawId = raw ?? null;
+  }
+  get quote() {
+    return referenceQuote(this.#rawId);
+  }
   toString() {
     return this.format(false);
   }
@@ -460,6 +479,197 @@ function formatLinks(links, lessParentheses = false) {
   return links.map((link) => link.format(lessParentheses)).join(`
 `);
 }
+// src/comments.js
+var COMMENT = "#";
+var BEFORE_REFERENCE = [" ", "\t", `
+`, "\r", "(", ":"];
+var BEFORE_COMMENT = [" ", "\t", `
+`, "\r"];
+function stripComments(document) {
+  let blanked = null;
+  let position = 0;
+  const references = new DelimitedReferences(document);
+  while (position < document.length) {
+    const character = document[position];
+    if (QUOTES.includes(character) && follows(document, position, BEFORE_REFERENCE)) {
+      const end = references.endAt(position);
+      position = end === null ? position + 1 : end;
+      continue;
+    }
+    if (character === COMMENT && follows(document, position, BEFORE_COMMENT)) {
+      blanked = blanked ?? document.split("");
+      while (position < document.length && document[position] !== `
+` && document[position] !== "\r") {
+        blanked[position] = " ";
+        position++;
+      }
+      continue;
+    }
+    position++;
+  }
+  return blanked === null ? document : blanked.join("");
+}
+function follows(document, position, allowed) {
+  return position === 0 || allowed.includes(document[position - 1]);
+}
+
+// src/Cst.js
+var CstKind = Object.freeze({
+  DOCUMENT: "document",
+  LINE: "line",
+  GROUP: "group",
+  WHITESPACE: "whitespace",
+  NEWLINE: "newline",
+  COMMENT: "comment",
+  OPEN_PAREN: "open_paren",
+  CLOSE_PAREN: "close_paren",
+  COLON: "colon",
+  REFERENCE: "reference"
+});
+var NODE_KINDS = new Set([CstKind.DOCUMENT, CstKind.LINE, CstKind.GROUP]);
+
+class CstNode {
+  #text;
+  constructor(kind, { text = "", children = [], value = null, quote = null } = {}) {
+    this.kind = kind;
+    this.children = children;
+    this.value = value;
+    this.quote = quote;
+    this.#text = text;
+  }
+  get isToken() {
+    return !NODE_KINDS.has(this.kind);
+  }
+  get text() {
+    if (this.isToken)
+      return this.#text;
+    return this.children.map((child) => child.text).join("");
+  }
+  toString() {
+    return this.text;
+  }
+  tokens() {
+    if (this.isToken)
+      return [this];
+    return this.children.flatMap((child) => child.tokens());
+  }
+  toSExpression() {
+    if (this.isToken)
+      return `${this.kind}:${quoteText(this.#text)}`;
+    return `(${[this.kind, ...this.children.map((child) => child.toSExpression())].join(" ")})`;
+  }
+}
+var ESCAPES = {
+  "\\": "\\\\",
+  '"': "\\\"",
+  "\n": "\\n",
+  "\r": "\\r",
+  "\t": "\\t"
+};
+function quoteText(text) {
+  return `"${text.replace(/[\\"\n\r\t]/g, (character) => ESCAPES[character])}"`;
+}
+var LITERAL_PAYLOAD_END = new Set(["}", " ", "\t", "\r", `
+`, "(", ")"]);
+function literalEnd(text, start) {
+  if (text[start] !== "~")
+    return -1;
+  let index = start + 1;
+  while (index < text.length && text[index] >= "0" && text[index] <= "9") {
+    index++;
+  }
+  if (index === start + 1 || text[index] !== "{")
+    return -1;
+  index++;
+  while (index < text.length && !LITERAL_PAYLOAD_END.has(text[index])) {
+    index++;
+  }
+  return text[index] === "}" ? index + 1 : -1;
+}
+var BARE_REFERENCE_END = new Set([" ", "\t", "\r", `
+`, "(", ":", ")"]);
+function buildCst(input, { comments = true } = {}) {
+  const prepared = comments ? stripComments(input) : input;
+  const references = new DelimitedReferences(prepared);
+  const document = new CstNode(CstKind.DOCUMENT);
+  const containers = [{ node: document, line: null }];
+  const add = (token) => {
+    const container = containers[containers.length - 1];
+    if (container.line === null) {
+      container.line = new CstNode(CstKind.LINE);
+      container.node.children.push(container.line);
+    }
+    container.line.children.push(token);
+  };
+  const token = (kind, start, end, parts = {}) => new CstNode(kind, { text: input.slice(start, end), ...parts });
+  let position = 0;
+  while (position < input.length) {
+    const character = input[position];
+    let end = position + 1;
+    if (comments && character === "#" && prepared[position] !== "#") {
+      while (end < input.length && input[end] !== `
+` && input[end] !== "\r") {
+        end++;
+      }
+      add(token(CstKind.COMMENT, position, end));
+    } else if (character === "\r" || character === `
+`) {
+      if (character === "\r" && input[end] === `
+`)
+        end++;
+      add(token(CstKind.NEWLINE, position, end));
+      containers[containers.length - 1].line = null;
+    } else if (character === " " || character === "\t") {
+      while (end < input.length && (input[end] === " " || input[end] === "\t")) {
+        end++;
+      }
+      add(token(CstKind.WHITESPACE, position, end));
+    } else if (character === "(") {
+      const group = new CstNode(CstKind.GROUP, {
+        children: [token(CstKind.OPEN_PAREN, position, end)]
+      });
+      add(group);
+      containers.push({ node: group, line: null });
+    } else if (character === ")") {
+      if (containers.length === 1) {
+        throw new SyntaxError(`Unbalanced ")" at offset ${position}`);
+      }
+      containers.pop().node.children.push(token(CstKind.CLOSE_PAREN, position, end));
+    } else if (character === ":") {
+      add(token(CstKind.COLON, position, end));
+    } else {
+      end = referenceEnd(prepared, position, references);
+      const text = input.slice(position, end);
+      const quoted = QUOTES.includes(character) && references.readAt(position);
+      add(token(CstKind.REFERENCE, position, end, {
+        value: quoted ? quoted.value : character === "~" && isLiteral(prepared, position, end) ? decodeReferenceLiteral(text) : text,
+        quote: quoted ? character : null
+      }));
+    }
+    position = end;
+  }
+  if (containers.length !== 1) {
+    throw new SyntaxError('Unbalanced "(" at the end of the document');
+  }
+  return document;
+}
+function referenceEnd(prepared, start, references) {
+  const literal = literalEnd(prepared, start);
+  if (literal !== -1)
+    return literal;
+  if (QUOTES.includes(prepared[start])) {
+    const end = references.endAt(start);
+    if (end !== null)
+      return end;
+  }
+  let end = start + 1;
+  while (end < prepared.length && !BARE_REFERENCE_END.has(prepared[end]))
+    end++;
+  return end;
+}
+function isLiteral(prepared, start, end) {
+  return literalEnd(prepared, start) === end;
+}
 // src/LinksGroup.js
 class LinksGroup {
   constructor(element, children = []) {
@@ -564,40 +774,6 @@ function windowAround(lineText, column) {
   return [quoted, target - start + shift + 1];
 }
 
-// src/comments.js
-var COMMENT = "#";
-var BEFORE_REFERENCE = [" ", "\t", `
-`, "\r", "(", ":"];
-var BEFORE_COMMENT = [" ", "\t", `
-`, "\r"];
-function stripComments(document) {
-  let blanked = null;
-  let position = 0;
-  const references = new DelimitedReferences(document);
-  while (position < document.length) {
-    const character = document[position];
-    if (QUOTES.includes(character) && follows(document, position, BEFORE_REFERENCE)) {
-      const end = references.endAt(position);
-      position = end === null ? position + 1 : end;
-      continue;
-    }
-    if (character === COMMENT && follows(document, position, BEFORE_COMMENT)) {
-      blanked = blanked ?? document.split("");
-      while (position < document.length && document[position] !== `
-` && document[position] !== "\r") {
-        blanked[position] = " ";
-        position++;
-      }
-      continue;
-    }
-    position++;
-  }
-  return blanked === null ? document : blanked.join("");
-}
-function follows(document, position, allowed) {
-  return position === 0 || allowed.includes(document[position - 1]);
-}
-
 // src/parser-generated.js
 class peg$SyntaxError extends SyntaxError {
   constructor(message, expected, found, location) {
@@ -789,8 +965,8 @@ function peg$parse(input, options) {
   function peg$f11(l) {
     return l;
   }
-  function peg$f12(i) {
-    return { id: i };
+  function peg$f12(r) {
+    return { id: r.value, rawId: r.raw };
   }
   function peg$f13(g, rest) {
     return rest === null ? g : { values: [g].concat(rest) };
@@ -834,27 +1010,31 @@ function peg$parse(input, options) {
     return list;
   }
   function peg$f26(id, v) {
-    return { id, values: v };
+    return { id: id.value, rawId: id.raw, values: v };
   }
   function peg$f27(v) {
     return { values: v };
   }
   function peg$f28(id) {
-    return { id, values: [] };
+    return { id: id.value, rawId: id.raw, values: [] };
+  }
+  function peg$f29(value) {
+    const { start, end } = range();
+    return { value, raw: source.slice(start, end) };
   }
-  function peg$f29() {
+  function peg$f30() {
     return hasReferenceLiteralPrefix(input, offset());
   }
-  function peg$f30(literal) {
+  function peg$f31(literal) {
     return decodeReferenceLiteral(literal);
   }
-  function peg$f31() {
+  function peg$f32() {
     return !hasReferenceLiteralPrefix(input, offset());
   }
-  function peg$f32(chars) {
+  function peg$f33(chars) {
     return chars.join("");
   }
-  function peg$f33() {
+  function peg$f34() {
     const pos = offset();
     const result = parseQuotedStringAt(input, pos, '"');
     if (result) {
@@ -864,19 +1044,19 @@ function peg$parse(input, options) {
     }
     return false;
   }
-  function peg$f34(chars) {
+  function peg$f35(chars) {
     return parsedValue;
   }
-  function peg$f35(c, cs) {
+  function peg$f36(c, cs) {
     return [c].concat(cs).join("");
   }
-  function peg$f36() {
+  function peg$f37() {
     return parsedLength > 1 && (parsedLength--, true);
   }
-  function peg$f37(c) {
+  function peg$f38(c) {
     return c;
   }
-  function peg$f38() {
+  function peg$f39() {
     const pos = offset();
     const result = parseQuotedStringAt(input, pos, "'");
     if (result) {
@@ -886,19 +1066,19 @@ function peg$parse(input, options) {
     }
     return false;
   }
-  function peg$f39(chars) {
+  function peg$f40(chars) {
     return parsedValue;
   }
-  function peg$f40(c, cs) {
+  function peg$f41(c, cs) {
     return [c].concat(cs).join("");
   }
-  function peg$f41() {
+  function peg$f42() {
     return parsedLength > 1 && (parsedLength--, true);
   }
-  function peg$f42(c) {
+  function peg$f43(c) {
     return c;
   }
-  function peg$f43() {
+  function peg$f44() {
     const pos = offset();
     const result = parseQuotedStringAt(input, pos, "`");
     if (result) {
@@ -908,34 +1088,34 @@ function peg$parse(input, options) {
     }
     return false;
   }
-  function peg$f44(chars) {
+  function peg$f45(chars) {
     return parsedValue;
   }
-  function peg$f45(c, cs) {
+  function peg$f46(c, cs) {
     return [c].concat(cs).join("");
   }
-  function peg$f46() {
+  function peg$f47() {
     return parsedLength > 1 && (parsedLength--, true);
   }
-  function peg$f47(c) {
+  function peg$f48(c) {
     return c;
   }
-  function peg$f48() {
+  function peg$f49() {
     return indentationStack.slice();
   }
-  function peg$f49(spaces) {
+  function peg$f50(spaces) {
     setBaseIndentation(spaces);
   }
-  function peg$f50(spaces) {
+  function peg$f51(spaces) {
     return normalizeIndentation(spaces) > getCurrentIndentation();
   }
-  function peg$f51(spaces) {
+  function peg$f52(spaces) {
     pushIndentation(spaces);
   }
-  function peg$f52(spaces) {
+  function peg$f53(spaces) {
     return checkIndentation(spaces);
   }
-  function peg$f53() {
+  function peg$f54() {
     return isInsideNestedContext();
   }
   let peg$currPos = options.peg$currPos | 0;
@@ -1781,6 +1961,17 @@ function peg$parse(input, options) {
     return s0;
   }
   function peg$parsereference() {
+    let s0, s1;
+    s0 = peg$currPos;
+    s1 = peg$parsereferenceValue();
+    if (s1 !== peg$FAILED) {
+      peg$savedPos = s0;
+      s1 = peg$f29(s1);
+    }
+    s0 = s1;
+    return s0;
+  }
+  function peg$parsereferenceValue() {
     let s0;
     s0 = peg$parsereferenceLiteral();
     if (s0 === peg$FAILED) {
@@ -1814,7 +2005,7 @@ function peg$parse(input, options) {
     }
     if (s1 !== peg$FAILED) {
       peg$savedPos = peg$currPos;
-      s2 = peg$f29();
+      s2 = peg$f30();
       if (s2) {
         s2 = undefined;
       } else {
@@ -1927,7 +2118,7 @@ function peg$parse(input, options) {
         }
         if (s3 !== peg$FAILED) {
           peg$savedPos = s0;
-          s0 = peg$f30(s3);
+          s0 = peg$f31(s3);
         } else {
           peg$currPos = s0;
           s0 = peg$FAILED;
@@ -1946,7 +2137,7 @@ function peg$parse(input, options) {
     let s0, s1, s2, s3;
     s0 = peg$currPos;
     peg$savedPos = peg$currPos;
-    s1 = peg$f31();
+    s1 = peg$f32();
     if (s1) {
       s1 = undefined;
     } else {
@@ -1965,7 +2156,7 @@ function peg$parse(input, options) {
       }
       if (s2 !== peg$FAILED) {
         peg$savedPos = s0;
-        s0 = peg$f32(s2);
+        s0 = peg$f33(s2);
       } else {
         peg$currPos = s0;
         s0 = peg$FAILED;
@@ -2010,7 +2201,7 @@ function peg$parse(input, options) {
     }
     if (s1 !== peg$FAILED) {
       peg$savedPos = peg$currPos;
-      s2 = peg$f33();
+      s2 = peg$f34();
       if (s2) {
         s2 = undefined;
       } else {
@@ -2020,7 +2211,7 @@ function peg$parse(input, options) {
         s3 = peg$parseconsumeDouble();
         if (s3 !== peg$FAILED) {
           peg$savedPos = s0;
-          s0 = peg$f34(s3);
+          s0 = peg$f35(s3);
         } else {
           peg$currPos = s0;
           s0 = peg$FAILED;
@@ -2055,7 +2246,7 @@ function peg$parse(input, options) {
         s3 = peg$parseconsumeDoubleMore();
       }
       peg$savedPos = s0;
-      s0 = peg$f35(s1, s2);
+      s0 = peg$f36(s1, s2);
     } else {
       peg$currPos = s0;
       s0 = peg$FAILED;
@@ -2066,7 +2257,7 @@ function peg$parse(input, options) {
     let s0, s1, s2;
     s0 = peg$currPos;
     peg$savedPos = peg$currPos;
-    s1 = peg$f36();
+    s1 = peg$f37();
     if (s1) {
       s1 = undefined;
     } else {
@@ -2084,7 +2275,7 @@ function peg$parse(input, options) {
       }
       if (s2 !== peg$FAILED) {
         peg$savedPos = s0;
-        s0 = peg$f37(s2);
+        s0 = peg$f38(s2);
       } else {
         peg$currPos = s0;
         s0 = peg$FAILED;
@@ -2118,7 +2309,7 @@ function peg$parse(input, options) {
     }
     if (s1 !== peg$FAILED) {
       peg$savedPos = peg$currPos;
-      s2 = peg$f38();
+      s2 = peg$f39();
       if (s2) {
         s2 = undefined;
       } else {
@@ -2128,7 +2319,7 @@ function peg$parse(input, options) {
         s3 = peg$parseconsumeSingle();
         if (s3 !== peg$FAILED) {
           peg$savedPos = s0;
-          s0 = peg$f39(s3);
+          s0 = peg$f40(s3);
         } else {
           peg$currPos = s0;
           s0 = peg$FAILED;
@@ -2163,7 +2354,7 @@ function peg$parse(input, options) {
         s3 = peg$parseconsumeSingleMore();
       }
       peg$savedPos = s0;
-      s0 = peg$f40(s1, s2);
+      s0 = peg$f41(s1, s2);
     } else {
       peg$currPos = s0;
       s0 = peg$FAILED;
@@ -2174,7 +2365,7 @@ function peg$parse(input, options) {
     let s0, s1, s2;
     s0 = peg$currPos;
     peg$savedPos = peg$currPos;
-    s1 = peg$f41();
+    s1 = peg$f42();
     if (s1) {
       s1 = undefined;
     } else {
@@ -2192,7 +2383,7 @@ function peg$parse(input, options) {
       }
       if (s2 !== peg$FAILED) {
         peg$savedPos = s0;
-        s0 = peg$f42(s2);
+        s0 = peg$f43(s2);
       } else {
         peg$currPos = s0;
         s0 = peg$FAILED;
@@ -2226,7 +2417,7 @@ function peg$parse(input, options) {
     }
     if (s1 !== peg$FAILED) {
       peg$savedPos = peg$currPos;
-      s2 = peg$f43();
+      s2 = peg$f44();
       if (s2) {
         s2 = undefined;
       } else {
@@ -2236,7 +2427,7 @@ function peg$parse(input, options) {
         s3 = peg$parseconsumeBacktick();
         if (s3 !== peg$FAILED) {
           peg$savedPos = s0;
-          s0 = peg$f44(s3);
+          s0 = peg$f45(s3);
         } else {
           peg$currPos = s0;
           s0 = peg$FAILED;
@@ -2271,7 +2462,7 @@ function peg$parse(input, options) {
         s3 = peg$parseconsumeBacktickMore();
       }
       peg$savedPos = s0;
-      s0 = peg$f45(s1, s2);
+      s0 = peg$f46(s1, s2);
     } else {
       peg$currPos = s0;
       s0 = peg$FAILED;
@@ -2282,7 +2473,7 @@ function peg$parse(input, options) {
     let s0, s1, s2;
     s0 = peg$currPos;
     peg$savedPos = peg$currPos;
-    s1 = peg$f46();
+    s1 = peg$f47();
     if (s1) {
       s1 = undefined;
     } else {
@@ -2300,7 +2491,7 @@ function peg$parse(input, options) {
       }
       if (s2 !== peg$FAILED) {
         peg$savedPos = s0;
-        s0 = peg$f47(s2);
+        s0 = peg$f48(s2);
       } else {
         peg$currPos = s0;
         s0 = peg$FAILED;
@@ -2316,7 +2507,7 @@ function peg$parse(input, options) {
     s0 = peg$currPos;
     s1 = "";
     peg$savedPos = s0;
-    s1 = peg$f48();
+    s1 = peg$f49();
     s0 = s1;
     return s0;
   }
@@ -2346,7 +2537,7 @@ function peg$parse(input, options) {
       }
     }
     peg$savedPos = s0;
-    s1 = peg$f49(s1);
+    s1 = peg$f50(s1);
     s0 = s1;
     return s0;
   }
@@ -2376,7 +2567,7 @@ function peg$parse(input, options) {
       }
     }
     peg$savedPos = peg$currPos;
-    s2 = peg$f50(s1);
+    s2 = peg$f51(s1);
     if (s2) {
       s2 = undefined;
     } else {
@@ -2384,7 +2575,7 @@ function peg$parse(input, options) {
     }
     if (s2 !== peg$FAILED) {
       peg$savedPos = s0;
-      s0 = peg$f51(s1);
+      s0 = peg$f52(s1);
     } else {
       peg$currPos = s0;
       s0 = peg$FAILED;
@@ -2417,7 +2608,7 @@ function peg$parse(input, options) {
       }
     }
     peg$savedPos = peg$currPos;
-    s2 = peg$f52(s1);
+    s2 = peg$f53(s1);
     if (s2) {
       s2 = undefined;
     } else {
@@ -2628,7 +2819,7 @@ function peg$parse(input, options) {
     let s0, s1, s2, s3;
     s0 = peg$currPos;
     peg$savedPos = peg$currPos;
-    s1 = peg$f53();
+    s1 = peg$f54();
     if (s1) {
       s1 = undefined;
     } else {
@@ -2755,6 +2946,7 @@ function peg$parse(input, options) {
   let contextStack = [];
   let contextDepth = 0;
   const maxDepth = options.maxDepth ?? Infinity;
+  const source = options.source ?? input;
   let unreadableLines = new Set;
   function resetState() {
     indentationStack = [0];
@@ -2870,6 +3062,7 @@ class Parser {
     this.maxInputSize = options.maxInputSize || 10 * 1024 * 1024;
     this.maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
     this.comments = options.comments ?? true;
+    this.syntax = options.syntax ?? true;
   }
   parse(input) {
     return this._parse(input, (raw) => this.transformResult(raw));
@@ -2877,6 +3070,10 @@ class Parser {
   parseGroups(input) {
     return this._parse(input, (raw) => raw.map((item) => this._transformGroup(item)));
   }
+  parseCst(input) {
+    this.parse(input);
+    return buildCst(input, { comments: this.comments });
+  }
   _transformGroup(item) {
     return new LinksGroup(this.transformLink(item), (item.children || []).map((child) => this._transformGroup(child)));
   }
@@ -2890,7 +3087,8 @@ class Parser {
     const prepared = this.comments ? stripComments(input) : input;
     try {
       const rawResult = peg$parse(prepared, {
-        maxDepth: this.maxDepth
+        maxDepth: this.maxDepth,
+        source: input
       });
       return transform(rawResult);
     } catch (error) {
@@ -2920,6 +3118,7 @@ class Parser {
         const childValues = item.children.map((child) => this.transformIndentedValue(child));
         const linkWithChildren = {
           id: item.id,
+          rawId: item.rawId,
           values: childValues
         };
         const currentLink = this.transformLink(linkWithChildren);
@@ -2952,14 +3151,14 @@ class Parser {
   transformIndentedValue(item) {
     const children = item.children || [];
     if (children.length && item.id != null && !item.values?.length) {
-      return new Link(item.id, children.map((child) => this.transformIndentedValue(child)));
+      return this._withRawId(new Link(item.id, children.map((child) => this.transformIndentedValue(child))), item);
     }
     const current = this.transformLink(item);
     if (children.length) {
-      return new Link(current.id, [
+      return this._withRawId(new Link(current.id, [
         ...current.values,
         ...children.map((child) => this.transformIndentedValue(child))
-      ]);
+      ]), item);
     }
     if (item.id == null && item.nested === undefined && current.values.length === 1) {
       return current.values[0];
@@ -3004,14 +3203,20 @@ class Parser {
       return this.transformNested(item.nested);
     }
     if (item.id !== undefined && !item.values && !item.children) {
-      return new Link(item.id);
+      return this._withRawId(new Link(item.id), item);
     }
     if (item.values && Array.isArray(item.values)) {
-      const link = new Link(item.id ?? null, []);
+      const link = this._withRawId(new Link(item.id ?? null, []), item);
       link.values = item.values.map((v) => this.transformLink(v));
       return link;
     }
-    return new Link(item.id ?? null, []);
+    return this._withRawId(new Link(item.id ?? null, []), item);
+  }
+  _withRawId(link, item) {
+    if (this.syntax && link.id !== null && typeof item.rawId === "string") {
+      link.rawId = item.rawId;
+    }
+    return link;
   }
 }
 
@@ -3072,8 +3277,104 @@ function formatIndentedDocument(entries) {
 `) + `
 ` : "";
 }
+// src/Emitter.js
+class Emitter {
+  #listeners = new Map;
+  on(event, listener) {
+    return this.#add(event, listener, false, false);
+  }
+  addListener(event, listener) {
+    return this.on(event, listener);
+  }
+  prependListener(event, listener) {
+    return this.#add(event, listener, false, true);
+  }
+  once(event, listener) {
+    return this.#add(event, listener, true, false);
+  }
+  prependOnceListener(event, listener) {
+    return this.#add(event, listener, true, true);
+  }
+  off(event, listener) {
+    checkListener(listener);
+    const entries = this.#listeners.get(event);
+    if (!entries)
+      return this;
+    const entry = entries.findLast((entry) => entry.listener === listener);
+    if (entry)
+      this.#remove(event, entry);
+    return this;
+  }
+  removeListener(event, listener) {
+    return this.off(event, listener);
+  }
+  removeAllListeners(event) {
+    if (event === undefined) {
+      this.#listeners.clear();
+    } else {
+      this.#listeners.delete(event);
+    }
+    return this;
+  }
+  emit(event, ...arguments_) {
+    const entries = this.#listeners.get(event);
+    if (!entries || entries.length === 0) {
+      if (event === "error") {
+        const error = arguments_[0];
+        if (error instanceof Error)
+          throw error;
+        throw new Error(`Unhandled error. (${String(error)})`);
+      }
+      return false;
+    }
+    for (const entry of [...entries]) {
+      if (entry.once)
+        this.#remove(event, entry);
+      entry.listener.apply(this, arguments_);
+    }
+    return true;
+  }
+  listeners(event) {
+    return (this.#listeners.get(event) ?? []).map((entry) => entry.listener);
+  }
+  listenerCount(event) {
+    return this.#listeners.get(event)?.length ?? 0;
+  }
+  eventNames() {
+    return [...this.#listeners.keys()];
+  }
+  #remove(event, entry) {
+    const entries = this.#listeners.get(event);
+    const index = entries?.indexOf(entry) ?? -1;
+    if (index === -1)
+      return;
+    entries.splice(index, 1);
+    if (entries.length === 0)
+      this.#listeners.delete(event);
+  }
+  #add(event, listener, once, prepend) {
+    checkListener(listener);
+    let entries = this.#listeners.get(event);
+    if (!entries) {
+      entries = [];
+      this.#listeners.set(event, entries);
+    }
+    const entry = { listener, once };
+    if (prepend) {
+      entries.unshift(entry);
+    } else {
+      entries.push(entry);
+    }
+    return this;
+  }
+}
+function checkListener(listener) {
+  if (typeof listener !== "function") {
+    throw new TypeError(`The "listener" argument must be a function. Received ${typeof listener}`);
+  }
+}
+
 // src/StreamParser.js
-import { EventEmitter } from "events";
 var DEFAULT_MAX_BUFFER_SIZE = 10 * 1024 * 1024;
 
 class StreamParseError extends Error {
@@ -3094,7 +3395,7 @@ class StreamParseError extends Error {
   }
 }
 
-class StreamParser extends EventEmitter {
+class StreamParser extends Emitter {
   constructor(options = {}) {
     super();
     this.parser = options.parser ?? new Parser(options);
@@ -3889,6 +4190,8 @@ export {
   ArityRange,
   BinaryLinoCodec,
   BinaryLinoOptions,
+  CstKind,
+  CstNode,
   DEFAULT_MAX_DEPTH,
   DecodeLimits,
   External,
@@ -3911,6 +4214,7 @@ export {
   formatIndentedDocument,
   formatLinks,
   parseIndentedDocument,
+  referenceQuote,
   stripComments,
   unescapeReference
 };