From 9902f46c7a6872c756558c23c41dd83d16e125eb Mon Sep 17 00:00:00 2001
From: keven1024 <keven@fudaoyuan.icu>
Date: Fri, 17 Oct 2025 23:01:21 +0800
Subject: [PATCH] feat(front): add Tooltip component and related subcomponents
 for enhanced UI functionality

---
 front/components/ui/tooltip/Tooltip.vue       | 15 +++++++
 .../components/ui/tooltip/TooltipContent.vue  | 39 +++++++++++++++++++
 .../components/ui/tooltip/TooltipProvider.vue | 14 +++++++
 .../components/ui/tooltip/TooltipTrigger.vue  | 12 ++++++
 front/components/ui/tooltip/index.ts          |  4 ++
 5 files changed, 84 insertions(+)
 create mode 100644 front/components/ui/tooltip/Tooltip.vue
 create mode 100644 front/components/ui/tooltip/TooltipContent.vue
 create mode 100644 front/components/ui/tooltip/TooltipProvider.vue
 create mode 100644 front/components/ui/tooltip/TooltipTrigger.vue
 create mode 100644 front/components/ui/tooltip/index.ts

diff --git a/front/components/ui/tooltip/Tooltip.vue b/front/components/ui/tooltip/Tooltip.vue
new file mode 100644
index 0000000..9e48344
--- /dev/null
+++ b/front/components/ui/tooltip/Tooltip.vue
@@ -0,0 +1,15 @@
+<script setup lang="ts">
+import type { TooltipRootEmits, TooltipRootProps } from 'reka-ui'
+import { TooltipRoot, useForwardPropsEmits } from 'reka-ui'
+
+const props = defineProps<TooltipRootProps>()
+const emits = defineEmits<TooltipRootEmits>()
+
+const forwarded = useForwardPropsEmits(props, emits)
+</script>
+
+<template>
+    <TooltipRoot data-slot="tooltip" v-bind="forwarded">
+        <slot />
+    </TooltipRoot>
+</template>
diff --git a/front/components/ui/tooltip/TooltipContent.vue b/front/components/ui/tooltip/TooltipContent.vue
new file mode 100644
index 0000000..2794354
--- /dev/null
+++ b/front/components/ui/tooltip/TooltipContent.vue
@@ -0,0 +1,39 @@
+<script setup lang="ts">
+import type { TooltipContentEmits, TooltipContentProps } from 'reka-ui'
+import type { HTMLAttributes } from 'vue'
+import { reactiveOmit } from '@vueuse/core'
+import { TooltipArrow, TooltipContent, TooltipPortal, useForwardPropsEmits } from 'reka-ui'
+import { cn } from '@/lib/utils'
+
+defineOptions({
+    inheritAttrs: false,
+})
+
+const props = withDefaults(defineProps<TooltipContentProps & { class?: HTMLAttributes['class'] }>(), {
+    sideOffset: 4,
+})
+
+const emits = defineEmits<TooltipContentEmits>()
+
+const delegatedProps = reactiveOmit(props, 'class')
+const forwarded = useForwardPropsEmits(delegatedProps, emits)
+</script>
+
+<template>
+    <TooltipPortal>
+        <TooltipContent
+            data-slot="tooltip-content"
+            v-bind="{ ...forwarded, ...$attrs }"
+            :class="
+                cn(
+                    'bg-primary text-primary-foreground animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-fit rounded-md px-3 py-1.5 text-xs text-balance',
+                    props.class
+                )
+            "
+        >
+            <slot />
+
+            <TooltipArrow class="bg-primary fill-primary z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]" />
+        </TooltipContent>
+    </TooltipPortal>
+</template>
diff --git a/front/components/ui/tooltip/TooltipProvider.vue b/front/components/ui/tooltip/TooltipProvider.vue
new file mode 100644
index 0000000..725b5fd
--- /dev/null
+++ b/front/components/ui/tooltip/TooltipProvider.vue
@@ -0,0 +1,14 @@
+<script setup lang="ts">
+import type { TooltipProviderProps } from 'reka-ui'
+import { TooltipProvider } from 'reka-ui'
+
+const props = withDefaults(defineProps<TooltipProviderProps>(), {
+    delayDuration: 0,
+})
+</script>
+
+<template>
+    <TooltipProvider v-bind="props">
+        <slot />
+    </TooltipProvider>
+</template>
diff --git a/front/components/ui/tooltip/TooltipTrigger.vue b/front/components/ui/tooltip/TooltipTrigger.vue
new file mode 100644
index 0000000..15693bf
--- /dev/null
+++ b/front/components/ui/tooltip/TooltipTrigger.vue
@@ -0,0 +1,12 @@
+<script setup lang="ts">
+import type { TooltipTriggerProps } from 'reka-ui'
+import { TooltipTrigger } from 'reka-ui'
+
+const props = defineProps<TooltipTriggerProps>()
+</script>
+
+<template>
+    <TooltipTrigger data-slot="tooltip-trigger" v-bind="props">
+        <slot />
+    </TooltipTrigger>
+</template>
diff --git a/front/components/ui/tooltip/index.ts b/front/components/ui/tooltip/index.ts
new file mode 100644
index 0000000..5ab9653
--- /dev/null
+++ b/front/components/ui/tooltip/index.ts
@@ -0,0 +1,4 @@
+export { default as Tooltip } from './Tooltip.vue'
+export { default as TooltipContent } from './TooltipContent.vue'
+export { default as TooltipProvider } from './TooltipProvider.vue'
+export { default as TooltipTrigger } from './TooltipTrigger.vue'