From 5656e394d3d879d9cd48c18400cd7ce4c12f416e Mon Sep 17 00:00:00 2001
From: Mohamed Bassem <me@mbassem.com>
Date: Mon, 26 Jan 2026 00:50:55 +0000
Subject: feat(search): add tag: alias for # and ! alias for negation (#2425)

Add `tag:` as an alternative syntax to `#` for tag search queries,
and `!` as an alternative to `-` for negating qualifiers. This provides
more intuitive syntax options for users who prefer text-based qualifiers
over special characters.

Co-authored-by: Claude <noreply@anthropic.com>
---
 packages/shared/searchQueryParser.test.ts | 133 ++++++++++++++++++++++++++++++
 1 file changed, 133 insertions(+)

(limited to 'packages/shared/searchQueryParser.test.ts')

diff --git a/packages/shared/searchQueryParser.test.ts b/packages/shared/searchQueryParser.test.ts
index aa11433f..3954e871 100644
--- a/packages/shared/searchQueryParser.test.ts
+++ b/packages/shared/searchQueryParser.test.ts
@@ -333,6 +333,139 @@ describe("Search Query Parser", () => {
       },
     });
   });
+  test("! negation alias for -", () => {
+    // ! should work exactly like - for negation
+    expect(parseSearchQuery("!is:archived")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "archived",
+        archived: false,
+      },
+    });
+    expect(parseSearchQuery("!is:fav")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "favourited",
+        favourited: false,
+      },
+    });
+    expect(parseSearchQuery("!#my-tag")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "my-tag",
+        inverse: true,
+      },
+    });
+    expect(parseSearchQuery("!tag:my-tag")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "my-tag",
+        inverse: true,
+      },
+    });
+    expect(parseSearchQuery("!url:example.com")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "url",
+        url: "example.com",
+        inverse: true,
+      },
+    });
+    expect(parseSearchQuery("!list:my-list")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "listName",
+        listName: "my-list",
+        inverse: true,
+      },
+    });
+    expect(parseSearchQuery("!is:link")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "type",
+        typeName: BookmarkTypes.LINK,
+        inverse: true,
+      },
+    });
+    // Combined with complex queries
+    expect(parseSearchQuery("is:fav !is:archived")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "and",
+        matchers: [
+          {
+            type: "favourited",
+            favourited: true,
+          },
+          {
+            type: "archived",
+            archived: false,
+          },
+        ],
+      },
+    });
+  });
+
+  test("tag: qualifier alias for #", () => {
+    // tag: should work exactly like #
+    expect(parseSearchQuery("tag:my-tag")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "my-tag",
+        inverse: false,
+      },
+    });
+    expect(parseSearchQuery("-tag:my-tag")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "my-tag",
+        inverse: true,
+      },
+    });
+    expect(parseSearchQuery('tag:"my tag"')).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "my tag",
+        inverse: false,
+      },
+    });
+    expect(parseSearchQuery('-tag:"my tag"')).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "my tag",
+        inverse: true,
+      },
+    });
+    // Tags starting with qualifiers should be treated correctly
+    expect(parseSearchQuery("tag:android")).toEqual({
+      result: "full",
+      text: "",
+      matcher: {
+        type: "tagName",
+        tagName: "android",
+        inverse: false,
+      },
+    });
+  });
+
   test("date queries", () => {
     expect(parseSearchQuery("after:2023-10-12")).toEqual({
       result: "full",
-- 
cgit v1.2.3-70-g09d2