@blackglory/match 0.3.5 → 0.4.0

package/lib/matchers/text-content-equals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-content-equals.js","sourceRoot":"","sources":["../../src/matchers/text-content-equals.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAO5C,MAAM,UAAU,iBAAiB,CAC/B,IAAY,EACZ,EACE,aAAa,GAAG,IAAI,EACpB,IAAI,GAAG,KAAK,KACiB,EAAE;IAEjC,OAAO,CAAC,IAAU,EAAE,EAAE;QACpB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAA;QAE1C,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QAClC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAA;YACvC,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAA;QAC3B,CAAC;QACD,IAAI,IAAI;YAAE,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAA;QAE1C,OAAO,WAAW,KAAK,IAAI,CAAA;IAC7B,CAAC,CAAA;AACH,CAAC"}

package/lib/{es2018/matchers → matchers}/text-content-includes.d.ts

@@ -1,4 +1,4 @@
-import { ITerminalMatcher } from '../types';
+import { ITerminalMatcher } from "../types.js";
 interface ITextContentIncludesOptions {
     caseSensitive?: boolean;
     trim?: boolean;

package/lib/matchers/text-content-includes.js

@@ -0,0 +1,16 @@
+import { isNull } from '@blackglory/prelude';
+export function textContentIncludes(searchString, { caseSensitive = true, trim = false } = {}) {
+    return (node) => {
+        if (isNull(node.textContent))
+            return false;
+        let textContent = node.textContent;
+        if (!caseSensitive) {
+            textContent = textContent.toLowerCase();
+            searchString = searchString.toLowerCase();
+        }
+        if (trim)
+            textContent = textContent.trim();
+        return textContent.includes(searchString);
+    };
+}
+//# sourceMappingURL=text-content-includes.js.map

package/lib/matchers/text-content-includes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-content-includes.js","sourceRoot":"","sources":["../../src/matchers/text-content-includes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAO5C,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,EACE,aAAa,GAAG,IAAI,EACpB,IAAI,GAAG,KAAK,KACmB,EAAE;IAEnC,OAAO,CAAC,IAAU,EAAE,EAAE;QACpB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAA;QAE1C,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QAClC,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,WAAW,GAAG,WAAW,CAAC,WAAW,EAAE,CAAA;YACvC,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAA;QAC3C,CAAC;QACD,IAAI,IAAI;YAAE,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAA;QAE1C,OAAO,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAA;IAC3C,CAAC,CAAA;AACH,CAAC"}

package/lib/{es2015/matchers → matchers}/text-content-matches.d.ts

@@ -1,4 +1,4 @@
-import { ITerminalMatcher } from '../types';
+import { ITerminalMatcher } from "../types.js";
 interface ITextContentMatchesOptions {
     trim?: boolean;
 }

package/lib/matchers/text-content-matches.js

@@ -0,0 +1,12 @@
+import { isNull } from '@blackglory/prelude';
+export function textContentMatches(pattern, { trim = false } = {}) {
+    return (node) => {
+        if (isNull(node.textContent))
+            return false;
+        let textContent = node.textContent;
+        if (trim)
+            textContent = textContent.trim();
+        return pattern.test(textContent);
+    };
+}
+//# sourceMappingURL=text-content-matches.js.map

package/lib/matchers/text-content-matches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-content-matches.js","sourceRoot":"","sources":["../../src/matchers/text-content-matches.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAM5C,MAAM,UAAU,kBAAkB,CAChC,OAAe,EACf,EAAE,IAAI,GAAG,KAAK,KAAiC,EAAE;IAEjD,OAAO,CAAC,IAAU,EAAE,EAAE;QACpB,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAA;QAE1C,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAA;QAClC,IAAI,IAAI;YAAE,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,CAAA;QAE1C,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAClC,CAAC,CAAA;AACH,CAAC"}

package/lib/{es2015/matchers → matchers}/text-node.d.ts

@@ -1,4 +1,4 @@
-import { INestedMatcher, ITerminalMatcher } from '../types';
+import { INestedMatcher, ITerminalMatcher } from "../types.js";
 export declare function textNode(strings: TemplateStringsArray, ...values: string[]): (...matchers: Array<ITerminalMatcher<Node>>) => INestedMatcher<Node>;
 export declare function textNode(name: string, ...matchers: Array<ITerminalMatcher<Node>>): INestedMatcher<Node>;
 export declare function textNode(...matchers: Array<ITerminalMatcher<Node>>): INestedMatcher<Node>;

package/lib/matchers/text-node.js

@@ -0,0 +1,30 @@
+import { isArray, isString } from '@blackglory/prelude';
+import { concat } from "../utils/concat.js";
+import { isntTextNode } from 'extra-dom';
+import { mergeInPlace } from "../utils/merge-in-place.js";
+export function textNode(...args) {
+    if (isArray(args[0])) {
+        const [strings, ...values] = args;
+        const name = concat(strings, values).join('');
+        return (...matchers) => textNode(name, ...matchers);
+    }
+    if (isString(args[0])) {
+        const [name, ...matchers] = args;
+        return function (node) {
+            const result = textNode(...matchers).call(this, node);
+            if (result) {
+                mergeInPlace(this.collection, { [name]: node });
+            }
+            return result;
+        };
+    }
+    const [...matchers] = args;
+    return function (node) {
+        if (isntTextNode(node))
+            return false;
+        if (matchers.length === 0)
+            return true;
+        return matchers.every(match => match.call(this, node));
+    };
+}
+//# sourceMappingURL=text-node.js.map

package/lib/matchers/text-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-node.js","sourceRoot":"","sources":["../../src/matchers/text-node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,MAAM,EAAE,2BAAwB;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,YAAY,EAAE,mCAAgC;AAavD,MAAM,UAAU,QAAQ,CAAC,GAAG,IAGkB;IAE5C,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GACxB,IAA4D,CAAA;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAE7C,OAAO,CAAC,GAAG,QAAuC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAA;IACpF,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,GACvB,IAAkE,CAAA;QAEpE,OAAO,UAAkC,IAAU;YACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;YACrD,IAAI,MAAM,EAAE,CAAC;gBACX,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAA;YACjD,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC,CAAA;IACH,CAAC;IAED,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,IAAoD,CAAA;IAE1E,OAAO,UAAkC,IAAU;QACjD,IAAI,YAAY,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAA;QACpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAA;QAEtC,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IACxD,CAAC,CAAA;AACH,CAAC"}

package/lib/{es2015/matchers → matchers}/xpath.d.ts

@@ -1,3 +1,3 @@
-import { ITerminalMatcher } from '../types';
+import { ITerminalMatcher } from "../types.js";
 export declare function xpath(strings: TemplateStringsArray, ...values: string[]): ITerminalMatcher<Node>;
 export declare function xpath(experssion: string): ITerminalMatcher<Node>;

package/lib/{es2015/matchers → matchers}/xpath.js

@@ -1,27 +1,23 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.xpath = void 0;
-const types_1 = require("@blackglory/types");
-const concat_1 = require("../utils/concat");
-const errors_1 = require("@blackglory/errors");
+import { isString } from '@blackglory/prelude';
+import { concat } from "../utils/concat.js";
+import { assert } from '@blackglory/prelude';
 const UNORDERED_NODE_ITERATOR_TYPE = 'XPathResult' in globalThis
     ? XPathResult.UNORDERED_NODE_ITERATOR_TYPE
     : 4;
-function xpath(...args) {
-    if ((0, types_1.isString)(args[0])) {
+export function xpath(...args) {
+    if (isString(args[0])) {
         const [expression] = args;
-        (0, errors_1.assert)(expression.startsWith('//*'), 'XPath expressions must start with "//*"');
+        assert(expression.startsWith('//*'), 'XPath expressions must start with "//*"');
         return function (node) {
             return xpathMatches(this.document, expression, node);
         };
     }
     else {
         const [strings, ...values] = args;
-        const expression = (0, concat_1.concat)(strings, values).join('');
+        const expression = concat(strings, values).join('');
         return xpath(expression);
     }
 }
-exports.xpath = xpath;
 function xpathMatches(document, expression, node) {
     const iterator = document.evaluate(expression, node, null, UNORDERED_NODE_ITERATOR_TYPE, null);
     let value;

package/lib/matchers/xpath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath.js","sourceRoot":"","sources":["../../src/matchers/xpath.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,2BAAwB;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C,MAAM,4BAA4B,GAChC,aAAa,IAAI,UAAU;IAC3B,CAAC,CAAC,WAAW,CAAC,4BAA4B;IAC1C,CAAC,CAAC,CAAC,CAAA;AASL,MAAM,UAAU,KAAK,CAAC,GAAG,IAE6B;IAEpD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;QACzB,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,yCAAyC,CAAC,CAAA;QAE/E,OAAO,UAEL,IAAU;YAEV,OAAO,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAA;QACtD,CAAC,CAAA;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,IAAI,CAAA;QACjC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAEnD,OAAO,KAAK,CAAC,UAAU,CAAC,CAAA;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,QAAkB,EAAE,UAAkB,EAAE,IAAU;IACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAChC,UAAU,EACV,IAAI,EACJ,IAAI,EACJ,4BAA4B,EAC5B,IAAI,CACL,CAAA;IAED,IAAI,KAAK,CAAA;IACT,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAA;IACjC,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,18 @@
+export interface IContext {
+    readonly document: Document;
+    readonly next: (node: Node, distance?: number) => Node | undefined;
+    readonly collection: {
+        [name: string]: Node | Node[];
+    };
+}
+export interface IReadonlyContext {
+    readonly document: Document;
+    readonly next: (node: Node, distance?: number) => Node | undefined;
+    readonly collection: {
+        readonly [name: string]: Node | Node[];
+    };
+}
+export type IMatcher<T extends Node> = ITerminalMatcher<T> | INestedMatcher<T> | ISkipMatcher<T> | (<T extends Node>(this: IReadonlyContext, node: T) => boolean | number | Iterable<number>);
+export type INestedMatcher<T extends Node> = (this: IReadonlyContext, node: T) => boolean;
+export type ISkipMatcher<T extends Node> = (this: IReadonlyContext, node: T) => number | Iterable<number> | false;
+export type ITerminalMatcher<T extends Node> = (this: IReadonlyContext, node: T) => boolean;

package/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/lib/{es2015/utils → utils}/concat.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.concat = void 0;
-function concat(strings, values) {
+export function concat(strings, values) {
     const result = [];
     for (let i = 0, len = values.length; i < len; i++) {
         result.push(strings[i]);
@@ -10,5 +7,4 @@ function concat(strings, values) {
     result.push(strings[strings.length - 1]);
     return result;
 }
-exports.concat = concat;
 //# sourceMappingURL=concat.js.map

package/lib/utils/concat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.js","sourceRoot":"","sources":["../../src/utils/concat.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CAAC,OAA6B,EAAE,MAAgB;IACpE,MAAM,MAAM,GAAG,EAAE,CAAA;IACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;QACvB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;IACxC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/lib/{es2015/utils → utils}/match-multiple.d.ts

@@ -1,2 +1,5 @@
-import { INestedMatcher, ITerminalMatcher, IReadonlyContext } from '../types';
+import { INestedMatcher, ITerminalMatcher, IReadonlyContext } from "../types.js";
+/**
+ * @returns {number} 返回值为成功匹配的元素个数, 当此值等于ubound时, 代表匹配成功.
+ */
 export declare function matchMultiple<T extends Node>(this: IReadonlyContext, node: T, ubound: number, matcher: INestedMatcher<T> | ITerminalMatcher<T>): number;

package/lib/utils/match-multiple.js

@@ -0,0 +1,20 @@
+import { countup } from 'extra-generator';
+/**
+ * @returns {number} 返回值为成功匹配的元素个数, 当此值等于ubound时, 代表匹配成功.
+ */
+export function matchMultiple(node, ubound, matcher) {
+    let currentNode = node;
+    for (const round of countup(1, ubound)) {
+        if (!currentNode)
+            return round - 1;
+        const result = matcher.call(this, currentNode);
+        if (result) {
+            currentNode = this.next(currentNode);
+        }
+        else {
+            return round - 1;
+        }
+    }
+    return ubound;
+}
+//# sourceMappingURL=match-multiple.js.map

package/lib/utils/match-multiple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-multiple.js","sourceRoot":"","sources":["../../src/utils/match-multiple.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAGzC;;GAEG;AACH,MAAM,UAAU,aAAa,CAE3B,IAAO,EACP,MAAc,EACd,OAAgD;IAEhD,IAAI,WAAW,GAAa,IAAI,CAAA;IAEhC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;QACvC,IAAI,CAAC,WAAW;YAAE,OAAO,KAAK,GAAG,CAAC,CAAA;QAElC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;QAC9C,IAAI,MAAM,EAAE,CAAC;YACX,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAa,CAAA;QAClD,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,GAAG,CAAC,CAAA;QAClB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/lib/{es2015/utils → utils}/match-one-by-one.d.ts

@@ -1,2 +1,2 @@
-import { IMatcher, IReadonlyContext } from '../types';
+import { IMatcher, IReadonlyContext } from "../types.js";
 export declare function matchOneByOne<T extends Node>(context: IReadonlyContext, source: T | null, ...matchers: Array<IMatcher<T>>): boolean;

package/lib/{es2015/utils → utils}/match-one-by-one.js

@@ -1,15 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.matchOneByOne = void 0;
-const types_1 = require("@blackglory/types");
-function matchOneByOne(context, source, ...matchers) {
+import { isBoolean, isNumber, isIterable } from '@blackglory/prelude';
+export function matchOneByOne(context, source, ...matchers) {
     if (matchers.length === 0)
         return true;
     if (!source)
         return false;
     const [matcher, ...otherMatchers] = matchers;
     const result = Reflect.apply(matcher, context, [source]);
-    if ((0, types_1.isBoolean)(result)) {
+    // TerminalMatcher
+    if (isBoolean(result)) {
         if (result) {
             const nextNode = context.next(source);
             return matchOneByOne(context, nextNode, ...otherMatchers);
@@ -18,21 +16,23 @@ function matchOneByOne(context, source, ...matchers) {
             return false;
         }
     }
-    if ((0, types_1.isNumber)(result)) {
+    // 此处一定是成功匹配, 因为SkipMatcher在失败时会返回false.
+    if (isNumber(result)) {
         const distance = result;
         const nextNode = context.next(source, distance);
         return matchOneByOne(context, nextNode, ...otherMatchers);
     }
-    if ((0, types_1.isIterable)(result)) {
+    // SkipMatcher返回Iterable意味着存在多种可能性, 可能出现失败回溯.
+    if (isIterable(result)) {
         for (const distance of result) {
             const nextNode = context.next(source, distance);
             if (matchOneByOne(context, nextNode, ...otherMatchers)) {
                 return true;
             }
         }
+        // 尝试了所有可能性, 未发现可以匹配的结果
         return false;
     }
     throw new Error('Unknown return value');
 }
-exports.matchOneByOne = matchOneByOne;
 //# sourceMappingURL=match-one-by-one.js.map

package/lib/utils/match-one-by-one.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-one-by-one.js","sourceRoot":"","sources":["../../src/utils/match-one-by-one.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErE,MAAM,UAAU,aAAa,CAC3B,OAAyB,EACzB,MAAgB,EAChB,GAAG,QAA4B;IAE/B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAA;IAEzB,MAAM,CAAC,OAAO,EAAE,GAAG,aAAa,CAAC,GAAG,QAAQ,CAAA;IAE5C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,CAA+B,CAAA;IAEtF,kBAAkB;IAClB,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAa,CAAA;YACjD,OAAO,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAA;QAC3D,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,MAAM,CAAA;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAa,CAAA;QAC3D,OAAO,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,CAAA;IAC3D,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAa,CAAA;YAC3D,IAAI,aAAa,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC;gBACvD,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;AACzC,CAAC"}

package/lib/utils/merge-in-place.d.ts

@@ -0,0 +1 @@
+export declare function mergeInPlace<T>(target: Record<string, T | T[]>, source: Record<string, T | T[]>): void;

package/lib/{es2015/utils → utils}/merge-in-place.js

@@ -1,12 +1,9 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mergeInPlace = void 0;
-const types_1 = require("@blackglory/types");
-function mergeInPlace(target, source) {
+import { isArray } from '@blackglory/prelude';
+export function mergeInPlace(target, source) {
     for (const [key, value] of Object.entries(source)) {
         if (target[key]) {
-            if ((0, types_1.isArray)(target[key])) {
-                if ((0, types_1.isArray)(value)) {
+            if (isArray(target[key])) {
+                if (isArray(value)) {
                     target[key] = [...target[key], ...value];
                 }
                 else {
@@ -14,7 +11,7 @@ function mergeInPlace(target, source) {
                 }
             }
             else {
-                if ((0, types_1.isArray)(value)) {
+                if (isArray(value)) {
                     target[key] = [target[key], ...value];
                 }
                 else {
@@ -27,5 +24,4 @@ function mergeInPlace(target, source) {
         }
     }
 }
-exports.mergeInPlace = mergeInPlace;
 //# sourceMappingURL=merge-in-place.js.map

package/lib/utils/merge-in-place.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-in-place.js","sourceRoot":"","sources":["../../src/utils/merge-in-place.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE7C,MAAM,UAAU,YAAY,CAC1B,MAA+B,EAC/B,MAA+B;IAE/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACzB,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAQ,EAAE,GAAG,KAAK,CAAC,CAAA;gBACjD,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAQ,EAAE,KAAK,CAAC,CAAA;gBAC9C,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACnB,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAM,EAAE,GAAG,KAAK,CAAC,CAAA;gBAC5C,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAM,EAAE,KAAK,CAAC,CAAA;gBACzC,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;AACH,CAAC"}

package/lib/utils/next-element-sibling.js

@@ -0,0 +1,7 @@
+import * as ExtraDOM from 'extra-dom';
+export function nextElementSibling(node, distance = 1) {
+    if (distance === 0)
+        return node;
+    return ExtraDOM.nextElementSibling(node, distance);
+}
+//# sourceMappingURL=next-element-sibling.js.map

package/lib/utils/next-element-sibling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-element-sibling.js","sourceRoot":"","sources":["../../src/utils/next-element-sibling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAA;AAErC,MAAM,UAAU,kBAAkB,CAChC,IAAU,EACV,WAAmB,CAAC;IAEpB,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAE/B,OAAO,QAAQ,CAAC,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AACpD,CAAC"}

package/lib/utils/next-sibling.js

@@ -0,0 +1,7 @@
+import * as ExtraDOM from 'extra-dom';
+export function nextSibling(node, distance = 1) {
+    if (distance === 0)
+        return node;
+    return ExtraDOM.nextSibling(node, distance);
+}
+//# sourceMappingURL=next-sibling.js.map

package/lib/utils/next-sibling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-sibling.js","sourceRoot":"","sources":["../../src/utils/next-sibling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,WAAW,CAAA;AAErC,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,WAAmB,CAAC;IAC1D,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IAE/B,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AAC7C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blackglory/match",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "description": "A module for matching nodes from pages",
   "keywords": [
     "query",
@@ -9,71 +9,56 @@
   ],
   "files": [
     "lib",
-    "dist"
+    "src"
   ],
-  "main": "lib/es2018/index.js",
-  "types": "lib/es2018/index.d.ts",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
   "repository": "git@github.com:BlackGlory/match.git",
   "author": "BlackGlory <woshenmedoubuzhidao@blackglory.me>",
   "license": "MIT",
-  "sideEffects": false,
   "scripts": {
+    "prepare": "ts-patch install -s",
     "lint": "eslint --ext .js,.jsx,.ts,.tsx --quiet src __tests__",
-    "test": "jest --config jest.config.js",
-    "test:coverage": "jest --coverage --config jest.config.js",
-    "prepublishOnly": "run-s clean build bundle",
-    "clean": "run-p clean:*",
-    "clean:build": "rimraf lib",
-    "clean:bundle": "rimraf dist",
-    "build": "run-p build:*",
-    "build:es2015": "run-s build:es2015:*",
-    "build:es2015:compile": "tsc --project tsconfig.build.json --module commonjs --target es2015 --outDir lib/es2015",
-    "build:es2015:patch": "tscpaths -p tsconfig.build.json -s ./src -o ./lib/es2015",
-    "build:es2018": "run-s build:es2018:*",
-    "build:es2018:compile": "tsc --project tsconfig.build.json --module commonjs --target es2018 --outDir lib/es2018",
-    "build:es2018:patch": "tscpaths -p tsconfig.build.json -s ./src -o ./lib/es2018",
-    "bundle": "rollup --config rollup.config.js",
+    "test": "vitest --run",
+    "prepublishOnly": "run-s prepare clean build",
+    "clean": "rimraf lib",
+    "build": "tsc --project tsconfig.build.json",
     "release": "standard-version"
   },
   "husky": {
     "hooks": {
-      "pre-commit": "run-s lint build test",
+      "pre-commit": "run-s prepare lint build test",
       "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
     }
   },
   "devDependencies": {
-    "@blackglory/jest-matchers": "^0.2.1",
-    "@commitlint/cli": "^15.0.0",
-    "@commitlint/config-conventional": "^15.0.0",
-    "@rollup/plugin-commonjs": "^21.0.1",
-    "@rollup/plugin-json": "^4.1.0",
-    "@rollup/plugin-node-resolve": "^13.0.6",
-    "@rollup/plugin-replace": "^3.0.0",
-    "@rollup/plugin-typescript": "^8.3.0",
-    "@types/jest": "^27.0.3",
-    "@types/jsdom": "^16.2.13",
-    "@typescript-eslint/eslint-plugin": "^5.6.0",
-    "@typescript-eslint/parser": "^5.6.0",
-    "eslint": "^8.4.1",
+    "@commitlint/cli": "^20.3.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@eslint/js": "^9.39.2",
+    "@types/jsdom": "^27.0.0",
+    "eslint": "^9.39.2",
     "husky": "^4.3.8",
-    "iterable-operator": "^0.14.4",
-    "jest": "^27.4.4",
-    "jsdom": "^19.0.0",
+    "iterable-operator": "^5.1.0",
+    "jsdom": "^27.4.0",
     "npm-run-all": "^4.1.5",
-    "rimraf": "^3.0.2",
-    "rollup": "^2.61.1",
-    "rollup-plugin-analyzer": "^4.0.0",
-    "rollup-plugin-terser": "^7.0.2",
-    "standard-version": "^9.3.2",
-    "ts-jest": "^27.1.1",
-    "tscpaths": "^0.0.9",
-    "tslib": "^2.3.1",
-    "typescript": "^4.5.3"
+    "rimraf": "^6.1.2",
+    "standard-version": "^9.5.0",
+    "ts-patch": "^3.3.0",
+    "tslib": "^2.8.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.53.0",
+    "typescript-transform-paths": "^3.5.6",
+    "vite-tsconfig-paths": "^6.0.4",
+    "vitest": "^4.0.17"
   },
   "dependencies": {
-    "@blackglory/errors": "^1.1.2",
-    "@blackglory/types": "^0.5.2",
-    "extra-dom": "^0.4.4",
-    "extra-generator": "^0.2.15"
+    "@blackglory/prelude": "^0.4.0",
+    "extra-dom": "^0.7.0",
+    "extra-generator": "^0.5.9"
   }
 }

package/src/index.ts

@@ -0,0 +1,18 @@
+export { match } from './match.js'
+export { matchElement } from './match-element.js'
+
+export { anyOf } from '@matchers/any-of.js'
+export { childNodes } from '@matchers/child-nodes.js'
+export { children } from '@matchers/children.js'
+export { css } from '@matchers/css.js'
+export { element } from '@matchers/element.js'
+export { multiple } from '@matchers/multiple.js'
+export { node } from '@matchers/node.js'
+export { optional } from '@matchers/optional.js'
+export { repeat } from '@matchers/repeat.js'
+export { tap } from '@matchers/tap.js'
+export { textContentEquals } from '@matchers/text-content-equals.js'
+export { textContentIncludes } from '@matchers/text-content-includes.js'
+export { textContentMatches } from '@matchers/text-content-matches.js'
+export { textNode } from '@matchers/text-node.js'
+export { xpath } from '@matchers/xpath.js'

package/src/match-element.ts

@@ -0,0 +1,23 @@
+import { isDocument } from 'extra-dom'
+import { IMatcher, IContext } from './types.js'
+import { matchOneByOne } from '@utils/match-one-by-one.js'
+import { nextElementSibling } from '@utils/next-element-sibling.js'
+
+export function matchElement(
+  this: void | Document
+, element: Element
+, ...matchers: Array<IMatcher<Element>>
+): { [name: string]: Node | Node[] } | null {
+  const document = isDocument(this) ? this : globalThis.document
+  const context: IContext = {
+    document
+  , collection: {}
+  , next: nextElementSibling
+  }
+
+  if (matchOneByOne(context, element, ...matchers)) {
+    return context.collection
+  } else {
+    return null
+  }
+}

package/src/match.ts

@@ -0,0 +1,23 @@
+import { isDocument } from 'extra-dom'
+import { IMatcher, IContext } from './types.js'
+import { matchOneByOne } from '@utils/match-one-by-one.js'
+import { nextSibling } from '@utils/next-sibling.js'
+
+export function match(
+  this: void | Document
+, node: Node
+, ...matchers: Array<IMatcher<Node>>
+): { [name: string]: Node | Node[] } | null {
+  const document = isDocument(this) ? this : globalThis.document
+  const context: IContext = {
+    document
+  , collection: {}
+  , next: nextSibling
+  }
+
+  if (matchOneByOne(context, node, ...matchers)) {
+    return context.collection
+  } else {
+    return null
+  }
+}

package/src/matchers/any-of.ts

@@ -0,0 +1,13 @@
+import { ITerminalMatcher, INestedMatcher, IReadonlyContext } from '@src/types.js'
+
+export function anyOf<T extends Node>(
+  ...matchers: [
+    INestedMatcher<T> | ITerminalMatcher<T>
+  , INestedMatcher<T> | ITerminalMatcher<T>
+  , ...Array<INestedMatcher<T> | ITerminalMatcher<T>>
+  ]
+): INestedMatcher<T> {
+  return function (this: IReadonlyContext, node: T) {
+    return matchers.some(match => match.call(this, node))
+  }
+}

package/src/matchers/child-nodes.ts

@@ -0,0 +1,33 @@
+import { INestedMatcher, IMatcher, IReadonlyContext } from '@src/types.js'
+import { matchOneByOne } from '@utils/match-one-by-one.js'
+import { mergeInPlace } from '@utils/merge-in-place.js'
+import { nextSibling } from '@utils/next-sibling.js'
+
+export function childNodes(...matchers: Array<IMatcher<Node>>): INestedMatcher<Node> {
+  return function (this: IReadonlyContext, node: Node) {
+    // 空matchers意味着"childNodes应该为空".
+    if (matchers.length === 0) {
+      return node.childNodes.length === 0
+    }
+
+    if (node.childNodes.length === 0) return false
+
+    const context: IReadonlyContext = {
+      ...this
+    , collection: {}
+    , next: nextSibling
+    }
+
+    const result = matchOneByOne(
+      context
+    , node.childNodes[0]
+    , ...matchers
+    )
+
+    if (result) {
+      mergeInPlace(this.collection, context.collection)
+    }
+
+    return result
+  }
+}

package/src/matchers/children.ts

@@ -0,0 +1,35 @@
+import { IMatcher, INestedMatcher, IReadonlyContext } from '@src/types.js'
+import { matchOneByOne } from '@utils/match-one-by-one.js'
+import { mergeInPlace } from '@utils/merge-in-place.js'
+import { nextElementSibling } from '@utils/next-element-sibling.js'
+
+export function children(
+  ...matchers: Array<IMatcher<Element>>
+): INestedMatcher<Element> {
+  return function (this: IReadonlyContext, element: Element) {
+    // 空matchers意味着"children应该为空".
+    if (matchers.length === 0) {
+      return element.children.length === 0
+    }
+
+    if (element.children.length === 0) return false
+
+    const context: IReadonlyContext = {
+      ...this
+    , collection: {}
+    , next: nextElementSibling
+    }
+
+    const result = matchOneByOne(
+      context
+    , element.children[0]
+    , ...matchers
+    )
+
+    if (result) {
+      mergeInPlace(this.collection, context.collection)
+    }
+
+    return result
+  }
+}