[ERROR] Could not resolve "@tiptap/y-tiptap"

[higgsaxhh]

Description

A fresh install returns the following runtime error on startup.

20:24:11 [ERROR] [UnhandledRejection] Astro detected an unhandled rejection. Here's the stack trace:
Error: Error during dependency optimization:

✘ [ERROR] Could not resolve "@tiptap/extension-collaboration"

Complete log at the bottom of this issue.

Steps to reproduce

npm create emdash@latest

Run through the setup with the following options:

  — E M D A S H —

┌  Create a new EmDash project
│
◇  Project name?
│  emdash
│
◇  Where will you deploy?
│  Node.js
│
◇  Which template?
│  Starter
│
◇  Which package manager?
│  yarn
│
◇  Install dependencies?
│  Yes
│
◇  Project created!
│
◇  Dependencies installed!
│
◇  Next steps ─╮
│              │
│  cd emdash   │
│  yarn dev    │
│              │
├──────────────╯
│
└  Done! Your EmDash project is ready at emdash

In the emdash project, run yarn dev

Environment

node version: v24.14.0
emdash version: latest
runtime: nodejs
os: Windows 11

Logs / error output

PS c:\users\hipster\code\emdash> yarn run dev
yarn run v1.22.22
$ astro dev
20:44:10 [@astrojs/node] Enabling sessions with filesystem storage


  — E M D A S H —


  › Admin UI    /_emdash/admin
  › API         /_emdash/api/*

[vite] connected.
20:44:11 [types] Generated 4ms
20:44:12 [WARN] [content] Content config not loaded
 astro  v6.1.9 ready in 3829 ms
┃ Local    http://localhost:4321/
┃ Network  use --host to expose
20:44:13 watching for file changes...
✘ [ERROR] Could not resolve "@tiptap/extension-collaboration"

    node_modules/@tiptap/extension-drag-handle/dist/index.js:7:31:
      7 │ import { isChangeOrigin } from "@tiptap/extension-collaboration";
        ╵                                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  You can mark the path "@tiptap/extension-collaboration" as external to exclude it from the bundle,
  which will remove this error and leave the unresolved path in the bundle.

✘ [ERROR] Could not resolve "@tiptap/y-tiptap"

    node_modules/@tiptap/extension-drag-handle/dist/index.js:13:7:
      13 │ } from "@tiptap/y-tiptap";
         ╵        ~~~~~~~~~~~~~~~~~~

  You can mark the path "@tiptap/y-tiptap" as external to exclude it from the bundle, which will
  remove this error and leave the unresolved path in the bundle.

20:44:14 [ERROR] [UnhandledRejection] Astro detected an unhandled rejection. Here's the stack trace:
Error: Error during dependency optimization:

✘ [ERROR] Could not resolve "@tiptap/extension-collaboration"

    node_modules/@tiptap/extension-drag-handle/dist/index.js:7:31:
      7 │ import { isChangeOrigin } from "@tiptap/extension-collaboration";
        ╵                                ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

  You can mark the path "@tiptap/extension-collaboration" as external to exclude it from the bundle, which will remove this error and leave the unresolved path in the bundle.


✘ [ERROR] Could not resolve "@tiptap/y-tiptap"

    node_modules/@tiptap/extension-drag-handle/dist/index.js:13:7:
      13 │ } from "@tiptap/y-tiptap";
         ╵        ~~~~~~~~~~~~~~~~~~

  You can mark the path "@tiptap/y-tiptap" as external to exclude it from the bundle, which will remove this error and leave the unresolved path in the bundle.


    at failureErrorWithLog (C:\Users\WOODNL\Code\research\emdash\node_modules\esbuild\lib\main.js:1748:15)
    at C:\Users\WOODNL\Code\research\emdash\node_modules\esbuild\lib\main.js:1207:25
    at C:\Users\WOODNL\Code\research\emdash\node_modules\esbuild\lib\main.js:1626:9
    at process.processTicksAndRejections (node:internal/process/task_queues:104:5)
  Hint:
    Make sure your promises all have an `await` or a `.catch()` handler.
  Error reference:
    https://docs.astro.build/en/reference/errors/unhandled-rejection/
  Stack trace:
    at C:\Users\WOODNL\Code\research\emdash\    node_modules\@tiptap\extension-drag-handle\dist\index.js::7:31
    [...] See full stack trace in the browser, or rerun with --verbose.
Auto-seeded default collections
20:44:16 [200] POST /_emdash/api/typegen 2519ms

[higgsaxhh]

This was resolved by adding the following dependencies:

@tiptap/extension-collaboration @tiptap/y-tiptap yjs y-protocols

[mvanhorn]

Implemented in #780 — appends @tiptap/extension-collaboration and @tiptap/y-tiptap to optimizeDeps.exclude in both branches of packages/core/src/astro/integration/vite-config.ts. Both packages are transitive-only and not imported anywhere; excluding them lets esbuild's dep scanner skip the failed resolve.