Move 3D code to separate @opentui/three package

.github/workflows/build-core.yml

@@ -99,6 +99,11 @@ jobs:
           cd packages/core
           bun run build:lib
 
+      - name: Build 3D package
+        run: |
+          cd packages/three
+          bun run build --ci
+
       - name: Run TypeScript tests
         run: |
           cd packages/core

.github/workflows/build-examples.yml

@@ -101,25 +101,25 @@ jobs:
           # Check for platform-specific packages in .bun cache (where bun install --os="*" --cpu="*" puts them)
           echo ""
           echo "Checking for platform-specific bun-webgpu packages in cache..."
-          if [ -d node_modules/.bun/bun-webgpu-darwin-arm64@0.1.4 ]; then
+          if [ -d node_modules/.bun/bun-webgpu-darwin-arm64@0.1.5 ]; then
             echo "✅ bun-webgpu-darwin-arm64 found in cache"
           else
             echo "⚠️  bun-webgpu-darwin-arm64 not found (will be installed during build)"
           fi
 
-          if [ -d node_modules/.bun/bun-webgpu-darwin-x64@0.1.4 ]; then
+          if [ -d node_modules/.bun/bun-webgpu-darwin-x64@0.1.5 ]; then
             echo "✅ bun-webgpu-darwin-x64 found in cache"
           else
             echo "⚠️  bun-webgpu-darwin-x64 not found (will be installed during build)"
           fi
 
-          if [ -d node_modules/.bun/bun-webgpu-linux-x64@0.1.4 ]; then
+          if [ -d node_modules/.bun/bun-webgpu-linux-x64@0.1.5 ]; then
             echo "✅ bun-webgpu-linux-x64 found in cache"
           else
             echo "⚠️  bun-webgpu-linux-x64 not found (will be installed during build)"
           fi
 
-          if [ -d node_modules/.bun/bun-webgpu-win32-x64@0.1.4 ]; then
+          if [ -d node_modules/.bun/bun-webgpu-win32-x64@0.1.5 ]; then
             echo "✅ bun-webgpu-win32-x64 found in cache"
           else
             echo "⚠️  bun-webgpu-win32-x64 not found (will be installed during build)"

.github/workflows/build-native.yml

@@ -43,6 +43,8 @@ jobs:
           cd packages/core
           bun run build:native --all
           bun run build:lib
+          cd ../three
+          bun run build
           cd ../react
           bun run build
           cd ../solid
@@ -155,6 +157,13 @@ jobs:
 
           # Copy other package dists (optional - don't fail if missing)
           echo "Packaging other packages..."
+          if [ -d packages/three/dist ]; then
+            cp -r packages/three/dist artifacts/npm-packages/three-dist
+            echo "✅ Three dist packaged"
+          else
+            echo "⚠️  Three dist not found (skipping)"
+          fi
+
           if [ -d packages/react/dist ]; then
             cp -r packages/react/dist artifacts/npm-packages/react-dist
             echo "✅ React dist packaged"

.github/workflows/npm-latest-release.yml

@@ -62,6 +62,11 @@ jobs:
           fi
 
           # Copy other package dists
+          if [ -d "npm-packages/three-dist" ]; then
+            cp -r npm-packages/three-dist packages/three/dist
+            echo "Copied three dist"
+          fi
+
           if [ -d "npm-packages/react-dist" ]; then
             cp -r npm-packages/react-dist packages/react/dist
             echo "Copied react dist"
@@ -91,6 +96,10 @@ jobs:
           echo "📦 Checking @opentui/core..."
           cd packages/core/dist && npm pack --dry-run
 
+          echo ""
+          echo "📦 Checking @opentui/three..."
+          cd ../../three/dist && npm pack --dry-run
+
           echo ""
           echo "📦 Checking @opentui/react..."
           cd ../../react/dist && npm pack --dry-run

.github/workflows/npm-release.yml

@@ -57,6 +57,7 @@ jobs:
           cd packages/core
           bun run build:native --all
           bun run build:lib
+          cd ../three && bun run build
           cd ../solid && bun run build
           cd ../react && bun run build
 

