Fix segmentation fault when loading @tailwindcss/oxide in a Worker thread (#17276)

When Tailwind is loaded in a Node Worker thread, it currently causes a
segmentation fault on Linux when the thread exits. This is due to a
longstanding issue in Rust that affects all native modules:
rust-lang/rust#91979. I reported this years
ago but unfortunately it is still not fixed, and seems to have gotten
worse in Rust 1.83.0 and later. Looks like Tailwind recently updated
Rust versions and this issue started appearing when run in tools like
Parcel that use worker threads.

The workaround is to prevent the native module from ever being unloaded.
One way to do that is to always load the native module in the main
thread in addition to workers, but this is hard to enforce.
@Brooooooklyn found another method, which is to use a linker option for
this. I tested this on an Ubuntu system and verified it fixed the issue.
You can test with the following script.

```js
// test.js
const {Worker} = require('worker_threads');
new Worker('./worker.js');

// worker.js
require('@tailwindcss/oxide');
```

Without this change, a segmentation fault will occur.

---------

Co-authored-by: Jordan Pittman <[email protected]>

Author: 2 people

.github/workflows/integration-tests.yml

@@ -30,6 +30,7 @@ jobs:
           - vite
           - cli
           - postcss
+          - workers
 
         # Exclude windows and macos from being built on feature branches
         on-main-branch:

CHANGELOG.md

@@ -27,6 +27,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Use the `oklab(…)` function when applying opacity to `currentColor` to work around a crash in Safari 16.4 and 16.5 ([#17247](https://github.com/tailwindlabs/tailwindcss/pull/17247))
 - Pre-process `<template lang="…">` in Vue files ([#17252](https://github.com/tailwindlabs/tailwindcss/pull/17252))
 - Remove redundant `line-height: initial` from Preflight ([#15212](https://github.com/tailwindlabs/tailwindcss/pull/15212))
+- Prevent segfault when loaded in a worker thread on Linux ([#17276](https://github.com/tailwindlabs/tailwindcss/pull/17276))
+- Increase Standalone hardware compatibility on macOS x64 builds ([#17267](https://github.com/tailwindlabs/tailwindcss/pull/17267))
 
 ## [4.0.14] - 2025-03-13
 

crates/node/.cargo/config.toml

@@ -10,3 +10,5 @@ linker = "arm-linux-gnueabihf-gcc"
 rustflags = ["-C", "target-feature=+crt-static"]
 [target.aarch64-pc-windows-msvc]
 rustflags = ["-C", "target-feature=+crt-static"]
+[target.'cfg(target_env = "gnu")']
+rustflags = ["-C", "link-args=-Wl,-z,nodelete"]

integrations/workers/index.test.ts

@@ -0,0 +1,32 @@
+import { js, json, test } from '../utils'
+
+test(
+  '@tailwindcss/oxide can be loaded into a Node.js worker thread',
+  {
+    fs: {
+      'package.json': json`
+        {
+          "dependencies": {
+            "@tailwindcss/oxide": "workspace:^"
+          }
+        }
+      `,
+      'start.js': js`
+        let { Worker } = require('worker_threads')
+        new Worker('./worker.js')
+      `,
+      'worker.js': js`
+        require('@tailwindcss/oxide')
+        process.on('exit', () => console.log('worker thread exited'))
+      `,
+    },
+  },
+  async ({ exec, expect }) => {
+    let output = await exec('node ./start.js').then(
+      (out) => out.trim(),
+      (err) => `${err}`,
+    )
+
+    expect(output).toEqual('worker thread exited')
+  },
+)

packages/@tailwindcss-standalone/scripts/build.ts

@@ -12,8 +12,8 @@ async function buildForPlatform(triple: string, outfile: string) {
     try {
       let cmd = $`bun build --compile --target=${triple} ./src/index.ts --outfile=${outfile} --env inline`
 
-      // This env var is used by our patched versions of Lightning CSS and Parcel Watcher
-      // to statically bundle the proper binaries for musl vs glibc
+      // This env var is used by our patched versions of Lightning CSS and Parcel Watcher to
+      // statically bundle the proper binaries for musl vs glibc
       cmd = cmd.env({
         PLATFORM_LIBC: triple.includes('-musl') ? 'musl' : 'glibc',
       })
@@ -51,21 +51,18 @@ async function build(triple: string, file: string) {
 
 await mkdir(path.resolve(__dirname, '../dist'), { recursive: true })
 
-// Build platform binaries and checksum them
+// Build platform binaries and checksum them. We use baseline builds for all x64 platforms to ensure
+// compatibility with older hardware.
 let results = await Promise.all([
   build('bun-linux-arm64', './tailwindcss-linux-arm64'),
   build('bun-linux-arm64-musl', './tailwindcss-linux-arm64-musl'),
 
-  // All Linux x64 builds use `bun-baseline` due to various instruction-related
-  // errors on some older Server hardware.
   build('bun-linux-x64-baseline', './tailwindcss-linux-x64'),
   build('bun-linux-x64-musl-baseline', './tailwindcss-linux-x64-musl'),
 
   build('bun-darwin-arm64', './tailwindcss-macos-arm64'),
-  build('bun-darwin-x64', './tailwindcss-macos-x64'),
+  build('bun-darwin-x64-baseline', './tailwindcss-macos-x64'),
 
-  // The Windows x64 build uses `bun-baseline` instead of the regular bun build.
-  // This enables support for running inside the ARM emulation mode.
   build('bun-windows-x64-baseline', './tailwindcss-windows-x64.exe'),
 ])
 

turbo.json

@@ -10,6 +10,7 @@
         "./build.rs",
         "./package.json",
         "./Cargo.toml",
+        "./.cargo/config.toml",
         "../oxide/src/**/*",
         "../oxide/Cargo.toml",
         "../Cargo.toml",
@@ -24,6 +25,7 @@
         "./build.rs",
         "./package.json",
         "./Cargo.toml",
+        "./.cargo/config.toml",
         "../oxide/src/**/*",
         "../oxide/Cargo.toml",
         "../Cargo.toml",