@rolldown/pluginutils 1.0.0-beta.8-commit.66f4623 → 1.0.0-beta.8-commit.985af6d

package/dist/index.cjs

@@ -60,6 +60,16 @@ var Code = class {
 		this.kind = "code";
 	}
 };
+var Query = class {
+	kind;
+	key;
+	pattern;
+	constructor(key, pattern) {
+		this.pattern = pattern;
+		this.key = key;
+		this.kind = "query";
+	}
+};
 var Include = class {
 	kind;
 	expr;
@@ -94,24 +104,46 @@ function moduleType(pattern) {
 function code(pattern) {
 	return new Code(pattern);
 }
+function query(key, pattern) {
+	return new Query(key, pattern);
+}
 function include(expr) {
 	return new Include(expr);
 }
 function exclude(expr) {
 	return new Exclude(expr);
 }
+/**
+* convert a queryObject to FilterExpression like
+* ```js
+*   and(query(k1, v1), query(k2, v2))
+* ```
+* @param queryFilterObject The query filter object needs to be matched.
+* @returns a `And` FilterExpression
+*
+* There are three kinds of conditions are supported:
+* 1. `boolean`: if the value is `true`, the key must exist and be truthy. if the value is `false`, the key must not exist or be falsy.
+* 2. `string`: the key must exist and be equal to the value.
+* 3. `RegExp`: the key must exist and match the value.
+*/
+function queryObjectToFilterExpr(queryFilter) {
+	let arr = Object.entries(queryFilter).map(([key, value]) => {
+		return new Query(key, value);
+	});
+	return and(...arr);
+}
 function interpreter(exprs, code$1, id$1, moduleType$1) {
 	let arr = [];
 	if (Array.isArray(exprs)) arr = exprs;
 	else arr = [exprs];
 	return interpreterImpl(arr, code$1, id$1, moduleType$1);
 }
-function interpreterImpl(expr, code$1, id$1, moduleType$1) {
+function interpreterImpl(expr, code$1, id$1, moduleType$1, ctx = {}) {
 	let hasInclude = false;
 	for (const e of expr) switch (e.kind) {
 		case "include": {
 			hasInclude = true;
-			if (exprInterpreter(e.expr, code$1, id$1, moduleType$1)) return true;
+			if (exprInterpreter(e.expr, code$1, id$1, moduleType$1, ctx)) return true;
 			break;
 		}
 		case "exclude": {
@@ -121,11 +153,11 @@ function interpreterImpl(expr, code$1, id$1, moduleType$1) {
 	}
 	return !hasInclude;
 }
-function exprInterpreter(expr, code$1, id$1, moduleType$1) {
+function exprInterpreter(expr, code$1, id$1, moduleType$1, ctx = {}) {
 	switch (expr.kind) {
-		case "and": return expr.args.every((e) => exprInterpreter(e, code$1, id$1, moduleType$1));
-		case "or": return expr.args.some((e) => exprInterpreter(e, code$1, id$1, moduleType$1));
-		case "not": return !exprInterpreter(expr.expr, code$1, id$1, moduleType$1);
+		case "and": return expr.args.every((e) => exprInterpreter(e, code$1, id$1, moduleType$1, ctx));
+		case "or": return expr.args.some((e) => exprInterpreter(e, code$1, id$1, moduleType$1, ctx));
+		case "not": return !exprInterpreter(expr.expr, code$1, id$1, moduleType$1, ctx);
 		case "id": {
 			if (id$1 === void 0) throw new Error("`id` is required for `id` expression");
 			if (expr.params.cleanUrl) id$1 = cleanUrl(id$1);
@@ -139,7 +171,19 @@ function exprInterpreter(expr, code$1, id$1, moduleType$1) {
 			if (code$1 === void 0) throw new Error("`code` is required for `code` expression");
 			return typeof expr.pattern === "string" ? code$1.includes(expr.pattern) : expr.pattern.test(code$1);
 		}
-		default: throw new Error(`Expression kind ${expr.kind} is not expected.`);
+		case "query": {
+			if (id$1 === void 0) throw new Error("`id` is required for `Query` expression");
+			if (!ctx.urlSearchParamsCache) {
+				let [_, queryString = ""] = id$1.split("?", 2);
+				ctx.urlSearchParamsCache = new URLSearchParams(queryString);
+			}
+			let urlParams = ctx.urlSearchParamsCache;
+			if (typeof expr.pattern === "boolean") if (expr.pattern) return urlParams.has(expr.key);
+			else return !urlParams.has(expr.key);
+			else if (typeof expr.pattern === "string") return urlParams.get(expr.key) === expr.pattern;
+			else return expr.pattern.test(urlParams.get(expr.key) ?? "");
+		}
+		default: throw new Error(`Expression kind ${expr} is not expected.`);
 	}
 }
 
@@ -192,7 +236,6 @@ function makeRegexIdFilterToMatchWithQuery(input) {
 }
 
 //#endregion
-exports.And = And
 exports.and = and
 exports.code = code
 exports.exactRegex = exactRegex
@@ -206,4 +249,6 @@ exports.makeIdFiltersToMatchWithQuery = makeIdFiltersToMatchWithQuery
 exports.moduleType = moduleType
 exports.not = not
 exports.or = or
-exports.prefixRegex = prefixRegex
+exports.prefixRegex = prefixRegex
+exports.query = query
+exports.queryObjectToFilterExpr = queryObjectToFilterExpr

package/dist/index.d.cts

@@ -2,7 +2,7 @@
 type StringOrRegExp = string | RegExp;
 type PluginModuleType = "js" | "jsx" | "ts" | "tsx" | "json" | "text" | "base64" | "dataurl" | "binary" | "empty" | (string & {});
 type FilterExpressionKind = FilterExpression["kind"];
-type FilterExpression = And | Or | Not | Id | ModuleType | Code | Include | Exclude;
+type FilterExpression = And | Or | Not | Id | ModuleType | Code | Query;
 type TopLevelFilterExpression = Include | Exclude;
 declare class And {
   kind: "and";
@@ -19,6 +19,9 @@ declare class Not {
   expr: FilterExpression;
   constructor(expr: FilterExpression);
 }
+interface QueryFilterObject {
+  [key: string]: StringOrRegExp | boolean;
+}
 interface IdParams {
   cleanUrl?: boolean;
 }
@@ -38,6 +41,12 @@ declare class Code {
   pattern: StringOrRegExp;
   constructor(expr: StringOrRegExp);
 }
+declare class Query {
+  kind: "query";
+  key: string;
+  pattern: StringOrRegExp | boolean;
+  constructor(key: string, pattern: StringOrRegExp | boolean);
+}
 declare class Include {
   kind: "include";
   expr: FilterExpression;
@@ -54,11 +63,29 @@ declare function not(expr: FilterExpression): Not;
 declare function id(pattern: StringOrRegExp, params?: IdParams): Id;
 declare function moduleType(pattern: PluginModuleType): ModuleType;
 declare function code(pattern: StringOrRegExp): Code;
+declare function query(key: string, pattern: StringOrRegExp | boolean): Query;
 declare function include(expr: FilterExpression): Include;
 declare function exclude(expr: FilterExpression): Exclude;
+/**
+* convert a queryObject to FilterExpression like
+* ```js
+*   and(query(k1, v1), query(k2, v2))
+* ```
+* @param queryFilterObject The query filter object needs to be matched.
+* @returns a `And` FilterExpression
+*
+* There are three kinds of conditions are supported:
+* 1. `boolean`: if the value is `true`, the key must exist and be truthy. if the value is `false`, the key must not exist or be falsy.
+* 2. `string`: the key must exist and be equal to the value.
+* 3. `RegExp`: the key must exist and match the value.
+*/
+declare function queryObjectToFilterExpr(queryFilter: QueryFilterObject): And;
 declare function interpreter(exprs: TopLevelFilterExpression | TopLevelFilterExpression[], code?: string, id?: string, moduleType?: PluginModuleType): boolean;
-declare function interpreterImpl(expr: TopLevelFilterExpression[], code?: string, id?: string, moduleType?: PluginModuleType): boolean;
-declare function exprInterpreter(expr: FilterExpression, code?: string, id?: string, moduleType?: PluginModuleType): boolean;
+interface InterpreterCtx {
+  urlSearchParamsCache?: URLSearchParams;
+}
+declare function interpreterImpl(expr: TopLevelFilterExpression[], code?: string, id?: string, moduleType?: PluginModuleType, ctx?: InterpreterCtx): boolean;
+declare function exprInterpreter(expr: FilterExpression, code?: string, id?: string, moduleType?: PluginModuleType, ctx?: InterpreterCtx): boolean;
 
 //#endregion
 //#region src/simple-filters.d.ts
@@ -91,4 +118,4 @@ declare function makeIdFiltersToMatchWithQuery<T extends string | RegExp>(input:
 declare function makeIdFiltersToMatchWithQuery(input: string | RegExp | readonly (string | RegExp)[]): string | RegExp | (string | RegExp)[];
 
 //#endregion
-export { And, FilterExpression, FilterExpressionKind, TopLevelFilterExpression, and, code, exactRegex, exclude, exprInterpreter, id, include, interpreter, interpreterImpl, makeIdFiltersToMatchWithQuery, moduleType, not, or, prefixRegex };
+export { FilterExpression, FilterExpressionKind, QueryFilterObject, TopLevelFilterExpression, and, code, exactRegex, exclude, exprInterpreter, id, include, interpreter, interpreterImpl, makeIdFiltersToMatchWithQuery, moduleType, not, or, prefixRegex, query, queryObjectToFilterExpr };

package/dist/index.d.ts

@@ -2,7 +2,7 @@
 type StringOrRegExp = string | RegExp;
 type PluginModuleType = "js" | "jsx" | "ts" | "tsx" | "json" | "text" | "base64" | "dataurl" | "binary" | "empty" | (string & {});
 type FilterExpressionKind = FilterExpression["kind"];
-type FilterExpression = And | Or | Not | Id | ModuleType | Code | Include | Exclude;
+type FilterExpression = And | Or | Not | Id | ModuleType | Code | Query;
 type TopLevelFilterExpression = Include | Exclude;
 declare class And {
   kind: "and";
@@ -19,6 +19,9 @@ declare class Not {
   expr: FilterExpression;
   constructor(expr: FilterExpression);
 }
+interface QueryFilterObject {
+  [key: string]: StringOrRegExp | boolean;
+}
 interface IdParams {
   cleanUrl?: boolean;
 }
@@ -38,6 +41,12 @@ declare class Code {
   pattern: StringOrRegExp;
   constructor(expr: StringOrRegExp);
 }
+declare class Query {
+  kind: "query";
+  key: string;
+  pattern: StringOrRegExp | boolean;
+  constructor(key: string, pattern: StringOrRegExp | boolean);
+}
 declare class Include {
   kind: "include";
   expr: FilterExpression;
@@ -54,11 +63,29 @@ declare function not(expr: FilterExpression): Not;
 declare function id(pattern: StringOrRegExp, params?: IdParams): Id;
 declare function moduleType(pattern: PluginModuleType): ModuleType;
 declare function code(pattern: StringOrRegExp): Code;
+declare function query(key: string, pattern: StringOrRegExp | boolean): Query;
 declare function include(expr: FilterExpression): Include;
 declare function exclude(expr: FilterExpression): Exclude;
+/**
+* convert a queryObject to FilterExpression like
+* ```js
+*   and(query(k1, v1), query(k2, v2))
+* ```
+* @param queryFilterObject The query filter object needs to be matched.
+* @returns a `And` FilterExpression
+*
+* There are three kinds of conditions are supported:
+* 1. `boolean`: if the value is `true`, the key must exist and be truthy. if the value is `false`, the key must not exist or be falsy.
+* 2. `string`: the key must exist and be equal to the value.
+* 3. `RegExp`: the key must exist and match the value.
+*/
+declare function queryObjectToFilterExpr(queryFilter: QueryFilterObject): And;
 declare function interpreter(exprs: TopLevelFilterExpression | TopLevelFilterExpression[], code?: string, id?: string, moduleType?: PluginModuleType): boolean;
-declare function interpreterImpl(expr: TopLevelFilterExpression[], code?: string, id?: string, moduleType?: PluginModuleType): boolean;
-declare function exprInterpreter(expr: FilterExpression, code?: string, id?: string, moduleType?: PluginModuleType): boolean;
+interface InterpreterCtx {
+  urlSearchParamsCache?: URLSearchParams;
+}
+declare function interpreterImpl(expr: TopLevelFilterExpression[], code?: string, id?: string, moduleType?: PluginModuleType, ctx?: InterpreterCtx): boolean;
+declare function exprInterpreter(expr: FilterExpression, code?: string, id?: string, moduleType?: PluginModuleType, ctx?: InterpreterCtx): boolean;
 
 //#endregion
 //#region src/simple-filters.d.ts
@@ -91,4 +118,4 @@ declare function makeIdFiltersToMatchWithQuery<T extends string | RegExp>(input:
 declare function makeIdFiltersToMatchWithQuery(input: string | RegExp | readonly (string | RegExp)[]): string | RegExp | (string | RegExp)[];
 
 //#endregion
-export { And, FilterExpression, FilterExpressionKind, TopLevelFilterExpression, and, code, exactRegex, exclude, exprInterpreter, id, include, interpreter, interpreterImpl, makeIdFiltersToMatchWithQuery, moduleType, not, or, prefixRegex };
+export { FilterExpression, FilterExpressionKind, QueryFilterObject, TopLevelFilterExpression, and, code, exactRegex, exclude, exprInterpreter, id, include, interpreter, interpreterImpl, makeIdFiltersToMatchWithQuery, moduleType, not, or, prefixRegex, query, queryObjectToFilterExpr };

package/dist/index.js

@@ -58,6 +58,16 @@ var Code = class {
 		this.kind = "code";
 	}
 };
+var Query = class {
+	kind;
+	key;
+	pattern;
+	constructor(key, pattern) {
+		this.pattern = pattern;
+		this.key = key;
+		this.kind = "query";
+	}
+};
 var Include = class {
 	kind;
 	expr;
@@ -92,24 +102,46 @@ function moduleType(pattern) {
 function code(pattern) {
 	return new Code(pattern);
 }
+function query(key, pattern) {
+	return new Query(key, pattern);
+}
 function include(expr) {
 	return new Include(expr);
 }
 function exclude(expr) {
 	return new Exclude(expr);
 }
+/**
+* convert a queryObject to FilterExpression like
+* ```js
+*   and(query(k1, v1), query(k2, v2))
+* ```
+* @param queryFilterObject The query filter object needs to be matched.
+* @returns a `And` FilterExpression
+*
+* There are three kinds of conditions are supported:
+* 1. `boolean`: if the value is `true`, the key must exist and be truthy. if the value is `false`, the key must not exist or be falsy.
+* 2. `string`: the key must exist and be equal to the value.
+* 3. `RegExp`: the key must exist and match the value.
+*/
+function queryObjectToFilterExpr(queryFilter) {
+	let arr = Object.entries(queryFilter).map(([key, value]) => {
+		return new Query(key, value);
+	});
+	return and(...arr);
+}
 function interpreter(exprs, code$1, id$1, moduleType$1) {
 	let arr = [];
 	if (Array.isArray(exprs)) arr = exprs;
 	else arr = [exprs];
 	return interpreterImpl(arr, code$1, id$1, moduleType$1);
 }
-function interpreterImpl(expr, code$1, id$1, moduleType$1) {
+function interpreterImpl(expr, code$1, id$1, moduleType$1, ctx = {}) {
 	let hasInclude = false;
 	for (const e of expr) switch (e.kind) {
 		case "include": {
 			hasInclude = true;
-			if (exprInterpreter(e.expr, code$1, id$1, moduleType$1)) return true;
+			if (exprInterpreter(e.expr, code$1, id$1, moduleType$1, ctx)) return true;
 			break;
 		}
 		case "exclude": {
@@ -119,11 +151,11 @@ function interpreterImpl(expr, code$1, id$1, moduleType$1) {
 	}
 	return !hasInclude;
 }
-function exprInterpreter(expr, code$1, id$1, moduleType$1) {
+function exprInterpreter(expr, code$1, id$1, moduleType$1, ctx = {}) {
 	switch (expr.kind) {
-		case "and": return expr.args.every((e) => exprInterpreter(e, code$1, id$1, moduleType$1));
-		case "or": return expr.args.some((e) => exprInterpreter(e, code$1, id$1, moduleType$1));
-		case "not": return !exprInterpreter(expr.expr, code$1, id$1, moduleType$1);
+		case "and": return expr.args.every((e) => exprInterpreter(e, code$1, id$1, moduleType$1, ctx));
+		case "or": return expr.args.some((e) => exprInterpreter(e, code$1, id$1, moduleType$1, ctx));
+		case "not": return !exprInterpreter(expr.expr, code$1, id$1, moduleType$1, ctx);
 		case "id": {
 			if (id$1 === void 0) throw new Error("`id` is required for `id` expression");
 			if (expr.params.cleanUrl) id$1 = cleanUrl(id$1);
@@ -137,7 +169,19 @@ function exprInterpreter(expr, code$1, id$1, moduleType$1) {
 			if (code$1 === void 0) throw new Error("`code` is required for `code` expression");
 			return typeof expr.pattern === "string" ? code$1.includes(expr.pattern) : expr.pattern.test(code$1);
 		}
-		default: throw new Error(`Expression kind ${expr.kind} is not expected.`);
+		case "query": {
+			if (id$1 === void 0) throw new Error("`id` is required for `Query` expression");
+			if (!ctx.urlSearchParamsCache) {
+				let [_, queryString = ""] = id$1.split("?", 2);
+				ctx.urlSearchParamsCache = new URLSearchParams(queryString);
+			}
+			let urlParams = ctx.urlSearchParamsCache;
+			if (typeof expr.pattern === "boolean") if (expr.pattern) return urlParams.has(expr.key);
+			else return !urlParams.has(expr.key);
+			else if (typeof expr.pattern === "string") return urlParams.get(expr.key) === expr.pattern;
+			else return expr.pattern.test(urlParams.get(expr.key) ?? "");
+		}
+		default: throw new Error(`Expression kind ${expr} is not expected.`);
 	}
 }
 
@@ -190,4 +234,4 @@ function makeRegexIdFilterToMatchWithQuery(input) {
 }
 
 //#endregion
-export { And, and, code, exactRegex, exclude, exprInterpreter, id, include, interpreter, interpreterImpl, makeIdFiltersToMatchWithQuery, moduleType, not, or, prefixRegex };
+export { and, code, exactRegex, exclude, exprInterpreter, id, include, interpreter, interpreterImpl, makeIdFiltersToMatchWithQuery, moduleType, not, or, prefixRegex, query, queryObjectToFilterExpr };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rolldown/pluginutils",
-  "version": "1.0.0-beta.8-commit.66f4623",
+  "version": "1.0.0-beta.8-commit.985af6d",
   "license": "MIT",
   "type": "module",
   "repository": {