Wrong module path in `package.json` file.

[navtoj]

Details

• xterm.js version: 6.0.0

The node_modules/@xterm/headless/package.json file has "module": "lib/xterm.mjs", but that path does not exist.

$ tree node_modules/@xterm/headless
node_modules/@xterm/headless
├── lib-headless
│   ├── xterm-headless.js
│   ├── xterm-headless.js.map
│   ├── xterm-headless.mjs
│   └── xterm-headless.mjs.map
├── package.json
├── README.md
└── typings
    └── xterm-headless.d.ts

3 directories, 7 files

The issue is temporarily resolved if the module line is changed to the correct path.

  "main": "lib-headless/xterm-headless.js",
- "module": "lib/xterm.mjs",
+ "module": "lib-headless/xterm-headless.mjs",
  "types": "typings/xterm-headless.d.ts",

Steps to reproduce

1. Create App Boilerplate

   bun create --no-install --no-git tauri-app --manager bun --template svelte-ts --identifier com.domain.example --tauri-version 2 --yes Example

2. Install @xterm/headless Package

   cd Example && bun add @xterm/headless

3. Update +page.svelte File

   <script lang="ts">
   + import { Terminal } from '@xterm/headless';

4. Start Example App

   bun tauri app

Terminal Output

bun tauri dev
$ tauri dev
     Running BeforeDevCommand (`bun run dev`)
$ vite dev

  VITE v6.4.2  ready in 440 ms

  ➜  Local:   http://localhost:1420/
     Running DevCommand (`cargo  run --no-default-features --color always --`)
        Info Watching /Users/navtoj/Developer/Example/src-tauri for changes...
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.40s
     Running `target/debug/example`
2:15:54 PM [vite] (client) Pre-transform error: Failed to resolve entry for package "@xterm/headless". The package may have incorrect main/module/exports specified in its package.json.
  Plugin: vite:import-analysis
  File: /Users/navtoj/Developer/Example/src/routes/+page.svelte:2:27
  4  |  
  5  |  import * as $ from 'svelte/internal/client';
  6  |  import { Terminal } from '@xterm/headless';
     |                            ^
  7  |  import { invoke } from "@tauri-apps/api/core";
  8  |  
2:15:54 PM [vite] Internal server error: Failed to resolve entry for package "@xterm/headless". The package may have incorrect main/module/exports specified in its package.json.
  Plugin: vite:import-analysis
  File: /Users/navtoj/Developer/Example/src/routes/+page.svelte:2:27
  4  |  
  5  |  import * as $ from 'svelte/internal/client';
  6  |  import { Terminal } from '@xterm/headless';
     |                            ^
  7  |  import { invoke } from "@tauri-apps/api/core";
  8  |  
      at packageEntryFailure (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:16198:19)
      at resolvePackageEntry (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:16195:3)
      at tryNodeResolve (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:16060:18)
      at resolveId (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:15831:19)
      at processTicksAndRejections (native:7:39)
2:15:54 PM [vite] Internal server error: Failed to resolve entry for package "@xterm/headless". The package may have incorrect main/module/exports specified in its package.json.
  Plugin: vite:import-analysis
  File: /Users/navtoj/Developer/Example/src/routes/+page.svelte:2:27
  4  |  
  5  |  import * as $ from 'svelte/internal/client';
  6  |  import { Terminal } from '@xterm/headless';
     |                            ^
  7  |  import { invoke } from "@tauri-apps/api/core";
  8  |  
      at packageEntryFailure (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:16198:19)
      at resolvePackageEntry (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:16195:3)
      at tryNodeResolve (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:16060:18)
      at resolveId (/Users/navtoj/Developer/Example/node_modules/vite/dist/node/chunks/dep-Dq2t6Dq0.js:15831:19)
      at processTicksAndRejections (native:7:39)

[navtoj]

Temporary Fix

Add this code snippet to the vite.config.js file.

export default defineConfig(async () => ({
+	resolve: {
+		alias: {
+			'@xterm/headless': '@xterm/headless/lib-headless/xterm-headless.mjs',
+		},
+	},
}));