wikiparser-node 1.0.0-beta.2 → 1.0.0-beta.4

package/config/minimum.json

@@ -0,0 +1,136 @@
+{
+	"ext": [],
+	"html": [
+		[
+			"b",
+			"bdi",
+			"del",
+			"i",
+			"ins",
+			"u",
+			"font",
+			"big",
+			"small",
+			"sub",
+			"sup",
+			"h1",
+			"h2",
+			"h3",
+			"h4",
+			"h5",
+			"h6",
+			"cite",
+			"code",
+			"em",
+			"s",
+			"strike",
+			"strong",
+			"tt",
+			"var",
+			"div",
+			"center",
+			"blockquote",
+			"ol",
+			"ul",
+			"dl",
+			"table",
+			"caption",
+			"pre",
+			"ruby",
+			"rb",
+			"rp",
+			"rt",
+			"rtc",
+			"p",
+			"span",
+			"abbr",
+			"dfn",
+			"kbd",
+			"samp",
+			"data",
+			"time",
+			"mark",
+			"tr",
+			"td",
+			"th",
+			"q",
+			"bdo"
+		],
+		[
+			"li",
+			"dt",
+			"dd"
+		],
+		[
+			"br",
+			"wbr",
+			"hr",
+			"meta",
+			"link",
+			"img"
+		]
+	],
+	"namespaces": {
+		"6": "File",
+		"10": "Template"
+	},
+	"nsid": {},
+	"parserFunction": [
+		{
+			"#language": "language",
+			"#special": "special",
+			"#speciale": "speciale",
+			"#tag": "tag",
+			"#formatdate": "formatdate",
+			"#invoke": "invoke",
+			"#while": "while",
+			"#dowhile": "dowhile",
+			"#loop": "loop",
+			"#forargs": "forargs",
+			"#fornumargs": "fornumargs",
+			"#if": "if",
+			"#ifeq": "ifeq",
+			"#switch": "switch",
+			"#ifexist": "ifexist",
+			"#ifexpr": "ifexpr",
+			"#iferror": "iferror",
+			"#time": "time",
+			"#timel": "timel",
+			"#expr": "expr",
+			"#rel2abs": "rel2abs",
+			"#titleparts": "titleparts",
+			"#categorytree": "categorytree",
+			"#urldecode": "urldecode",
+			"#choose": "choose",
+			"#var": "var",
+			"#varexists": "varexists",
+			"#var_final": "var_final",
+			"#vardefine": "vardefine",
+			"#vardefineecho": "vardefineecho",
+			"#widget": "widget",
+			"#regex": "regex",
+			"#related": "related",
+			"#cscore": "cscore"
+		},
+		[],
+		[
+			"msg",
+			"原始",
+			"raw"
+		],
+		[
+			"替代",
+			"subst",
+			"安全替代",
+			"safesubst"
+		]
+	],
+	"doubleUnderscore": [
+		[],
+		[]
+	],
+	"protocol": "bitcoin:|ftp://|ftps://|geo:|git://|gopher://|http://|https://|irc://|ircs://|magnet:|mailto:|mms://|news:|nntp://|redis://|sftp://|sip:|sips:|sms:|ssh://|svn://|tel:|telnet://|urn:|worldwind://|xmpp:",
+	"interwiki": [],
+	"img": {},
+	"variants": []
+}

package/dist/index.d.ts

@@ -58,5 +58,5 @@ declare interface Parser {
     isInterwiki(title: string, config?: Config): [string, string] | null;
 }
 declare const Parser: Parser;
-export default Parser;
+export = Parser;
 export type * from './internal';

package/dist/index.js

@@ -1,5 +1,5 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint n/exports-style: 0 */
 const fs = require("fs");
 const path = require("path");
 /**
@@ -7,13 +7,13 @@ const path = require("path");
  * @param file 文件名
  * @param dir 子路径
  */
