chore: wip

Author: chrisbbreuer

packages/launchpad/package.json

@@ -2,6 +2,7 @@
   "name": "@stacksjs/launchpad",
   "type": "module",
   "version": "0.6.4",
+  "packageManager": "bun",
   "description": "Like Homebrew, but faster.",
   "author": "Chris Breuer <[email protected]>",
   "license": "MIT",

packages/launchpad/src/dev/sniff.ts

@@ -614,31 +614,21 @@ export default async function sniff(dir: SimplePath | { string: string }): Promi
     // Collect all dependencies from different sources
     const allDependencies: Record<string, string> = {}
 
-    // Process engines
-    if (json?.engines) {
-      if (json.engines.node)
-        allDependencies['nodejs.org'] = json.engines.node
-      if (json.engines.npm)
-        allDependencies['npmjs.com'] = json.engines.npm
-      if (json.engines.yarn)
-        allDependencies['yarnpkg.com'] = json.engines.yarn
-      if (json.engines.pnpm) {
-        allDependencies['pnpm.io'] = json.engines.pnpm
-        detected_pnpm_usage = true
-      }
-    }
-
-    // Process packageManager (corepack)
+    // First check packageManager to determine if we should skip Node.js-specific processing
+    let isUsingBun = false
     if (json?.packageManager) {
-      const match = json.packageManager.match(
+      // Support both "pkg@version" and "pkg" formats
+      const matchWithVersion = json.packageManager.match(
         /^(?<pkg>[^@]+)@(?<version>[^+]+)/,
       )
+      const matchWithoutVersion = json.packageManager.match(
+        /^(?<pkg>[^@]+)$/,
+      )
 
+      const match = matchWithVersion || matchWithoutVersion
       if (match) {
-        const { pkg, version } = match.groups as {
-          pkg: string
-          version: string
-        }
+        const { pkg } = match.groups as { pkg: string }
+        const version = matchWithVersion?.groups?.version || '*' // Default to latest
 
         switch (pkg) {
           case 'npm':
@@ -651,19 +641,37 @@ export default async function sniff(dir: SimplePath | { string: string }): Promi
             detected_pnpm_usage = true
             allDependencies['pnpm.io'] = version
             break
+          case 'bun':
+            allDependencies['bun.sh'] = version
+            isUsingBun = true
+            break
         }
       }
     }
 
-    // Process volta
+    // Process engines (but skip Node.js ecosystem if packageManager is bun)
+    if (json?.engines) {
+      if (json.engines.node && !isUsingBun)
+        allDependencies['nodejs.org'] = json.engines.node
+      if (json.engines.npm && !isUsingBun)
+        allDependencies['npmjs.com'] = json.engines.npm
+      if (json.engines.yarn && !isUsingBun)
+        allDependencies['yarnpkg.com'] = json.engines.yarn
+      if (json.engines.pnpm && !isUsingBun) {
+        allDependencies['pnpm.io'] = json.engines.pnpm
+        detected_pnpm_usage = true
+      }
+    }
+
+    // Process volta (but skip Node.js ecosystem if packageManager is bun)
     if (json?.volta) {
-      if (json.volta.node)
+      if (json.volta.node && !isUsingBun)
         allDependencies['nodejs.org'] = json.volta.node
-      if (json.volta.npm)
+      if (json.volta.npm && !isUsingBun)
         allDependencies['npmjs.com'] = json.volta.npm
-      if (json.volta.yarn)
+      if (json.volta.yarn && !isUsingBun)
         allDependencies['yarnpkg.com'] = json.volta.yarn
-      if (json.volta.pnpm) {
+      if (json.volta.pnpm && !isUsingBun) {
         allDependencies['pnpm.io'] = json.volta.pnpm
         detected_pnpm_usage = true
       }

packages/launchpad/src/install-helpers.ts

@@ -390,6 +390,26 @@ exec "${binaryPath}" "$@"
             }
             fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2))
 
+            // Create node_modules directory structure
+            const nodeModulesDir = path.join(globalDir, 'node_modules')
+            fs.mkdirSync(nodeModulesDir, { recursive: true })
+
+            // Create empty bun.lock file to make Bun recognize this as a valid package
+            const lockFilePath = path.join(globalDir, 'bun.lock')
+            if (!fs.existsSync(lockFilePath)) {
+              try {
+                fs.writeFileSync(lockFilePath, '')
+                if (config.verbose) {
+                  console.warn(`Created empty bun.lock file in global directory`)
+                }
+              }
+              catch (error) {
+                if (config.verbose) {
+                  console.warn(`Failed to create bun.lock file: ${error instanceof Error ? error.message : String(error)}`)
+                }
+              }
+            }
+
             // Create bin directory in the official Bun directory
             const officialBinDir = path.join(officialBunDir, 'bin')
             fs.mkdirSync(officialBinDir, { recursive: true })
@@ -410,6 +430,28 @@ exec "${binaryPath}" "$@"
             fs.symlinkSync(binaryPath, officialBunBinPath)
             fs.symlinkSync(officialBunBinPath, officialBunxBinPath)
 
