hyperbole conflicts with org mode export subtree

[pedro-nonfree]

I started recently using hyperbole and I love it, I installed it with:

(use-package hyperbole :ensure nil
  :config
  (hyperbole-mode 1))

But I discovered a very weird problem

suppose an org file example.org with the following contents and that I open it with emacs -q (GNU Emacs 30.1 (build 3, x86_64-pc-linux-gnu, X toolkit, cairo version 1.16.0, Xaw3d scroll bars) of 2025-05-04):

* my document
:PROPERTIES:
:EXPORT_OPTIONS: toc:nil
:END:

my cursor is here

** heading 1
** heading 2
** heading 3

Then, I apply (where my cursor is):

(org-latex-export-to-pdf nil t t nil)

That makes export of current subtree, so the properties are going to be read

this is the document generated (example.pdf), it effectively hides toc

when I load hyperbole

;; https://www.gnu.org/software/hyperbole/man/hyperbole.html
;;  date might differ for you
(push "~/.emacs.d/elpa/hyperbole-20250608.536/" load-path)
(require 'hyperbole)
(hyperbole-mode 1)

ignores my EXPORT_OPTIONS to hide the toc (that also applies with a bunch of properties that I use on certain org headings to export, for example, invoices, quotes, etc.)

As I was saying, I like hyperbole a lot, but I don't know how to avoid having this problem, no matter what I do, after enabling it, I cannot disable to return to the previous functionality with org export subtree, I need to restart emacs, this is what I tried:

(hyperbole-mode -1)
(unload-feature 'hyperbole t)
(revert-buffer t t)
(org-mode-restart)

[rswgnu]

Hyperbole does contain a toc implicit button type that jumps to sections referred to by a toc. {C-h A} will show you what it will do in any context. But since you are not pressing the Action Key, this should not affect what you are doing at all. It is very strange behavior. We’ll test it out and see. Thanks for the clear explanation.

…

-- rsw

[rswgnu]

As expected, when I tested with the latest Hyperbole release loaded, I see the TOC and Hyperbole has no effect on this. You must have something else in your configuration that is interfering with your Org latex export. Also just to see, try initializing Hyperbole without the :defer keyword and see if anything behaves differently.

Here is the screenshot of the output I see:

https://i.imgur.com/cPdOk9f.png

[pedro-nonfree]

Your image reproduce, essentially, the same bug: the toc should not appear when subtree is exported with property :EXPORT_OPTIONS: toc:nil src https://orgmode.org/manual/Export-Settings.html

I think it's better to test with a different orgmode PROPERTY to show the bug more broadly, let's add author John Doe in the previous document:

* my document
:PROPERTIES:
:EXPORT_AUTHOR: John Doe
:EXPORT_OPTIONS: toc:nil
:END:

my cursor is here

** heading 1
** heading 2
** heading 3

if I enable hypermode in emacs -q the same way I did in the previous publication, the author does not appear (hence, is not taking in consideration the property I defined), and this could be extended to any property of that node when subtree is exported (that's why I realized this is the problem)

There is nothing else in my configuration because when I try with emacs -q, it test with no init config, with vanilla emacs (orgmode is included in core, but hyperbole no). I am not using :defer to initialize it, but the same error happens no matter how I initialize it, when hyperbole-mode is initialized, the only way to process again subtree properties of export is restarting emacs. I would like to know if I can toggle hyperbole on and off effectively to avoid restarting emacs.