From 0b5f09bc15cf56db7898c6f8ef5986dca0720d1b Mon Sep 17 00:00:00 2001
From: yyh <yuanyouhuilyz@gmail.com>
Date: Sat, 9 May 2026 12:45:13 +0800
Subject: [PATCH] docs(web): remove legacy tooltip migration references

---
 packages/dify-ui/README.md    | 2 +-
 web/docs/overlay-migration.md | 4 ----
 web/eslint.constants.mjs      | 8 --------
 3 files changed, 1 insertion(+), 13 deletions(-)

diff --git a/packages/dify-ui/README.md b/packages/dify-ui/README.md
index fd75042d76..c78faede89 100644
--- a/packages/dify-ui/README.md
+++ b/packages/dify-ui/README.md
@@ -103,7 +103,7 @@ See `[web/docs/overlay-migration.md](../../web/docs/overlay-migration.md)` for t
 
 - Use `Tooltip` only for short, non-interactive visual labels. The trigger must already have visible text or an `aria-label`; the tooltip is not the accessible name and must not contain links, buttons, forms, or structured prose.
 - Use `Popover` for explanatory content, long text, rich layout, or anything users may need to reach on touch or with assistive technology. In `web/`, the `Infotip` wrapper is the preferred pattern for a `?` help glyph backed by `Popover`.
-- Do not copy legacy tooltip offsets into migrated call sites. Pick a `placement` and let the primitive own spacing.
+- Pick a `placement` and let the primitive own spacing. Avoid per-call-site offsets unless the component API explicitly needs a measured layout exception.
 - When passing a Base UI trigger `render` prop, render a real `<button type="button">` for button-like triggers. If a Popover trigger must render a `div`, `span`, or another non-button element, pass `nativeButton={false}`.
 
 ## Development
diff --git a/web/docs/overlay-migration.md b/web/docs/overlay-migration.md
index 807bc2fc68..3d94d82e64 100644
--- a/web/docs/overlay-migration.md
+++ b/web/docs/overlay-migration.md
@@ -7,8 +7,6 @@ This document tracks the Dify-web migration away from legacy overlay APIs.
 ## Scope
 
 - Deprecated imports:
-  - `@/app/components/base/tooltip`
-  - `@/app/components/base/tooltip/content`
   - `@/app/components/base/modal`
   - `@/app/components/base/dialog`
   - `@/app/components/base/drawer`
@@ -78,8 +76,6 @@ back to `z-9999`.
   parent legacy overlay should be migrated instead.
 - When migrating a legacy overlay that has a high z-index, remove the z-index
   entirely — the new primitive's default `z-1002` handles it.
-- Do not preserve legacy tooltip offsets at call sites. Choose the nearest
-  `placement`/side alignment and let the primitive own its default spacing.
 - When using Base UI trigger `render`, render a real `button` for button-like
   triggers. If the trigger must render a non-button element, the primitive must
   explicitly opt out of the native button behavior where that API is available.
diff --git a/web/eslint.constants.mjs b/web/eslint.constants.mjs
index 16a4b4a7a8..eb85d5d902 100644
--- a/web/eslint.constants.mjs
+++ b/web/eslint.constants.mjs
@@ -45,14 +45,6 @@ export const WEB_RESTRICTED_IMPORT_PATTERNS = [
 ]
 
 export const OVERLAY_RESTRICTED_IMPORT_PATTERNS = [
-  {
-    group: [
-      '**/base/tooltip',
-      '**/base/tooltip/index',
-      '**/base/tooltip/content',
-    ],
-    message: 'Deprecated: use @langgenius/dify-ui/tooltip for short labels; use Popover/Infotip for rich or explanatory content. See issue #32767.',
-  },
   {
     group: [
       '**/base/modal',