When node is narrowed, only show backlinks of that node

[alexjp]

Hi,

One cool feature:
Imagine you have many headings with backlinks in a journal note.
When one heading is narrowed (for example, with org-toggle-narrow-to-subtree), the backlinks section on the panel could only show backlinks of that subtree, not the whole buffer/note.

Example:

Sidebar "backlinks section" shows 3 backlinks

* Heading A ... (has 2 backlinks)
* Heading B ... (has 1 backlink)

When * Heading B is narrowed, Sidebar "backlinks section" shows 1 backlink

Thanks.

[d12frosted]

Implemented in #69: when the buffer is narrowed (e.g. org-toggle-narrow-to-subtree), the backlinks section shows only backlinks targeting IDs inside the narrowed region, and the count gets a "narrowed" marker so a shorter list reads as scoped. Outline and stats follow the restriction too.

One caveat: Emacs has no narrowing hook, so the sidebar picks up a narrow/widen on the next idle refresh (vulpea-ui-auto-refresh-delay, 1.5s by default) rather than instantly.

It is on by default; (setq vulpea-ui-respect-narrowing nil) turns it off. Thanks for the idea!

[alexjp]

One caveat: Emacs has no narrowing hook, so the sidebar picks up a narrow/widen on the next idle refresh (vulpea-ui-auto-refresh-delay, 1.5s by default) rather than instantly.

Yeah, no worries, its the same with outline (which already updates with narrowing)!

One question: is vulpea-ui-auto-refresh-delay heavy work?

:EDIT START: hehe @d12frosted , I just did this and works well:

(defun my/org-toggle-narrow-and-sidebar ()
  (interactive)
  (org-toggle-narrow-to-subtree)
  (vulpea-ui-sidebar-refresh))

(with-eval-after-load 'vulpea
  (define-key org-mode-map (kbd "M-<insert>") #'my/org-toggle-narrow-and-sidebar))

:EDIT END:

Also, sorry for the "not complete issue report", could links also be narrowed?

The daily journal sidebar could then become (order is just an idea, since its configurable):

* stats (common note)
* calendar (journal specific section)
* schema (common note)
* outline (common note)
* backlinks (common note)
* unlinked mentions (common note)
* links (common note)
* outgoing mentions (common note)
* created today (journal specific section)
* previous years (journal specific section)

and the sections of (common note), could be affected by narrowing (simulating "zoom in/out" in Logseq and other outline apps).

Thanks!

[d12frosted]

is vulpea-ui-auto-refresh-delay heavy work?

No. The idle refresh re-renders the sidebar, but all the heavy parts (database queries, ripgrep, buffer parsing) are cached and only recompute when something they depend on actually changed (the note, the buffer content, the restriction). On a quiet buffer the refresh is a cheap diff, so lowering the delay is fine.

Nice recipe, by the way; that is exactly the intended escape hatch for the missing narrowing hook. I added it to the README.

And yes, links can be narrowed too: #71 scopes the links widget to the restriction (by link position), with the same narrowed marker on the count. Mentions widgets are the remaining ones; they are ripgrep-based so scoping them is a bit more involved, but the groundwork is there (the narrowing scope is shared with all widgets as context now), so they can follow later.