.github/workflows/pkg-pr-new.yml

@@ -50,6 +50,10 @@ jobs:
         run: bun run build --ci
         working-directory: packages/react
 
+      - name: Build three
+        run: bun run build --ci
+        working-directory: packages/three
+
       - name: Build solid
         run: bun run build --ci
         working-directory: packages/solid
@@ -59,5 +63,6 @@ jobs:
           npx pkg-pr-new publish --no-template --commentWithSha --bun \
             './packages/core/dist' \
             ${{ steps.native-packages.outputs.dirs }} \
+            './packages/three/dist' \
             './packages/react/dist' \
             './packages/solid/dist'

package.json

@@ -5,9 +5,10 @@
     "packages/*"
   ],
   "scripts": {
-    "build": "cd packages/core && bun run build && cd ../solid && bun run build && cd ../react && bun run build",
+    "build": "cd packages/core && bun run build && cd ../three && bun run build && cd ../solid && bun run build && cd ../react && bun run build",
     "pre-publish": "bun scripts/pre-publish.ts",
-    "publish": "bun run pre-publish && bun run publish:core && bun run publish:react && bun run publish:solid",
+    "publish": "bun run pre-publish && bun run publish:core && bun run publish:three && bun run publish:react && bun run publish:solid",
+    "publish:three": "cd packages/three && bun run publish",
     "publish:core": "cd packages/core && bun run publish",
     "publish:react": "cd packages/react && bun run publish",
     "publish:solid": "cd packages/solid && bun run publish",

packages/core/package.json

@@ -28,9 +28,9 @@
   },
   "license": "MIT",
   "devDependencies": {
+    "@opentui/three": "workspace:^",
     "@types/bun": "latest",
     "@types/node": "^24.0.0",
-    "@types/three": "0.177.0",
     "commander": "^13.1.0",
     "typescript": "^5",
     "web-tree-sitter": "0.25.10"
@@ -46,10 +46,6 @@
     "web-tree-sitter": "0.25.10"
   },
   "optionalDependencies": {
-    "@dimforge/rapier2d-simd-compat": "^0.17.3",
-    "bun-webgpu": "0.1.5",
-    "planck": "^1.4.2",
-    "three": "0.177.0",
     "@opentui/core-darwin-x64": "0.1.88",
     "@opentui/core-darwin-arm64": "0.1.88",
     "@opentui/core-linux-x64": "0.1.88",
@@ -62,10 +58,6 @@
       "types": "./src/index.ts",
       "import": "./src/index.ts"
     },