-const rootRequire = (file, dir = '') => require(`../${file.includes('/') ? '' : dir}${file}`);
+const rootRequire = (file, dir) => require(file.startsWith('/') ? file : `../${file.includes('/') ? '' : dir}${file}`);
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 const Parser = {
     config: 'default',
+    MAX_STAGE: 11,
     conversionTable: new Map(),
     redirects: new Map(),
-    MAX_STAGE: 11,
     warning: true,
     debugging: false,
     running: false,
@@ -302,4 +302,4 @@ for (const key in Parser) {
     }
 }
 Object.defineProperties(Parser, def);
-exports.default = Parser;
+module.exports = Parser;

package/dist/internal.d.ts

@@ -6,7 +6,7 @@ export type * from './src/nowiki/noinclude';
 export type * from './src/tagPair/include';
 export type * from './src/nowiki/comment';
 export type * from './src/atom';
-export type * from './src/attribute';
+export type { AttributeToken } from './src/attribute';
 export type * from './src/attributes';
 export type * from './src/tagPair/ext';
 export type * from './src/hidden';

package/dist/lib/element.d.ts

@@ -88,10 +88,10 @@ export declare abstract class AstElement extends AstNode {
     /**
      * 还原为wikitext
      * @browser
-     * @param selector
+     * @param omit 忽略的节点类型
      * @param separator 子节点间的连接符
      */
-    toString(selector?: string, separator?: string): string;
+    toString(omit?: Set<string>, separator?: string): string;
     /**
      * Linter
      * @browser
@@ -106,7 +106,6 @@ export declare abstract class AstElement extends AstNode {
     print(opt?: PrintOpt): string;
     /**
      * 保存为JSON
-     * @browser
      * @param file 文件名
      */
     json(file?: string): unknown;
@@ -123,15 +122,20 @@ export declare abstract class AstElement extends AstNode {
      */
     querySelector(selector: string): Token | undefined;
     /**
-     * 符合选择器的所有后代节点
-     * @param selector 选择器
+     * 类型选择器
+     * @param types
      */
-    querySelectorAll(selector: string): Token[];
+    getElementByTypes(types: string): Token | undefined;
     /**
      * id选择器
      * @param id id名
      */
     getElementById(id: string): Token | undefined;
+    /**
+     * 符合选择器的所有后代节点
+     * @param selector 选择器
+     */
+    querySelectorAll(selector: string): Token[];
     /**
      * 类选择器
      * @param className 类名之一
@@ -139,9 +143,9 @@ export declare abstract class AstElement extends AstNode {
     getElementsByClassName(className: string): Token[];
     /**
      * 标签名选择器
-     * @param name 标签名
+     * @param tag 标签名
      */
-    getElementsByTagName(name: string): Token[];
+    getElementsByTagName(tag: string): Token[];
     /**
      * 获取某一行的wikitext
      * @param n 行号

package/dist/lib/element.js

@@ -7,7 +7,7 @@ const string_1 = require("../util/string");
 const selector_1 = require("../parser/selector");
 const ranges_1 = require("./ranges");
 const title_1 = require("./title");
-const index_1 = require("../index");
+const Parser = require("../index");
 const node_1 = require("./node");
 const lintIgnoredExt = new Set([
     'nowiki',
@@ -32,6 +32,16 @@ const lintIgnoredExt = new Set([
  * @param i 待检查的下标
  */
 const nth = (str, i) => new ranges_1.Ranges(str.split(',')).applyTo(i + 1).includes(i);
+/**
+ * 检测:lang()伪选择器
+ * @param node 节点
+ * @param node.attributes 节点属性
+ * @param regex 语言正则
+ */
+const matchesLang = ({ attributes }, regex) => {
+    const lang = attributes?.['lang'];
+    return typeof lang === 'string' && regex.test(lang);
+};
 /** 类似HTMLElement */
 class AstElement extends node_1.AstNode {
     /** @browser */
@@ -106,7 +116,7 @@ class AstElement extends node_1.AstNode {
      * @browser
      * @param separator 子节点间的连接符
      */
-    text(separator = '') {
+    text(separator) {
         return (0, string_1.text)(this.childNodes, separator);
     }
     /**
@@ -152,11 +162,11 @@ class AstElement extends node_1.AstNode {
      */
     insertAt(node, i = this.length) {
         if (node.contains(this)) {
-            index_1.default.error('不能插入祖先节点！', node);
+            Parser.error('不能插入祖先节点！', node);
             throw new RangeError('不能插入祖先节点！');
         }
         this.verifyChild(i, 1);
-        const childNodes = [...this.childNodes], e = new Event('insert', { bubbles: true }), j = index_1.default.running ? -1 : childNodes.indexOf(node);
+        const childNodes = [...this.childNodes], e = new Event('insert', { bubbles: true }), j = Parser.running ? -1 : childNodes.indexOf(node);
         if (j === -1) {
             node.parentNode?.removeChild(node);
             node.setAttribute('parentNode', this);
@@ -175,10 +185,17 @@ class AstElement extends node_1.AstNode {
      * @param selector 选择器
      */
     closest(selector) {
-        let { parentNode } = this;
-        const stack = (0, selector_1.parseSelector)(selector);
+        let { parentNode } = this, condition;
+        if (/[^a-z\-,\s]/u.test(selector)) {
+            const stack = (0, selector_1.parseSelector)(selector);
+            condition = /** @implements */ (token) => token.#matchesStack(stack);
+        }
+        else {
+            const types = new Set(selector.split(',').map(str => str.trim()));
+            condition = /** @implements */ ({ type }) => types.has(type);
+        }
         while (parentNode) {
-            if (parentNode.#matchesStack(stack)) {
+            if (condition(parentNode)) {
                 return parentNode;
             }
             ({ parentNode } = parentNode);
@@ -226,13 +243,13 @@ class AstElement extends node_1.AstNode {
     /**
      * 还原为wikitext
      * @browser
-     * @param selector
+     * @param omit 忽略的节点类型
      * @param separator 子节点间的连接符
      */
-    toString(selector, separator = '') {
-        return selector && this.matches(selector)
+    toString(omit, separator = '') {
+        return omit && this.matchesTypes(omit)
             ? ''
-            : this.childNodes.map(child => child.toString(selector)).join(separator);
+            : this.childNodes.map(child => child.toString(omit)).join(separator);
     }
     /**
      * Linter
@@ -253,19 +270,20 @@ class AstElement extends node_1.AstNode {
         }
         return errors;
     }
+    /** @private */
+    matchesTypes(types) {
+        return types.has(this.type);
+    }
     /**
      * 以HTML格式打印
      * @browser
      * @param opt 选项
      */
     print(opt = {}) {
-        return String(this)
-            ? `<span class="wpb-${opt.class ?? this.type}">${(0, string_1.print)(this.childNodes, opt)}</span>`
-            : '';
+        return String(this) ? `<span class="wpb-${opt.class ?? this.type}">${(0, string_1.print)(this.childNodes, opt)}</span>` : '';
     }
     /**
      * 保存为JSON
-     * @browser
      * @param file 文件名
      */
     json(file) {
@@ -391,7 +409,7 @@ class AstElement extends node_1.AstNode {
                         return this.#isProtected() === false;
                     default: {
                         const [t, n] = selector.split('#');
-                        return (!t || t === type || Boolean(index_1.default.typeAliases[type]?.includes(t)))
+                        return (!t || t === type || Boolean(Parser.typeAliases[type]?.includes(t)))
                             && (!n || n === name);
                     }
                 }
@@ -428,8 +446,7 @@ class AstElement extends node_1.AstNode {
                         throw new SyntaxError('错误的伪选择器用法。请使用形如 ":regex(\'attr, /re/i\')" 的格式。');
                     }
                     try {
-                        const regex = new RegExp(mt[2], mt[3]);
-                        return regex.test(String(this.getAttribute(mt[1].trim())));
+                        return new RegExp(mt[2], mt[3]).test(String(this.getAttribute(mt[1].trim())));
                     }
                     catch {
                         throw new SyntaxError(`错误的正则表达式：/${mt[2]}/${mt[3]}`);
@@ -483,15 +500,15 @@ class AstElement extends node_1.AstNode {
         return selector === undefined || this.#matchesStack((0, selector_1.parseSelector)(selector));
     }
     /**
-     * 符合组合选择器的第一个后代节点
-     * @param stack 解析后的一组选择器
+     * 符合条件的第一个后代节点
+     * @param condition 条件
      */
-    #queryStack(stack) {
+    #getElementBy(condition) {
         for (const child of this.children) {
-            if (child.#matchesStack(stack)) {
+            if (condition(child)) {
                 return child;
             }
-            const descendant = child.#queryStack(stack);
+            const descendant = child.#getElementBy(condition);
             if (descendant) {
                 return descendant;
             }
@@ -503,19 +520,35 @@ class AstElement extends node_1.AstNode {
      * @param selector 选择器
      */
     querySelector(selector) {
-        return this.#queryStack((0, selector_1.parseSelector)(selector));
+        const stack = (0, selector_1.parseSelector)(selector);
+        return this.#getElementBy(token => token.#matchesStack(stack));
     }
     /**
-     * 符合组合选择器的所有后代节点
-     * @param stack 解析后的一组选择器
+     * 类型选择器
+     * @param types
+     */
+    getElementByTypes(types) {
+        const typeSet = new Set(types.split(',').map(str => str.trim()));
+        return this.#getElementBy(({ type }) => typeSet.has(type));
+    }
+    /**
+     * id选择器
+     * @param id id名
+     */
+    getElementById(id) {
+        return this.#getElementBy(token => 'id' in token && token.id === id);
+    }
+    /**
+     * 符合条件的所有后代节点
+     * @param condition 条件
      */
-    #queryStackAll(stack) {
+    #getElementsBy(condition) {
         const descendants = [];
         for (const child of this.children) {
-            if (child.#matchesStack(stack)) {
+            if (condition(child)) {
                 descendants.push(child);
             }
-            descendants.push(...child.#queryStackAll(stack));
+            descendants.push(...child.#getElementsBy(condition));
         }
         return descendants;
     }
@@ -524,30 +557,22 @@ class AstElement extends node_1.AstNode {
      * @param selector 选择器
      */
     querySelectorAll(selector) {
-        return this.#queryStackAll((0, selector_1.parseSelector)(selector));
-    }
-    /**
-     * id选择器
-     * @param id id名
-     */
-    getElementById(id) {
-        const eid = id.replace(/(?<!\\)"/gu, '\\"');
-        return this.querySelector(`ext[id="${eid}"], html[id="${eid}"]`);
+        const stack = (0, selector_1.parseSelector)(selector);
+        return this.#getElementsBy(token => token.#matchesStack(stack));
     }
     /**
      * 类选择器
      * @param className 类名之一
      */
     getElementsByClassName(className) {
-        return this.querySelectorAll(`[className~="${className.replace(/(?<!\\)"/gu, '\\"')}"]`);
+        return this.#getElementsBy(token => 'classList' in token && token.classList.has(className));
     }
     /**
      * 标签名选择器
-     * @param name 标签名
+     * @param tag 标签名
      */
-    getElementsByTagName(name) {
-        const ename = name.replace(/(?<!\\)"/gu, '\\"');
-        return this.querySelectorAll(`ext[name="${ename}"], html[name="${ename}"]`);
+    getElementsByTagName(tag) {
+        return this.#getElementsBy(({ type, name }) => name === tag && (type === 'html' || type === 'ext'));
     }
     /**
      * 获取某一行的wikitext
@@ -573,7 +598,7 @@ class AstElement extends node_1.AstNode {
     #getChildIndex(node) {
         const i = this.childNodes.indexOf(node);
         if (i === -1) {
-            index_1.default.error('找不到子节点！', node);
+            Parser.error('找不到子节点！', node);
             throw new RangeError('找不到子节点！');
         }
         return i;
@@ -617,7 +642,7 @@ class AstElement extends node_1.AstNode {
             console.log(`${indent}\x1B[32m<%s>\x1B[0m${(0, string_1.noWrap)(str)}\x1B[32m</%s>\x1B[0m`, type, type);
             return;
         }
-        index_1.default.info(`${indent}<${type}>`);
+        Parser.info(`${indent}<${type}>`);
         let i = this.getPadding();
         if (i) {
             console.log(`${indent}  ${(0, string_1.noWrap)(str.slice(0, i))}`);
@@ -642,18 +667,8 @@ class AstElement extends node_1.AstNode {
         if (i < str.length) {
             console.log(`${indent}  ${(0, string_1.noWrap)(str.slice(i))}`);
         }
-        index_1.default.info(`${indent}</${type}>`);
+        Parser.info(`${indent}</${type}>`);
     }
 }
 exports.AstElement = AstElement;
-/**
- * 检测:lang()伪选择器
- * @param node 节点
- * @param node.attributes 节点属性
- * @param regex 语言正则
- */
-const matchesLang = ({ attributes }, regex) => {
-    const lang = attributes?.['lang'];
-    return typeof lang === 'string' && regex.test(lang);
-};
-index_1.default.classes['AstElement'] = __filename;
+Parser.classes['AstElement'] = __filename;

package/dist/lib/node.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstNode = void 0;
 const assert = require("assert/strict");
 const EventEmitter = require("events");
-const index_1 = require("../index");
+const Parser = require("../index");
 /**
  * 定制TypeError消息
  * @param {Function} Constructor 类
@@ -254,7 +254,7 @@ class AstNode {
      */
     isEqualNode(node) {
         try {
-            assert.deepStrictEqual(this, node);
+            assert.deepEqual(this, node);
         }
         catch (e) {
             if (e instanceof assert.AssertionError) {
@@ -431,8 +431,7 @@ class AstNode {
             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]);
+        return childNodes.indexOf(aAncestors[depth]) - childNodes.indexOf(bAncestors[depth]);
     }
     /**
      * 将行列号转换为字符位置
@@ -455,4 +454,4 @@ class AstNode {
     }
 }
 exports.AstNode = AstNode;
-index_1.default.classes['AstNode'] = __filename;
+Parser.classes['AstNode'] = __filename;

package/dist/lib/range.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstRange = void 0;
-const index_1 = require("../index");
+const Parser = require("../index");
 /**
  * 计算绝对位置
  * @param referenceNode 容器
@@ -33,8 +33,7 @@ class AstRange {
     }
     /** 起点绝对位置 */
     get startIndex() {
-        const { startContainer, startOffset } = this;
-        return getIndex(startContainer, startOffset);
+        return getIndex(this.startContainer, this.startOffset);
     }
     /** 终点容器 */
     get endContainer() {
@@ -46,8 +45,7 @@ class AstRange {
     }
     /** 终点绝对位置 */
     get endIndex() {
-        const { endContainer, endOffset } = this;
-        return getIndex(endContainer, endOffset);
+        return getIndex(this.endContainer, this.endOffset);
     }
     /** 起始和终止位置是否重合 */
     get collapsed() {
@@ -379,9 +377,8 @@ class AstRange {
     }
     /** 范围内的全部文本 */
     toString() {
-        const { startContainer, startIndex, endIndex } = this;
-        return String(startContainer.getRootNode()).slice(startIndex, endIndex);
+        return String(this.startContainer.getRootNode()).slice(this.startIndex, this.endIndex);
     }
 }
 exports.AstRange = AstRange;
-index_1.default.classes['AstRange'] = __filename;
+Parser.classes['AstRange'] = __filename;

package/dist/lib/ranges.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Ranges = exports.Range = void 0;
-const index_1 = require("../index");
+const Parser = require("../index");
 /** 模拟Python的Range对象。除`step`至少为`1`外，允许负数、小数或`end < start`的情形。 */
 class Range {
     start;
@@ -122,4 +122,4 @@ class Ranges extends Array {
     }
 }
 exports.Ranges = Ranges;
-index_1.default.classes['Ranges'] = __filename;
+Parser.classes['Ranges'] = __filename;

package/dist/lib/text.d.ts

@@ -14,7 +14,7 @@ export declare class AstText extends AstNode {
      * @browser
      * @param text 包含文本
      */
-    constructor(text?: string);
+    constructor(text: string);
     /**
      * 输出字符串
      * @browser
@@ -36,7 +36,7 @@ export declare class AstText extends AstNode {
      * @browser
      * @param text 替换的字符串
      */
-    replaceData(text?: string): void;
+    replaceData(text: string): void;
     /** 复制 */
     cloneNode(): AstText;
     /**

package/dist/lib/text.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstText = void 0;
-const index_1 = require("../index");
+const Parser = require("../index");
 const node_1 = require("./node");
 const errorSyntax = /https?:\/\/|\{+|\}+|\[{2,}|\[(?![^[]*\])|(?<=^|\])([^[]*?)\]+|\]{2,}|<\s*\/?([a-z]\w*)/giu, errorSyntaxUrl = /\{+|\}+|\[{2,}|\[(?![^[]*\])|(?<=^|\])([^[]*?)\]+|\]{2,}|<\s*\/?([a-z]\w*)/giu, disallowedTags = [
     'html',
@@ -69,7 +69,7 @@ class AstText extends node_1.AstNode {
      * @browser
      * @param text 包含文本
      */
-    constructor(text = '') {
+    constructor(text) {
         super();
         Object.defineProperties(this, {
             data: { value: text, writable: false },
@@ -118,7 +118,7 @@ class AstText extends node_1.AstNode {
                     ? 'error'
                     : 'warning';
                 return (char !== 'h' || index > 0) && (char !== '<' || tags.has(tag.toLowerCase())) && {
-                    message: index_1.default.msg('lonely "$1"', char === 'h' ? error : char),
+                    message: Parser.msg('lonely "$1"', char === 'h' ? error : char),
                     severity,
                     startIndex,
                     endIndex,
@@ -149,7 +149,7 @@ class AstText extends node_1.AstNode {
      * @browser
      * @param text 替换的字符串
      */
-    replaceData(text = '') {
+    replaceData(text) {
         this.#setData(text);
     }
     /** 复制 */
@@ -224,4 +224,4 @@ class AstText extends node_1.AstNode {
     }
 }
 exports.AstText = AstText;
-index_1.default.classes['AstText'] = __filename;
+Parser.classes['AstText'] = __filename;

package/dist/lib/title.d.ts

@@ -1,3 +1,4 @@
+import * as Parser from '../index';
 /** MediaWiki页面标题对象 */
 export declare class Title {
     /** @browser */
@@ -17,12 +18,12 @@ export declare class Title {
     get title(): string;
     /**
      * @browser
-     * @param str 标题（含或不含命名空间前缀）
+     * @param title 标题（含或不含命名空间前缀）
      * @param defaultNs 命名空间
      * @param decode 是否需要解码
      * @param selfLink 是否允许selfLink
      */
-    constructor(str: string, defaultNs?: number, config?: import("../index").Config, decode?: boolean, selfLink?: boolean);
+    constructor(title: string, defaultNs?: number, config?: Parser.Config, decode?: boolean, selfLink?: boolean);
     /** 完整链接 */
     toString(): string;
     /**