feat: expose toggleTooltip function

docs/guide/usage/composition-api.md

@@ -14,7 +14,8 @@ const VuePopperOptions = {
 const {
 	popperInstance,
 	triggerElement,
-	tooltipElement
+	tooltipElement,
+	toggleTooltip
 } = useVuePopper(VuePopperOptions);
 </script>
 ```
@@ -23,6 +24,7 @@ As you notice, the `useVuePopper` returns an object with three properties:
 - `popperInstance`: The popper instance. It will give you access to the popper instance.
 - `triggerElement`: The trigger element. Use this to add the trigger element.
 - `tooltipElement`: The tooltip element. Use this to add the tooltip element.
+- `toggleTooltip`: A function to toggle the tooltip visibility. Optionally pass a value of ('hide' or 'show') to force the tooltip to hide or show.
 
 We can use these in template to add the trigger and tooltip elements. Like this:
 

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kalimahapps/vue-popper",
   "description": "vue3 tooltip component based on popperjs",
-  "version": "1.1.8",
+  "version": "1.1.9",
   "sideEffects": false,
   "repository": {
     "type": "git",
@@ -29,7 +29,6 @@
   "author": "khr2003",
   "license": "MIT",
   "dependencies": {
-    "@kalimahapps/vue-popper": "^1.1.7",
     "@popperjs/core": "^2.11.8",
     "@vueuse/core": "^10.4.1"
   },

src/VuePopper.vue

@@ -154,7 +154,7 @@ if (Object.keys(props.popperOptions).length > 0) {
 	console.warn('@kalimahapps/vue-popper: popperOptions is deprecated. Use the individual props instead.');
 }
 
-const { popperInstance, triggerElement, tooltipElement, isOpened } = useVuePopper({
+const { popperInstance, triggerElement, tooltipElement, isOpened, toggleTooltip } = useVuePopper({
 	hover: props.hover,
 	disableClickOutside: props.disableClickOutside,
 	openDelay: props.openDelay,
@@ -183,5 +183,6 @@ defineExpose({
 	isOpened: computed(() => {
 		return isOpened.value;
 	}),
+	toggleTooltip,
 });
 </script>

src/composable.ts

@@ -544,6 +544,7 @@ const useVuePopper = function (suppliedOptions: Options = {}) {
 		triggerElement,
 		tooltipElement,
 		popperInstance,
+		toggleTooltip,
 		isOpened: computed(() => { return isOpened.value; }),
 	};
 };