bsky-richtext-react 1.1.0 → 2.0.0

package/CHANGELOG.md

@@ -7,6 +7,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [2.0.0] — 2026-02-18
+
+### Breaking Changes
+
+- **Upgraded all `@tiptap/*` dependencies from v2 to v3** (`^3.20.0`). Consumers must update their installed `@tiptap/*` packages to v3.
+- **Replaced `tippy.js` with `@floating-ui/dom`** for mention suggestion popup positioning, aligning with the tiptap v3 ecosystem. The `tippy.js` peer dependency has been removed.
+- **Peer dependency requirements changed**: consumers must install `@tiptap/*@^3.20.0` and `@floating-ui/dom@^1.6.0`. The `tippy.js` peer dependency is no longer required.
+
+### Why
+
+- Fixes Turbopack build failures in Next.js 16+ when the consumer's dependency tree includes tiptap v3 packages (e.g., via `@tiptap/starter-kit@3.x`). Turbopack's strict static export analysis caught that `@tiptap/extension-list@3.x` imports symbols from `@tiptap/core` that don't exist in v2.
+- Aligns with the tiptap v3 ecosystem (`tippy.js` → `@floating-ui/dom`).
+
+### Migration
+
+```diff
+- "@tiptap/core": "^2.x.x",
++ "@tiptap/core": "^3.20.0",
+  // repeat for all @tiptap/* packages
+
+- "tippy.js": "^6.x.x",
++ "@floating-ui/dom": "^1.6.0",
+```
+
+---
+
+## [2.0.0] — 2026-02-18
+
+### Breaking Changes
+
+- **tiptap upgraded from v2 to v3** — all `@tiptap/*` peer dependencies must be updated to `^3.20.0`.
+- **`tippy.js` replaced with `@floating-ui/dom`** — the mention suggestion popup now uses `@floating-ui/dom` for positioning. Remove `tippy.js` from your dependencies and install `@floating-ui/dom` instead.
+
+### Migration
+
+```diff
+- bun add @tiptap/core@^2 @tiptap/react@^2 ... tippy.js
++ bun add @tiptap/core@^3.20.0 @tiptap/react@^3.20.0 ... @floating-ui/dom
+```
+
+Update all `@tiptap/*` peer dependencies to `^3.20.0` and replace `tippy.js` with `@floating-ui/dom`.
+
+---
+
 ## [1.1.0] — 2026-02-17
 
 ### Changed

package/README.md

@@ -36,7 +36,16 @@ pnpm add bsky-richtext-react
 Peer dependencies (if not already installed):
 
 ```bash
-bun add react react-dom
+bun add react react-dom @floating-ui/dom \
+  @tiptap/core@^3.20.0 \
+  @tiptap/extension-document@^3.20.0 \
+  @tiptap/extension-hard-break@^3.20.0 \
+  @tiptap/extension-history@^3.20.0 \
+  @tiptap/extension-mention@^3.20.0 \
+  @tiptap/extension-paragraph@^3.20.0 \
+  @tiptap/extension-placeholder@^3.20.0 \
+  @tiptap/extension-text@^3.20.0 \
+  @tiptap/react@^3.20.0
 ```
 
 ---
@@ -224,7 +233,7 @@ import { RichTextEditor } from 'bsky-richtext-react'
 | `onMentionQuery` | `(query: string) => Promise<MentionSuggestion[]>` | **Bluesky public API** | Custom mention search. Overrides the built-in search. |
 | `mentionSearchDebounceMs` | `number` | `300` | Debounce delay (ms) for the built-in search. No effect when `onMentionQuery` is set. |
 | `disableDefaultMentionSearch` | `boolean` | `false` | Disable the built-in Bluesky API search entirely |
-| `renderMentionSuggestion` | `SuggestionOptions['render']` | tippy.js popup | Custom TipTap suggestion renderer factory |
+| `renderMentionSuggestion` | `SuggestionOptions['render']` | @floating-ui/dom popup | Custom TipTap suggestion renderer factory |
 | `mentionSuggestionOptions` | `DefaultSuggestionRendererOptions` | — | Options forwarded to the default renderer |
 | `editorRef` | `Ref<RichTextEditorRef>` | — | Imperative ref |
 | `editable` | `boolean` | `true` | Toggle read-only mode |
@@ -281,7 +290,7 @@ The editor searches Bluesky actors **by default** when the user types `@`:
 
 ### `<MentionSuggestionList>`
 
