Merge branch 'main' of https://github.com/NotePlan/plugins

Author: jgclark

dwertheimer.Favorites/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Favorites Plugin Changelog
 
+## [1.4.1] - 2026-07-21 @dwertheimer
+
+- **Fixed**: The unfavorite star icon on each note row was getting clipped at the top of the row.
+- **Feature**: Added a "Group favorites by folder" plugin setting (bool). This controls the initial state of the Notes list's "group by folder" toggle when the Favorites browser window opens; users can still switch modes from the toggle itself within the session.
+
+## [1.4.0] - 2026-07-21 @dwertheimer
+
+- **Feature**: Added a "Group by folder" toggle to the Favorites browser Notes view (next to the Notes/Commands segmented control). When enabled, favorite notes are grouped under folder headers instead of a flat list, making it easier to scan favorites when you have many of them across different folders.
+
 ## [1.3.6] - 2026-04-13 @dwertheimer
 
 - **PluginRequestEnvelope**: Favorites browser `requestFromPlugin` resolves with `@helpers/react/pluginRequestEnvelope` (`unwrapPluginRequestData` / explicit `success` + `data` + `message`). **Release together with np.Shared 1.0.7+** (or matching Root bundle).

dwertheimer.Favorites/plugin.json

@@ -6,8 +6,8 @@
   "plugin.name": "⭐️ Favorites",
   "plugin.description": "Get fast access to commonly-used notes. Set any Project Note(s) as a Favorites and have quick access to choose/open the file",
   "plugin.author": "@dwertheimer",
-  "plugin.version": "1.3.6",
-  "plugin.lastUpdateInfo": "1.3.6: PluginRequestEnvelope / requestFromPlugin aligned with np.Shared 1.0.7.\n1.3.5: Fix sidebar icon colour issue\n1.3.4: Fix dark mode issues (thx @clayrussell)\n1.3.3: Use new sidebar view feature\n1.3.0: Add new '/favorites browser' command to open favorites in a sidebar window to view and open favorite notes and commands\n1.3.1: Fix request timeout issue\n1.3.2: Fix frontmatter not being removed when unfavoriting",
+  "plugin.version": "1.4.1",
+  "plugin.lastUpdateInfo": "1.4.1: Fix clipped unfavorite star icon; add 'Group favorites by folder' setting.\n1.4.0: Add 'Group by folder' toggle to Favorites browser Notes view.\n1.3.6: PluginRequestEnvelope / requestFromPlugin aligned with np.Shared 1.0.7.\n1.3.5: Fix sidebar icon colour issue\n1.3.4: Fix dark mode issues (thx @clayrussell)\n1.3.3: Use new sidebar view feature\n1.3.0: Add new '/favorites browser' command to open favorites in a sidebar window to view and open favorite notes and commands\n1.3.1: Fix request timeout issue\n1.3.2: Fix frontmatter not being removed when unfavoriting",
   "plugin.dependencies": [],
   "plugin.requiredFiles": ["react.c.FavoritesView.bundle.dev.js"],
   "plugin.script": "script.js",
@@ -243,6 +243,14 @@
       "default": "-",
       "required": false
     },
+    {
+      "key": "groupFavoritesByFolder",
+      "title": "Group favorites by folder",
+      "description": "In the Favorites browser window, start the Notes list grouped by folder rather than sorted by name. You can still toggle this on/off from the browser window itself; this setting just controls the default it starts in.",
+      "type": "bool",
+      "default": false,
+      "required": true
+    },
     {
       "key": "favoriteIdentifier",
       "title": "How should favorite notes be identified?",

dwertheimer.Favorites/src/components/FavoritesView.css

@@ -90,6 +90,41 @@
   font-weight: 600;
 }
 
+.favorites-group-toggle-button {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.5rem 0.625rem;
+  border: 1px solid var(--divider-color);
+  background: var(--bg-main-color);
+  border-radius: 6px;
+  cursor: pointer;
+  color: var(--fg-placeholder-color);
+  transition: all 0.2s ease;
+  flex-shrink: 0;
+}
+
+.favorites-group-toggle-button:hover {
+  background: var(--bg-mid-color);
+  color: var(--fg-main-color);
+}
+
+.favorites-group-toggle-button-active {
+  background: var(--tint-color);
+  border-color: var(--tint-color);
+  color: var(--fg-main-color);
+}
+
+.favorites-group-toggle-button-active:hover {
+  background: var(--tint-color);
+}
+
+.favorites-group-toggle-icon {
+  font-size: 0.875rem;
+  width: 14px;
+  text-align: center;
+}
+
 .favorites-new-button {
   display: flex;
   align-items: center;
@@ -179,11 +214,54 @@
   white-space: nowrap;
 }
 
+/* Folder group header row */
+.favorites-item-folder-header {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  width: 100%;
+  min-width: 0;
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.02em;
+  color: var(--fg-placeholder-color);
+}
+
+.favorites-folder-header-icon {
+  flex-shrink: 0;
+  width: 12px;
+  text-align: center;
+  font-size: 0.75rem;
+}
+
+.favorites-folder-header-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Folder headers are informational only - not selectable/clickable rows */
+.list-item:has(.favorites-item-folder-header) {
+  cursor: default;
+  background: transparent !important;
+  border-color: transparent !important;
+  pointer-events: none;
+  margin-top: 0.5rem;
+}
+
+.list-item:has(.favorites-item-folder-header):first-child {
+  margin-top: 0.125rem;
+}
+
 /* Unfavorite icon styling */
 .favorites-item-note .favorites-unfavorite-icon {
   margin-left: auto;
   margin-right: 0.25rem;
   flex-shrink: 0;
+  /* Override InfoIcon's default `top: -0.5em` offset, which clips the icon against
+     the overflow:hidden list-item-content wrapper in this tightly-padded list row */
+  top: 0;
 }
 
 /* Styles for Add Favorite Note Dialog with Markdown Preview */