+            // Create a node symlink to bun to handle packages that expect node
+            // Only create if no node binary/shim already exists (avoids conflict with actual Node.js)
+            const nodeShimPath = path.join(targetShimDir, 'node')
+            if (!fs.existsSync(nodeShimPath)) {
+              try {
+                fs.symlinkSync('bun', nodeShimPath)
+                if (config.verbose) {
+                  console.warn(`Created node symlink: node -> bun (to handle packages that expect node)`)
+                }
+                installedBinaries.push('node')
+              }
+              catch (error) {
+                if (config.verbose) {
+                  console.warn(`Failed to create node symlink: ${error instanceof Error ? error.message : String(error)}`)
+                }
+                // Don't fail the installation if node symlink creation fails
+              }
+            }
+            else if (config.verbose) {
+              console.warn(`Skipped creating node symlink: node binary/shim already exists`)
+            }
+
             // Create a custom shim for Bun with BUN_INSTALL environment variable
             const customShimContent = `#!/bin/sh
 # Launchpad shim for ${binary} (${domain} v${version})

packages/launchpad/test-envs/README.md

@@ -73,6 +73,28 @@ This directory contains comprehensive test environments for Launchpad's global/l
 - **Expected**: All packages install locally (default behavior)
 - **Use Case**: Traditional project-isolated installation
 
+### Bun Package Manager Tests
+
+#### `bun-package-manager-basic/` 🆕
+- **Pattern**: `packageManager: "bun"` (no version)
+- **Expected**: Bun latest installed, NO Node.js, proper environment setup
+- **Use Case**: Basic Bun project without version constraints
+
+#### `bun-package-manager-versioned/` 🆕
+- **Pattern**: `packageManager: "[email protected]"` (specific version)
+- **Expected**: Exact Bun version, TypeScript/ESLint support, NO Node.js
+- **Use Case**: Project requiring specific Bun version for stability
+
+#### `bun-package-manager-with-deps/` 🆕
+- **Pattern**: `packageManager: "bun@latest"` + additional tools from dependencies.yaml
+- **Expected**: Bun + additional tools, complex npm packages working, NO Node.js
+- **Use Case**: Full-stack project using Bun with additional development tools
+
+#### `bun-vs-node-engines/` 🆕
+- **Pattern**: `packageManager: "bun"` + conflicting `engines.node` + `volta.node`
+- **Expected**: Bun prioritized over Node.js engines/volta, node symlink for compatibility
+- **Use Case**: Testing package manager priority over other Node.js configurations
+
 ### Existing Test Environments
 
 #### `complex-deps/`
@@ -133,6 +155,9 @@ launchpad env:list
 | `no-global-flag` | None | None | All local (default) |
 | `team-standard` | None | Mixed | Mixed per individual flags |
 | `fullstack-mixed` | None | Mixed | Runtimes global, tools local |
+| `bun-package-manager-basic` | N/A | `packageManager: "bun"` | Only Bun, NO Node.js |
+| `bun-package-manager-versioned` | N/A | `packageManager: "[email protected]"` | Bun v1.2.20, NO Node.js |
+| `bun-vs-node-engines` | N/A | Bun vs engines conflict | Bun wins, NO Node.js |
 
 ## Key Test Cases Covered
 
@@ -145,5 +170,12 @@ launchpad env:list
 ✅ Complex real-world scenarios (team, fullstack, dev machine)
 ✅ String array format with top-level global
 ✅ Object format with version and global flags
-
-These test environments comprehensively validate Launchpad's global/local installation functionality across all supported configuration patterns.
+🆕 **Bun Package Manager Support**:
+✅ `packageManager: "bun"` without version (defaults to latest)
+✅ `packageManager: "bun@version"` with specific version
+✅ Bun prioritized over Node.js engines/volta configurations
+✅ Node.js compatibility via symlink creation
+✅ Complex npm packages working with Bun runtime
+✅ ESLint/Prettier/Next.js compatibility testing
+
+These test environments comprehensively validate Launchpad's global/local installation functionality and Bun package manager support across all supported configuration patterns.

packages/launchpad/test-envs/bun-package-manager-basic/README.md

@@ -0,0 +1,39 @@
+# Bun Package Manager Basic Test Environment
+
+This test environment verifies that Launchpad correctly handles `packageManager: "bun"` without a version specification.
+
+## Expected Behavior
+
+When running `launchpad install` in this directory:
+
+1. **Should install Bun** (latest version)
+2. **Should NOT install Node.js** (since Bun is the package manager)
+3. **Should create proper Bun environment** with:
+   - `bunx` symlink to `bun`
+   - `node` symlink to `bun` (for package compatibility)
+   - `.bun/install/global/` directory structure
+   - `BUN_INSTALL` environment variable in shim
+
+## Key Features Tested
+
+- ✅ Package manager detection without version
+- ✅ Node.js exclusion when Bun is package manager
+- ✅ Bun environment setup
+- ✅ Compatibility shims creation
+
+## Test Commands
+
+```bash
+# Install packages
+launchpad install --verbose
+
+# Verify Bun is installed and working
+bunx --version
+bun --version
+
+# Verify Node.js compatibility
+node --version  # Should actually call Bun
+
+# Test package management
+bunx eslint --version  # Should work without "env: node" error
+```