From a3f96c86cff75ab3035664e90b246956f7717beb Mon Sep 17 00:00:00 2001
From: Michael Gartner <mclicks@gmail.com>
Date: Mon, 17 Aug 2026 14:45:18 -0600
Subject: [PATCH 1/2] Enhance QuickSwitcherDialog with original title
 visibility feature

- Implemented a tooltip to reveal original titles for bookmarks with aliases, improving user experience by allowing inspection of original content.
- Refactored rendering logic to conditionally display original titles in the menu items based on selection state.
- Updated utility function to manage bookmark title presentation, ensuring clarity between aliases and original titles.
---
 CHANGELOG.md                           |   4 +
 src/components/QuickSwitcherDialog.tsx | 102 ++++++++++++++++---------
 src/utils/quickSwitcher.ts             |   9 +++
 tests/quickSwitcher.test.ts            |  25 ++++++
 4 files changed, 102 insertions(+), 38 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 825c32f..5952fe0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1 +1,5 @@
 # Changelog
+
+## Unreleased
+
+- Hide original page and block content for aliased saved entries, with a reveal tooltip for inspecting the original.
diff --git a/src/components/QuickSwitcherDialog.tsx b/src/components/QuickSwitcherDialog.tsx
index 90a9100..8dba5a1 100644
--- a/src/components/QuickSwitcherDialog.tsx
+++ b/src/components/QuickSwitcherDialog.tsx
@@ -7,6 +7,7 @@ import {
   Menu,
   MenuItem,
   Spinner,
+  Tooltip,
 } from "@blueprintjs/core";
 import React, {
   useCallback,
@@ -22,6 +23,8 @@ import type {
 } from "~/types/quickSwitcher";
 import {
   filterBookmarks,
+  getBookmarkRowPresentation,
+  getBookmarkTargetLabel,
   getBookmarkTargetType,
   getBookmarkTargetUid,
 } from "~/utils/quickSwitcher";
@@ -151,18 +154,6 @@ const getModeFromTabId = ({
   tabId: string | number;
 }): QuickSwitcherDialogMode => (tabId === "manage" ? "manage" : "open");
 
-const getBookmarkDisplayTitle = ({
-  bookmark,
-}: {
-  bookmark: QuickSwitcherBookmark;
-}): string => bookmark.alias || bookmark.title;
-
-const getBookmarkSubtitle = ({
-  bookmark,
-}: {
-  bookmark: QuickSwitcherBookmark;
-}): string | undefined => (bookmark.alias ? bookmark.title : undefined);
-
 const renderFooterActionContent = ({
   label,
   hotkeys = [],
@@ -804,11 +795,9 @@ const QuickSwitcherDialog = ({
 
   const renderRowContent = ({
     breadcrumbs = [],
-    subtitle,
     title,
   }: {
     breadcrumbs?: string[];
-    subtitle?: string;
     title: string;
   }): React.ReactElement => (
     <div
@@ -826,14 +815,46 @@ const QuickSwitcherDialog = ({
           }
         >
           <span>{title}</span>
-          {subtitle ? (
-            <div className="bp3-text-muted truncate text-xs">{subtitle}</div>
-          ) : null}
         </div>
       </div>
     </div>
   );
 
+  const renderOriginalTitleButton = ({
+    bookmark,
+  }: {
+    bookmark: QuickSwitcherBookmark;
+  }): React.ReactElement | null => {
+    const { originalTitle } = getBookmarkRowPresentation({ bookmark });
+    if (!originalTitle) {
+      return null;
+    }
+
+    const targetLabel = getBookmarkTargetLabel({ bookmark }).toLowerCase();
+    return (
+      <Tooltip
+        content={
+          <div className="max-w-sm">
+            <div className="mb-1 font-semibold">Original {targetLabel}</div>
+            <div className="break-words">{originalTitle}</div>
+          </div>
+        }
+        hoverOpenDelay={250}
+      >
+        <Button
+          aria-label={`Show original ${targetLabel}: ${originalTitle}`}
+          icon="eye-open"
+          minimal
+          onClick={(event): void => {
+            event.preventDefault();
+            event.stopPropagation();
+          }}
+          small
+        />
+      </Tooltip>
+    );
+  };
+
   const renderAliasEditor = ({
     bookmark,
   }: {
@@ -884,25 +905,29 @@ const QuickSwitcherDialog = ({
 
     return (
       <Menu className="rm-find-or-create-modal-body__list">
-        {visibleBookmarks.map((bookmark, index) => (
-          <MenuItem
-            aria-selected={selectedIndex === index}
-            key={bookmark.id}
-            onClick={(event): void => onBookmarkRowClick({ bookmark, event })}
-            onMouseEnter={(): void => setSelectedIndex(index)}
-            multiline
-            style={
-              selectedIndex === index
-                ? SELECTED_MENU_ITEM_STYLE
-                : MENU_ITEM_STYLE
-            }
-            text={renderRowContent({
-              breadcrumbs: getBookmarkBreadcrumbs({ bookmark }),
-              subtitle: getBookmarkSubtitle({ bookmark }),
-              title: getBookmarkDisplayTitle({ bookmark }),
-            })}
-          />
-        ))}
+        {visibleBookmarks.map((bookmark, index) => {
+          const isSelected = selectedIndex === index;
+          const { title } = getBookmarkRowPresentation({ bookmark });
+          return (
+            <MenuItem
+              aria-selected={isSelected}
+              key={bookmark.id}
+              labelElement={
+                isSelected ? renderOriginalTitleButton({ bookmark }) : null
+              }
+              onClick={(event): void =>
+                onBookmarkRowClick({ bookmark, event })
+              }
+              onMouseEnter={(): void => setSelectedIndex(index)}
+              multiline
+              style={isSelected ? SELECTED_MENU_ITEM_STYLE : MENU_ITEM_STYLE}
+              text={renderRowContent({
+                breadcrumbs: getBookmarkBreadcrumbs({ bookmark }),
+                title,
+              })}
+            />
+          );
+        })}
       </Menu>
     );
   };
@@ -964,6 +989,7 @@ const QuickSwitcherDialog = ({
       <Menu className="rm-find-or-create-modal-body__list">
         {bookmarks.map((bookmark) => {
           const isEditingAlias = editingAliasBookmarkId === bookmark.id;
+          const { title } = getBookmarkRowPresentation({ bookmark });
           return (
             <MenuItem
               key={bookmark.id}
@@ -996,6 +1022,7 @@ const QuickSwitcherDialog = ({
                   </div>
                 ) : (
                   <div className="flex items-center gap-1">
+                    {renderOriginalTitleButton({ bookmark })}
                     <Button
                       aria-label={`Edit alias for ${bookmark.title}`}
                       icon="edit"
@@ -1034,8 +1061,7 @@ const QuickSwitcherDialog = ({
                   ? renderAliasEditor({ bookmark })
                   : renderRowContent({
                       breadcrumbs: getBookmarkBreadcrumbs({ bookmark }),
-                      subtitle: getBookmarkSubtitle({ bookmark }),
-                      title: getBookmarkDisplayTitle({ bookmark }),
+                      title,
                     })
               }
               style={MENU_ITEM_STYLE}
diff --git a/src/utils/quickSwitcher.ts b/src/utils/quickSwitcher.ts
index 00b37d5..13a20e6 100644
--- a/src/utils/quickSwitcher.ts
+++ b/src/utils/quickSwitcher.ts
@@ -152,6 +152,15 @@ export const getBookmarkTargetLabel = ({
 }): string =>
   getBookmarkTargetType({ bookmark }) === "block" ? "Block" : "Page";
 
+export const getBookmarkRowPresentation = ({
+  bookmark,
+}: {
+  bookmark: QuickSwitcherBookmark;
+}): { originalTitle?: string; title: string } => ({
+  title: bookmark.alias || bookmark.title,
+  ...(bookmark.alias ? { originalTitle: bookmark.title } : {}),
+});
+
 export const deriveBlockTitle = ({
   text,
   maxWords = 8,
diff --git a/tests/quickSwitcher.test.ts b/tests/quickSwitcher.test.ts
index 54da636..0dfbe98 100644
--- a/tests/quickSwitcher.test.ts
+++ b/tests/quickSwitcher.test.ts
@@ -5,6 +5,7 @@ import {
   deriveBlockTitle,
   extractBlockRefUid,
   filterBookmarks,
+  getBookmarkRowPresentation,
   getCommandPaletteCommandLabel,
   normalizeCommandPaletteSettings,
   parsePageUidFromUrl,
@@ -59,6 +60,30 @@ test("filters bookmarks by title or url", () => {
   expect(filterBookmarks({ bookmarks, query: "graph/page" })).toHaveLength(2);
 });
 
+test("hides original titles only when a bookmark has an alias", () => {
+  const baseBookmark: QuickSwitcherBookmark = {
+    id: "block-1",
+    title: "Meeting Notes {{Today:SmartBlock:DevMeetingToday}}",
+    url: "https://roamresearch.com/#/app/graph/page/block-1",
+    targetType: "block",
+    pageUid: null,
+    blockUid: "block-1",
+    breadcrumbs: ["Sync", "Dev team"],
+  };
+
+  expect(getBookmarkRowPresentation({ bookmark: baseBookmark })).toEqual({
+    title: "Meeting Notes {{Today:SmartBlock:DevMeetingToday}}",
+  });
+  expect(
+    getBookmarkRowPresentation({
+      bookmark: { ...baseBookmark, alias: "Dev Team" },
+    }),
+  ).toEqual({
+    title: "Dev Team",
+    originalTitle: "Meeting Notes {{Today:SmartBlock:DevMeetingToday}}",
+  });
+});
+
 test("parses and sanitizes stored bookmarks", () => {
   const parsed = parseStoredBookmarks({
     value: [

From 89730b271c1144ffc16fd3a20081135c53674fd7 Mon Sep 17 00:00:00 2001
From: Michael Gartner <mclicks@gmail.com>
Date: Mon, 17 Aug 2026 14:57:01 -0600
Subject: [PATCH 2/2] Update CHANGELOG to remove unreleased section

Removed unreleased section and related entry from CHANGELOG.
---
 CHANGELOG.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5952fe0..825c32f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1 @@
 # Changelog
-
-## Unreleased
-
-- Hide original page and block content for aliased saved entries, with a reveal tooltip for inspecting the original.