wikiparser-node 0.3.0 → 0.4.0

package/test/real.js

@@ -0,0 +1,133 @@
+'use strict';
+
+const {diff} = require('./util'),
+	Api = require('./api'),
+	Parser = require('../'),
+	AstText = require('../lib/text');
+
+const {argv: [,, site = '']} = process,
+	apis = [
+		['LLWiki', 'https://llwiki.org/mediawiki', 'llwiki'],
+		['萌娘百科', 'https://zh.moegirl.org.cn', 'moegirl'],
+		['维基百科', 'https://zh.wikipedia.org/w', 'zhwiki'],
+	].filter(([name]) => name.toLowerCase().includes(site.toLowerCase())),
+	complexOrHiddenTypes = [
+		// 以下为子节点必为Token的类
+		'ext',
+		'arg',
+		'template',
+		'magic-word',
+		'parameter',
+		'heading',
+		'html',
+		'table',
+		'tr',
+		'td',
+		'link',
+		'category',
+		'file',
+		'gallery-image',
+		'ext-link',
+		'converter',
+		'converter-flags',
+		'converter-rule',
+		// 以下为不可见的类
+		'noinclude',
+		'include',
+		'comment',
+		'double-underscore',
+		'hidden',
+		// 以下为SyntaxToken
+		'magic-word-name',
+		'heading-trail',
+		'table-syntax',
+		// 以下为代码不受限的NowikiToken
+		'ext-inner#nowiki',
+		'ext-inner#pre',
+		'ext-inner#syntaxhighlight',
+		'ext-inner#source',
+		'ext-inner#math',
+		'ext-inner#timeline',
+	],
+	simpleTypes = new Set([
+		'ext-inner',
+		'ext-attr',
+		'html-attr',
+		'table-attr',
+		'arg-default',
+		'parameter-key',
+		'parameter-value',
+		'heading-title',
+		'td-inner',
+		'link-target',
+		'link-text',
+		'image-parameter',
+		'ext-link-text',
+		'converter-rule-noconvert',
+		'converter-rule-to',
+	]),
+	possibleSyntax = /[{}]|\[{2,}|\[(?!(?:(?!https?\b)[^[])*\])|(?<=^|\])([^[]*?)\]+|<(?=\s*\/?\w+[\s/>])/giu;
+
+Parser.debugging = true;
+
+/**
+ * 获取最近更改的页面源代码
+ * @param {string} url api.php网址
+ */
+const getPages = async url => {
+	const api = new Api(url),
+		generatorParams = {generator: 'recentchanges', grcnamespace: '0|10', grclimit: 'max', grctype: 'edit'},
+		revisionParams = {prop: 'revisions', rvprop: 'contentmodel|content'};
+	/** @type {{query: {pages: MediaWikiPage[]}}} */
+	const {query: {pages}} = await api.get({...generatorParams, ...revisionParams});
+	return pages.map(({title, ns, revisions}) => ({
+		title, ns, content: revisions?.[0]?.contentmodel === 'wikitext' && revisions?.[0]?.content,
+	})).filter(({content}) => content);
+};
+
+(async () => {
+	const moreTypes = new Set();
+	for (const [name, url, config] of apis) {
+		Parser.debug(`开始检查${name}：`);
+		Parser.config = `./config/${config}`;
+		try {
+			const revs = await getPages(`${url}/api.php`);
+			for (const {title, ns, content} of revs) {
+				try {
+					console.time(title);
+					const root = Parser.parse(content, ns === 10);
+					console.timeEnd(title);
+					await diff(content, String(root));
+					for (const token of root.querySelectorAll(`:not(${complexOrHiddenTypes.join()})`)) {
+						const {childNodes, type, hidden} = token;
+						if (hidden && !simpleTypes.has(type)) {
+							moreTypes.add(type);
+							continue;
+						}
+						let first;
+						for (let i = 0; i < childNodes.length; i++) {
+							const /** @type {AstText} */ {type: childType, data} = childNodes[i];
+							if (childType === 'text') {
+								first = i;
+								if (data.search(possibleSyntax) >= 0) {
+									token.setText(data.replaceAll(possibleSyntax, '$1'), i);
+								}
+							}
+						}
+						if (first === undefined && !simpleTypes.has(type)) {
+							moreTypes.add(type);
+						}
+					}
+					await diff(content, String(root));
+				} catch (e) {
+					Parser.error(`解析${name}的 ${title} 页面时出错！`, e);
+				}
+			}
+		} catch (e) {
+			Parser.error(`访问${name}的API端口时出错！`, e);
+		}
+	}
+	if (moreTypes.size > 0) {
+		Parser.debug('其他可能不含纯文本子节点的类：', moreTypes);
+	}
+})();

package/test/test.js

@@ -0,0 +1,28 @@
+'use strict';
+/* eslint-disable no-var */
+const fs = require('fs/promises'),
+	assert = require('assert'), // eslint-disable-line no-unused-vars
+	path = require('path');
+
+var Parser = require('..');
+var wikitext = ''; // eslint-disable-line no-unused-vars
+const {argv: [,, title = '']} = process;
+Parser.debugging = true;
+
+(async () => {
+	const list = await fs.readdir(path.join(__dirname, '../wiki'));
+	for (const file of list) {
+		if (file.endsWith('.md') && file.toLowerCase().includes(title.toLowerCase())) {
+			Parser.debug(file);
+			const md = await fs.readFile(path.join(__dirname, '../wiki', file), 'utf8');
+			for (const [, code] of md.matchAll(/```js\n(.+?)\n```/gsu)) {
+				try {
+					eval(code); // eslint-disable-line no-eval
+				} catch (e) {
+					Parser.error(code);
+					throw e;
+				}
+			}
+		}
+	}
+})();

package/test/util.js

@@ -0,0 +1,80 @@
+'use strict';
+const {spawn} = require('child_process'),
+	fs = require('fs/promises');
+
+process.on('unhandledRejection', e => {
+	console.error(e);
+});
+
+/**
+ * 将shell命令转化为Promise对象
+ * @param {string} command shell指令
+ * @param {string[]} args shell输入参数
+ * @returns {Promise<?string>}
+ */
+const cmd = (command, args) => new Promise(resolve => {
+	let timer, shell;
+
+	/**
+	 * 清除进程并返回
+	 * @param {any} val 返回值
+	 */
+	const r = val => {
+		clearTimeout(timer);
+		shell.kill('SIGINT');
+		resolve(val);
+	};
+	try {
+		shell = spawn(command, args);
+		timer = setTimeout(() => {
+			shell.kill('SIGINT');
+		}, 60 * 1000);
+		let buf = '';
+		shell.stdout.on('data', data => {
+			buf += data.toString();
+		});
+		shell.stdout.on('end', () => {
+			r(buf);
+		});
+		shell.on('exit', () => {
+			r(shell.killed ? null : '');
+		});
+		shell.on('error', () => {
+			r(null);
+		});
+	} catch {
+		r(null);
+	}
+});
+
+/**
+ * 比较两个文件
+ * @param {string} oldfile 旧文件
+ * @param {string} newfile 新文件
+ */
+const diff = async (oldfile, newfile) => {
+	if (oldfile === newfile) {
+		return;
+	}
+	await Promise.all([fs.writeFile('npmTestOldContent', oldfile), fs.writeFile('npmTestNewContent', newfile)]);
+	const stdout = await cmd('git', [
+		'diff',
+		'--color-words=[\xc0-\xff][\x80-\xbf]+|<?/?\\w+/?>?|[^[:space:]]',
+		'-U0',
+		'--no-index',
+		'npmTestOldContent',
+		'npmTestNewContent',
+	]);
+	await Promise.all([fs.unlink('npmTestOldContent'), fs.unlink('npmTestNewContent')]);
+	console.log(stdout?.split('\n')?.slice(4)?.join('\n'));
+};
+
+/**
+ * 延时
+ * @param {number} t 秒数
+ */
+const sleep = t => new Promise(resolve => {
+	setTimeout(resolve, t * 1000);
+});
+
+module.exports = {diff, sleep};

package/tool/index.js

@@ -1,7 +1,9 @@
+/* eslint no-underscore-dangle: [2, {allowAfterThis: true, enforceInMethodNames: false, allow: ['__filename']}] */
 'use strict';
 
 const {typeError, externalUse} = require('../util/debug'),
 	{text, noWrap} = require('../util/string'),
+	AstText = require('../lib/text'),
 	Token = require('../src'),
 	assert = require('assert/strict');
 
@@ -9,7 +11,7 @@ const /** @type {WeakMap<Token, Record<string, any>>} */ dataStore = new WeakMap
 
 /**
  * @param {string} method
- * @param {string|Token|Token[]} selector
+ * @param {AstText|Token|Token[]} selector
  * @returns {(token: Token) => boolean}
  */
 const matchesGenerator = (method, selector) => {
@@ -20,7 +22,7 @@ const matchesGenerator = (method, selector) => {
 	} else if (selector instanceof Token) {
 		return token => token === selector;
 	}
-	typeError(TokenCollection, method, 'String', 'Token', 'Array');
+	return typeError(TokenCollection, method, 'String', 'Token', 'Array'); // eslint-disable-line no-use-before-define
 };
 
 /** @extends {Array<Token>} */
@@ -37,10 +39,10 @@ class TokenCollection extends Array {
 		for (const token of arr) {
 			if (token === undefined) {
 				continue;
-			} else if (typeof token === 'string') {
+			} else if (token instanceof AstText) {
 				this.push(token);
 			} else if (!(token instanceof Token)) {
-				this.typeError('constructor', 'String', 'Token');
+				this.typeError('constructor', 'AstText', 'Token');
 			} else if (!this.includes(token)) {
 				this.#roots.add(token.getRootNode());
 				this.push(token);
@@ -58,20 +60,21 @@ class TokenCollection extends Array {
 		return typeError(this.constructor, method, ...types);
 	}
 
+	/** 节点排序 */
 	#sort() {
-		if (this.some(token => typeof token === 'string')) {
+		if (this.some(({type}) => type === 'text')) {
 			return;
 		}
 		const rootArray = [...this.#roots];
 		this.sort((a, b) => {
 			const aRoot = a.getRootNode(),
 				bRoot = b.getRootNode();
-			return aRoot === bRoot ? a.comparePosition(b) : rootArray.indexOf(aRoot) - rootArray.indexOf(bRoot);
+			return aRoot === bRoot ? a.compareDocumentPosition(b) : rootArray.indexOf(aRoot) - rootArray.indexOf(bRoot);
 		});
 	}
 
 	toArray() {
-		return Array.from(this);
+		return [...this];
 	}
 
 	_filter(selector = '') {
@@ -108,9 +111,9 @@ class TokenCollection extends Array {
 
 	/** @param {CollectionCallback<void, string|Token>} callback */
 	each(callback) {
-		this.forEach((ele, i) => { // 不能使用`for`...`of`
-			callback.call(ele, i, ele);
-		});
+		for (let i = 0; i < this.length; i++) {
+			callback.call(this[i], i, this[i]);
+		}
 		return this;
 	}
 
@@ -162,8 +165,9 @@ class TokenCollection extends Array {
 	text(str) {
 		/** @type {(ele: Token, i: number, str: string) => string} */
 		const callback = typeof str === 'function' ? str.call : () => str;
-		if (['string', 'function'].includes(typeof str)) {
-			for (const [i, ele] of this.entries()) {
+		if (typeof str === 'string' || typeof str === 'function') {
+			for (let i = 0; i < this.length; i++) {
+				const ele = this[i];
 				if (ele instanceof Token) {
 					try {
 						ele.replaceChildren(callback(ele, i, ele.text()));
@@ -237,7 +241,7 @@ class TokenCollection extends Array {
 		} else if (selector instanceof Token) {
 			return arr.some(ele => ele.contains(selector));
 		}
-		this.typeError('has', 'String', 'Token');
+		return this.typeError('has', 'String', 'Token');
 	}
 
 	/** @param {string} selector */
@@ -292,11 +296,11 @@ class TokenCollection extends Array {
 	 */
 	_siblings(start, count, selector = '') {
 		return this._create(arr => arr.flatMap(ele => {
-			const {parentElement} = ele;
-			if (!parentElement) {
+			const {parentNode} = ele;
+			if (!parentNode) {
 				return undefined;
 			}
-			const {children} = parentElement,
+			const {children} = parentNode,
 				i = children.indexOf(ele);
 			children.splice(
 				typeof start === 'function' ? start(i) : start,
@@ -323,7 +327,7 @@ class TokenCollection extends Array {
 	 * @param {string|Token|Token[]} selector
 	 */
 	_until(method, selector, filter = '') {
-		const matches = matchesGenerator(`${method.replace(/All$/, '')}Until`, selector);
+		const matches = matchesGenerator(`${method.replace(/All$/u, '')}Until`, selector);
 		return this._create(arr => arr.flatMap(ele => {
 			const tokens = $(ele)[method]().toArray(),
 				tokenArray = method === 'nextAll' ? tokens : tokens.reverse(),
@@ -382,7 +386,7 @@ class TokenCollection extends Array {
 		if (name !== undefined && typeof name !== 'string' && !Array.isArray(name)) {
 			this.typeError('removeData', 'String', 'Array');
 		}
-		name = typeof name === 'string' ? name.split(/\s/) : name;
+		name = typeof name === 'string' ? name.split(/\s/u) : name;
 		for (const token of this._filter()) {
 			if (!$.dataStore.has(token)) {
 				continue;
@@ -404,14 +408,14 @@ class TokenCollection extends Array {
 	 * @param {AstListener} handler
 	 */
 	_addEventListener(events, selector, handler, once = false) {
-		if (!['string', 'object'].includes(typeof events)) {
+		if (typeof events !== 'string' && typeof events !== 'object') {
 			this.typeError(once ? 'once' : 'on', 'String', 'Object');
 		} else if (typeof selector === 'function') {
 			handler = selector;
 			selector = undefined;
 		}
 		const eventPair = typeof events === 'string'
-			? events.split(/\s/).map(/** @returns {[string, AstListener]} */ event => [event, handler])
+			? events.split(/\s/u).map(/** @returns {[string, AstListener]} */ event => [event, handler])
 			: Object.entries(events);
 		for (const token of this._filter(selector)) {
 			for (const [event, listener] of eventPair) {
@@ -445,14 +449,14 @@ class TokenCollection extends Array {
 	 * @param {AstListener} handler
 	 */
 	off(events, selector, handler) {
-		if (!['string', 'object', 'undefined'].includes(typeof events)) {
+		if (typeof events !== 'string' && typeof events !== 'object' && events !== undefined) {
 			this.typeError('off', 'String', 'Object');
 		}
 		handler = typeof selector === 'function' ? selector : handler;
 		let eventPair;
 		if (events) {
 			eventPair = typeof events === 'string'
-				? events.split(/\s/).map(/** @returns {[string, AstListener]} */ event => [event, handler])
+				? events.split(/\s/u).map(/** @returns {[string, AstListener]} */ event => [event, handler])
 				: Object.entries(events);
 		}
 		for (const token of this._filter(selector)) {
@@ -460,7 +464,7 @@ class TokenCollection extends Array {
 				token.removeAllEventListeners();
 			} else {
 				for (const [event, listener] of eventPair) {
-					if (typeof event !== 'string' || !['function', 'undefined'].includes(typeof listener)) {
+					if (typeof event !== 'string' || typeof listener !== 'function' && listener !== undefined) {
 						this.typeError('off', 'String', 'Function');
 					} else if (listener) {
 						token.removeEventListener(event, listener);
@@ -486,7 +490,7 @@ class TokenCollection extends Array {
 	triggerHandler(event, data) {
 		const firstToken = this._find();
 		if (!firstToken) {
-			return;
+			return undefined;
 		}
 		const e = typeof event === 'string' ? new Event(event) : event,
 			listeners = firstToken.listEventListeners(typeof event === 'string' ? event : event.type);
@@ -504,7 +508,8 @@ class TokenCollection extends Array {
 	 */
 	_insert(method, content, ...additional) {
 		if (typeof content === 'function') {
-			for (const [i, token] of this.entries()) {
+			for (let i = 0; i < this.length; i++) {
+				const token = this[i];
 				if (token instanceof Token) {
 					const result = content.call(token, i, token.toString());
 					if (typeof result === 'string' || result instanceof Token) {
@@ -576,7 +581,8 @@ class TokenCollection extends Array {
 	}
 
 	remove(selector = '') {
-		for (const token of this.removeData()._filter(selector)) {
+		this.removeData();
+		for (const token of this._filter(selector)) {
 			token.remove();
 			token.removeAllEventListeners();
 		}
@@ -659,7 +665,8 @@ class TokenCollection extends Array {
 		} else {
 			this.typeError('val', 'String', 'Array', 'Function');
 		}
-		for (const [i, token] of this.entries()) {
+		for (let i = 0; i < this.length; i++) {
+			const token = this[i];
 			if (token instanceof Token && typeof token.setValue === 'function' && token.setValue.length === 1) {
 				token.setValue(toValue(i, token));
 			}
@@ -678,7 +685,8 @@ class TokenCollection extends Array {
 			const firstToken = this._find();
 			return firstToken?.[getter] && firstToken[getter](name);
 		}
-		for (const [i, token] of this.entries()) {
+		for (let i = 0; i < this.length; i++) {
+			const token = this[i];
 			if (token instanceof Token && typeof token[setter] === 'function') {
 				if (typeof value === 'string') {
 					token[setter](name, value);
@@ -784,6 +792,7 @@ class TokenCollection extends Array {
 			this.typeError(method, 'Array', 'Function');
 		}
 		return this[method](
+
 			/**
 			 * @this {string|Token}
 			 * @param {number} i
@@ -817,7 +826,7 @@ class TokenCollection extends Array {
 	offset() {
 		const firstToken = this._find();
 		if (!firstToken) {
-			return;
+			return undefined;
 		}
 		const {top, left} = firstToken.getBoundingClientRect();
 		return {top, left};
@@ -837,9 +846,9 @@ class TokenCollection extends Array {
 	}
 }
 
-/** @param {string|Token|Iterable<string|Token>} tokens */
+/** @param {AstText|Token|Iterable<string|Token>} tokens */
 const $ = tokens => {
-	if (typeof tokens === 'string' || tokens instanceof Token) {
+	if (tokens instanceof AstText || tokens instanceof Token) {
 		tokens = [tokens];
 	}
 	return new Proxy(new TokenCollection(...tokens), {
@@ -851,6 +860,7 @@ const $ = tokens => {
 			) {
 				return obj[prop];
 			}
+			return undefined;
 		},
 		set(obj, prop, val) {
 			if (prop === 'prevObject' && (val === undefined || val instanceof TokenCollection)) {

package/typings/api.d.ts

@@ -0,0 +1,13 @@
+declare global {
+	interface MediaWikiRevision {
+		content: string;
+		contentmodel: string;
+	}
+	interface MediaWikiPage {
+		title: string;
+		ns: number;
+		revisions: MediaWikiRevision[];
+	};
+}
+
+export {};

package/typings/array.d.ts

@@ -0,0 +1,28 @@
+declare global {
+	interface Array<T> {
+		/**
+		 * Returns the value of the last element in the array where predicate is true, and undefined
+		 * otherwise.
+		 * @param predicate find calls predicate once for each element of the array, in descending
+		 * order, until it finds one where predicate returns true. If such an element is found, findLast
+		 * immediately returns that element value. Otherwise, findLast returns undefined.
+		 * @param thisArg If provided, it will be used as the this value for each invocation of
+		 * predicate. If it is not provided, undefined is used instead.
+		 */
+		findLast<S extends T>(predicate: (this: void, value: T, index: number, obj: T[]) => value is S, thisArg?: any): S | undefined;
+		findLast(predicate: (value: T, index: number, obj: T[]) => unknown, thisArg?: any): T | undefined;
+	
+		/**
+		 * Returns the index of the last element in the array where predicate is true, and -1
+		 * otherwise.
+		 * @param predicate find calls predicate once for each element of the array, in descending
+		 * order, until it finds one where predicate returns true. If such an element is found,
+		 * findLastIndex immediately returns that element index. Otherwise, findLastIndex returns -1.
+		 * @param thisArg If provided, it will be used as the this value for each invocation of
+		 * predicate. If it is not provided, undefined is used instead.
+		 */
+		findLastIndex(predicate: (value: T, index: number, obj: T[]) => unknown, thisArg?: any): number;
+	}
+}
+
+export {};

package/typings/event.d.ts

@@ -0,0 +1,24 @@
+import Token from '../src';
+import AstText from '../lib/text';
+
+declare global {
+	interface AstEvent extends Event {
+		readonly target: Token & AstText;
+		currentTarget: Token;
+		prevTarget: ?Token;
+	};
+	interface AstEventData {
+		position: number;
+		removed: AstText|Token;
+		inserted: AstText|Token;
+		oldToken: Token;
+		newToken: Token;
+		oldText: string;
+		newText: string;
+		oldKey: string;
+		newKey: string;
+	}
+	type AstListener = (e: AstEvent, data: AstEventData) => any;
+}
+
+export {};

package/typings/index.d.ts

@@ -7,13 +7,29 @@ declare global {
 		warning: boolean;
 		debugging: boolean;
 
-		/** 默认输出到console.warn */
+		/**
+		 * 默认输出到console.warn
+		 * @param {string} msg 消息
+		 * @param {...any} args 更多信息
+		 */
 		warn(msg: string, ...args: any[]): void;
-		/** 默认不输出到console.debug */
+		/**
+		 * 默认不输出到console.debug
+		 * @param {string} msg 消息
+		 * @param {...any} args 更多信息
+		 */
 		debug(msg: string, ...args: any[]): void;
-		/** 总是输出到console.error */
+		/**
+		 * 总是输出到console.error
+		 * @param {string} msg 消息
+		 * @param {...any} args 更多信息
+		 */
 		error(msg: string, ...args: any[]): void;
-		/** 总是输出到console.info */
+		/**
+		 * 总是输出到console.info
+		 * @param {string} msg 消息
+		 * @param {...any} args 更多信息
+		 */
 		info(msg: string, ...args: any[]): void;
 
 		running: boolean;
@@ -27,20 +43,46 @@ declare global {
 		/** 清除各模块的缓存 */
 		clearCache(): void;
 
+		/**
+		 * 打印函数定义
+		 * @param {Function} f 待打印的函数
+		 */
 		log(f: Function): void;
 
 		readonly aliases: string[][];
 
 		config: string;
+		/** 获取设置 */
 		getConfig(): ParserConfig;
 
+		/**
+		 * 是否是跨维基链接
+		 * @param {string} title 链接标题
+		 */
 		isInterwiki(title: string, config?: ParserConfig): RegExpMatchArray;
+		/**
+		 * 规范化页面标题
+		 * @param {string} title 标题（含或不含命名空间前缀）
+		 * @param {number} defaultNs 命名空间
+		 * @param {boolean} include 是否嵌入
+		 * @param {boolean} halfParsed 是否是半解析状态
+		 */
 		normalizeTitle(
 			title: string, defaultNs?: number, include?: boolean, config?: ParserConfig, halfParsed?: boolean
 		): Title;
 
 		readonly MAX_STAGE: number;
+		/**
+		 * 解析wikitext
+		 * @param {string|Token} wikitext wikitext
+		 * @param {boolean} include 是否嵌入
+		 * @param {number} maxStage 最大解析层级
+		 */
 		parse(wikitext: string|Token, include?: boolean, maxStage?: number, config?: ParserConfig): Token;
+		/**
+		 * 再次解析上次出错的wikitext
+		 * @param {string} date 错误日期
+		 */
 		reparse(date: string): Token;
 
 		getTool(): typeof $;

package/typings/node.d.ts

@@ -1,22 +1,28 @@
 import Ranges from '../lib/ranges';
 import Token from '../src';
+import AstText from '../lib/text';
 import ParameterToken from '../src/parameter';
 
 declare global {
 	type TokenAttribute<T> =
-		T extends 'childNodes' ? (string|Token)[] :
-		T extends 'parentNode' ? Token|undefined :
+		T extends 'stage' ? number :
+		T extends 'include' ? boolean :
+		T extends 'pattern' ? RegExp :
 		T extends 'optional'|'tags'|'flags' ? string[] :
-		T extends 'stage'|'indent' ? number :
+		T extends 'keys' ? Set<string> :
+		T extends 'attr' ? Map<string, string|true> :
+		T extends 'acceptable' ? Record<string, Ranges> :
+		T extends 'args' ? Record<string, Set<ParameterToken>> :
 		T extends 'config' ? ParserConfig :
 		T extends 'accum' ? accum :
-		T extends 'acceptable' ? Record<string, Ranges> :
 		T extends 'protectedChildren' ? Ranges :
-		T extends 'keys' ? Set<string> :
-		T extends 'args' ? Record<string, Set<ParameterToken>> :
-		T extends 'attr' ? Map<string, string|true> :
-		T extends 'include'|'selfLink'|'ul'|'ol'|'dt'|'unidirectional'|'bidirectional' ? boolean :
-		T extends 'pattern' ? RegExp :
+		T extends 'parentNode' ? Token|undefined :
+		T extends 'childNodes' ? (AstText|Token)[] :
+		T extends 'verifyChild' ? (i: number, addition: number) => void :
+		T extends 'matchesAttr' ? (key: string, equal: string, val: string, i: string) => boolean :
+		T extends 'parseOnce' ? (n: number, include: boolean) => Token :
+		T extends 'buildFromStr' ? (str: string) => (AstText|Token)[] :
+		T extends 'protectChildren' ? (...args: string|number|Range) => void :
 		string;
 }