wikilint 2.22.1 → 2.23.0

package/dist/index.d.ts

@@ -48,4 +48,4 @@ export = Parser;
 export default Parser;
 export type { Config, ConfigData, LintError, TokenTypes, LanguageService, QuickFixData, };
 export type * from './internal';
-declare global { type Acceptable = Record<string, any>; }
+declare global { type WikiParserAcceptable = Record<string, any>; }

package/dist/lib/element.d.ts

@@ -1,17 +1,19 @@
 import { AstNode } from './node';
 import type { LintError } from '../base';
+import type { ElementLike } from '../mixin/elementLike';
 import type { AstNodes, Token } from '../internal';
 export interface CaretPosition {
     readonly offsetNode: AstNodes;
     readonly offset: number;
 }
+export interface AstElement extends AstNode, ElementLike {
+}
 /**
  * HTMLElement-like
  *
  * 类似HTMLElement
  */
 export declare abstract class AstElement extends AstNode {
-    #private;
     readonly name?: string;
     readonly data: undefined;
     /** number of child nodes / 子节点总数 */
@@ -44,20 +46,6 @@ export declare abstract class AstElement extends AstNode {
      * @param selector selector / 选择器
      */
     closest<T = Token>(selector: string): T | undefined;
-    /**
-     * Get the first descendant that matches the selector
-     *
-     * 符合选择器的第一个后代节点
-     * @param selector selector / 选择器
-     */
-    querySelector<T = Token>(selector: string): T | undefined;
-    /**
-     * Get all descendants that match the selector
-     *
-     * 符合选择器的所有后代节点
-     * @param selector selector / 选择器
-     */
-    querySelectorAll<T = Token>(selector: string): T[];
     /**
      * Insert a batch of child nodes at the end
      *

package/dist/lib/element.js

@@ -1,272 +1,267 @@
 "use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstElement = void 0;
 const string_1 = require("../util/string");
 const debug_1 = require("../util/debug");
 const selector_1 = require("../parser/selector");
 const node_1 = require("./node");
+const elementLike_1 = require("../mixin/elementLike");
 /**
  * HTMLElement-like
  *
  * 类似HTMLElement
  */
-class AstElement extends node_1.AstNode {
-    /** number of child nodes / 子节点总数 */
-    get length() {
-        return this.childNodes.length;
-    }
-    /** @private */
-    text(separator) {
-        return (0, string_1.text)(this.childNodes, separator);
-    }
-    /**
-     * Merge adjacent text child nodes
-     *
-     * 合并相邻的文本子节点
-     */
-    normalize() {
-        const childNodes = this.getChildNodes();
+let AstElement = (() => {
+    let _classDecorators = [elementLike_1.elementLike];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = node_1.AstNode;
+    var AstElement = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            AstElement = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /** number of child nodes / 子节点总数 */
+        get length() {
+            return this.childNodes.length;
+        }
+        /** @private */
+        text(separator) {
+            return (0, string_1.text)(this.childNodes, separator);
+        }
         /**
-         * 移除子节点
-         * @param i 移除位置
+         * Merge adjacent text child nodes
+         *
+         * 合并相邻的文本子节点
          */
-        const remove = (i) => {
-            childNodes.splice(i, 1);
-            childNodes[i - 1]?.setAttribute('nextSibling', childNodes[i]);
-            childNodes[i]?.setAttribute('previousSibling', childNodes[i - 1]);
-        };
-        for (let i = childNodes.length - 1; i >= 0; i--) {
-            const { type, data } = childNodes[i];
-            if (type !== 'text' || childNodes.length === 1 || this.getGaps(i - (i && 1))) {
-                //
-            }
-            else if (data === '') {
-                remove(i);
+        normalize() {
+            const childNodes = this.getChildNodes();
+            /**
+             * 移除子节点
+             * @param i 移除位置
+             */
+            const remove = (i) => {
+                childNodes.splice(i, 1);
+                childNodes[i - 1]?.setAttribute('nextSibling', childNodes[i]);
+                childNodes[i]?.setAttribute('previousSibling', childNodes[i - 1]);
+            };
+            for (let i = childNodes.length - 1; i >= 0; i--) {
+                const { type, data } = childNodes[i];
+                if (type !== 'text' || childNodes.length === 1 || this.getGaps(i - (i && 1))) {
+                    //
+                }
+                else if (data === '') {
+                    remove(i);
+                }
             }
+            this.setAttribute('childNodes', childNodes);
         }
-        this.setAttribute('childNodes', childNodes);
-    }
-    /**
-     * Remove a child node
-     *
-     * 移除子节点
-     * @param i position of the child node / 移除位置
-     */
-    removeAt(i) {
-        return (0, debug_1.setChildNodes)(this, i, 1)[0];
-    }
-    /**
-     * Insert a child node
-     *
-     * 插入子节点
-     * @param node node to be inserted / 待插入的子节点
-     * @param i position to be inserted at / 插入位置
-     */
-    insertAt(node, i = this.length) {
-        (0, debug_1.setChildNodes)(this, i, 0, [node]);
-        return node;
-    }
-    /**
-     * Get the closest ancestor node that matches the selector
-     *
-     * 最近的符合选择器的祖先节点
-     * @param selector selector / 选择器
-     */
-    closest(selector) {
-        const condition = (0, selector_1.getCondition)(selector, this);
-        let { parentNode } = this;
-        while (parentNode) {
-            if (condition(parentNode)) {
-                return parentNode;
-            }
-            ({ parentNode } = parentNode);
+        /**
+         * Remove a child node
+         *
+         * 移除子节点
+         * @param i position of the child node / 移除位置
+         */
+        removeAt(i) {
+            return (0, debug_1.setChildNodes)(this, i, 1)[0];
         }
-        return undefined;
-    }
-    /**
-     * 符合条件的第一个后代节点
-     * @param condition 条件
-     */
-    #getElementBy(condition) {
-        for (const child of this.childNodes) {
-            if (child.type === 'text') {
-                continue;
-            }
-            else if (condition(child)) {
-                return child;
-            }
-            const descendant = child.#getElementBy(condition);
-            if (descendant) {
-                return descendant;
+        /**
+         * Insert a child node
+         *
+         * 插入子节点
+         * @param node node to be inserted / 待插入的子节点
+         * @param i position to be inserted at / 插入位置
+         */
+        insertAt(node, i = this.length) {
+            (0, debug_1.setChildNodes)(this, i, 0, [node]);
+            return node;
+        }
+        /**
+         * Get the closest ancestor node that matches the selector
+         *
+         * 最近的符合选择器的祖先节点
+         * @param selector selector / 选择器
+         */
+        closest(selector) {
+            const condition = (0, selector_1.getCondition)(selector, this);
+            let { parentNode } = this;
+            while (parentNode) {
+                if (condition(parentNode)) {
+                    return parentNode;
+                }
+                ({ parentNode } = parentNode);
             }
+            return undefined;
         }
-        return undefined;
-    }
-    /**
-     * Get the first descendant that matches the selector
-     *
-     * 符合选择器的第一个后代节点
-     * @param selector selector / 选择器
-     */
-    querySelector(selector) {
-        const condition = (0, selector_1.getCondition)(selector, this);
-        return this.#getElementBy(condition);
-    }
-    /**
-     * 符合条件的所有后代节点
-     * @param condition 条件
-     * @param descendants 已经找到的后代节点
-     */
-    #getElementsBy(condition, descendants = []) {
-        for (const child of this.childNodes) {
-            if (child.type === 'text') {
-                continue;
+        /**
+         * Insert a batch of child nodes at the end
+         *
+         * 在末尾批量插入子节点
+         * @param elements nodes to be inserted / 插入节点
+         */
+        append(...elements) {
+            this.safeAppend(elements);
+        }
+        /** @private */
+        safeAppend(elements) {
+            for (const element of elements) {
+                this.insertAt(element);
             }
-            else if (condition(child)) {
-                descendants.push(child);
+        }
+        /**
+         * Replace all child nodes
+         *
+         * 批量替换子节点
+         * @param elements nodes to be inserted / 新的子节点
+         */
+        replaceChildren(...elements) {
+            this.safeReplaceChildren(elements);
+        }
+        /** @private */
+        safeReplaceChildren(elements) {
+            for (let i = this.length - 1; i >= 0; i--) {
+                this.removeAt(i);
             }
-            child.#getElementsBy(condition, descendants);
+            this.safeAppend(elements);
         }
-        return descendants;
-    }
-    /**
-     * Get all descendants that match the selector
-     *
-     * 符合选择器的所有后代节点
-     * @param selector selector / 选择器
-     */
-    querySelectorAll(selector) {
-        const condition = (0, selector_1.getCondition)(selector, this);
-        return this.#getElementsBy(condition);
-    }
-    /**
-     * Insert a batch of child nodes at the end
-     *
-     * 在末尾批量插入子节点
-     * @param elements nodes to be inserted / 插入节点
-     */
-    append(...elements) {
-        this.safeAppend(elements);
-    }
-    /** @private */
-    safeAppend(elements) {
-        for (const element of elements) {
-            this.insertAt(element);
+        /**
+         * Modify the text child node
+         *
+         * 修改文本子节点
+         * @param str new text / 新文本
+         * @param i position of the text child node / 子节点位置
+         */
+        setText(str, i = 0) {
+            i += i < 0 ? this.length : 0;
+            const oldText = this.childNodes[i];
+            const { data } = oldText;
+            oldText.replaceData(str);
+            return data;
         }
-    }
-    /**
-     * Replace all child nodes
-     *
-     * 批量替换子节点
-     * @param elements nodes to be inserted / 新的子节点
-     */
-    replaceChildren(...elements) {
-        this.safeReplaceChildren(elements);
-    }
-    /** @private */
-    safeReplaceChildren(elements) {
-        for (let i = this.length - 1; i >= 0; i--) {
-            this.removeAt(i);
+        /** @private */
+        toString(skip, separator = '') {
+            return this.childNodes.map(child => child.toString(skip)).join(separator);
         }
-        this.safeAppend(elements);
-    }
-    /**
-     * Modify the text child node
-     *
-     * 修改文本子节点
-     * @param str new text / 新文本
-     * @param i position of the text child node / 子节点位置
-     */
-    setText(str, i = 0) {
-        i += i < 0 ? this.length : 0;
-        const oldText = this.childNodes[i];
-        const { data } = oldText;
-        oldText.replaceData(str);
-        return data;
-    }
-    /** @private */
-    toString(skip, separator = '') {
-        return this.childNodes.map(child => child.toString(skip)).join(separator);
-    }
-    /**
-     * Get the caret position from the character index
-     *
-     * 找到给定位置
-     * @param index character index / 位置
-     */
-    caretPositionFromIndex(index) {
-        LSP: { // eslint-disable-line no-unused-labels
-            if (index === undefined) {
-                return undefined;
-            }
-            const { length } = this.toString();
-            if (index > length || index < -length) {
-                return undefined;
-            }
-            index += index < 0 ? length : 0;
-            let self = this, acc = 0, start = 0;
-            while (self.type !== 'text') {
-                const { childNodes } = self;
-                acc += self.getAttribute('padding');
-                for (let i = 0; acc <= index && i < childNodes.length; i++) {
-                    const cur = childNodes[i], { nextSibling } = cur, str = cur.toString(), l = str.length;
-                    cur.setAttribute('aIndex', acc);
-                    acc += l;
-                    // 优先选择靠前的非文本兄弟节点，但永不进入假节点
-                    if (acc > index
-                        || acc === index && l > 0 && (!nextSibling
-                            || nextSibling.type === 'text'
-                            || cur.type !== 'text' && (str.trim() || !nextSibling.toString().trim()))) {
-                        self = cur;
-                        acc -= l;
-                        start = acc;
-                        break;
-                    }
-                    acc += self.getGaps(i);
+        /**
+         * Get the caret position from the character index
+         *
+         * 找到给定位置
+         * @param index character index / 位置
+         */
+        caretPositionFromIndex(index) {
+            LSP: { // eslint-disable-line no-unused-labels
+                if (index === undefined) {
+                    return undefined;
                 }
-                if (self.childNodes === childNodes) {
-                    return { offsetNode: self, offset: index - start };
+                const { length } = this.toString();
+                if (index > length || index < -length) {
+                    return undefined;
+                }
+                index += index < 0 ? length : 0;
+                let self = this, acc = 0, start = 0;
+                while (self.type !== 'text') {
+                    const { childNodes } = self;
+                    acc += self.getAttribute('padding');
+                    for (let i = 0; acc <= index && i < childNodes.length; i++) {
+                        const cur = childNodes[i], { nextSibling } = cur, str = cur.toString(), l = str.length;
+                        cur.setAttribute('aIndex', acc);
+                        acc += l;
+                        // 优先选择靠前的非文本兄弟节点，但永不进入假节点
+                        if (acc > index
+                            || acc === index && l > 0 && (!nextSibling
+                                || nextSibling.type === 'text'
+                                || cur.type !== 'text' && (str.trim() || !nextSibling.toString().trim()))) {
+                            self = cur;
+                            acc -= l;
+                            start = acc;
+                            break;
+                        }
+                        acc += self.getGaps(i);
+                    }
+                    if (self.childNodes === childNodes) {
+                        return { offsetNode: self, offset: index - start };
+                    }
                 }
+                return { offsetNode: self, offset: index - start };
             }
-            return { offsetNode: self, offset: index - start };
         }
-    }
-    /**
-     * Get the closest ancestor element from the character index
-     *
-     * 找到给定位置所在的最内层非文本节点
-     * @param index character index / 位置
-     */
-    elementFromIndex(index) {
-        LSP: { // eslint-disable-line no-unused-labels
-            const node = this.caretPositionFromIndex(index)?.offsetNode;
-            return node?.type === 'text' ? node.parentNode : node;
+        /**
+         * Get the closest ancestor element from the character index
+         *
+         * 找到给定位置所在的最内层非文本节点
+         * @param index character index / 位置
+         */
+        elementFromIndex(index) {
+            LSP: { // eslint-disable-line no-unused-labels
+                const node = this.caretPositionFromIndex(index)?.offsetNode;
+                return node?.type === 'text' ? node.parentNode : node;
+            }
         }
-    }
-    /**
-     * Get the closest ancestor element from the position
-     *
-     * 找到给定位置所在的最内层非文本节点
-     * @param x column number / 列数
-     * @param y line number / 行数
-     */
-    elementFromPoint(x, y) {
-        // eslint-disable-next-line no-unused-labels
-        LSP: return this.elementFromIndex(this.indexFromPos(y, x));
-    }
-    /** @private */
-    lint(start = this.getAbsoluteIndex(), re) {
-        const errors = [];
-        for (let i = 0, cur = start + this.getAttribute('padding'); i < this.length; i++) {
-            const child = this.childNodes[i];
-            child.setAttribute('aIndex', cur);
-            const childErrors = child.lint(cur, re);
-            if (childErrors.length > 0) {
-                errors.push(...childErrors);
+        /**
+         * Get the closest ancestor element from the position
+         *
+         * 找到给定位置所在的最内层非文本节点
+         * @param x column number / 列数
+         * @param y line number / 行数
+         */
+        elementFromPoint(x, y) {
+            // eslint-disable-next-line no-unused-labels
+            LSP: return this.elementFromIndex(this.indexFromPos(y, x));
+        }
+        /** @private */
+        lint(start = this.getAbsoluteIndex(), re) {
+            const errors = [];
+            for (let i = 0, cur = start + this.getAttribute('padding'); i < this.length; i++) {
+                const child = this.childNodes[i];
+                child.setAttribute('aIndex', cur);
+                const childErrors = child.lint(cur, re);
+                if (childErrors.length > 0) {
+                    errors.push(...childErrors);
+                }
+                cur += child.toString().length + this.getGaps(i);
             }
-            cur += child.toString().length + this.getGaps(i);
+            return errors;
         }
-        return errors;
-    }
-}
+    };
+    return AstElement = _classThis;
+})();
 exports.AstElement = AstElement;

package/dist/lib/lsp.js

@@ -25,7 +25,7 @@ const cssRules = {
 let colors;
 /* NOT FOR BROWSER ONLY END */
 exports.tasks = new WeakMap();
-const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']), nameAttrs = new Set(['name', 'extends', 'follow']), groupAttrs = new Set(['group']), renameTypes = new Set([
+const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']), nameAttrs = new Set(['name', 'follow']), groupAttrs = new Set(['group']), renameTypes = new Set([
     'arg-name',
     'template-name',
     'link-target',

package/dist/lib/node.d.ts

@@ -1,4 +1,5 @@
 import type { LintError, AstNode as AstNodeBase, TokenTypes } from '../base';
+import type { NodeLike } from '../mixin/nodeLike';
 import type { AstText, Token } from '../internal';
 export type AstNodes = AstText | Token;
 export interface Dimension {
@@ -17,6 +18,8 @@ export interface Font {
     bold: boolean;
     italic: boolean;
 }
+export interface AstNode extends NodeLike {
+}
 /**
  * Node-like
  *
@@ -37,20 +40,12 @@ export declare abstract class AstNode implements AstNodeBase {
     lint(): LintError[] & {
         output?: string;
     };
-    /** first child node / 首位子节点 */
-    get firstChild(): AstNodes | undefined;
-    /** last child node / 末位子节点 */
-    get lastChild(): AstNodes | undefined;
     /** parent node / 父节点 */
     get parentNode(): Token | undefined;
     /** next sibling node / 后一个兄弟节点 */
     get nextSibling(): AstNodes | undefined;
     /** previous sibling node / 前一个兄弟节点 */
     get previousSibling(): AstNodes | undefined;
-    /** number of lines / 行数 */
-    get offsetHeight(): number;
-    /** number of columns of the last line / 最后一行的列数 */
-    get offsetWidth(): number;
     /**
      * Get the root node
      *

package/dist/lib/node.js

@@ -39,20 +39,29 @@ exports.AstNode = void 0;
 const lint_1 = require("../util/lint");
 const debug_1 = require("../util/debug");
 const cached_1 = require("../mixin/cached");
+const nodeLike_1 = require("../mixin/nodeLike");
 /**
  * Node-like
  *
  * 类似Node
  */
 let AstNode = (() => {
+    let _classDecorators = [nodeLike_1.nodeLike];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
     let _instanceExtraInitializers = [];
     let _getLines_decorators;
-    return class AstNode {
+    var AstNode = class {
+        static { _classThis = this; }
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
             _getLines_decorators = [(0, cached_1.cached)(false)];
             __esDecorate(this, null, _getLines_decorators, { kind: "method", name: "getLines", static: false, private: false, access: { has: obj => "getLines" in obj, get: obj => obj.getLines }, metadata: _metadata }, null, _instanceExtraInitializers);
-            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            AstNode = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
         }
         childNodes = (__runInitializers(this, _instanceExtraInitializers), []);
         #parentNode;
@@ -61,14 +70,6 @@ let AstNode = (() => {
         #root;
         #aIndex;
         #rIndex = {};
-        /** first child node / 首位子节点 */
-        get firstChild() {
-            return this.childNodes[0];
-        }
-        /** last child node / 末位子节点 */
-        get lastChild() {
-            return this.childNodes[this.childNodes.length - 1];
-        }
         /** parent node / 父节点 */
         get parentNode() {
             return this.#parentNode;
@@ -81,14 +82,6 @@ let AstNode = (() => {
         get previousSibling() {
             return this.#previousSibling;
         }
-        /** number of lines / 行数 */
-        get offsetHeight() {
-            return this.#getDimension().height;
-        }
-        /** number of columns of the last line / 最后一行的列数 */
-        get offsetWidth() {
-            return this.#getDimension().width;
-        }
         /** @private */
         getChildNodes() {
             const { childNodes } = this;
@@ -169,8 +162,8 @@ let AstNode = (() => {
             }
             return undefined;
         }
-        /** 获取行数和最后一行的列数 */
-        #getDimension() {
+        /** @private */
+        getDimension() {
             const lines = this.getLines(), last = lines[lines.length - 1];
             return { height: lines.length, width: last[2] - last[1] };
         }
@@ -224,7 +217,7 @@ let AstNode = (() => {
         getBoundingClientRect() {
             // eslint-disable-next-line no-unused-labels
             LSP: return {
-                ...this.#getDimension(),
+                ...this.getDimension(),
                 ...this.getRootNode().posFromIndex(this.getAbsoluteIndex()),
             };
         }
@@ -255,5 +248,6 @@ let AstNode = (() => {
             return results;
         }
     };
+    return AstNode = _classThis;
 })();
 exports.AstNode = AstNode;

package/dist/lib/text.js

@@ -86,7 +86,7 @@ class AstText extends node_1.AstNode {
         const { type, name, parentNode: grandparent } = parentNode;
         if (type === 'attr-value') {
             const { name: grandName, tag } = grandparent;
-            if (tag === 'ref' && (grandName === 'name' || grandName === 'extends' || grandName === 'follow')
+            if (tag === 'ref' && (grandName === 'name' || grandName === 'follow')
                 || grandName === 'group' && (tag === 'ref' || tag === 'references')
                 || tag === 'choose' && (grandName === 'before' || grandName === 'after')) {
                 return [];

package/dist/mixin/attributesParent.js

@@ -7,21 +7,20 @@ const debug_1 = require("../util/debug");
  * @param i AttributesToken子节点的位置
  */
 const attributesParent = (i = 0) => (constructor) => {
-    /** 子节点含有AttributesToken的类 */
+    /* eslint-disable jsdoc/require-jsdoc */
     class AttributesParent extends constructor {
         /** AttributesToken子节点 */
         #getAttributesChild() {
             return this.childNodes[i];
         }
-        /** @implements */
         hasAttr(key) {
             return this.#getAttributesChild().hasAttr(key);
         }
-        /** @implements */
         getAttr(key) {
             return this.#getAttributesChild().getAttr(key);
         }
     }
+    /* eslint-enable jsdoc/require-jsdoc */
     (0, debug_1.mixin)(AttributesParent, constructor);
     return AttributesParent;
 };

package/dist/mixin/elementLike.d.ts

@@ -0,0 +1,21 @@
+import type { AstNodes, Token } from '../internal';
+declare type ElementConstructor = abstract new (...args: any[]) => {
+    readonly childNodes: readonly AstNodes[];
+};
+export interface ElementLike {
+    /**
+     * Get the first descendant that matches the selector
+     *
+     * 符合选择器的第一个后代节点
+     * @param selector selector / 选择器
+     */
+    querySelector<T = Token>(selector: string): T | undefined;
+    /**
+     * Get all descendants that match the selector
+     *
+     * 符合选择器的所有后代节点
+     * @param selector selector / 选择器
+     */
+    querySelectorAll<T = Token>(selector: string): T[];
+}
+/** @ignore */

package/dist/mixin/elementLike.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.elementLike = void 0;
+const debug_1 = require("../util/debug");
+const selector_1 = require("../parser/selector");
+/** @ignore */
+const elementLike = (constructor) => {
+    /* eslint-disable jsdoc/require-jsdoc */
+    class ElementLike extends constructor {
+        #getCondition(selector) {
+            return (0, selector_1.getCondition)(selector, 
+            // @ts-expect-error only AstElement
+            this);
+        }
+        getElementBy(condition) {
+            for (const child of this.childNodes) {
+                if (child.type === 'text') {
+                    continue;
+                }
+                else if (condition(child)) {
+                    return child;
+                }
+                const descendant = child.getElementBy(condition);
+                if (descendant) {
+                    return descendant;
+                }
+            }
+            return undefined;
+        }
+        querySelector(selector) {
+            return this.getElementBy(this.#getCondition(selector));
+        }
+        getElementsBy(condition, descendants = []) {
+            for (const child of this.childNodes) {
+                if (child.type === 'text') {
+                    continue;
+                }
+                else if (condition(child)) {
+                    descendants.push(child);
+                }
+                child.getElementsBy(condition, descendants);
+            }
+            return descendants;
+        }
+        querySelectorAll(selector) {
+            return this.getElementsBy(this.#getCondition(selector));
+        }
+    }
+    /* eslint-enable jsdoc/require-jsdoc */
+    (0, debug_1.mixin)(ElementLike, constructor);
+    return ElementLike;
+};
+exports.elementLike = elementLike;

package/dist/mixin/gapped.js

@@ -7,13 +7,13 @@ const debug_1 = require("../util/debug");
  * @param gap
  */
 const gapped = (gap = 1) => (constructor) => {
-    /** 不可增删子节点的类 */
+    /* eslint-disable jsdoc/require-jsdoc */
     class GappedToken extends constructor {
-        /** @private */
         getGaps() {
             return gap;
         }
     }
+    /* eslint-enable jsdoc/require-jsdoc */
     (0, debug_1.mixin)(GappedToken, constructor);
     return GappedToken;
 };

package/dist/mixin/hidden.js

@@ -8,7 +8,7 @@ const debug_1 = require("../util/debug");
  * @param html 是否覆写 toHtml 方法
  */
 const hiddenToken = (linter = true, html = true) => (constructor) => {
-    /** 解析后不可见的类 */
+    /* eslint-disable jsdoc/require-jsdoc */
     class AnyHiddenToken extends constructor {
         /** 没有可见部分 */
         text() {
@@ -19,6 +19,7 @@ const hiddenToken = (linter = true, html = true) => (constructor) => {
             return linter ? [] : super.lint(start);
         }
     }
+    /* eslint-enable jsdoc/require-jsdoc */
     (0, debug_1.mixin)(AnyHiddenToken, constructor);
     return AnyHiddenToken;
 };

package/dist/mixin/multiLine.js

@@ -7,7 +7,7 @@ const debug_1 = require("../util/debug");
  * @ignore
  */
 const multiLine = (constructor) => {
-    /** 不可包含换行符的类 */
+    /* eslint-disable jsdoc/require-jsdoc */
     class MultiLineToken extends constructor {
         toString(skip) {
             return super.toString(skip, '\n');
@@ -15,11 +15,11 @@ const multiLine = (constructor) => {
         text() {
             return super.text('\n').replace(/\n\s*\n/gu, '\n');
         }
-        /** @private */
         getGaps() {
             return 1;
         }
     }
+    /* eslint-enable jsdoc/require-jsdoc */
     (0, debug_1.mixin)(MultiLineToken, constructor);
     return MultiLineToken;
 };

package/dist/mixin/nodeLike.d.ts

@@ -0,0 +1,17 @@
+import type { Dimension } from '../lib/node';
+import type { AstNodes } from '../internal';
+declare type NodeConstructor = abstract new (...args: any[]) => {
+    readonly childNodes: readonly AstNodes[];
+    getDimension(): Dimension;
+};
+export interface NodeLike {
+    /** first child node / 首位子节点 */
+    readonly firstChild: AstNodes | undefined;
+    /** last child node / 末位子节点 */
+    readonly lastChild: AstNodes | undefined;
+    /** number of lines / 行数 */
+    readonly offsetHeight: number;
+    /** number of columns of the last line / 最后一行的列数 */
+    readonly offsetWidth: number;
+}
+/** @ignore */

package/dist/mixin/nodeLike.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nodeLike = void 0;
+const debug_1 = require("../util/debug");
+/** @ignore */
+const nodeLike = (constructor) => {
+    /* eslint-disable jsdoc/require-jsdoc */
+    class NodeLike extends constructor {
+        get firstChild() {
+            return this.childNodes[0];
+        }
+        get lastChild() {
+            return this.childNodes[this.childNodes.length - 1];
+        }
+        get offsetHeight() {
+            return this.getDimension().height;
+        }
+        get offsetWidth() {
+            return this.getDimension().width;
+        }
+    }
+    /* eslint-enable jsdoc/require-jsdoc */
+    (0, debug_1.mixin)(NodeLike, constructor);
+    return NodeLike;
+};
+exports.nodeLike = nodeLike;

package/dist/mixin/padded.js

@@ -8,12 +8,13 @@ const debug_1 = require("../util/debug");
  * @param padding.length
  */
 const padded = ({ length }) => (constructor) => {
-    /** 不可增删子节点的类 */
+    /* eslint-disable jsdoc/require-jsdoc */
     class PaddedToken extends constructor {
         getAttribute(key) {
             return key === 'padding' ? length : super.getAttribute(key);
         }
     }
+    /* eslint-enable jsdoc/require-jsdoc */
     (0, debug_1.mixin)(PaddedToken, constructor);
     return PaddedToken;
 };

package/dist/src/atom.d.ts

@@ -12,6 +12,6 @@ export declare class AtomToken extends Token {
     get type(): AtomTypes;
     set type(value: AtomTypes);
     /** @class */
-    constructor(wikitext: string | undefined, type: AtomTypes, config?: Config, accum?: Token[], acceptable?: Acceptable);
+    constructor(wikitext: string | undefined, type: AtomTypes, config?: Config, accum?: Token[], acceptable?: WikiParserAcceptable);
 }
 export {};

package/dist/src/index.d.ts

@@ -15,7 +15,7 @@ export declare class Token extends AstElement {
     get type(): TokenTypes;
     set type(value: TokenTypes);
     /** @class */
-    constructor(wikitext?: string, config?: Parser.Config, accum?: Token[], acceptable?: Acceptable);
+    constructor(wikitext?: string, config?: Parser.Config, accum?: Token[], acceptable?: WikiParserAcceptable);
     /**
      * @override
      * @param child node to be inserted / 待插入的子节点

package/dist/src/link/galleryImage.js

@@ -79,7 +79,7 @@ let GalleryImageToken = (() => {
             if (text !== undefined) {
                 const { length } = accum;
                 token = new index_2.Token(text, config, accum);
-                for (let n = 1; n < constants_1.MAX_STAGE; n++) {
+                for (let n = 0; n < constants_1.MAX_STAGE - 1; n++) {
                     token.parseOnce();
                 }
                 accum.splice(length, 1);

package/dist/src/nested.js

@@ -34,7 +34,7 @@ class NestedToken extends index_2.Token {
      */
     constructor(wikitext, regex, tags, config, accum = []) {
         if (typeof regex === 'boolean') {
-            const placeholder = Symbol('InputboxToken'), { length } = accum;
+            const placeholder = Symbol('NestedToken'), { length } = accum;
             accum.push(placeholder);
             wikitext &&= (0, commentAndExt_1.parseCommentAndExt)(wikitext, config, accum, regex);
             wikitext &&= (0, braces_1.parseBraces)(wikitext, config, accum);

package/dist/src/paramTag/index.d.ts

@@ -17,5 +17,5 @@ export declare abstract class ParamTagToken extends Token {
     abstract get parentNode(): ExtToken | undefined;
     get type(): 'ext-inner';
     /** @class */
-    constructor(include: boolean, wikitext?: string, config?: Parser.Config, accum?: Token[], acceptable?: Acceptable);
+    constructor(include: boolean, wikitext?: string, config?: Parser.Config, accum?: Token[], acceptable?: WikiParserAcceptable);
 }

package/dist/src/syntax.d.ts

@@ -12,6 +12,6 @@ export declare class SyntaxToken extends Token {
     /**
      * @class
      */
-    constructor(wikitext: string | undefined, type: SyntaxTypes, config?: Config, accum?: Token[], acceptable?: Acceptable);
+    constructor(wikitext: string | undefined, type: SyntaxTypes, config?: Config, accum?: Token[], acceptable?: WikiParserAcceptable);
 }
 export {};

package/dist/src/table/base.d.ts

@@ -17,6 +17,6 @@ export declare abstract class TableBaseToken extends Token {
      * @param type 节点类型
      * @param attr 表格属性
      */
-    constructor(pattern: RegExp, syntax: string, type: TableTypes, attr?: string, config?: Config, accum?: Token[], acceptable?: Acceptable);
+    constructor(pattern: RegExp, syntax: string, type: TableTypes, attr?: string, config?: Config, accum?: Token[], acceptable?: WikiParserAcceptable);
 }
 export {};

package/dist/src/table/index.d.ts

@@ -35,18 +35,12 @@ export declare abstract class TableToken extends TrBaseToken {
      *
      * 闭合表格语法
      * @param syntax syntax of the table end / 表格结尾语法
-     * @param halfParsed
      */
     close(syntax?: string, halfParsed?: boolean): void;
     /**
      * Get the table layout
      *
      * 获取表格布局
-     * @param stop stop condition / 中止条件
-     * @param stop.row stop at the row / 中止行
-     * @param stop.column stop at the column / 中止列
-     * @param stop.x stop at the row / 中止行
-     * @param stop.y stop at the column / 中止列
      */
     getLayout(stop?: {
         row?: number;
@@ -65,9 +59,6 @@ export declare abstract class TableToken extends TrBaseToken {
      *
      * 获取第n行
      * @param n row number / 行号
-     * @param force whether to regard the table itself as the first row / 是否将表格自身视为第一行
-     * @param insert whether to be used to insert a new row / 是否用于判断插入新行的位置
-     * @throws `RangeError` 不存在该行
      */
     getNthRow(n: number, force?: boolean, insert?: false): TrToken | this | undefined;
 }

package/dist/src/table/index.js

@@ -130,12 +130,12 @@ let TableToken = (() => {
             }
             return errors;
         }
+        // eslint-disable-next-line jsdoc/require-param
         /**
          * Close the table syntax
          *
          * 闭合表格语法
          * @param syntax syntax of the table end / 表格结尾语法
-         * @param halfParsed
          */
         close(syntax = '\n|}', halfParsed) {
             const config = this.getAttribute('config'), accum = this.getAttribute('accum'), inner = [syntax];
@@ -145,15 +145,11 @@ let TableToken = (() => {
             });
             this.lastChild.safeReplaceChildren(inner);
         }
+        // eslint-disable-next-line jsdoc/require-param
         /**
          * Get the table layout
          *
          * 获取表格布局
-         * @param stop stop condition / 中止条件
-         * @param stop.row stop at the row / 中止行
-         * @param stop.column stop at the column / 中止列
-         * @param stop.x stop at the row / 中止行
-         * @param stop.y stop at the column / 中止列
          */
         getLayout(stop) {
             const rows = this.getAllRows(), { length } = rows, layout = Layout.from(emptyArray(length, () => []));

package/dist/src/transclude.d.ts

@@ -74,8 +74,6 @@ export declare abstract class TranscludeToken extends Token {
      *
      * 获取指定参数
      * @param key parameter name / 参数名
-     * @param exact whether to match anonymosity / 是否匹配匿名性
-     * @param copy whether to return a copy / 是否返回一个备份
      */
     getArgs(key: string | number, exact?: boolean, copy?: boolean): Set<ParameterToken>;
     /**

package/dist/src/transclude.js

@@ -364,13 +364,12 @@ let TranscludeToken = (() => {
         getAnonArgs() {
             return this.getAllArgs().filter(({ anon }) => anon);
         }
+        // eslint-disable-next-line jsdoc/require-param
         /**
          * Get parameters with the specified name
          *
          * 获取指定参数
          * @param key parameter name / 参数名
-         * @param exact whether to match anonymosity / 是否匹配匿名性
-         * @param copy whether to return a copy / 是否返回一个备份
          */
         getArgs(key, exact, copy = true) {
             const keyStr = String(key)

package/dist/util/debug.js

@@ -59,6 +59,7 @@ const setChildNodes = (parent, position, deleteCount, inserted = []) => {
     return removed;
 };
 exports.setChildNodes = setChildNodes;
+/* NOT FOR BROWSER ONLY */
 /**
  * 同步混入的类名
  * @param target 混入的目标

package/dist/util/sharable.js

@@ -96,7 +96,7 @@ exports.commonHtmlAttrs = new Set([
     nowiki: empty,
     indicator: new Set(['name']),
     langconvert: new Set(['from', 'to']),
-    ref: new Set(['group', 'name', 'extends', 'follow', 'dir']),
+    ref: new Set(['group', 'name', 'follow', 'dir', 'details']),
     references: new Set(['group', 'responsive']),
     charinsert: new Set(['label']),
     choose: new Set(['uncached', 'before', 'after']),

package/dist/util/sharable.mjs

@@ -94,7 +94,7 @@ const commonHtmlAttrs = /* @__PURE__ */ new Set([
   nowiki: empty,
   indicator: /* @__PURE__ */ new Set(["name"]),
   langconvert: /* @__PURE__ */ new Set(["from", "to"]),
-  ref: /* @__PURE__ */ new Set(["group", "name", "extends", "follow", "dir"]),
+  ref: /* @__PURE__ */ new Set(["group", "name", "follow", "dir", "details"]),
   references: /* @__PURE__ */ new Set(["group", "responsive"]),
   charinsert: /* @__PURE__ */ new Set(["label"]),
   choose: /* @__PURE__ */ new Set(["uncached", "before", "after"]),

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "wikilint",
-	"version": "2.22.1",
+	"version": "2.23.0",
 	"description": "A Node.js linter for MediaWiki markup",
 	"keywords": [
 		"mediawiki",
@@ -39,7 +39,6 @@
 		"url": "git+https://github.com/bhsd-harry/wikiparser-node.git"
 	},
 	"scripts": {
-		"declaration": "grep -rl --include='*.d.ts' '@private' dist/ | xargs bash sed.sh -i -E '/^\\s+\\/\\*\\* @private/,+1d'; grep -rl --include='*.d.ts' '/util/' dist/ | xargs bash sed.sh -i -E '/^import .+\\/util\\//d'; bash sed.sh -i -E 's/abstract (lint|print|text)\\b/\\1/' dist/lib/node.d.ts; node dist/script/declaration.js",
 		"prepublishOnly": "npm run build:core",
 		"build:core": "bash build.sh",
 		"build": "npm run build:core",