wikiparser-node 0.10.0 → 0.11.0-m

package/lib/node.js

@@ -1,34 +1,17 @@
 'use strict';
 
-const {text} = require('../util/string'),
-	{typeError} = require('../util/debug'),
-	assert = require('assert/strict'),
-	EventEmitter = require('events'),
-	Parser = require('..');
+/**
+ * @template T
+ * @typedef {import('../typings/node').TokenAttribute<T>} TokenAttribute
+ */
+
+const {text} = require('../util/string');
 
 /** 类似Node */
 class AstNode {
 	/** @type {string} */ type;
 	/** @type {this[]} */ childNodes = [];
 	/** @type {this} */ #parentNode;
-	/** @type {Set<string>} */ #optional = new Set();
-	#events = new EventEmitter();
-
-	/**
-	 * 检查在某个位置增删子节点是否合法
-	 * @param {number} i 增删位置
-	 * @param {number} addition 将会插入的子节点个数
-	 * @throws `RangeError` 指定位置不存在子节点
-	 */
-	#verifyChild = (i, addition = 0) => {
-		if (!Number.isInteger(i)) {
-			this.typeError('verifyChild', 'Number');
-		}
-		const {childNodes: {length}} = this;
-		if (i < -length || i >= length + addition) {
-			throw new RangeError(`不存在第 ${i} 个子节点！`);
-		}
-	};
 
 	/** 首位子节点 */
 	get firstChild() {
@@ -63,158 +46,6 @@ class AstNode {
 		return childNodes && childNodes[childNodes.indexOf(this) - 1];
 	}
 
-	/**
-	 * 后一个非文本兄弟节点
-	 * @complexity `n`
-	 * @returns {this}
-	 */
-	get nextElementSibling() {
-		const childNodes = this.#parentNode?.childNodes,
-			i = childNodes?.indexOf(this);
-		return childNodes?.slice(i + 1)?.find(({type}) => type !== 'text');
-	}
-
-	/**
-	 * 前一个非文本兄弟节点
-	 * @complexity `n`
-	 * @returns {this}
-	 */
-	get previousElementSibling() {
-		const childNodes = this.#parentNode?.childNodes,
-			i = childNodes?.indexOf(this);
-		return childNodes?.slice(0, i)?.findLast(({type}) => type !== 'text');
-	}
-
-	/** 是否具有根节点 */
-	get isConnected() {
-		return this.getRootNode().type === 'root';
-	}
-
-	/** 不是自身的根节点 */
-	get ownerDocument() {
-		const root = this.getRootNode();
-		return root.type === 'root' && root !== this ? root : undefined;
-	}
-
-	/**
-	 * 后方是否还有其他节点（不含后代）
-	 * @returns {boolean}
-	 * @complexity `n`
-	 */
-	get eof() {
-		if (this.type === 'root') {
-			return true;
-		}
-		let {nextSibling} = this;
-		while (nextSibling?.type === 'text' && String(nextSibling).trim() === '') {
-			({nextSibling} = nextSibling);
-		}
-		return nextSibling === undefined && this.parentNode?.eof;
-	}
-
-	constructor() {
-		Object.defineProperty(this, 'childNodes', {writable: false});
-		Object.freeze(this.childNodes);
-	}
-
-	/**
-	 * 标记仅用于代码调试的方法
-	 * @param {string} method
-	 * @throws `Error`
-	 */
-	debugOnly(method = 'debugOnly') {
-		throw new Error(`${this.constructor.name}.${method} 方法仅用于代码调试！`);
-	}
-
-	/**
-	 * 抛出`TypeError`
-	 * @param {string} method
-	 * @param  {...string} types 可接受的参数类型
-	 */
-	typeError(method, ...types) {
-		return typeError(this.constructor, method, ...types);
-	}
-
-	/**
-	 * 冻结部分属性
-	 * @param {string|string[]} keys 属性键
-	 * @param {boolean} permanent 是否永久
-	 */
-	seal(keys, permanent) {
-		if (!Parser.running && !Parser.debugging) {
-			this.debugOnly('seal');
-		}
-		keys = Array.isArray(keys) ? keys : [keys];
-		if (!permanent) {
-			for (const key of keys) {
-				this.#optional.add(key);
-			}
-		}
-		for (const key of keys) {
-			Object.defineProperty(this, key, {
-				writable: false, enumerable: !permanent && Boolean(this[key]), configurable: !permanent,
-			});
-		}
-	}
-
-	/**
-	 * 是否是全同节点
-	 * @param {this} node 待比较的节点
-	 * @throws `assert.AssertionError`
-	 */
-	isEqualNode(node) {
-		try {
-			assert.deepStrictEqual(this, node);
-		} catch (e) {
-			if (e instanceof assert.AssertionError) {
-				return false;
-			}
-			throw e;
-		}
-		return true;
-	}
-
-	/** 获取所有属性键 */
-	getAttributeNames() {
-		const names = Object.getOwnPropertyNames(this);
-		return names.filter(name => typeof this[name] !== 'function');
-	}
-
-	/** 是否具有任意属性 */
-	hasAttributes() {
-		return this.getAttributeNames().length > 0;
-	}
-
-	/**
-	 * 移除某属性
-	 * @param {PropertyKey} key 属性键
-	 * @throws `RangeError` 不可删除的属性
-	 */
-	removeAttribute(key) {
-		if (this.hasAttribute(key)) {
-			const descriptor = Object.getOwnPropertyDescriptor(this, key);
-			if (!descriptor || !descriptor.writable) {
-				throw new RangeError(`属性 ${key} 不可删除！`);
-			}
-			delete this[key];
-		}
-	}
-
-	/**
-	 * 开关某属性
-	 * @param {PropertyKey} key 属性键
-	 * @param {boolean|undefined} force 强制开启或关闭
-	 * @throws `RangeError` 不为Boolean类型的属性值
-	 */
-	toggleAttribute(key, force) {
-		if (force !== undefined && typeof force !== 'boolean') {
-			this.typeError('toggleAttribute', 'Boolean');
-		} else if (this.hasAttribute(key) && typeof this[key] !== 'boolean') {
-			throw new RangeError(`${key} 属性的值不为 Boolean！`);
-		}
-		this.setAttribute(key, force === true || force === undefined && !this[key]);
-	}
-
 	/**
 	 * 是否具有某属性
 	 * @param {PropertyKey} key 属性键
@@ -223,7 +54,7 @@ class AstNode {
 		const type = typeof key;
 		return type === 'string' || type === 'number' || type === 'symbol'
 			? key in this
-			: this.typeError('hasAttribute', 'String', 'Number', 'Symbol');
+			: false;
 	}
 
 	/**
@@ -233,11 +64,6 @@ class AstNode {
 	 * @returns {TokenAttribute<T>}
 	 */
 	getAttribute(key) {
-		if (key === 'optional') {
-			return new Set(this.#optional);
-		} else if (key === 'verifyChild') {
-			return this.#verifyChild;
-		}
 		return this.hasAttribute(key) ? String(this[key]) : undefined;
 	}
 
@@ -250,17 +76,6 @@ class AstNode {
 	setAttribute(key, value) {
 		if (key === 'parentNode') {
 			this.#parentNode = value;
-		} else if (Object.hasOwn(this, key)) {
-			const descriptor = Object.getOwnPropertyDescriptor(this, key);
-			if (this.#optional.has(key)) {
-				descriptor.enumerable = Boolean(value);
-			}
-			const oldValue = this[key],
-				frozen = oldValue !== null && typeof oldValue === 'object' && Object.isFrozen(oldValue);
-			Object.defineProperty(this, key, {...descriptor, value});
-			if (frozen && value !== null && typeof value === 'object') {
-				Object.freeze(value);
-			}
 		} else {
 			this[key] = value;
 		}
@@ -282,13 +97,8 @@ class AstNode {
 	 * @param {number} i 移除位置
 	 */
 	removeAt(i) {
-		this.getAttribute('verifyChild')(i);
-		const childNodes = [...this.childNodes],
-			e = new Event('remove', {bubbles: true}),
+		const {childNodes} = this,
 			[node] = childNodes.splice(i, 1);
-		node.setAttribute('parentNode');
-		this.setAttribute('childNodes', childNodes);
-		this.dispatchEvent(e, {position: i, removed: node});
 		return node;
 	}
 
@@ -298,298 +108,24 @@ class AstNode {
 	 * @param {T} node 待插入的子节点
 	 * @param {number} i 插入位置
 	 * @complexity `n`
-	 * @throws `RangeError` 不能插入祖先节点
 	 */
 	insertAt(node, i = this.childNodes.length) {
-		if (!(node instanceof AstNode)) {
-			this.typeError('insertAt', 'String', 'AstNode');
-		} else if (node.contains(this)) {
-			Parser.error('不能插入祖先节点！', node);
-			throw new RangeError('不能插入祖先节点！');
-		}
-		this.getAttribute('verifyChild')(i, 1);
-		const childNodes = [...this.childNodes],
-			e = new Event('insert', {bubbles: true}),
-			j = Parser.running ? -1 : childNodes.indexOf(node);
+		const {childNodes} = this,
+			j = -1;
 		if (j === -1) {
-			node.parentNode?.removeChild(node);
 			node.setAttribute('parentNode', this);
-		} else {
-			childNodes.splice(j, 1);
 		}
 		childNodes.splice(i, 0, node);
-		this.setAttribute('childNodes', childNodes);
-		this.dispatchEvent(e, {position: i < 0 ? i + this.childNodes.length - 1 : i, inserted: node});
 		return node;
 	}
 
-	/**
-	 * 获取子节点的位置
-	 * @param {this} node 子节点
-	 * @complexity `n`
-	 * @throws `RangeError` 找不到子节点
-	 */
-	#getChildIndex(node) {
-		const i = this.childNodes.indexOf(node);
-		if (i === -1) {
-			Parser.error('找不到子节点！', node);
-			throw new RangeError('找不到子节点！');
-		}
-		return i;
-	}
-
-	/**
-	 * 移除子节点
-	 * @template {this} T
-	 * @param {T} node 子节点
-	 * @complexity `n`
-	 */
-	removeChild(node) {
-		this.removeAt(this.#getChildIndex(node));
-		return node;
-	}
-
-	/**
-	 * 在末尾插入子节点
-	 * @template {this} T
-	 * @param {T} node 插入节点
-	 * @complexity `n`
-	 */
-	appendChild(node) {
-		return this.insertAt(node);
-	}
-
-	/**
-	 * 在指定位置前插入子节点
-	 * @template {this} T
-	 * @param {T} child 插入节点
-	 * @param {this} reference 指定位置处的子节点
-	 * @complexity `n`
-	 */
-	insertBefore(child, reference) {
-		return reference === undefined ? this.insertAt(child) : this.insertAt(child, this.#getChildIndex(reference));
-	}
-
-	/**
-	 * 替换子节点
-	 * @template {this} T
-	 * @param {this} newChild 新子节点
-	 * @param {T} oldChild 原子节点
-	 * @complexity `n`
-	 */
-	replaceChild(newChild, oldChild) {
-		const i = this.#getChildIndex(oldChild);
-		this.removeAt(i);
-		this.insertAt(newChild, i);
-		return oldChild;
-	}
-
-	/**
-	 * 在当前节点前后插入兄弟节点
-	 * @param {this[]} nodes 插入节点
-	 * @param {number} offset 插入的相对位置
-	 * @complexity `n`
-	 * @throws `Error` 不存在父节点
-	 */
-	#insertAdjacent(nodes, offset) {
-		const {parentNode} = this;
-		if (!parentNode) {
-			throw new Error('不存在父节点！');
-		}
-		const i = parentNode.childNodes.indexOf(this) + offset;
-		for (let j = 0; j < nodes.length; j++) {
-			parentNode.insertAt(nodes[j], i + j);
-		}
-	}
-
-	/**
-	 * 在后方批量插入兄弟节点
-	 * @param {...this} nodes 插入节点
-	 * @complexity `n`
-	 */
-	after(...nodes) {
-		this.#insertAdjacent(nodes, 1);
-	}
-
-	/**
-	 * 在前方批量插入兄弟节点
-	 * @param {...this} nodes 插入节点
-	 * @complexity `n`
-	 */
-	before(...nodes) {
-		this.#insertAdjacent(nodes, 0);
-	}
-
-	/**
-	 * 移除当前节点
-	 * @complexity `n`
-	 * @throws `Error` 不存在父节点
-	 */
-	remove() {
-		const {parentNode} = this;
-		if (!parentNode) {
-			throw new Error('不存在父节点！');
-		}
-		parentNode.removeChild(this);
-	}
-
-	/**
-	 * 将当前节点批量替换为新的节点
-	 * @param {...this} nodes 插入节点
-	 * @complexity `n`
-	 */
-	replaceWith(...nodes) {
-		this.after(...nodes);
-		this.remove();
-	}
-
-	/** 是否具有子节点 */
-	hasChildNodes() {
-		return this.childNodes.length > 0;
-	}
-
-	/**
-	 * 是自身或后代节点
-	 * @param {this} node 待检测节点
-	 * @returns {boolean}
-	 * @complexity `n`
-	 */
-	contains(node) {
-		return node instanceof AstNode
-			? node === this || this.childNodes.some(child => child.contains(node))
-			: this.typeError('contains', 'AstNode');
-	}
-
-	/**
-	 * 添加事件监听
-	 * @param {string|string[]} types 事件类型
-	 * @param {AstListener} listener 监听函数
-	 * @param {{once: boolean}} options 选项
-	 */
-	addEventListener(types, listener, options) {
-		if (Array.isArray(types)) {
-			for (const type of types) {
-				this.addEventListener(type, listener, options);
-			}
-		} else if (typeof types === 'string' && typeof listener === 'function') {
-			this.#events[options?.once ? 'once' : 'on'](types, listener);
-		} else {
-			this.typeError('addEventListener', 'String', 'Function');
-		}
-	}
-
-	/**
-	 * 移除事件监听
-	 * @param {string|string[]} types 事件类型
-	 * @param {AstListener} listener 监听函数
-	 */
-	removeEventListener(types, listener) {
-		if (Array.isArray(types)) {
-			for (const type of types) {
-				this.removeEventListener(type, listener);
-			}
-		} else if (typeof types === 'string' && typeof listener === 'function') {
-			this.#events.off(types, listener);
-		} else {
-			this.typeError('removeEventListener', 'String', 'Function');
-		}
-	}
-
-	/**
-	 * 移除事件的所有监听
-	 * @param {string|string[]} types 事件类型
-	 */
-	removeAllEventListeners(types) {
-		if (Array.isArray(types)) {
-			for (const type of types) {
-				this.removeAllEventListeners(type);
-			}
-		} else if (types === undefined || typeof types === 'string') {
-			this.#events.removeAllListeners(types);
-		} else {
-			this.typeError('removeAllEventListeners', 'String');
-		}
-	}
-
-	/**
-	 * 列举事件监听
-	 * @param {string} type 事件类型
-	 * @returns {AstListener[]}
-	 */
-	listEventListeners(type) {
-		return typeof type === 'string' ? this.#events.listeners(type) : this.typeError('listEventListeners', 'String');
-	}
-
-	/**
-	 * 触发事件
-	 * @param {AstEvent} e 事件对象
-	 * @param {*} data 事件数据
-	 */
-	dispatchEvent(e, data) {
-		if (!(e instanceof Event)) {
-			this.typeError('dispatchEvent', 'Event');
-		} else if (!e.target) { // 初始化
-			Object.defineProperty(e, 'target', {value: this, enumerable: true});
-
-			/** 终止冒泡 */
-			e.stopPropagation = function() {
-				Object.defineProperty(this, 'bubbles', {value: false});
-			};
-		}
-		Object.defineProperties(e, { // 每次bubble更新
-			prevTarget: {value: e.currentTarget, enumerable: true, configurable: true},
-			currentTarget: {value: this, enumerable: true, configurable: true},
-		});
-		this.#events.emit(e.type, e, data);
-		if (e.bubbles && this.parentNode) {
-			this.parentNode.dispatchEvent(e, data);
-		}
-	}
-
-	/** 获取所有祖先节点 */
-	getAncestors() {
-		const /** @type {this[]} */ ancestors = [];
-		let {parentNode} = this;
-		while (parentNode) {
-			ancestors.push(parentNode);
-			({parentNode} = parentNode);
-		}
-		return ancestors;
-	}
-
-	/**
-	 * 比较和另一个节点的相对位置
-	 * @param {this} other 待比较的节点
-	 * @complexity `n`
-	 * @throws `Error` 不在同一个语法树
-	 */
-	compareDocumentPosition(other) {
-		if (!(other instanceof AstNode)) {
-			this.typeError('compareDocumentPosition', 'AstNode');
-		} else if (this === other) {
-			return 0;
-		} else if (this.contains(other)) {
-			return -1;
-		} else if (other.contains(this)) {
-			return 1;
-		} else if (this.getRootNode() !== other.getRootNode()) {
-			throw new Error('不在同一个语法树！');
-		}
-		const aAncestors = [...this.getAncestors().reverse(), this],
-			bAncestors = [...other.getAncestors().reverse(), other],
-			depth = aAncestors.findIndex((ancestor, i) => bAncestors[i] !== ancestor),
-			commonAncestor = aAncestors[depth - 1],
-			{childNodes} = commonAncestor;
-		return childNodes.indexOf(aAncestors[depth]) - childNodes.indexOf(bAncestors[depth]);
-	}
-
 	/**
 	 * 合并相邻的文本子节点
 	 * @complexity `n`
 	 */
 	normalize() {
 		const AstText = require('./text');
-		const /** @type {AstText[]} */ childNodes = [...this.childNodes];
+		const /** @type {{childNodes: AstText[]}} */ {childNodes} = this;
 		for (let i = childNodes.length - 1; i >= 0; i--) {
 			const {type, data} = childNodes[i];
 			if (this.getGaps(i - 1)) {
@@ -601,7 +137,6 @@ class AstNode {
 				childNodes.splice(i, 1);
 			}
 		}
-		this.setAttribute('childNodes', childNodes);
 	}
 
 	/** 获取根节点 */
@@ -619,9 +154,6 @@ class AstNode {
 	 * @complexity `n`
 	 */
 	posFromIndex(index) {
-		if (!Number.isInteger(index)) {
-			this.typeError('posFromIndex', 'Number');
-		}
 		const str = String(this);
 		if (index >= -str.length && index <= str.length) {
 			const lines = str.slice(0, index).split('\n');
@@ -630,22 +162,6 @@ class AstNode {
 		return undefined;
 	}
 
-	/**
-	 * 将行列号转换为字符位置
-	 * @param {number} top 行号
-	 * @param {number} left 列号
-	 * @complexity `n`
-	 */
-	indexFromPos(top, left) {
-		if (!Number.isInteger(top) || !Number.isInteger(left)) {
-			this.typeError('indexFromPos', 'Number');
-		}
-		const lines = String(this).split('\n');
-		return top >= 0 && left >= 0 && lines.length >= top + 1 && lines[top].length >= left
-			? lines.slice(0, top).reduce((acc, curLine) => acc + curLine.length + 1, 0) + left
-			: undefined;
-	}
-
 	/**
 	 * 获取行数和最后一行的列数
 	 * @complexity `n`
@@ -691,7 +207,6 @@ class AstNode {
 			}
 			return 0;
 		}
-		this.getAttribute('verifyChild')(j, 1);
 		({childNodes} = this);
 		return getIndex(j, this);
 	}
@@ -706,25 +221,6 @@ class AstNode {
 		return parentNode ? parentNode.getAbsoluteIndex() + this.getRelativeIndex() : 0;
 	}
 
-	/**
-	 * 获取当前节点的相对位置，或其第`j`个子节点的相对位置
-	 * @param {number|undefined} j 子节点序号
-	 * @complexity `n`
-	 */
-	#getPosition(j) {
-		return j === undefined
-			? this.parentNode?.posFromIndex(this.getRelativeIndex()) ?? {top: 0, left: 0}
-			: this.posFromIndex(this.getRelativeIndex(j));
-	}
-
-	/**
-	 * 获取当前节点的行列位置和大小
-	 * @complexity `n`
-	 */
-	getBoundingClientRect() {
-		return {...this.#getDimension(), ...this.getRootNode().posFromIndex(this.getAbsoluteIndex())};
-	}
-
 	/**
 	 * 行数
 	 * @complexity `n`
@@ -740,31 +236,6 @@ class AstNode {
 	get offsetWidth() {
 		return this.#getDimension().width;
 	}
-
-	/**
-	 * 相对于父容器的行号
-	 * @complexity `n`
-	 */
-	get offsetTop() {
-		return this.#getPosition().top;
-	}
-
-	/**
-	 * 相对于父容器的列号
-	 * @complexity `n`
-	 */
-	get offsetLeft() {
-		return this.#getPosition().left;
-	}
-
-	/**
-	 * 位置、大小和padding
-	 * @complexity `n`
-	 */
-	get style() {
-		return {...this.#getPosition(), ...this.#getDimension(), padding: this.getPadding()};
-	}
 }
 
-Parser.classes.AstNode = __filename;
 module.exports = AstNode;