cypress-plugin-grep-boxes 2.2.0 → 2.3.0

package/README.md

@@ -110,7 +110,9 @@ npx cypress open --env grepTags=@skip
 
 The `cypress-plugin-grep-boxes` plugin (new in v2.0.0) displays all available `effectiveTestTags` in the Cypress Test Runner for each test.
 
-If for any reason you'd like to exclude specific tags from being added to the Cypress Test Runner, use the environment variable `hideSpecTags` set to an array of tags you do not want to be displayed in the Cypress Test Runner.
+If for any reason you'd like to exclude tags from being displayed in the Cypress Test Runner, use the environment variable `hideSpecTags` set to an array of tags you do not want to be displayed in the Cypress Test Runner.
+
+### Hide specific tags
 
 Example:
 
@@ -122,7 +124,35 @@ Example:
 }
 ```
 
-The example above would not add any tags to Cypress Test Runner titled `@smoke` and `@sanity`.
+The example above would hide `@smoke` and `@sanity` tags, but show all other tags, in the Cypress Test Runner.
+
+### Hide all tags
+
+If you'd like to exclude all tags from being displayed in the Cypress Test Runner, use the following:
+
+```json
+{
+  "env": {
+    "hideSpecTags": ["*"]
+  }
+}
+```
+
+The example above would not display ANY tags to Cypress Test Runner.
+
+### Hide all tags EXCEPT specified
+
+If you'd like to ONLY display a specific subset of tags in the Cypress Test Runner, prefix tags you'd like to see displayed with `+`:
+
+```json
+{
+  "env": {
+    "hideSpecTags": ["*", "+@smoke", "+@sanity"]
+  }
+}
+```
+
+The example above would hide all tags EXCEPT `@smoke` and `@sanity` tags in the Cypress Test Runner.
 
 ## disableInitialAutoRun
 

package/index.js

@@ -402,17 +402,45 @@ export const addTags = () => {
 
 function getTagsForTitle(title, fullTagsObj) {
   const test = fullTagsObj[title];
-  if (!test) {
-    return []; // Title not found
-  }
+  if (!test) return [];
 
   const allTags = [...test.effectiveTestTags, ...test.requiredTestTags];
-  const tagsToExclude = Cypress.env('hideSpecTags');
 
-  if (!tagsToExclude?.length) return allTags;
+  let raw = Cypress.env('hideSpecTags');
+  if (!raw) return allTags;
+
+  let rules = Array.isArray(raw)
+    ? raw
+    : String(raw)
+        .split(',')
+        .map((s) => s.trim());
+
+  const includeSet = new Set();
+  const excludeSet = new Set();
+  let hideAll = false;
 
-  // Filter out excluded tags
-  return allTags.filter((tag) => !tagsToExclude?.includes(tag));
+  for (const r of rules) {
+    if (r === '*') {
+      hideAll = true;
+      continue;
+    }
+    if (r.startsWith('+')) {
+      includeSet.add(r.substring(1));
+    } else {
+      excludeSet.add(r);
+    }
+  }
+
+  // Apply tag display filtering logic
+  return allTags.filter((tag) => {
+    if (includeSet.has(tag)) return true;
+
+    if (hideAll) return false;
+
+    if (excludeSet.has(tag)) return false;
+
+    return true;
+  });
 }
 
 function renderTagPills(tags, container) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cypress-plugin-grep-boxes",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Cypress plugin that allows user to run specific tests in open mode.",
   "main": "./index.js",
   "keywords": [