wikiparser-node 0.0.2 → 0.2.0

package/README.md

@@ -29,6 +29,7 @@
         10. [findEnclosingHtml](#token.findenclosinghtml)
         11. [getCategories](#token.getcategories)
         12. [redoQuotes](#token.redoquotes)
+        13. [print](#token.print)
     2. [实例属性](#token.instance.properties)
         1. [type](#token.type)
     3. [原型属性](#token.prototype.properties)
@@ -180,12 +181,35 @@
         2. [setTarget](#magiclinktoken.settarget)
     2. [原型属性](#magiclinktoken.prototype.properties)
         1. [protocol](#magiclinktoken.protocol)
-21. [选择器](#选择器)
+21. [ConverterToken](#convertertoken)
+    1. [原型方法](#convertertoken.prototype.methods)
+        1. [getAllFlags](#convertertoken.getallflags)
+        2. [getEffectiveFlags](#convertertoken.geteffectiveflags)
+        3. [hasFlag](#convertertoken.hasflag)
+        4. [hasEffectiveFlag](#convertertoken.haseffectiveflag)
+        5. [removeFlag](#convertertoken.removeflag)
+        6. [setFlag](#convertertoken.setflag)
+        7. [toggleFlag](#convertertoken.toggleflag)
+    2. [原型属性](#convertertoken.prototype.properties)
+        1. [noConvert](#convertertoken.noconvert)
+22. [ConverterRuleToken](#converterruletoken)
+    1. [原型方法](#converterruletoken.prototype.methods)
+        1. [noConvert](#converterruletoken.noconvert)
+        2. [setTo](#converterruletoken.setto)
+        3. [setVariant](#converterruletoken.setvariant)
+        4. [setFrom](#converterruletoken.setfrom)
+        5. [makeUnidirectional](#converterruletoken.makeunidirectional)
+        6. [makeBidirectional](#converterruletoken.makebidirectional)
+    2. [实例属性](#converterruletoken.instance.properties)
+        1. [variant](#converterruletoken.variant)
+        2. [unidirectional](#converterruletoken.unidirectional)
+        3. [bidirectional](#converterruletoken.bidirectional)
+23. [选择器](#选择器)
     1. [type](#selector.type)
     2. [name](#selector.name)
     3. [属性](#selector.attribute)
     4. [伪选择器](#selector.pseudo)
-22. [$ (TokenCollection)](#-tokencollection)
+24. [$ (TokenCollection)](#-tokencollection)
 </details>
 
 # Parser
@@ -426,6 +450,15 @@ assert.deepStrictEqual(root.childNodes, ["'", root.firstElementChild, "a", root.
 var root = Parser.parse(wikitext);
 assert(root.type === 'root');
 ```
+
+**print**(format?: 'markup'\|'json' = 'markup'): void\|object<a id="token.print"></a>
+- 打印解析生成的 AST。
+
+```js
+var root = Parser.parse("<ref>{{T|<br>\n----\n[[File:F|thumb|''[//example.net]'']]}}</ref>");
+root.print();
+root.print('json', 'example'); // JSON格式的输出结果将保存至 /printed/example.json 文件
+```
 </details>
 
 ## 原型属性<a id="token.prototype.properties"></a>
@@ -930,7 +963,7 @@ param.setValue(' 2 ');
 assert(root.toString() === '{{a|b= 2 }}'); // setValue方法总是保留空白字符，哪怕是无效的
 ```
 
-**rename**(key: string, force: boolean): void<a id="parametertoken.rename"></a>
+**rename**(key: string, force?: boolean = false): void<a id="parametertoken.rename"></a>
 - 重命名参数，可选是否在导致重复参数时抛出错误。
 
 ```js
@@ -1164,7 +1197,7 @@ assert(root.toString() === '{|\n!colspan=2|\n|-\n| \n!\n|}');
 |:-:|:-:|:-:|
 |<table><tr><td colspan=2>td</td></tr><tr><td>td</td><td>td</td></tr></table>|<table><tr><td colspan=2>td</td></tr><tr><td>td</td><th>th</th></tr></table>|<table><tr><th colspan=2>th</th></tr><tr><td>td</td><th>th</th></tr></table>|
 
-**insertTableRow**(row: number, attr: Record\<string, string\|boolean>, inner?: string, subtype?: 'td'\|'th', innerAttr?: Record\<string, string\|boolean>): TrToken<a id="tabletoken.inserttablerow"></a>
+**insertTableRow**(row: number, attr: Record\<string, string\|boolean>, inner?: string, subtype?: 'td'\|'th' = 'td', innerAttr?: Record\<string, string\|boolean>): TrToken<a id="tabletoken.inserttablerow"></a>
 - 插入空行或一行单元格。
 
 ```js
@@ -1179,7 +1212,7 @@ assert(root.toString() === '{|\n|a|| rowspan="3"|b||c\n|- class="tr"\n|-\n! clas
 |:-:|:-:|
 |<table><tr><td>a</td><td rowspan=2>b</td><td>c</td></tr><tr><td>d</td><td>e</td></tr></table>|<table><tr><td>a</td><td rowspan=3>b</td><td>c</td></tr><tr><th>f</th><th>f</th></tr><tr><td>d</td><td>e</td></tr></table>|
 
-**insertTableCol**(x: number, inner: string, subtype: 'td'\|'th', attr: Record\<string, string\|boolean>): void<a id="tabletoken.inserttablecol"></a>
+**insertTableCol**(x: number, inner: string, subtype?: 'td'\|'th' = 'td', attr?: Record\<string, string\|boolean>): void<a id="tabletoken.inserttablecol"></a>
 - 插入一列单元格。
 
 ```js
@@ -1193,7 +1226,7 @@ assert(root.toString() === '{|\n| colspan="3"|a\n|-\n|b\n! class="th"|d\n|c\n|}'
 |:-:|:-:|
 |<table><tr><td colspan=2 align="center">a</td></tr><tr><td>b</td><td>c</td></tr></table>|<table><tr><td colspan=3 align="center">a</td></tr><tr><td>b</td><th>d</th><td>c</td></tr></table>|
 
-**insertTableCell**(inner: string, coords: {row: number, column: number}\|{x: number, y: number}, subtype: 'td'\|'th', attr: Record\<string, string\|boolean>): [TdToken](#tdtoken)<a id="tabletoken.inserttablecell"></a>
+**insertTableCell**(inner: string, coords: {row: number, column: number}\|{x: number, y: number}, subtype?: 'td'\|'th' = 'td', attr?: Record\<string, string\|boolean>): [TdToken](#tdtoken)<a id="tabletoken.inserttablecell"></a>
 - 插入一个单元格。
 
 ```js
@@ -1471,7 +1504,7 @@ link.asSelfLink();
 assert(root.toString() === '[[#b]]');
 ```
 
-**setLinkText**(linkText?: string)<a id="linktoken.setlinktext"></a>
+**setLinkText**(linkText: string)<a id="linktoken.setlinktext"></a>
 - 修改链接文本。
 
 ```js
@@ -1797,6 +1830,192 @@ assert(root.toString() === 'https://example.org');
 
 [返回目录](#目录)
 
+# ConverterToken
+转换。
+
+## 原型方法<a id="convertertoken.prototype.methods"></a>
+<details>
+    <summary>展开</summary>
+
+**getAllFlags**(): Set\<string><a id="convertertoken.getallflags"></a>
+- 获取所有转换 flag，包括无效的。
+
+```js
+var root = Parser.parse('-{zh-hans;zh-hant|}-'),
+    converter = root.firstChild;
+assert.deepStrictEqual(converter.getAllFlags(), new Set(['zh-hans', 'zh-hant']));
+```
+
+**getEffectiveFlags**(): Set\<string><a id="convertertoken.geteffectiveflags"></a>
+- 解析有效的转换 flag。
+
+```js
+var root = Parser.parse('-{}-'),
+    converter = root.firstChild;
+assert.deepStrictEqual(converter.getEffectiveFlags(), new Set(['S']));
+```
+
+**hasFlag**(flag: string): boolean<a id="convertertoken.hasflag"></a>
+- 是否包含 flag，即使可能是无效 flag。
+
+```js
+var root = Parser.parse('-{R|}-'),
+    converter = root.firstChild;
+assert(converter.hasFlag('R') === true);
+```
+
+**hasEffectiveFlag**(flag: string): boolean<a id="convertertoken.haseffectiveflag"></a>
+- 是否包含某有效 flag。
+
+```js
+var root = Parser.parse('-{}-'),
+    converter = root.firstChild;
+assert(converter.hasEffectiveFlag('S') === true);
+```
+
+**removeFlag**(flag: string): void<a id="convertertoken.removeflag"></a>
+- 移除 flag，可能原本就是无效的 flag。
+
+```js
+var root = Parser.parse('-{R|}-'),
+    converter = root.firstChild;
+converter.removeFlag('R');
+assert(root.toString() === '-{}-');
+```
+
+**setFlag**(flag: string): void<a id="convertertoken.setflag"></a>
+- 添加指定 flag，可能是无效 flag。
+
+```js
+var root = Parser.parse('-{}-'),
+    converter = root.firstChild;
+converter.setFlag('R');
+assert(root.toString() === '-{R|}-');
+```
+
+**toggleFlag**(flag: string): void<a id="convertertoken.toggleflag"></a>
+- 改变某 flag 的有无，可能是无效 flag。
+
+```js
+var root = Parser.parse('-{R|}-'),
+    converter = root.firstChild;
+converter.toggleFlag('R');
+converter.toggleFlag('D');
+assert(root.toString() === '-{D|}-');
+```
+</details>
+
+## 原型属性<a id="convertertoken.prototype.properties"></a>
+<details>
+    <summary>展开</summary>
+
+**noConvert**: boolean<a id="convertertoken.noconvert"></a>
+- 是否不会转换。
+
+```js
+var root = Parser.parse('-{简体}-'),
+    converter = root.firstChild;
+assert(converter.noConvert === true);
+```
+</details>
+
+[返回目录](#目录)
+
+# ConverterRuleToken
+单条转换规则。
+
+## 原型方法<a id="converterruletoken.prototype.methods"></a>
+<details>
+    <summary>展开</summary>
+
+**noConvert**(): void<a id="converterruletoken.noconvert"></a>
+- 更改规则使得内容不会转换。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁體}-'),
+    converterRule = root.querySelector('converter-rule');
+converterRule.noConvert();
+assert(root.toString() === '-{繁體}-');
+```
+
+**setTo**(to: string): void<a id="converterruletoken.setto"></a>
+- 修改转换结果。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁體}-'),
+    converterRule = root.querySelector('converter-rule');
+converterRule.setTo('繁体');
+assert(root.toString() === '-{繁體=>zh-hans:繁体}-');
+```
+
+**setVariant**(variant: string): void<a id="converterruletoken.setvariant"></a>
+- 修改转换规则对应的语言变体。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁體}-'),
+    converterRule = root.querySelector('converter-rule');
+converterRule.setVariant('zh-cn');
+assert(root.toString() === '-{繁體=>zh-cn:繁體}-');
+```
+
+**setFrom**(from: string): void<a id="converterruletoken.setfrom"></a>
+- 对单项转换规则，修改待转换的内容。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁体}-'),
+    converterRule = root.querySelector('converter-rule');
+converterRule.setFrom('正體');
+assert(root.toString() === '-{正體=>zh-hans:繁体}-');
+```
+
+**makeUnidirectional**(from: string): void<a id="converterruletoken.makeunidirectional"></a>
+- [ConverterRuleToken.setFrom](#converterruletoken.setfrom) 方法的別名。
+
+**makeBidirectional**(): void<a id="converterruletoken.makebidirectional"></a>
+- 将规则改为双向转换。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁体}-'),
+    converterRule = root.querySelector('converter-rule');
+converterRule.makeBidirectional();
+assert(root.toString() === '-{zh-hans:繁体}-');
+```
+</details>
+
+## 原型属性<a id="convertertoken.prototype.properties"></a>
+<details>
+    <summary>展开</summary>
+
+**variant**: string<a id="converterruletoken.variant"></a>
+- 规则对应的语言变体。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁体}-'),
+    converterRule = root.querySelector('converter-rule');
+assert(converterRule.variant === 'zh-hans');
+```
+
+**unidirectional**: boolean<a id="converterruletoken.unidirectional"></a>
+- 是否是单向转换。
+
+```js
+var root = Parser.parse('-{繁體=>zh-hans:繁体}-'),
+    converterRule = root.querySelector('converter-rule');
+assert(converterRule.unidirectional === true);
+```
+
+**bidirectional**: boolean<a id="converterruletoken.bidirectional"></a>
+- 是否是双向转换。
+
+```js
+var root = Parser.parse('-{zh-hans:繁体}-'),
+    converterRule = root.querySelector('converter-rule');
+assert(converterRule.bidirectional === true);
+```
+</details>
+
+[返回目录](#目录)
+
 # 选择器
 Token 选择器的设计仿照了 CSS 和 jQuery 的选择器。
 <details>

package/config/default.json

@@ -763,5 +763,16 @@
 		"底部": "bottom",
 		"text-bottom": "text-bottom",
 		"文字底部": "text-bottom"
-	}
+	},
+	"variants": [
+		"zh",
+		"zh-hans",
+		"zh-hant",
+		"zh-cn",
+		"zh-tw",
+		"zh-hk",
+		"zh-sg",
+		"zh-my",
+		"zh-mo"
+	]
 }

package/config/llwiki.json

@@ -683,5 +683,16 @@
 		"底部": "bottom",
 		"text-bottom": "text-bottom",
 		"文字底部": "text-bottom"
-	}
+	},
+	"variants": [
+		"zh",
+		"zh-hans",
+		"zh-hant",
+		"zh-cn",
+		"zh-tw",
+		"zh-hk",
+		"zh-sg",
+		"zh-my",
+		"zh-mo"
+	]
 }

package/config/moegirl.json

@@ -718,5 +718,13 @@
 		"底部": "bottom",
 		"text-bottom": "text-bottom",
 		"文字底部": "text-bottom"
-	}
+	},
+	"variants": [
+		"zh",
+		"zh-hans",
+		"zh-hant",
+		"zh-cn",
+		"zh-tw",
+		"zh-hk"
+	]
 }

package/errors/2022-07-04T22:30:41.785Z

@@ -0,0 +1 @@
+{|

package/errors/2022-07-04T22:30:41.785Z.err

@@ -0,0 +1,11 @@
+TypeError: normalizeSpace is not a function
+    at AttributeToken.toString (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/attribute.js:249:44)
+    at #parseAttr (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/attribute.js:58:21)
+    at new AttributeToken (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/attribute.js:87:45)
+    at new TrToken (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/table/tr.js:28:4)
+    at new TableToken (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/table/index.js:66:3)
+    at parseTable (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/parser/table.js:40:18)
+    at #parseTable (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/index.js:553:16)
+    at Token.parseOnce (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/index.js:431:21)
+    at Token.parse (/Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/src/index.js:526:9)
+    at /Users/mengxiwu/Documents/CCM-RP/node/wikiparser-node/index.js:134:11

package/errors/2022-07-04T22:30:41.785Z.json

@@ -0,0 +1,5 @@
+{
+	"stage": 3,
+	"include": false,
+	"config": "./config/default"
+}

package/errors/README

@@ -0,0 +1 @@
+这里记录解析失败时处于半解析状态的维基文本以及错误信息。

package/index.js

@@ -76,6 +76,8 @@ const /** @type {Parser} */ Parser = {
 		['QuoteToken'],
 		['ExtLinkToken'],
 		['MagicLinkToken'],
+		['ListToken', 'DdToken'],
+		['ConverterToken'],
 	],
 
 	config: './config/default',
@@ -108,7 +110,7 @@ const /** @type {Parser} */ Parser = {
 					}
 				}
 			};
-			Parser.run(() => {
+			this.run(() => {
 				build(['title', 'fragment']);
 			});
 		}
@@ -119,31 +121,105 @@ const /** @type {Parser} */ Parser = {
 
 	parse(wikitext, include = false, maxStage = Parser.MAX_STAGE, config = Parser.getConfig()) {
 		const Token = require('./src');
+		let token;
 		this.run(() => {
 			if (typeof wikitext === 'string') {
-				wikitext = new Token(wikitext, config);
-			} else if (!(wikitext instanceof Token)) {
+				token = new Token(wikitext, config);
+			} else if (wikitext instanceof Token) {
+				token = wikitext;
+				wikitext = token.toString();
+			} else {
 				throw new TypeError('待解析的内容应为 String 或 Token！');
 			}
 			try {
-				wikitext.parse(maxStage, include);
+				token.parse(maxStage, include);
 			} catch (e) {
 				if (e instanceof Error) {
-					fs.writeFileSync(
-						`${__dirname}/errors/${new Date().toISOString()}`,
-						`${e.stack}\n\n\n${wikitext.toString()}`,
-					);
+					const file = `${__dirname}/errors/${new Date().toISOString()}`,
+						stage = token.getAttribute('stage');
+					fs.writeFileSync(file, stage === this.MAX_STAGE ? wikitext : token.toString());
+					fs.writeFileSync(`${file}.err`, e.stack);
+					fs.writeFileSync(`${file}.json`, JSON.stringify({
+						stage, include: token.getAttribute('include'), config: this.config,
+					}, null, '\t'));
 				}
 				throw e;
 			}
 		});
-		return wikitext;
+		return token;
+	},
+
+	reparse(date) {
+		const path = `${__dirname}/errors/`,
+			main = fs.readdirSync(path).find(name => name.startsWith(date) && name.endsWith('Z'));
+		if (!main) {
+			throw new RangeError(`找不到对应时间戳的错误记录：${date}`);
+		}
+		const Token = require('./src'),
+			file = `${path}${main}`,
+			wikitext = fs.readFileSync(file, 'utf8'),
+			{stage, include, config} = require(`${file}.json`);
+		this.config = config;
+		return this.run(() => {
+			const halfParsed = stage < this.MAX_STAGE,
+				token = new Token(wikitext, this.getConfig(), halfParsed);
+			if (halfParsed) {
+				token.setAttribute('stage', stage).parseOnce(stage, include);
+			} else {
+				token.parse(undefined, include);
+			}
+			fs.unlinkSync(file);
+			fs.unlinkSync(`${file}.err`);
+			fs.unlinkSync(`${file}.json`);
+			return token;
+		});
 	},
 
 	getTool() {
 		delete require.cache[require.resolve('./tool')];
 		return require('./tool');
 	},
+
+	typeAliases: {
+		ext: ['extension'],
+		'ext-inner': ['extension-inner'],
+		arg: ['argument'],
+		'arg-name': ['argument-name'],
+		'arg-default': ['argument-default'],
+		'arg-redundant': ['argument-redundant'],
+		template: ['tpl'],
+		'template-name': ['tpl-name'],
+		'magic-word': ['parser-function', 'parser-func'],
+		'invoke-function': ['invoke-func'],
+		'invoke-module': ['invoke-mod'],
+		parameter: ['param'],
+		'parameter-key': ['param-key'],
+		'parameter-value': ['parameter-val', 'param-value', 'param-val'],
+		heading: ['header'],
+		'heading-title': ['header-title'],
+		table: ['tbl'],
+		'table-inter': ['tbl-inter'],
+		tr: ['table-row', 'tbl-row'],
+		td: ['table-cell', 'tbl-cell', 'table-data', 'tbl-data'],
+		'double-underscore': ['underscore', 'behavior-switch', 'behaviour-switch'],
+		hr: ['horizontal'],
+		category: ['category-link', 'cat', 'cat-link'],
+		file: ['file-link', 'image', 'image-link', 'img', 'img-link'],
+		'image-parameter': ['img-parameter', 'image-param', 'img-param'],
+		quote: ['quotes', 'quot', 'apostrophe', 'apostrophes', 'apos'],
+		'ext-link': ['external-link'],
+		'ext-link-text': ['external-link-text'],
+		'ext-link-url': ['external-link-url'],
+		'free-ext-link': ['free-external-link', 'magic-link'],
+		dd: ['indent', 'indentation'],
+		converter: ['convert', 'conversion'],
+		'converter-flags': ['convert-flags', 'conversion-flags', 'converter-flag', 'convert-flag', 'conversion-flag'],
+		'converter-rule': ['convert-rule', 'conversion-rule'],
+		'converter-rule-noconvert': ['convert-rule-noconvert', 'conversion-rule-noconvert'],
+		'converter-rule-variant': ['convert-rule-variant', 'conversion-rule-variant'],
+		'converter-rule-to': ['convert-rule-to', 'conversion-rule-to'],
+		'converter-rule-from': ['convert-rule-from', 'conversion-rule-from'],
+	},
 };
 
 const /** @type {PropertyDescriptorMap} */ def = {};

package/lib/element.js

@@ -1,7 +1,8 @@
 'use strict';
 
-const {typeError, externalUse} = require('../util/debug'),
-	{toCase} = require('../util/string'),
+const fs = require('fs'),
+	{externalUse} = require('../util/debug'),
+	{toCase, noWrap} = require('../util/string'),
 	{nth} = require('./ranges'),
 	EventEmitter = require('events'),
 	AstNode = require('./node'),
@@ -93,7 +94,7 @@ class AstElement extends AstNode {
 				this.addEventListener(type, listener, options);
 			}
 		} else if (typeof types !== 'string' || typeof listener !== 'function') {
-			typeError(this, 'addEventListener', 'String', 'Function');
+			this.typeError('addEventListener', 'String', 'Function');
 		} else {
 			this.#events[options?.once ? 'once' : 'on'](types, listener);
 		}
@@ -109,7 +110,7 @@ class AstElement extends AstNode {
 				this.removeEventListener(type, listener);
 			}
 		} else if (typeof types !== 'string' || typeof listener !== 'function') {
-			typeError(this, 'removeEventListener', 'String', 'Function');
+			this.typeError('removeEventListener', 'String', 'Function');
 		} else {
 			this.#events.off(types, listener);
 		}
@@ -122,7 +123,7 @@ class AstElement extends AstNode {
 				this.removeAllEventListeners(type);
 			}
 		} else if (types !== undefined && typeof types !== 'string') {
-			typeError(this, 'removeAllEventListeners', 'String');
+			this.typeError('removeAllEventListeners', 'String');
 		} else {
 			this.#events.removeAllListeners(types);
 		}
@@ -134,7 +135,7 @@ class AstElement extends AstNode {
 	 */
 	listEventListeners(type) {
 		if (typeof type !== 'string') {
-			typeError(this, 'listEventListeners', 'String');
+			this.typeError('listEventListeners', 'String');
 		}
 		return this.#events.listeners(type);
 	}
@@ -145,7 +146,7 @@ class AstElement extends AstNode {
 	 */
 	dispatchEvent(e, data) {
 		if (!(e instanceof Event)) {
-			typeError(this, 'dispatchEvent', 'Event');
+			this.typeError('dispatchEvent', 'Event');
 		} else if (!e.target) { // 初始化
 			Object.defineProperty(e, 'target', {value: this, enumerable: true});
 			e.stopPropagation = function() {
@@ -357,7 +358,7 @@ class AstElement extends AstNode {
 	 */
 	matches(selector = '', simple = false) {
 		if (typeof selector !== 'string') {
-			typeError(this, 'matches', 'String');
+			this.typeError('matches', 'String');
 		} else if (!selector.trim()) {
 			return true;
 		}
@@ -401,7 +402,8 @@ class AstElement extends AstNode {
 				),
 				[type, ...parts] = plainSelector.trim().split('#'),
 				name = parts.join('#');
-			return (!type || this.type === type) && (!name || this.name === name)
+			return (!type || this.type === type || Boolean(Parser.typeAliases[this.type]?.includes(type)))
+				&& (!name || this.name === name)
 				&& attributes.every(args => this.matchesAttr(...args));
 		}
 		/*
@@ -479,7 +481,7 @@ class AstElement extends AstNode {
 	 */
 	comparePosition(other) {
 		if (!(other instanceof AstElement)) {
-			typeError(this, 'comparePosition', 'AstElement');
+			this.typeError('comparePosition', 'AstElement');
 		} else if (this === other) {
 			return 0;
 		} else if (this.contains(other)) {
@@ -541,7 +543,7 @@ class AstElement extends AstNode {
 	 */
 	posFromIndex(index) {
 		if (typeof index !== 'number') {
-			typeError(this, 'posFromIndex', 'Number');
+			this.typeError('posFromIndex', 'Number');
 		}
 		const text = this.toString();
 		if (index < -text.length || index >= text.length || !Number.isInteger(index)) {
@@ -558,7 +560,7 @@ class AstElement extends AstNode {
 	 */
 	indexFromPos(top, left) {
 		if (typeof top !== 'number' || typeof left !== 'number') {
-			typeError(this, 'indexFromPos', 'Number');
+			this.typeError('indexFromPos', 'Number');
 		} else if (top < 0 || left < 0 || !Number.isInteger(top) || !Number.isInteger(left)) {
 			return;
 		}
@@ -582,7 +584,7 @@ class AstElement extends AstNode {
 	 */
 	getRelativeIndex(j) {
 		if (j !== undefined && typeof j !== 'number') {
-			typeError(this, 'getRelativeIndex', 'Number');
+			this.typeError('getRelativeIndex', 'Number');
 		}
 		let /** @type {(string|this)[]} */ childNodes;
 		/**
@@ -684,6 +686,63 @@ class AstElement extends AstNode {
 			return node ? [[index + this.getRelativeIndex(i), node]] : [];
 		});
 	}
+
+	/**
+	 * @template {'markup'|'json'} T
+	 * @param {T} format
+	 * @param {T extends 'markup' ? number : string} depth
+	 * @returns {T extends 'markup' ? void : Record<string, any>}
+	 */
+	print(format = 'markup', depth = 0) {
+		if (format === 'json') {
+			const {childNodes, ...prop} = this,
+				json = {
+					...prop,
+					childNodes: childNodes.map(child => typeof child === 'string' ? child : child.print('json')),
+				};
+			if (typeof depth === 'string') {
+				fs.writeFileSync(
+					`${__dirname.slice(0, -3)}printed/${depth}${depth.endsWith('.json') ? '' : '.json'}`,
+					JSON.stringify(json, null, 2),
+				);
+			}
+			return json;
+		} else if (typeof depth !== 'number') {
+			this.typeError('print', 'Number');
+		}
+		const indent = '  '.repeat(depth),
+			str = this.toString(),
+			{childNodes, type, firstChild} = this,
+			{length} = childNodes;
+		if (!str || length === 0 || typeof firstChild === 'string' && firstChild === str) {
+			console.log(`${indent}\x1b[32m<%s>\x1b[0m${noWrap(str)}\x1b[32m</%s>\x1b[0m`, type, type);
+			return;
+		}
+		Parser.info(`${indent}<${type}>`);
+		let i = this.getPadding();
+		if (i) {
+			console.log(`${indent}  ${noWrap(str.slice(0, i))}`);
+		}
+		for (const [j, child] of childNodes.entries()) {
+			const childStr = String(child),
+				gap = j === length - 1 ? 0 : this.getGaps(j);
+			if (!childStr) {
+				// pass
+			} else if (typeof child === 'string') {
+				console.log(`${indent}  ${noWrap(child)}`);
+			} else {
+				child.print('markup', depth + 1);
+			}
+			i += childStr.length + gap;
+			if (gap) {
+				console.log(`${indent}  ${noWrap(str.slice(i - gap, i))}`);
+			}
+		}
+		if (i < str.length) {
+			console.log(`${indent}  ${noWrap(str.slice(i))}`);
+		}
+		Parser.info(`${indent}</${type}>`);
+	}
 }
 
 Parser.classes.AstElement = __filename;