wikiparser-node 0.2.2 → 0.3.0

package/.eslintrc.json

@@ -5,10 +5,7 @@
 	},
 	"extends": "eslint:recommended",
 	"parserOptions": {
-		"ecmaVersion": 13,
-		"ecmaFeatures": {
-			"impliedStrict": true
-		}
+		"ecmaVersion": 13
 	},
 	"rules": {
 		"array-callback-return": [
@@ -18,13 +15,39 @@
 			}
 		],
 		"no-await-in-loop": 2,
+		"no-constant-binary-expression": 2,
 		"no-constructor-return": 2,
 		"no-fallthrough": 1,
 		"no-promise-executor-return": 2,
 		"no-self-compare": 2,
 		"no-template-curly-in-string": 2,
+		"no-undef": [
+			2,
+			{
+				"typeof": true
+			}
+		],
 		"no-unmodified-loop-condition": 2,
 		"no-unreachable-loop": 2,
+		"no-unsafe-negation": [
+			2,
+			{
+				"enforceForOrderingRelations": true
+			}
+		],
+		"no-unsafe-optional-chaining": [
+			2,
+			{
+				"disallowArithmeticOperators": true
+			}
+		],
+		"no-unused-vars": [
+			2,
+			{
+				"varsIgnorePattern": "AstNode|AstElement|[a-zA-Z]*Token",
+				"ignoreRestSiblings": true
+			}
+		],
 		"no-use-before-define": [
 			2,
 			{
@@ -33,7 +56,12 @@
 				"variables": false
 			}
 		],
-		"require-atomic-updates": 2,
+		"require-atomic-updates": [
+			2,
+			{
+				"allowProperties": true
+			}
+		],
 		"block-scoped-var": 2,
 		"class-methods-use-this": 0,
 		"consistent-this": 2,
@@ -47,6 +75,13 @@
 			2,
 			"never"
 		],
+		"logical-assignment-operators": [
+			2,
+			"always",
+			{
+				"enforceForIfStatements": true
+			}
+		],
 		"multiline-comment-style": 2,
 		"new-cap": [
 			1,
@@ -67,6 +102,12 @@
 		],
 		"no-eval": 2,
 		"no-extend-native": 2,
