docs: imperativeModeOnly prop

Author: gabrieljablonski

docs/docs/examples/imperative-mode.mdx

@@ -87,6 +87,8 @@ interface TooltipImperativeProps {
 
 The imperative methods <b>can</b> be applied alongside regular tooltip usage. For example, you could use just `close()` to close a regular tooltip after an API request is finished.
 
+If you intend on using the tooltip exclusively with these methods, setting the `imperativeModeOnly` tooltip prop to disable default behavior is recommended. Otherwise, you might face undesired behavior.
+
 :::
 
 - `open()` opens the tooltip programatically. All of the arguments are optional
@@ -150,6 +152,14 @@ const tooltipRef2 = useRef<TooltipImperativeProps>(null)
 <Tooltip ref={tooltipRef2} />
 ```
 
+:::caution
+
+Notice the tooltip still closes when unhovering the anchor element. This might be undesired if you're using the imperative methods exclusively.
+
+If that's the case, use the `imperativeModeOnly` tooltip prop to disable default tooltip behavior.
+
+:::
+
 export const ImperativeModeExample = () => {
   const tooltipRef1 = useRef(null)
   const tooltipRef2 = useRef(null)

docs/docs/options.mdx

@@ -118,6 +118,7 @@ import { Tooltip } from 'react-tooltip';
 | `openEvents`            | `Record<string, boolean>`              | no       | `mouseenter` `focus`      | `mouseenter` `focus` `click` `dblclick` `mousedown`                                                                               | Events to be listened on the anchor elements to open the tooltip                                                                                                |
 | `closeEvents`           | `Record<string, boolean>`              | no       | `mouseleave` `blur`       | `mouseleave` `blur` `click` `dblclick` `mouseup`                                                                                  | Events to be listened on the anchor elements to close the tooltip                                                                                               |
 | `globalCloseEvents`     | `Record<string, boolean>`              | no       |                           | `escape` `scroll` `resize` `clickOutsideAnchor`                                                                                   | Global events to be listened to close the tooltip (`escape` closes on pressing `ESC`, `clickOutsideAnchor` is useful with click events on `openEvents`)         |
+| `imperativeModeOnly`    | `boolean`                              | no       | `false`                   | `true` `false`                                                                                                                    | When enabled, default tooltip behavior is disabled. Check [the examples](./examples/imperative-mode.mdx) for more details                                       |
 | `style`                 | `CSSProperties`                        | no       |                           | a CSS style object                                                                                                                | Add inline styles directly to the tooltip                                                                                                                       |
 | `position`              | `{ x: number; y: number }`             | no       |                           | any `number` value for both `x` and `y`                                                                                           | Override the tooltip position on the DOM                                                                                                                        |
 | `isOpen`                | `boolean`                              | no       |                           | `true` `false`                                                                                                                    | The tooltip can be controlled or uncontrolled, this attribute can be used to handle show and hide tooltip outside tooltip (can be used **without** `setIsOpen`) |