wikiparser-node 0.3.1 → 0.5.0

package/src/syntax.js

@@ -2,21 +2,23 @@
 
 const {undo} = require('../util/debug'),
 	{text} = require('../util/string'),
-	/** @type {Parser} */ Parser = require('..'),
+	Parser = require('..'),
 	Token = require('.');
 
 /**
  * 满足特定语法格式的plain Token
- * @classdesc `{childNodes: (string|Token)[]}`
+ * @classdesc `{childNodes: (AstText|Token)[]}`
  */
 class SyntaxToken extends Token {
 	#pattern;
 
 	/**
-	 * @param {?string} wikitext
-	 * @param {RegExp} pattern
+	 * @param {string} wikitext 语法wikitext
+	 * @param {RegExp} pattern 语法正则
+	 * @param {string} type Token.type
 	 * @param {accum} accum
-	 * @param {acceptable} acceptable
+	 * @param {acceptable} acceptable 可接受的子节点设置
+	 * @throws `RangeError` 含有g修饰符的语法正则
 	 */
 	constructor(wikitext, pattern, type = 'plain', config = Parser.getConfig(), accum = [], acceptable = null) {
 		if (pattern.global) {
@@ -27,8 +29,9 @@ class SyntaxToken extends Token {
 		this.#pattern = pattern;
 	}
 
+	/** @override */
 	cloneNode() {
-		const cloned = this.cloneChildren(),
+		const cloned = this.cloneChildNodes(),
 			config = this.getAttribute('config'),
 			acceptable = this.getAttribute('acceptable');
 		return Parser.run(() => {
@@ -38,33 +41,33 @@ class SyntaxToken extends Token {
 		});
 	}
 
+	/** @override */
 	afterBuild() {
-		const that = this,
-			/** @type {AstListener} */ syntaxListener = (e, data) => {
-				const pattern = that.#pattern;
-				if (!Parser.running && !pattern.test(that.text())) {
-					undo(e, data);
-					throw new Error(`不可修改 ${that.constructor.name} 的语法：/${pattern.source}/${pattern.flags}`);
-				}
-			};
+		const /** @type {AstListener} */ syntaxListener = (e, data) => {
+			const pattern = this.#pattern;
+			if (!Parser.running && !pattern.test(this.text())) {
+				undo(e, data);
+				Parser.error(`不可修改 ${this.constructor.name} 的语法！`, pattern);
+				throw new Error(`不可修改 ${this.constructor.name} 的语法！`);
+			}
+		};
 		this.addEventListener(['remove', 'insert', 'replace', 'text'], syntaxListener);
 		return this;
 	}
 
 	/**
+	 * @override
 	 * @template {string} T
-	 * @param {T} key
+	 * @param {T} key 属性键
 	 * @returns {TokenAttribute<T>}
 	 */
 	getAttribute(key) {
-		if (key === 'pattern') {
-			return this.#pattern;
-		}
-		return super.getAttribute(key);
+		return key === 'pattern' ? this.#pattern : super.getAttribute(key);
 	}
 
 	/**
-	 * @param {...string|Token} elements
+	 * @override
+	 * @param {...Token} elements 待替换的子节点
 	 * @complexity `n`
 	 */
 	replaceChildren(...elements) {