+		"no-extra-boolean-cast": [
+			2,
+			{
+				"enforceForLogicalOperands": true
+			}
+		],
 		"no-floating-decimal": 2,
 		"no-implied-eval": 2,
 		"no-invalid-this": [
@@ -91,7 +132,12 @@
 		"no-return-await": 2,
 		"no-script-url": 2,
 		"no-sequences": 2,
-		"no-shadow": 2,
+		"no-shadow": [
+			2,
+			{
+				"builtinGlobals": true
+			}
+		],
 		"no-undef-init": 2,
 		"no-unneeded-ternary": [
 			2,
@@ -139,6 +185,7 @@
 		],
 		"require-await": 2,
 		"spaced-comment": 2,
+        "strict": 2,
 		"symbol-description": 2,
 		"yoda": 2,
 		"array-bracket-spacing": 2,

package/config/default.json

@@ -646,65 +646,28 @@
 		"wikt",
 		"wiktionary",
 		"zhwiki",
-		"acronym",
-		"c2find",
+		"cc",
 		"cm",
-		"dictionary",
-		"drumcorpswiki",
-		"dwjwiki",
-		"elibre",
-		"emacswiki",
 		"enmoe",
-		"enwiki",
-		"foldoc",
-		"foxwiki",
-		"freebsdman",
-		"gentoo-wiki",
-		"hammondwiki",
-		"hrwiki",
+		"enwp",
+		"fandom",
+		"ghia",
+		"huiji",
 		"jamoe",
-		"kmwiki",
+		"jawp",
 		"library",
-		"linuxwiki",
-		"lojban",
-		"lqwiki",
-		"mcwiki",
-		"meatball",
-		"memoryalpha",
 		"meta",
-		"metawiki",
-		"mozillawiki",
-		"oeis",
-		"openwiki",
 		"phab",
 		"pmid",
-		"pythoninfo",
-		"rfc",
-		"s23wiki",
-		"seattlewireless",
-		"senseislibrary",
 		"shoutwiki",
-		"sourceforge",
-		"squeak",
-		"theopedia",
-		"tmbw",
-		"tmnet",
 		"translatewiki",
-		"twiki",
-		"uncyclopedia",
-		"unreal",
-		"usemod",
-		"wiki",
-		"wikif1",
-		"wikihow",
 		"zhmoe",
 		"zhmoegirl",
 		"zhtest",
+		"zhwp",
 		"文库",
-		"维基中文",
-		"维基日文",
-		"维基英文",
 		"萌娘共享",
+		"萌娘文库",
 		"萌百"
 	],
 	"img": {

package/config/moegirl.json

@@ -578,20 +578,14 @@
 	],
 	"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": [
-		"arxiv",
 		"commons",
-		"doi",
-		"imdb",
-		"jawiki",
 		"mediawikiwiki",
 		"metawikimedia",
 		"mw",
-		"wikia",
 		"wikibooks",
 		"wikidata",
 		"wikimedia",
 		"wikinews",
-		"wikiinfo",
 		"wikipedia",
 		"wikiquote",
 		"wikisource",
@@ -600,66 +594,31 @@
 		"wikivoyage",
 		"wikt",
 		"wiktionary",
-		"zhwiki",
-		"acronym",
-		"c2find",
+		"cc",
 		"cm",
-		"dictionary",
-		"drumcorpswiki",
-		"dwjwiki",
-		"elibre",
-		"emacswiki",
+		"en",
 		"enmoe",
-		"enwiki",
-		"foldoc",
-		"foxwiki",
-		"freebsdman",
-		"gentoo-wiki",
-		"hammondwiki",
-		"hrwiki",
+		"enwp",
+		"fandom",
+		"ghia",
+		"huiji",
+		"ja",
 		"jamoe",
-		"kmwiki",
+		"jawp",
 		"library",
-		"linuxwiki",
-		"lojban",
-		"lqwiki",
-		"mcwiki",
-		"meatball",
-		"memoryalpha",
 		"meta",
-		"metawiki",
-		"mozillawiki",
-		"oeis",
-		"openwiki",
 		"phab",
 		"pmid",
-		"pythoninfo",
-		"rfc",
-		"s23wiki",
-		"seattlewireless",
-		"senseislibrary",
 		"shoutwiki",
-		"sourceforge",
-		"squeak",
-		"theopedia",
-		"tmbw",
-		"tmnet",
 		"translatewiki",
-		"twiki",
-		"uncyclopedia",
-		"unreal",
-		"usemod",
-		"wiki",
-		"wikif1",
-		"wikihow",
+		"zh",
 		"zhmoe",
 		"zhmoegirl",
 		"zhtest",
+		"zhwp",
 		"文库",
-		"维基中文",
-		"维基日文",
-		"维基英文",
 		"萌娘共享",
+		"萌娘文库",
 		"萌百"
 	],
 	"img": {

package/lib/element.js

@@ -39,12 +39,12 @@ class AstElement extends AstNode {
 	/** @complexity `n` */
 	get nextElementSibling() {
 		const children = this.parentElement?.children;
-		return children?.[children?.indexOf(this) + 1];
+		return children && children[children.indexOf(this) + 1];
 	}
 	/** @complexity `n` */
 	get previousElementSibling() {
 		const children = this.parentElement?.children;
-		return children?.[children?.indexOf(this) - 1];
+		return children && children[children.indexOf(this) - 1];
 	}
 	/** @complexity `n` */
 	get hidden() {
@@ -673,18 +673,11 @@ class AstElement extends AstNode {
 	}
 
 	/**
-	 * 不作为特殊语法的文字
-	 * @returns {[number, string][]}
+	 * @returns {boolean}
 	 * @complexity `n`
 	 */
-	plain() {
-		const index = this.getAbsoluteIndex();
-		return this.childNodes.flatMap((node, i) => {
-			if (node instanceof AstElement) {
-				return node.plain();
-			}
-			return node ? [[index + this.getRelativeIndex(i), node]] : [];
-		});
+	get eof() {
+		return this.type === 'root' || !this.nextSibling && this.parentElement.eof;
 	}
 
 	/**
@@ -743,6 +736,11 @@ class AstElement extends AstNode {
 		}
 		Parser.info(`${indent}</${type}>`);
 	}
+
+	/** @param {number} n */
+	getLine(n) {
+		return this.toString().split('\n', n + 1).at(-1);
+	}
 }
 
 Parser.classes.AstElement = __filename;

package/lib/node.js

@@ -22,12 +22,12 @@ class AstNode {
 	/** @complexity `n` */
 	get nextSibling() {
 		const childNodes = this.#parentNode?.childNodes;
-		return childNodes?.[childNodes?.indexOf(this) + 1];
+		return childNodes && childNodes[childNodes.indexOf(this) + 1];
 	}
 	/** @complexity `n` */
 	get previousSibling() {
 		const childNodes = this.#parentNode?.childNodes;
-		return childNodes?.[childNodes?.indexOf(this) - 1];
+		return childNodes && childNodes[childNodes.indexOf(this) - 1];
 	}
 
 	debugOnly(method = 'debugOnly') {

package/lib/title.js

@@ -5,6 +5,8 @@ const {ucfirst} = require('../util/string'),
 
 class Title {
 	title = '';
+	main = '';
+	prefix = '';
 	ns = 0;
 	interwiki = '';
 	fragment = '';
@@ -19,7 +21,7 @@ class Title {
 			namespace = '';
 			title = title.slice(1).trim();
 		}
-		const iw = Parser.isInterwiki(title, config);
+		const iw = defaultNs ? null : Parser.isInterwiki(title, config);
 		if (iw) {
 			this.interwiki = iw[1].toLowerCase();
 			title = title.slice(iw[0].length);
@@ -48,8 +50,10 @@ class Title {
 			this.fragment ||= fragment;
 			title = title.slice(0, i).trim();
 		}
-		this.title = `${iw ? `${this.interwiki}:` : ''}${namespace}${namespace && ':'}${ucfirst(title)}`;
-		this.valid = !/\x00\d+[eh!+-]\x7f|[<>[\]{}|]/.test(this.title);
+		this.main = ucfirst(title);
+		this.prefix = `${namespace}${namespace && ':'}`;
+		this.title = `${iw ? `${this.interwiki}:` : ''}${this.prefix}${this.main}`;
+		this.valid = Boolean(this.main) && !/\x00\d+[eh!+-]\x7f|[<>[\]{}|]/.test(this.title);
 	}
 }
 

package/mixin/attributeParent.js

@@ -1,14 +1,14 @@
 'use strict';
 
 const /** @type {Parser} */ Parser = require('..'),
-	AttributeToken = require('../src/attribute'); // eslint-disable-line no-unused-vars
+	AttributeToken = require('../src/attribute');
 
 /**
  * @template T
  * @param {T} constructor
  * @returns {T}
  */
-const attributeParent = (constructor, i = 0) => class extends constructor {
+const attributeParent = (ct, i = 0) => class extends ct {
 	/**
 	 * @this {{children: AttributeToken[]}}
 	 * @param {string} key

package/mixin/fixedToken.js

@@ -7,7 +7,7 @@ const /** @type {Parser} */ Parser = require('..');
  * @param {T} constructor
  * @returns {T}
  */
-const fixedToken = constructor => class extends constructor {
+const fixedToken = ct => class extends ct {
 	static fixed = true;
 
 	removeAt() {

package/mixin/hidden.js

@@ -7,15 +7,10 @@ const /** @type {Parser} */ Parser = require('..');
  * @param {T} constructor
  * @returns {T}
  */
-const hidden = constructor => class extends constructor {
+const hidden = ct => class extends ct {
 	text() {
 		return '';
 	}
-
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
 };
 
 Parser.mixins.hidden = __filename;

package/mixin/sol.js

@@ -1,14 +1,14 @@
 'use strict';
 
 const /** @type {Parser} */ Parser = require('..'),
-	Token = require('../src'); // eslint-disable-line no-unused-vars
+	Token = require('../src');
 
 /**
  * @template T
  * @param {T} constructor
  * @returns {T}
  */
-const sol = constructor => class extends constructor {
+const sol = ct => class extends ct {
 	/** @this {Token} */
 	prependNewLine() {
 		const {previousVisibleSibling = '', parentNode} = this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wikiparser-node",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "A Node.js parser for MediaWiki markup with AST",
   "keywords": [
     "mediawiki",
@@ -21,8 +21,8 @@
     "test": "echo 'Error: no test specified' && exit 1"
   },
   "devDependencies": {
-    "eslint": "^8.8.0",
-    "@types/node": "^17.0.23"
+    "@types/node": "^17.0.23",
+    "eslint": "^8.30.0"
   },
   "engines": {
     "node": "^18.4.0"

package/parser/hrAndDoubleUnderscore.js

@@ -10,7 +10,7 @@ const parseHrAndDoubleUnderscore = (firstChild, config = Parser.getConfig(), acc
 	const HrToken = require('../src/nowiki/hr'),
 		DoubleUnderscoreToken = require('../src/nowiki/doubleUnderscore'),
 		{doubleUnderscore} = config;
-	return firstChild.replace(/^-{4,}/mg, m => {
+	return firstChild.replace(/(?<=^(?:\x00\d+c\x7f)*)-{4,}/mg, m => {
 		new HrToken(m.length, config, accum);
 		return `\x00${accum.length - 1}r\x7f`;
 	}).replace(new RegExp(`__(${doubleUnderscore.flat().join('|')})__`, 'ig'), /** @param {string} p1 */(m, p1) => {

package/parser/links.js

@@ -1,7 +1,7 @@
 'use strict';
 
 const /** @type {Parser} */ Parser = require('..'),
-	Token = require('../src'); // eslint-disable-line no-unused-vars
+	Token = require('../src');
 
 /**
  * @param {string} firstChild
@@ -78,7 +78,7 @@ const parseLinks = (firstChild, config = Parser.getConfig(), accum = []) => {
 				continue;
 			}
 		}
-		text = text && parseQuotes(text, config, accum);
+		text &&= parseQuotes(text, config, accum);
 		s += `\x00${accum.length}l\x7f${after}`;
 		let LinkToken = require('../src/link');
 		if (!force) {

package/parser/list.js

@@ -7,13 +7,13 @@ const /** @type {Parser} */ Parser = require('..');
  * @param {accum} accum
  */
 const parseList = (text, config = Parser.getConfig(), accum = []) => {
-	const mt = text.match(/^(?:[;:*#]|\x00\d+c\x7f)*[;:*#]/);
+	const mt = text.match(/^((?:\x00\d+c\x7f)*)([;:*#]+)/);
 	if (!mt) {
 		return text;
 	}
 	const ListToken = require('../src/nowiki/list'),
-		[prefix] = mt;
-	text = `\x00${accum.length}d\x7f${text.slice(prefix.length)}`;
+		[total, comment, prefix] = mt;
+	text = `${comment}\x00${accum.length}d\x7f${text.slice(total.length)}`;
 	new ListToken(prefix, config, accum);
 	let dt = prefix.split(';').length - 1;
 	if (!dt) {

package/parser/quotes.js

@@ -35,8 +35,8 @@ const parseQuotes = (text, config = Parser.getConfig(), accum = []) => {
 					}
 				} else if (arr[i - 1].at(-2) === ' ') {
 					firstSingle = i;
-				} else if (!firstMulti) {
-					firstMulti = i;
+				} else {
+					firstMulti ||= i;
 				}
 				break;
 			default:

package/parser/table.js

@@ -36,6 +36,9 @@ const parseTable = ({firstChild, type}, config = Parser.getConfig(), accum = [])
 		const line = outLine.slice(spaces.length),
 			matchesStart = line.match(/^(:*)((?:\s|\x00\d+c\x7f)*)({\||{\x00\d+!\x7f|\x00\d+{\x7f)(.*)/);
 		if (matchesStart) {
+			while (top && top.type !== 'td') {
+				top = stack.pop();
+			}
 			const [, indent, moreSpaces, tableSyntax, attr] = matchesStart;
 			if (indent) {
 				new DdToken(indent, config, accum);

package/src/arg.js

@@ -73,11 +73,6 @@ class ArgToken extends Token {
 		return `{{{${text(this.children.slice(0, 2), '|')}}}}`;
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return this.childNodes.length > 1 ? this.children[1].plain() : [];
-	}
-
 	/** @complexity `n` */
 	removeRedundant() {
 		Parser.run(() => {

package/src/attribute.js

@@ -82,7 +82,7 @@ class AttributeToken extends Token {
 	 * @param {accum} accum
 	 */
 	constructor(attr, type, name, config = Parser.getConfig(), accum = []) {
-		super(attr, config, type !== 'ext-attr', accum, {[`Stage-${stages[type]}`]: ':'});
+		super(attr, config, true, accum, {[`Stage-${stages[type]}`]: ':'});
 		this.type = type;
 		this.setAttribute('name', name).#parseAttr();
 	}
@@ -253,11 +253,6 @@ class AttributeToken extends Token {
 		return this.type === 'table-attr' ? normalizeSpace(str) : str;
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/**
 	 * @param {number} i
 	 * @complexity `n`

package/src/converter.js

@@ -19,7 +19,7 @@ class ConverterToken extends Token {
 	 * @param {accum} accum
 	 */
 	constructor(flags, rules, config = Parser.getConfig(), accum = []) {
-		super(undefined, config, false, accum);
+		super(undefined, config, true, accum);
 		this.append(new ConverterFlagsToken(flags, config, accum));
 		if (rules.length) {
 			const [firstRule] = rules,
@@ -65,11 +65,6 @@ class ConverterToken extends Token {
 		return `-{${flags.text()}|${text(rules, ';')}}-`;
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return this.children.slice(1).flatMap(child => child.plain());
-	}
-
 	/** @this {ConverterToken & {firstChild: ConverterFlagsToken}} */
 	getAllFlags() {
 		return this.firstChild.getAllFlags();

package/src/converterFlags.js

@@ -17,7 +17,7 @@ class ConverterFlagsToken extends Token {
 	 * @param {accum} accum
 	 */
 	constructor(flags, config = Parser.getConfig(), accum = []) {
-		super(undefined, config, false, accum, {AtomToken: ':'});
+		super(undefined, config, true, accum, {AtomToken: ':'});
 		this.append(...flags.map(flag => new AtomToken(flag, 'converter-flag', config, accum)));
 	}
 
@@ -86,11 +86,6 @@ class ConverterFlagsToken extends Token {
 		return super.text(';');
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/**
 	 * @param {string} flag
 	 * @returns {AtomToken[]}

package/src/converterRule.js

@@ -47,7 +47,7 @@ class ConverterRuleToken extends Token {
 
 	cloneNode() {
 		const cloned = this.cloneChildren(),
-			placeholders = ['', ':', '=>:'],
+			placeholders = ['', 'zh:', '=>zh:'],
 			placeholder = placeholders[cloned.length - 1],
 			token = Parser.run(() => new ConverterRuleToken(placeholder, placeholder, this.getAttribute('config')));
 		for (let i = 0; i < cloned.length; i++) {
@@ -120,15 +120,6 @@ class ConverterRuleToken extends Token {
 		return super.text(':');
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		const {firstElementChild, lastElementChild, unidirectional} = this;
-		if (unidirectional) {
-			return [...firstElementChild.plain(), ...lastElementChild.plain()];
-		}
-		return lastElementChild.plain();
-	}
-
 	noConvert() {
 		for (let i = this.childNodes.length - 2; i >= 0; i--) {
 			super.removeAt(i);

package/src/extLink.js

@@ -47,6 +47,7 @@ class ExtLinkToken extends Token {
 		if (text) {
 			token.appendChild(text);
 		}
+		return token;
 	}
 
 	#correct() {
@@ -77,14 +78,6 @@ class ExtLinkToken extends Token {
 		return `[${super.text(' ').replaceAll('\n', ' ')}]`;
 	}
 
-	/**
-	 * @returns {[number, string][]}
-	 * @complexity `n`
-	 */
-	plain() {
-		return this.childNodes.length === 1 ? [] : this.lastElementChild.plain();
-	}
-
 	/** @this {ExtLinkToken & {firstElementChild: MagicLinkToken}} */
 	getUrl() {
 		return this.firstElementChild.getUrl();

package/src/gallery.js

@@ -0,0 +1,64 @@
+'use strict';
+
+const {text} = require('../util/string'),
+	/** @type {Parser} */ Parser = require('..'),
+	Token = require('.'),
+	GalleryImageToken = require('./link/galleryImage');
+
+/**
+ * gallery标签
+ * @classdesc `{childNodes: (string|FileToken)[]]}`
+ */
+class GalleryToken extends Token {
+	type = 'ext-inner';
+	name = 'gallery';
+
+	/**
+	 * @param {string} inner
+	 * @param {accum} accum
+	 */
+	constructor(inner, config = Parser.getConfig(), accum = []) {
+		super(undefined, config, true, accum, {String: ':', GalleryImageToken: ':'});
+		for (const line of inner?.split('\n') ?? []) {
+			const matches = line.match(/^([^|]+)(?:\|(.*))?/);
+			if (!matches) {
+				this.appendChild(line);
+				continue;
+			}
+			const [, file, alt] = matches;
+			let title;
+			try {
+				title = this.normalizeTitle(decodeURIComponent(file), 6, true);
+			} catch {
+				title = this.normalizeTitle(file, 6, true);
+			}
+			if (!title.valid) {
+				this.appendChild(line);
+			} else {
+				this.appendChild(new GalleryImageToken(file, alt, title, config, accum));
+			}
+		}
+	}
+
+	cloneNode() {
+		const cloned = this.cloneChildren(),
+			token = Parser.run(() => new GalleryToken(undefined, this.getAttribute('config')));
+		token.append(...cloned);
+		return token;
+	}
+
+	toString() {
+		return super.toString('\n');
+	}
+
+	getGaps() {
+		return 1;
+	}
+
+	text() {
+		return text(this.children, '\n');
+	}
+}
+
+Parser.classes.GalleryToken = __filename;
+module.exports = GalleryToken;

package/src/heading.js

@@ -63,11 +63,6 @@ class HeadingToken extends fixedToken(sol(Token)) {
 		return `${this.prependNewLine()}${equals}${this.firstElementChild.text()}${equals}${this.appendNewLine()}`;
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return this.firstElementChild.plain();
-	}
-
 	/** @param {number} n */
 	setLevel(n) {
 		if (typeof n !== 'number') {

package/src/html.js

@@ -62,11 +62,6 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 		return `<${this.closing ? '/' : ''}${this.#tag}${super.text()}${this.selfClosing ? '/' : ''}>`;
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/** @param {string} tag */
 	replaceTag(tag) {
 		const name = tag.toLowerCase();

package/src/link/category.js

@@ -2,7 +2,7 @@
 
 const /** @type {Parser} */ Parser = require('../..'),
 	LinkToken = require('.'),
-	Token = require('..'); // eslint-disable-line no-unused-vars
+	Token = require('..');
 
 /**
  * 分类
@@ -12,6 +12,7 @@ class CategoryToken extends LinkToken {
 	type = 'category';
 	sortkey = '';
 
+	setLangLink = undefined;
 	setFragment = undefined;
 	asSelfLink = undefined;
 	pipeTrick = undefined;
@@ -74,11 +75,6 @@ class CategoryToken extends LinkToken {
 		return `[[${this.firstElementChild.text()}]]`;
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/** @param {string} text */
 	setSortkey(text) {
 		this.setLinkText(text);

package/src/link/file.js

@@ -15,6 +15,7 @@ class FileToken extends LinkToken {
 	/** @type {Set<string>} */ #keys = new Set();
 	/** @type {Record<string, Set<ImageParameterToken>>} */ #args = {};
 
+	setLangLink = undefined;
 	setFragment = undefined;
 	asSelfLink = undefined;
 	setLinkText = undefined;
@@ -63,7 +64,7 @@ class FileToken extends LinkToken {
 		super(link, undefined, title, config, accum);
 		this.setAttribute('acceptable', {AtomToken: 0, ImageParameterToken: '1:'});
 		this.append(...explode('-{', '}-', '|', text).map(part => new ImageParameterToken(part, config, accum)));
-		this.seal(['setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick']);
+		this.seal(['setLangLink', 'setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick']);
 	}
 
 	/**

package/src/link/galleryImage.js

@@ -0,0 +1,47 @@
+'use strict';
+
+const /** @type {Parser} */ Parser = require('../..'),
+	Token = require('..'),
+	FileToken = require('./file');
+
+/**
+ * 图片
+ * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken]}`
+ */
+class GalleryImageToken extends FileToken {
+	type = 'gallery-image';
+
+	size = undefined;
+	width = undefined;
+	height = undefined;
+
+	/**
+	 * @param {string} link
+	 * @param {string|undefined} text
+	 * @param {Title} title
+	 * @param {accum} accum
+	 */
+	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
+		let token;
+		if (text !== undefined) {
+			token = new Token(text, config, true, accum);
+			token.type = 'temp';
+			token.setAttribute('stage', 1);
+			for (let n = 1; n < Parser.MAX_STAGE; n++) {
+				token.parseOnce();
+			}
+			accum.splice(accum.indexOf(token), 1);
+		}
+		const newConfig = structuredClone(config);
+		newConfig.img = Object.fromEntries(Object.entries(config.img).filter(([, param]) => param !== 'width'));
+		super(link, token?.toString(), title, newConfig, accum);
+		this.seal(['size', 'width', 'height']);
+	}
+
+	getPadding() {
+		return 0;
+	}
+}
+
+Parser.classes.GalleryImageToken = __filename;
+module.exports = GalleryImageToken;

package/src/link/index.js

@@ -47,7 +47,7 @@ class LinkToken extends Token {
 					title: this.name, interwiki: this.interwiki, fragment: this.fragment,
 				}, this.getAttribute('config'));
 			token.firstElementChild.safeReplaceWith(link);
-			token.appendChild(...linkText);
+			token.append(...linkText);
 			return token.afterBuild();
 		});
 	}
@@ -90,7 +90,8 @@ class LinkToken extends Token {
 	}
 
 	toString() {
-		return `[[${super.toString('|')}]]`;
+		const str = super.toString('|');
+		return this.type === 'gallery-image' ? str : `[[${str}]]`;
 	}
 
 	getPadding() {
@@ -102,24 +103,20 @@ class LinkToken extends Token {
 	}
 
 	text() {
-		return `[[${super.text('|')}]]`;
-	}
-
-	/** @returns {[number, string][]} */
-	plain() {
-		return this.childNodes.length === 1 ? [] : this.lastElementChild.plain();
+		const str = super.text('|');
+		return this.type === 'gallery-image' ? str : `[[${str}]]`;
 	}
 
 	/** @param {string} link */
 	setTarget(link) {
 		link = String(link);
-		if (!/^\s*[:#]/.test(link)) {
+		if (link.type === 'link' && !/^\s*[:#]/.test(link)) {
 			link = `:${link}`;
 		}
 		const root = Parser.parse(`[[${link}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
 			{childNodes: {length}, firstElementChild} = root;
 		if (length !== 1 || firstElementChild?.type !== this.type || firstElementChild.childNodes.length !== 1) {
-			const msgs = {link: '内链', file: '文件链接', category: '分类'};
+			const msgs = {link: '内链', file: '文件链接', category: '分类', 'gallery-image': '文件链接'};
 			throw new SyntaxError(`非法的${msgs[this.type]}目标：${link}`);
 		}
 		const {firstChild} = firstElementChild;
@@ -128,6 +125,33 @@ class LinkToken extends Token {
 		this.firstElementChild.safeReplaceWith(firstChild);
 	}
 
+	/**
+	 * @param {string} lang
+	 * @param {string} link
+	 */
+	setLangLink(lang, link) {
+		if (typeof lang !== 'string') {
+			this.typeError('setLangLink', 'String');
+		}
+		link = String(link).trim();
+		if (link.startsWith('#')) {
+			throw new SyntaxError(`跨语言链接不能仅为fragment！`);
+		} else if (link.startsWith(':')) {
+			link = link.slice(1);
+		}
+		const root = Parser.parse(`[[${lang}:${link}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
+			/** @type {Token & {firstElementChild: LinkToken}} */ {childNodes: {length}, firstElementChild} = root;
+		if (length !== 1 || firstElementChild?.type !== 'link' || firstElementChild.childNodes.length !== 1
+			|| firstElementChild.interwiki !== lang.toLowerCase()
+		) {
+			throw new SyntaxError(`非法的跨语言链接目标：${lang}:${link}`);
+		}
+		const {firstChild} = firstElementChild;
+		root.destroy();
+		firstElementChild.destroy();
+		this.firstElementChild.safeReplaceWith(firstChild);
+	}
+
 	/** @param {string} fragment */
 	#setFragment(fragment, page = true) {
 		fragment = String(fragment).replace(/[<>[]#|=!]/g, p => encodeURIComponent(p));

package/src/magicLink.js

@@ -37,7 +37,7 @@ class MagicLinkToken extends Token {
 	}
 
 	afterBuild() {
-		const ParameterToken = require('./parameter'), // eslint-disable-line no-unused-vars
+		const ParameterToken = require('./parameter'),
 			/** @type {ParameterToken} */ parameter = this.closest('parameter');
 		if (parameter?.getValue() === this.text()) {
 			this.replaceWith(this.toString());
@@ -45,6 +45,16 @@ class MagicLinkToken extends Token {
 		return this;
 	}
 
+	cloneNode() {
+		const cloned = this.cloneChildren(),
+			token = Parser.run(() => new MagicLinkToken(
+				undefined, this.type === 'ext-link-url', this.getAttribute('config'),
+			));
+		token.append(...cloned);
+		token.afterBuild();
+		return token;
+	}
+
 	getUrl() {
 		let url = this.text();
 		if (url.startsWith('//')) {

package/src/nowiki/dd.js

@@ -29,11 +29,6 @@ class DdToken extends NowikiToken {
 		this.seal(['dt', 'ul', 'ol', 'indent']).#update(str);
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/** @param {string} str */
 	setText(str) {
 		const src = this.type === 'dd' ? ':' : ';:*#';

package/src/nowiki/hr.js

@@ -24,11 +24,6 @@ class HrToken extends sol(NowikiToken) {
 		return Parser.run(() => new HrToken(this.firstChild.length, this.getAttribute('config')));
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/** @param {string} str */
 	setText(str) {
 		if (!/^-{4,}$/.test(str)) {

package/src/nowiki/index.js

@@ -16,7 +16,7 @@ class NowikiToken extends fixedToken(Token) {
 	 * @param {accum} accum
 	 */
 	constructor(wikitext, config = Parser.getConfig(), accum = []) {
-		super(wikitext, config, false, accum);
+		super(wikitext, config, true, accum);
 	}
 
 	/** @this {NowikiToken & {firstChild: string}} */

package/src/nowiki/quote.js

@@ -26,11 +26,6 @@ class QuoteToken extends NowikiToken {
 		}
 		return super.setText(str);
 	}
-
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
 }
 
 Parser.classes.QuoteToken = __filename;

package/src/onlyinclude.js

@@ -15,7 +15,7 @@ class OnlyincludeToken extends Token {
 	 * @param {accum} accum
 	 */
 	constructor(inner, config = Parser.getConfig(), accum = []) {
-		super(inner, config, false, accum);
+		super(inner, config, true, accum);
 	}
 
 	cloneNode() {

package/src/parameter.js

@@ -85,11 +85,6 @@ class ParameterToken extends fixedToken(Token) {
 		return this.anon ? this.lastElementChild.text() : super.text('=');
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return this.lastElementChild.plain();
-	}
-
 	/**
 	 * @param {ParameterToken} token
 	 * @complexity `n`

package/src/syntax.js

@@ -60,11 +60,6 @@ class SyntaxToken extends Token {
 		return super.getAttribute(key);
 	}
 
-	/** @returns {[number, string][]} */
-	plain() {
-		return [];
-	}
-
 	/**
 	 * @param {...string|Token} elements
 	 * @complexity `n`

package/src/table/index.js

@@ -3,19 +3,19 @@
 const assert = require('assert/strict'),
 	{noWrap} = require('../../util/string'),
 	/** @type {Parser} */ Parser = require('../..'),
-	Token = require('..'), // eslint-disable-line no-unused-vars
+	Token = require('..'),
 	TrToken = require('./tr'),
 	TdToken = require('./td'),
 	SyntaxToken = require('../syntax'),
-	AttributeToken = require('../attribute'); // eslint-disable-line no-unused-vars
+	AttributeToken = require('../attribute');
 
 /**
  * @param {TableCoords} coords1
  * @param {TableCoords} coords2
  */
 const cmpCoords = (coords1, coords2) => {
-	const diff = coords1?.row - coords2?.row;
-	return diff === 0 ? coords1?.column - coords2?.column : diff;
+	const diff = coords1.row - coords2.row;
+	return diff === 0 ? coords1.column - coords2.column : diff;
 };
 const isRowEnd = /** @param {Token} */ ({type}) => ['tr', 'table-syntax'].includes(type);
 
@@ -192,7 +192,7 @@ class TableToken extends TrToken {
 			{length} = rows,
 			/** @type {Layout} */ layout = new Layout(length).fill().map(() => []);
 		for (const [i, rowToken] of rows.entries()) {
-			if (i > stop.row ?? stop.y) {
+			if (i > (stop.row ?? stop.y)) {
 				break;
 			}
 			const rowLayout = layout[i];

package/src/table/td.js

@@ -45,7 +45,7 @@ class TdToken extends fixedToken(TrToken) {
 	 */
 	getSyntax() {
 		const syntax = this.firstElementChild.text(),
-			escape = syntax.includes('{{');
+			esc = syntax.includes('{{');
 		let subtype = 'td';
 		if (syntax.endsWith('!')) {
 			subtype = 'th';
@@ -53,14 +53,14 @@ class TdToken extends fixedToken(TrToken) {
 			subtype = 'caption';
 		}
 		if (this.isIndependent()) {
-			return {subtype, escape, correction: false};
+			return {subtype, escape: esc, correction: false};
 		}
 		const {previousElementSibling} = this;
 		if (previousElementSibling?.type !== 'td') {
-			return {subtype, escape, correction: true};
+			return {subtype, escape: esc, correction: true};
 		}
 		const result = previousElementSibling.getSyntax();
-		result.escape ||= escape;
+		result.escape ||= esc;
 		result.correction = previousElementSibling.lastElementChild.offsetHeight > 1;
 		if (subtype === 'th' && result.subtype !== 'th') {
 			result.subtype = 'th';
@@ -91,6 +91,7 @@ class TdToken extends fixedToken(TrToken) {
 		if (innerSyntax) {
 			[this.#innerSyntax] = innerSyntax;
 		}
+		// eslint-disable-next-line no-unsafe-optional-chaining
 		const innerToken = new Token(inner?.slice(innerSyntax?.index + this.#innerSyntax.length), config, true, accum);
 		innerToken.type = 'td-inner';
 		this.setAttribute('acceptable', {SyntaxToken: 0, AttributeToken: 1, Token: 2})
@@ -98,7 +99,7 @@ class TdToken extends fixedToken(TrToken) {
 	}
 
 	cloneNode() {
-		const token = super.cloneNode();
+		const /** @type {TdToken} */ token = super.cloneNode();
 		token.setAttribute('innerSyntax', this.#innerSyntax);
 		return token;
 	}
@@ -141,6 +142,7 @@ class TdToken extends fixedToken(TrToken) {
 	 * @template {string} T
 	 * @param {T} key
 	 * @param {TokenAttribute<T>} value
+	 * @return {this}
 	 */
 	setAttribute(key, value) {
 		if (key !== 'innerSyntax') {
@@ -162,8 +164,8 @@ class TdToken extends fixedToken(TrToken) {
 	static #aliases = {td: '\n|', th: '\n!', caption: '\n|+'};
 
 	/** @param {string} syntax */
-	setSyntax(syntax, escape = false) {
-		super.setSyntax(TdToken.#aliases[syntax] ?? syntax, escape);
+	setSyntax(syntax, esc = false) {
+		super.setSyntax(TdToken.#aliases[syntax] ?? syntax, esc);
 	}
 
 	/** @complexity `n` */
@@ -171,17 +173,17 @@ class TdToken extends fixedToken(TrToken) {
 		if (this.children[1].toString()) {
 			this.#innerSyntax ||= '|';
 		}
-		const {subtype, escape, correction} = this.getSyntax();
+		const {subtype, escape: esc, correction} = this.getSyntax();
 		if (correction) {
-			this.setSyntax(subtype, escape);
+			this.setSyntax(subtype, esc);
 		}
 	}
 
 	/** @complexity `n` */
 	independence() {
 		if (!this.isIndependent()) {
-			const {subtype, escape} = this.getSyntax();
-			this.setSyntax(subtype, escape);
+			const {subtype, escape: esc} = this.getSyntax();
+			this.setSyntax(subtype, esc);
 		}
 	}
 

package/src/table/tr.js

@@ -93,10 +93,10 @@ class TrToken extends attributeParent(Token, 1) {
 	}
 
 	/** @param {string} syntax */
-	setSyntax(syntax, escape = false) {
+	setSyntax(syntax, esc = false) {
 		const {firstElementChild} = this;
 		firstElementChild.replaceChildren(syntax);
-		if (escape) {
+		if (esc) {
 			TrToken.escape(firstElementChild);
 		}
 	}
@@ -202,7 +202,7 @@ class TrToken extends attributeParent(Token, 1) {
 		if (n < 0 || n > nCols || n === nCols && !insert) {
 			throw new RangeError(`不存在第 ${n} 个单元格！`);
 		}
-		const TdToken = require('./td'); // eslint-disable-line no-unused-vars
+		const TdToken = require('./td');
 		let last = 0;
 		for (const child of this.children.slice(2)) {
 			if (child instanceof TdToken) {

package/src/tagPair/ext.js

@@ -23,7 +23,7 @@ class ExtToken extends attributeParent(TagPairToken) {
 			attrToken = new AttributeToken(attr, 'ext-attr', lcName, config, accum),
 			newConfig = structuredClone(config),
 			ext = new Set(newConfig.ext);
-		let /** @type {acceptable} */ acceptable, innerToken;
+		let /** @type {acceptable} */ acceptable, /** @type {Token} */ innerToken;
 		switch (lcName) {
 			case 'choose':
 				ext.add('option');
@@ -42,15 +42,23 @@ class ExtToken extends attributeParent(TagPairToken) {
 				innerToken = new Token(inner, newConfig, false, accum);
 				break;
 			}
+			case 'gallery': {
+				ext.delete(lcName);
+				newConfig.ext = [...ext];
+				const GalleryToken = require('../gallery');
+				acceptable = {AttributeToken: 0, GalleryToken: 1};
+				innerToken = new GalleryToken(inner, newConfig, accum);
+				break;
+			}
 			/*
 			 * 更多定制扩展的代码示例：
 			 * ```
 			 * case 'extensionName': {
-			 * 	ext.delete(this.name);
+			 * 	ext.delete(lcName);
 			 * 	newConfig.ext = [...ext];
 			 * 	const ExtensionToken = require('../extension');
 			 * 	acceptable = {AttributeToken: 0, ExtensionToken: 1};
-			 * 	innerToken = new ExtensionToken(extInner, newConfig, false, accum);
+			 * 	innerToken = new ExtensionToken(inner, newConfig, accum);
 			 * 	break;
 			 * }
 			 * ```
@@ -79,6 +87,10 @@ class ExtToken extends attributeParent(TagPairToken) {
 		token.lastElementChild.safeReplaceWith(inner);
 		return token;
 	}
+
+	get innerText() {
+		return this.selfClosing ? '' : this.lastElementChild.text();
+	}
 }
 
 Parser.classes.ExtToken = __filename;

package/src/tagPair/index.js

@@ -21,7 +21,7 @@ class TagPairToken extends fixedToken(Token) {
 	 * @param {accum} accum
 	 */
 	constructor(name, attr, inner, closing, config = Parser.getConfig(), accum = []) {
-		super(undefined, config);
+		super(undefined, config, true);
 		this.setAttribute('name', name.toLowerCase()).#tags = [name, closing || name];
 		this.selfClosing = closing === undefined;
 		this.closed = closing !== '';
@@ -76,15 +76,6 @@ class TagPairToken extends fixedToken(Token) {
 			? `<${opening}${typeof firstChild === 'string' ? firstChild : firstChild.text()}/>`
 			: `<${opening}${super.text('>')}${closed ? `</${closing}>` : ''}`;
 	}
-
-	/** @returns {[number, string][]} */
-	plain() {
-		const {lastChild} = this;
-		if (typeof lastChild === 'string') {
-			return lastChild ? [[this.getAbsoluteIndex() + this.getRelativeIndex(1), lastChild]] : [];
-		}
-		return lastChild.plain();
-	}
 }
 
 Parser.classes.TagPairToken = __filename;

package/src/transclude.js

@@ -209,10 +209,6 @@ class TranscludeToken extends Token {
 		}}}`;
 	}
 
-	plain() {
-		return this.getAllArgs().flatMap(child => child.plain());
-	}
-
 	/**
 	 * @param {number|ParameterToken} addedToken
 	 * @complexity `n`

package/util/string.js

@@ -21,7 +21,7 @@ const escapeRegExp = str => str.replace(/[\\{}()|.?*+\-^$[\]]/g, '\\$&');
 
 /** @param {(string|AstNode)[]} childNodes */
 const text = (childNodes, separator = '') => {
-	const AstNode = require('../lib/node'); // eslint-disable-line no-unused-vars
+	const AstNode = require('../lib/node');
 	return childNodes.map(child => typeof child === 'string' ? child : child.text()).join(separator);
 };
 
@@ -62,7 +62,7 @@ const noWrap = str => str.replaceAll('\n', '\\n');
  * @returns {string}
  */
 const normalizeSpace = (token = '', separator = '') => {
-	const Token = require('../src'); // eslint-disable-line no-unused-vars
+	const Token = require('../src');
 	return typeof token === 'string'
 		? token.replaceAll('\n', ' ')
 		: token.childNodes.map(child => typeof child === 'string' ? normalizeSpace(child) : child.toString())