-The default suggestion dropdown rendered inside the tippy.js popup. Exported so you can reuse or reference it in your own popup implementation.
+The default suggestion dropdown rendered inside the @floating-ui/dom popup. Exported so you can reuse or reference it in your own popup implementation.
 
 ```tsx
 import { MentionSuggestionList } from 'bsky-richtext-react'
@@ -507,6 +516,24 @@ bun run format
 
 ---
 
+## Migration
+
+### v2.0.0 — tiptap v3 upgrade
+
+**v2.0.0 upgrades tiptap from v2 to v3.** If you are upgrading from v1.x, you must:
+
+1. Update all `@tiptap/*` peer dependencies to `^3.20.0`.
+2. Replace `tippy.js` with `@floating-ui/dom`.
+
+```diff
+- bun add @tiptap/core@^2 @tiptap/react@^2 tippy.js
++ bun add @tiptap/core@^3.20.0 @tiptap/react@^3.20.0 @floating-ui/dom
+```
+
+See [CHANGELOG.md](./CHANGELOG.md) for the full list of changes.
+
+---
+
 ## Changelog
 
 See [CHANGELOG.md](./CHANGELOG.md).

package/dist/index.cjs

@@ -11,15 +11,11 @@ var extensionHardBreak = require('@tiptap/extension-hard-break');
 var extensionPlaceholder = require('@tiptap/extension-placeholder');
 var api = require('@atproto/api');
 var extensionMention = require('@tiptap/extension-mention');
-var tippy = require('tippy.js');
+var dom = require('@floating-ui/dom');
 var core = require('@tiptap/core');
 var state = require('@tiptap/pm/state');
 var view = require('@tiptap/pm/view');
 
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var tippy__default = /*#__PURE__*/_interopDefault(tippy);
-
 // src/components/RichTextDisplay/RichTextDisplay.tsx
 
 // src/types/facets.ts
@@ -455,12 +451,6 @@ function createDefaultSuggestionRenderer(options = {}) {
   return () => {
     let renderer;
     let popup;
-    const destroy = () => {
-      popup?.[0]?.destroy();
-      renderer?.destroy();
-      renderer = void 0;
-      popup = void 0;
-    };
     const buildProps = (props) => ({
       ...props,
       showAvatars: options.showAvatars ?? true,
@@ -475,33 +465,49 @@ function createDefaultSuggestionRenderer(options = {}) {
         });
         if (!props.clientRect) return;
         const clientRect = props.clientRect;
-        popup = tippy__default.default("body", {
-          getReferenceClientRect: () => clientRect?.() ?? new DOMRect(),
-          appendTo: () => document.body,
-          content: renderer.element,
-          showOnCreate: true,
-          interactive: true,
-          trigger: "manual",
-          placement: "bottom-start"
+        popup = document.createElement("div");
+        popup.style.position = "fixed";
+        popup.style.zIndex = "9999";
+        popup.appendChild(renderer.element);
+        document.body.appendChild(popup);
+        const virtualEl = { getBoundingClientRect: () => clientRect?.() ?? new DOMRect() };
+        void dom.computePosition(virtualEl, popup, {
+          placement: "bottom-start",
+          middleware: [dom.offset(8), dom.flip(), dom.shift({ padding: 8 })]
+        }).then(({ x, y }) => {
+          if (popup) {
+            popup.style.left = `${x}px`;
+            popup.style.top = `${y}px`;
+          }
         });
       },
       onUpdate(props) {
         renderer?.updateProps(buildProps(props));
-        if (!props.clientRect) return;
+        if (!props.clientRect || !popup) return;
         const clientRect = props.clientRect;
-        popup?.[0]?.setProps({
-          getReferenceClientRect: () => clientRect?.() ?? new DOMRect()
+        const virtualEl = { getBoundingClientRect: () => clientRect?.() ?? new DOMRect() };
+        void dom.computePosition(virtualEl, popup, {
+          placement: "bottom-start",
+          middleware: [dom.offset(8), dom.flip(), dom.shift({ padding: 8 })]
+        }).then(({ x, y }) => {
+          if (popup) {
+            popup.style.left = `${x}px`;
+            popup.style.top = `${y}px`;
+          }
         });
       },
       onKeyDown(props) {
         if (props.event.key === "Escape") {
-          popup?.[0]?.hide();
+          if (popup) popup.style.display = "none";
           return true;
         }
         return renderer?.ref?.onKeyDown(props) ?? false;
       },
       onExit() {
-        destroy();
+        popup?.remove();
+        renderer?.destroy();
+        popup = void 0;
+        renderer = void 0;
       }
     };
   };