-    "./3d": {
-      "types": "./src/3d.ts",
-      "import": "./src/3d.ts"
-    },
     "./testing": {
       "types": "./src/testing.ts",
       "import": "./src/testing.ts"

packages/core/scripts/build.ts

@@ -195,7 +195,6 @@ if (buildLib) {
 
   const entryPoints: string[] = [
     packageJson.module,
-    "src/3d.ts",
     "src/testing.ts",
     "src/runtime-plugin.ts",
     "src/runtime-plugin-support.ts",
@@ -256,7 +255,6 @@ if (buildLib) {
   console.log("Post-processing bundled files to fix duplicate exports...")
   const bundledFiles = [
     "dist/index.js",
-    "dist/3d.js",
     "dist/testing.js",
     "dist/runtime-plugin.js",
     "dist/runtime-plugin-support.js",
@@ -331,11 +329,6 @@ if (buildLib) {
       require: "./index.js",
       types: "./index.d.ts",
     },
-    "./3d": {
-      import: "./3d.js",
-      require: "./3d.js",
-      types: "./3d.d.ts",
-    },
     "./testing": {
       import: "./testing.js",
       require: "./testing.js",
@@ -362,6 +355,15 @@ if (buildLib) {
     variants.map(({ platform, arch }) => [`${packageJson.name}-${platform}-${arch}`, packageJson.version]),
   )
 
+  const processedDevDependencies = Object.fromEntries(
+    Object.entries(packageJson.devDependencies ?? {}).map(([name, version]) => {
+      if (version === "workspace:*" || version === "workspace:^") {
+        return [name, packageJson.version]
+      }
+      return [name, version]
+    }),
+  )
+
   writeFileSync(
     join(distDir, "package.json"),
     JSON.stringify(
@@ -381,7 +383,7 @@ if (buildLib) {
         bugs: packageJson.bugs,
         exports,
         dependencies: packageJson.dependencies,
-        devDependencies: packageJson.devDependencies,
+        devDependencies: processedDevDependencies,
         peerDependencies: packageJson.peerDependencies,
         optionalDependencies: {
           ...packageJson.optionalDependencies,

packages/core/src/examples/draggable-three-demo.ts

@@ -21,7 +21,7 @@ import {
   MeshPhongMaterial,
   Vector3,
 } from "three"
-import { ThreeRenderable } from "../3d.js"
+import { ThreeRenderable } from "@opentui/three"
 
 let nextZIndex = 200
 let keyListener: ((key: KeyEvent) => void) | null = null

packages/core/src/examples/fractal-shader-demo.ts

@@ -21,7 +21,7 @@ import {
   Fn,
   int,
 } from "three/tsl"
-import { ThreeCliRenderer } from "../3d.js"
+import { ThreeCliRenderer } from "@opentui/three"
 
 let engine: ThreeCliRenderer | null = null
 let sceneRoot: ThreeScene | null = null

packages/core/src/examples/golden-star-demo.ts

@@ -24,7 +24,7 @@ import {
   Quaternion,
   ConeGeometry,
 } from "three"
-import { ThreeCliRenderer } from "../3d.js"
+import { ThreeCliRenderer } from "@opentui/three"
 import { setupCommonDemoKeys } from "./lib/standalone-keys.js"
 
 interface StarParticle {

packages/core/src/examples/lights-phong-demo.ts

@@ -10,7 +10,7 @@ import {
   type KeyEvent,
 } from "../index.js"
 import { setupCommonDemoKeys } from "./lib/standalone-keys.js"
-import { TextureUtils } from "../3d/TextureUtils.js"
+import { TextureUtils, ThreeCliRenderer } from "@opentui/three"
 import {
   Scene as ThreeScene,
   Mesh as ThreeMesh,
@@ -29,7 +29,6 @@ import { TeapotGeometry } from "three/addons/geometries/TeapotGeometry.js"
 import normalTexPath from "./assets/Water_2_M_Normal.jpg" with { type: "image/jpeg" }
 // @ts-ignore
 import alphaTexPath from "./assets/roughness_map.jpg" with { type: "image/jpeg" }
-import { ThreeCliRenderer } from "../3d.js"
 
 interface PhongDemoState {
   camera: PerspectiveCamera

packages/core/src/examples/physx-planck-2d-demo.ts

@@ -10,17 +10,16 @@ import {
 } from "../index.js"
 import { setupCommonDemoKeys } from "./lib/standalone-keys.js"
 import * as THREE from "three"
+import { SpriteAnimator, TiledSprite, type SpriteDefinition, type AnimationDefinition } from "@opentui/three"
 import {
-  SpriteAnimator,
-  TiledSprite,
-  type SpriteDefinition,
-  type AnimationDefinition,
-} from "../3d/animation/SpriteAnimator.js"
-import { SpriteResourceManager, type ResourceConfig } from "../3d/SpriteResourceManager.js"
-import { PhysicsExplosionManager, type PhysicsExplosionHandle } from "../3d/animation/PhysicsExplodingSpriteEffect.js"
-import { PlanckPhysicsWorld } from "../3d/physics/PlanckPhysicsAdapter.js"
+  SpriteResourceManager,
+  type ResourceConfig,
+  PhysicsExplosionManager,
+  type PhysicsExplosionHandle,
+  PlanckPhysicsWorld,
+  ThreeCliRenderer,
+} from "@opentui/three"
 import * as planck from "planck"
-import { ThreeCliRenderer } from "../3d.js"
 
 // @ts-ignore
 import cratePath from "./assets/crate.png" with { type: "image/png" }