chore(release): v0.4.0

Reviewed-on: #4

.gitignore

@@ -22,4 +22,6 @@ node_modules/
 
 .env
 !tests/.env
+!tests/**/.env
 !examples/.env
+!examples/**/.env

.gitleaksignore

@@ -0,0 +1,3 @@
+tests/binary_test/.env:environment-file:1
+tests/script_test/.env:environment-file:1
+tests/binary_test/env_parent/.env:environment-file:1

BUILD.bazel

@@ -1 +1,9 @@
 package(default_visibility = ["//visibility:public"])
+
+filegroup(
+    name = "repo_runtime_files",
+    srcs = [
+        "BUILD.bazel",
+        "MODULE.bazel",
+    ],
+)

MODULE.bazel

@@ -1,6 +1,6 @@
 module(
     name = "rules_bun",
-    version = "0.2.2",
+    version = "0.4.0",
 )
 
 # Core ruleset dependencies.
@@ -37,6 +37,13 @@ bun_install_ext.install(
 )
 use_repo(bun_install_ext, "script_test_vite_monorepo_node_modules")
 
+bun_install_ext.install(
+    name = "script_test_paraglide_monorepo_node_modules",
+    bun_lockfile = "//tests/script_test:paraglide_monorepo/bun.lock",
+    package_json = "//tests/script_test:paraglide_monorepo/package.json",
+)
+use_repo(bun_install_ext, "script_test_paraglide_monorepo_node_modules")
+
 bun_install_ext.install(
     name = "examples_vite_monorepo_node_modules",
     bun_lockfile = "//examples/vite_monorepo:bun.lock",

MODULE.bazel.lock

@@ -192,8 +192,8 @@
   "moduleExtensions": {
     "//bun:extensions.bzl%bun": {
       "general": {
-        "bzlTransitiveDigest": "64B4fTkEHdAlieIOkE/Wi2M/R9lMNZhFxeI1eXEFHRs=",
+        "bzlTransitiveDigest": "lzOUyaXDbkH922ruNkkwEF2cnI4m0XpzrOti0qypwtA=",
-        "usagesDigest": "/0BcCMA6AOzLhQaRK6DquxrCfpPHJUjSUaFz4zmQrsM=",
+        "usagesDigest": "3e3c2oTwajnFd8qnwby/r5XJjkCbXcs0Y4hgl0tOBes=",
         "recordedInputs": [
           "REPO_MAPPING:,bazel_tools bazel_tools"
         ],
@@ -218,6 +218,26 @@
               "build_file_content": "\nexports_files([\"bun-linux-aarch64/bun\"])\n\nfilegroup(\n    name = \"bun\",\n    srcs = [\"bun-linux-aarch64/bun\"],\n    visibility = [\"//visibility:public\"],\n)\n"
             }
           },
+          "bun_linux_x64_musl": {
+            "repoRuleId": "@@bazel_tools//tools/build_defs/repo:http.bzl%http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-x64-musl.zip"
+              ],
+              "sha256": "48a6c32277d343db0148ce066336472ffd380358a4d26bb1329714742492d824",
+              "build_file_content": "\nexports_files([\"bun-linux-x64-musl/bun\"])\n\nfilegroup(\n    name = \"bun\",\n    srcs = [\"bun-linux-x64-musl/bun\"],\n    visibility = [\"//visibility:public\"],\n)\n"
+            }
+          },
+          "bun_linux_aarch64_musl": {
+            "repoRuleId": "@@bazel_tools//tools/build_defs/repo:http.bzl%http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-linux-aarch64-musl.zip"
+              ],
+              "sha256": "d2c81365a2e529b78a42330d3a0056e8dbd7896b4a6782c8e392b6532141e34d",
+              "build_file_content": "\nexports_files([\"bun-linux-aarch64-musl/bun\"])\n\nfilegroup(\n    name = \"bun\",\n    srcs = [\"bun-linux-aarch64-musl/bun\"],\n    visibility = [\"//visibility:public\"],\n)\n"
+            }
+          },
           "bun_darwin_x64": {
             "repoRuleId": "@@bazel_tools//tools/build_defs/repo:http.bzl%http_archive",
             "attributes": {
@@ -247,14 +267,24 @@
               "sha256": "7a77b3e245e2e26965c93089a4a1332e8a326d3364c89fae1d1fd99cdd3cd73d",
               "build_file_content": "\nexports_files([\"bun-windows-x64/bun.exe\"])\n\nfilegroup(\n    name = \"bun\",\n    srcs = [\"bun-windows-x64/bun.exe\"],\n    visibility = [\"//visibility:public\"],\n)\n"
             }
+          },
+          "bun_windows_aarch64": {
+            "repoRuleId": "@@bazel_tools//tools/build_defs/repo:http.bzl%http_archive",
+            "attributes": {
+              "urls": [
+                "https://github.com/oven-sh/bun/releases/download/bun-v1.3.10/bun-windows-aarch64.zip"
+              ],
+              "sha256": "6822f3aa7bd2be40fb94c194a1185aae1c6fade54ca4fc2efdc722e37f3257d2",
+              "build_file_content": "\nexports_files([\"bun-windows-aarch64/bun.exe\"])\n\nfilegroup(\n    name = \"bun\",\n    srcs = [\"bun-windows-aarch64/bun.exe\"],\n    visibility = [\"//visibility:public\"],\n)\n"
+            }
           }
         }
       }
     },
     "//bun:extensions.bzl%bun_install": {
       "general": {
-        "bzlTransitiveDigest": "64B4fTkEHdAlieIOkE/Wi2M/R9lMNZhFxeI1eXEFHRs=",
+        "bzlTransitiveDigest": "lzOUyaXDbkH922ruNkkwEF2cnI4m0XpzrOti0qypwtA=",
-        "usagesDigest": "d+DGTyl4FpB6Ygb/R/V5knxm9bGYZKO223wMX1Q6R6w=",
+        "usagesDigest": "Rpb8CFAx+vMvmPf6ZPeHR/gweyP8QXMGdOfSou7lKNg=",
         "recordedInputs": [
           "REPO_MAPPING:,bazel_tools bazel_tools"
         ],
@@ -265,7 +295,14 @@
               "package_json": "@@//tests/script_test:vite_app/package.json",
               "bun_lockfile": "@@//tests/script_test:vite_app/bun.lock",
               "install_inputs": [],
-              "isolated_home": true
+              "isolated_home": true,
+              "production": false,
+              "omit": [],
+              "linker": "",
+              "backend": "",
+              "ignore_scripts": false,
+              "install_flags": [],
+              "visible_repo_name": "script_test_vite_node_modules"
             }
           },
           "script_test_vite_monorepo_node_modules": {
@@ -274,7 +311,30 @@
               "package_json": "@@//tests/script_test:vite_monorepo/package.json",
               "bun_lockfile": "@@//tests/script_test:vite_monorepo/bun.lock",
               "install_inputs": [],
-              "isolated_home": true
+              "isolated_home": true,
+              "production": false,
+              "omit": [],
+              "linker": "",
+              "backend": "",
+              "ignore_scripts": false,
+              "install_flags": [],
+              "visible_repo_name": "script_test_vite_monorepo_node_modules"
+            }
+          },
+          "script_test_paraglide_monorepo_node_modules": {
+            "repoRuleId": "@@//internal:bun_install.bzl%bun_install_repository",
+            "attributes": {
+              "package_json": "@@//tests/script_test:paraglide_monorepo/package.json",
+              "bun_lockfile": "@@//tests/script_test:paraglide_monorepo/bun.lock",
+              "install_inputs": [],
+              "isolated_home": true,
+              "production": false,
+              "omit": [],
+              "linker": "",
+              "backend": "",
+              "ignore_scripts": false,
+              "install_flags": [],
+              "visible_repo_name": "script_test_paraglide_monorepo_node_modules"
             }
           },
           "examples_vite_monorepo_node_modules": {
@@ -283,7 +343,14 @@
               "package_json": "@@//examples/vite_monorepo:package.json",
               "bun_lockfile": "@@//examples/vite_monorepo:bun.lock",
               "install_inputs": [],
-              "isolated_home": true
+              "isolated_home": true,
+              "production": false,
+              "omit": [],
+              "linker": "",
+              "backend": "",
+              "ignore_scripts": false,
+              "install_flags": [],
+              "visible_repo_name": "examples_vite_monorepo_node_modules"
             }
           }
         }

README.md

@@ -1,7 +1,7 @@
 # Bun rules for [Bazel](https://bazel.build)
 
-`rules_bun` provides Bazel rules for running, testing, bundling, and developing
+`rules_bun` provides Bazel rules for running, testing, building, compiling,
-JavaScript and TypeScript code with Bun.
+bundling, and developing JavaScript and TypeScript code with Bun.
 
 ## Repository layout
 
@@ -29,10 +29,15 @@ The public entrypoint for rule authors and users is `@rules_bun//bun:defs.bzl`.
 `rules_bun` exports these primary rules:
 
 - `bun_binary`
+- `bun_build`
+- `bun_compile`
 - `bun_bundle`
 - `bun_dev`
 - `bun_script`
 - `bun_test`
+- `js_binary`
+- `js_test`
+- `js_run_devserver`
 - `js_library`
 - `ts_library`
 
@@ -55,7 +60,7 @@ Release announcements should provide a copy-pasteable module snippet in the
 standard ruleset form:
 
 ```starlark
-bazel_dep(name = "rules_bun", version = "0.2.2")
+bazel_dep(name = "rules_bun", version = "0.4.0")
 ```
 
 Then add the Bun repositories and register the toolchains in `MODULE.bazel`:
@@ -67,9 +72,12 @@ use_repo(
     bun_ext,
     "bun_linux_x64",
     "bun_linux_aarch64",
+    "bun_linux_x64_musl",
+    "bun_linux_aarch64_musl",
     "bun_darwin_x64",
     "bun_darwin_aarch64",
     "bun_windows_x64",
+    "bun_windows_aarch64",
 )
 
 register_toolchains(
@@ -105,6 +113,36 @@ bun_install_ext.install(
 use_repo(bun_install_ext, "bun_deps")
 ```
 
+## `rules_js` compatibility layer
+
+`rules_bun` now exposes a Bun-backed compatibility layer for the most common
+`rules_js` entrypoints:
+
+- `@rules_bun//js:defs.bzl` exports `js_binary`, `js_test`, `js_run_devserver`,
+  `js_library`, `ts_library`, and `JsInfo`.
+- `@rules_bun//npm:extensions.bzl` exports `npm_translate_lock`, which creates a
+  Bun-installed external repo and generates `@<repo>//:defs.bzl` with
+  `npm_link_all_packages()`.
+
+Example:
+
+```starlark
+load("@rules_bun//js:defs.bzl", "js_binary")
+load("@npm//:defs.bzl", "npm_link_all_packages")
+
+npm_link_all_packages()
+
+js_binary(
+    name = "app",
+    entry_point = "src/main.ts",
+    node_modules = ":node_modules",
+)
+```
+
+This is a compatibility subset, not a full reimplementation of `rules_js`.
+Package aliases created by `npm_link_all_packages()` use sanitized target names
+such as `npm__vite` or `npm__at_types_node`.
+
 ## Legacy WORKSPACE usage
 
 For non-Bzlmod consumers, the repository exposes a legacy setup macro in
@@ -122,6 +160,8 @@ bun_register_toolchains()
 load(
     "@rules_bun//bun:defs.bzl",
     "bun_binary",
+    "bun_build",
+    "bun_compile",
     "bun_bundle",
     "bun_dev",
     "bun_script",
@@ -161,6 +201,32 @@ When `node_modules` is provided, executables from `node_modules/.bin` are added
 to `PATH`. This label typically comes from `bun_install`, which still produces a
 standard `node_modules/` directory.
 
+### `bun_build` and `bun_compile`
+
+Use `bun_build` for general-purpose `bun build` output directories and
+`bun_compile` for standalone executables built with `bun build --compile`.
+
+```starlark
+load("@rules_bun//bun:defs.bzl", "bun_build", "bun_compile")
+
+bun_build(
+    name = "site",
+    entry_points = ["src/index.html"],
+    data = glob(["src/**"]),
+    splitting = True,
+    metafile = True,
+)
+
+bun_compile(
+    name = "cli",
+    entry_point = "src/cli.ts",
+)
+```
+
+`bun_build` exposes a directory output so Bun can emit HTML, CSS, assets, and
+split chunks. `bun_compile` produces a single executable artifact and supports
+explicit cross-compilation via `compile_executable`.
+
 ### `bun_dev` for local development
 
 Use `bun_dev` for long-running watch or hot-reload development targets.

VERSION

@@ -1,3 +1,3 @@
-0.2.2
+0.4.0
 stable
 0

bun/BUILD.bazel

@@ -10,6 +10,19 @@ exports_files([
     "version.bzl",
 ])
 
+filegroup(
+    name = "repo_runtime_files",
+    srcs = [
+        "BUILD.bazel",
+        "defs.bzl",
+        "extensions.bzl",
+        "repositories.bzl",
+        "toolchain.bzl",
+        "version.bzl",
+    ],
+    visibility = ["//visibility:public"],
+)
+
 bzl_library(
     name = "toolchain_bzl",
     srcs = ["toolchain.bzl"],
@@ -35,11 +48,14 @@ bzl_library(
     visibility = ["//visibility:public"],
     deps = [
         ":toolchain_bzl",
+        "//internal:bun_build_support_bzl",
         "//internal:bun_binary_bzl",
+        "//internal:bun_compile_bzl",
         "//internal:bun_bundle_bzl",
         "//internal:bun_dev_bzl",
         "//internal:bun_script_bzl",
         "//internal:bun_test_bzl",
+        "//internal:js_compat_bzl",
         "//internal:js_library_bzl",
     ],
 )

bun/defs.bzl

@@ -1,21 +1,29 @@
 """Public API surface for Bun Bazel rules."""
+load("//internal:bun_compile.bzl", _bun_build = "bun_build", _bun_compile = "bun_compile")
 load("//internal:bun_binary.bzl", _bun_binary = "bun_binary")
 load("//internal:bun_bundle.bzl", _bun_bundle = "bun_bundle")
 load("//internal:bun_dev.bzl", _bun_dev = "bun_dev")
 load("//internal:bun_script.bzl", _bun_script = "bun_script")
 load("//internal:bun_test.bzl", _bun_test = "bun_test")
+load("//internal:js_compat.bzl", _JsInfo = "JsInfo", _js_binary = "js_binary", _js_run_devserver = "js_run_devserver", _js_test = "js_test")
 load("//internal:js_library.bzl", _js_library = "js_library", _ts_library = "ts_library")
 load(":toolchain.bzl", _BunToolchainInfo = "BunToolchainInfo", _bun_toolchain = "bun_toolchain")
 
 visibility("public")
 
 bun_binary = _bun_binary
+bun_build = _bun_build
+bun_compile = _bun_compile
 bun_bundle = _bun_bundle
 bun_dev = _bun_dev
 bun_script = _bun_script
 bun_test = _bun_test
+js_binary = _js_binary
+js_test = _js_test
+js_run_devserver = _js_run_devserver
 js_library = _js_library
 ts_library = _ts_library
+JsInfo = _JsInfo
 BunToolchainInfo = _BunToolchainInfo
 bun_toolchain = _bun_toolchain
  

bun/extensions.bzl

@@ -13,6 +13,16 @@ _BUN_ARCHIVES = {
         "asset": "bun-linux-aarch64.zip",
         "binary": "bun-linux-aarch64/bun",
     },
+    "bun_linux_x64_musl": {
+        "sha256": "48a6c32277d343db0148ce066336472ffd380358a4d26bb1329714742492d824",
+        "asset": "bun-linux-x64-musl.zip",
+        "binary": "bun-linux-x64-musl/bun",
+    },
+    "bun_linux_aarch64_musl": {
+        "sha256": "d2c81365a2e529b78a42330d3a0056e8dbd7896b4a6782c8e392b6532141e34d",
+        "asset": "bun-linux-aarch64-musl.zip",
+        "binary": "bun-linux-aarch64-musl/bun",
+    },
     "bun_darwin_x64": {
         "sha256": "c1d90bf6140f20e572c473065dc6b37a4b036349b5e9e4133779cc642ad94323",
         "asset": "bun-darwin-x64.zip",
@@ -28,6 +38,11 @@ _BUN_ARCHIVES = {
         "asset": "bun-windows-x64.zip",
         "binary": "bun-windows-x64/bun.exe",
     },
+    "bun_windows_aarch64": {
+        "sha256": "6822f3aa7bd2be40fb94c194a1185aae1c6fade54ca4fc2efdc722e37f3257d2",
+        "asset": "bun-windows-aarch64.zip",
+        "binary": "bun-windows-aarch64/bun.exe",
+    },
 }
 
 _BUN_GITHUB_RELEASE_URL_TEMPLATE = "https://github.com/oven-sh/bun/releases/download/bun-v{}/{}"
@@ -62,6 +77,12 @@ _install = tag_class(
         "bun_lockfile": attr.label(mandatory = True),
         "install_inputs": attr.label_list(allow_files = True),
         "isolated_home": attr.bool(default = True),
+        "production": attr.bool(default = False),
+        "omit": attr.string_list(),
+        "linker": attr.string(),
+        "backend": attr.string(),
+        "ignore_scripts": attr.bool(default = False),
+        "install_flags": attr.string_list(),
     },
 )
 
@@ -75,6 +96,13 @@ def _bun_install_impl(ctx):
                 bun_lockfile = install.bun_lockfile,
                 install_inputs = install.install_inputs,
                 isolated_home = install.isolated_home,
+                production = install.production,
+                omit = install.omit,
+                linker = install.linker,
+                backend = install.backend,
+                ignore_scripts = install.ignore_scripts,
+                install_flags = install.install_flags,
+                visible_repo_name = install.name,
             )
 
 

bun/repositories.bzl

@@ -12,6 +12,16 @@ _BUN_ARCHIVES = {
         "asset": "bun-linux-aarch64.zip",
         "binary": "bun-linux-aarch64/bun",
     },
+    "bun_linux_x64_musl": {
+        "sha256": "48a6c32277d343db0148ce066336472ffd380358a4d26bb1329714742492d824",
+        "asset": "bun-linux-x64-musl.zip",
+        "binary": "bun-linux-x64-musl/bun",
+    },
+    "bun_linux_aarch64_musl": {
+        "sha256": "d2c81365a2e529b78a42330d3a0056e8dbd7896b4a6782c8e392b6532141e34d",
+        "asset": "bun-linux-aarch64-musl.zip",
+        "binary": "bun-linux-aarch64-musl/bun",
+    },
     "bun_darwin_x64": {
         "sha256": "c1d90bf6140f20e572c473065dc6b37a4b036349b5e9e4133779cc642ad94323",
         "asset": "bun-darwin-x64.zip",
@@ -27,6 +37,11 @@ _BUN_ARCHIVES = {
         "asset": "bun-windows-x64.zip",
         "binary": "bun-windows-x64/bun.exe",
     },
+    "bun_windows_aarch64": {
+        "sha256": "6822f3aa7bd2be40fb94c194a1185aae1c6fade54ca4fc2efdc722e37f3257d2",
+        "asset": "bun-windows-aarch64.zip",
+        "binary": "bun-windows-aarch64/bun.exe",
+    },
 }
 
 _BUN_GITHUB_RELEASE_URL_TEMPLATE = "https://github.com/oven-sh/bun/releases/download/bun-v{}/{}"

docs/BUILD.bazel

@@ -8,13 +8,17 @@ stardoc(
     input = "//bun:defs.bzl",
     symbol_names = [
         "bun_binary",
+        "bun_build",
+        "bun_compile",
         "bun_bundle",
         "bun_dev",
         "bun_script",
         "bun_test",
+        "js_binary",
+        "js_run_devserver",
+        "js_test",
         "js_library",
         "ts_library",
     ],
     deps = ["//bun:defs_bzl"],
-    target_compatible_with = ["@platforms//os:linux"],
 )

docs/bun_install.md

@@ -14,6 +14,7 @@ Unlike the build rules in [rules.md](rules.md), `bun_install` is not loaded from
 - runs `bun install --frozen-lockfile`
 - uses your checked-in `package.json` and `bun.lock` or `bun.lockb`
 - creates an external Bazel repository exposing `:node_modules`
+- generates `:defs.bzl` with `npm_link_all_packages()` and `package_target_name()`
 - keeps dependency installation under Bun rather than npm
 
 The generated repository can then be passed to rules such as `bun_script`,
@@ -28,6 +29,8 @@ bun_install_ext.install(
     name = "bun_deps",
     package_json = "//:package.json",
     bun_lockfile = "//:bun.lock",
+    production = True,
+    omit = ["peer"],
 )
 
 use_repo(bun_install_ext, "bun_deps")
@@ -112,6 +115,45 @@ repository root.
 - `False`: lets Bun use the host `HOME`, which can improve repeated-install
   performance when Bun's cache is home-scoped
 
+### `production`
+
+Optional boolean controlling whether Bun installs only production dependencies.
+
+Example:
+
+```starlark
+production = True
+```
+
+### `omit`
+
+Optional list of dependency groups to omit, forwarded as repeated
+`--omit` flags. Common values are `dev`, `optional`, and `peer`.
+
+### `linker`
+
+Optional Bun linker strategy, forwarded as `--linker`.
+
+Common values:
+
+- `isolated`
+- `hoisted`
+
+### `backend`
+
+Optional Bun install backend, forwarded as `--backend`.
+
+Examples include `hardlink`, `symlink`, and `copyfile`.
+
+### `ignore_scripts`
+
+Optional boolean controlling whether Bun skips lifecycle scripts in the project
+manifest.
+
+### `install_flags`
+
+Optional list of additional raw flags forwarded to `bun install`.
+
 ## Notes
 
 - `bun_install` runs Bun, not npm.

docs/index.md

@@ -36,9 +36,12 @@ use_repo(
 	bun_ext,
 	"bun_linux_x64",
 	"bun_linux_aarch64",
+	"bun_linux_x64_musl",
+	"bun_linux_aarch64_musl",
 	"bun_darwin_x64",
 	"bun_darwin_aarch64",
 	"bun_windows_x64",
+	"bun_windows_aarch64",
 )
 
 register_toolchains(
@@ -79,6 +82,12 @@ bun_script(
 `bun_script` runs from the package directory by default and adds
 `node_modules/.bin` to `PATH`.
 
+## Build and compile
+
+Use `bun_build` when Bun may emit a directory of outputs such as HTML, CSS,
+chunks, and static assets. Use `bun_compile` for standalone executables created
+with `bun build --compile`.
+
 ## Regeneration
 
 The rule reference is generated from the public Starlark symbols in

docs/rules.md

@@ -1,88 +1,484 @@
-# rules_bun rule reference
+<!-- Generated with Stardoc: http://skydoc.bazel.build -->
 
-This file documents the public rules exported from `@rules_bun//bun:defs.bzl`.
+Public API surface for Bun Bazel rules.
+
+<a id="bun_binary"></a>
 
 ## bun_binary
 
-Runs a JS/TS entry point with Bun as an executable target (`bazel run`).
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_binary")
 
-Attributes:
+bun_binary(<a href="#bun_binary-name">name</a>, <a href="#bun_binary-deps">deps</a>, <a href="#bun_binary-data">data</a>, <a href="#bun_binary-conditions">conditions</a>, <a href="#bun_binary-entry_point">entry_point</a>, <a href="#bun_binary-env_files">env_files</a>, <a href="#bun_binary-install_mode">install_mode</a>, <a href="#bun_binary-no_env_file">no_env_file</a>,
+           <a href="#bun_binary-node_modules">node_modules</a>, <a href="#bun_binary-preload">preload</a>, <a href="#bun_binary-run_flags">run_flags</a>, <a href="#bun_binary-smol">smol</a>, <a href="#bun_binary-working_dir">working_dir</a>)
+</pre>
 
-- `entry_point` (label, required): path to the main JS/TS file to execute.
+Runs a JS/TS entry point with Bun as an executable target.
-- `node_modules` (label, optional): package files from a `node_modules` tree, typically produced by `bun_install`, made available in runfiles.
-- `data` (label_list, optional): additional runtime files.
-- `working_dir` (string, default: `"workspace"`, values: `"workspace" | "entry_point"`): runtime working directory.
 
-## bun_dev
+Use this rule for non-test scripts and CLIs that should run via `bazel run`.
 
-Runs a JS/TS entry point in Bun development watch mode (`bazel run`).
+**ATTRIBUTES**
 
-Attributes:
 
-- `entry_point` (label, required): path to the main JS/TS file.
+| Name  | Description | Type | Mandatory | Default |
-- `watch_mode` (string, default: `"watch"`, values: `"watch" | "hot"`): Bun live-reload mode.
+| :------------- | :------------- | :------------- | :------------- | :------------- |
-- `restart_on` (label_list, optional): files that trigger full process restart when changed.
+| <a id="bun_binary-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
-- `node_modules` (label, optional): package files from a `node_modules` tree, typically produced by `bun_install`, made available in runfiles.
+| <a id="bun_binary-deps"></a>deps |  Library dependencies required by the program.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
-- `data` (label_list, optional): additional runtime files for dev process.
+| <a id="bun_binary-data"></a>data |  Additional runtime files required by the program.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
-- `working_dir` (string, default: `"workspace"`, values: `"workspace" | "entry_point"`): runtime working directory.
+| <a id="bun_binary-conditions"></a>conditions |  Custom package resolve conditions passed to Bun.   | List of strings | optional |  `[]`  |
+| <a id="bun_binary-entry_point"></a>entry_point |  Path to the main JS/TS file to execute.   | <a href="https://bazel.build/concepts/labels">Label</a> | required |  |
+| <a id="bun_binary-env_files"></a>env_files |  Additional environment files loaded with `--env-file`.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_binary-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages at runtime.   | String | optional |  `"disable"`  |
+| <a id="bun_binary-no_env_file"></a>no_env_file |  If true, disables Bun's automatic `.env` loading.   | Boolean | optional |  `False`  |
+| <a id="bun_binary-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, in runfiles.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_binary-preload"></a>preload |  Modules to preload with `--preload` before running the entry point.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_binary-run_flags"></a>run_flags |  Additional raw flags forwarded to `bun run` before the entry point.   | List of strings | optional |  `[]`  |
+| <a id="bun_binary-smol"></a>smol |  If true, enables Bun's lower-memory runtime mode.   | Boolean | optional |  `False`  |
+| <a id="bun_binary-working_dir"></a>working_dir |  Working directory at runtime: `workspace` root or nearest `entry_point` ancestor containing `.env`/`package.json`.   | String | optional |  `"workspace"`  |
 
-## bun_script
 
-Runs a named `package.json` script with Bun as an executable target (`bazel run`).
+<a id="bun_build"></a>
 
-Recommended for package-script based tools such as Vite (`dev`, `build`, `preview`).
+## bun_build
-When `node_modules` is provided, executables from `node_modules/.bin` are added
-to `PATH`, so scripts like `vite` work without wrapper scripts.
 
-Attributes:
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_build")
 
-- `script` (string, required): package script name passed to `bun run <script>`.
+bun_build(<a href="#bun_build-name">name</a>, <a href="#bun_build-deps">deps</a>, <a href="#bun_build-data">data</a>, <a href="#bun_build-asset_naming">asset_naming</a>, <a href="#bun_build-banner">banner</a>, <a href="#bun_build-build_flags">build_flags</a>, <a href="#bun_build-chunk_naming">chunk_naming</a>, <a href="#bun_build-conditions">conditions</a>,
-- `package_json` (label, required): `package.json` file containing the named script.
+          <a href="#bun_build-css_chunking">css_chunking</a>, <a href="#bun_build-define">define</a>, <a href="#bun_build-drop">drop</a>, <a href="#bun_build-emit_dce_annotations">emit_dce_annotations</a>, <a href="#bun_build-entry_naming">entry_naming</a>, <a href="#bun_build-entry_points">entry_points</a>, <a href="#bun_build-env">env</a>, <a href="#bun_build-external">external</a>,
-- `node_modules` (label, optional): package files from a `node_modules` tree, typically produced by `bun_install`, made available in runfiles.
+          <a href="#bun_build-feature">feature</a>, <a href="#bun_build-footer">footer</a>, <a href="#bun_build-format">format</a>, <a href="#bun_build-install_mode">install_mode</a>, <a href="#bun_build-jsx_factory">jsx_factory</a>, <a href="#bun_build-jsx_fragment">jsx_fragment</a>, <a href="#bun_build-jsx_import_source">jsx_import_source</a>,
-- `data` (label_list, optional): additional runtime files for the script.
+          <a href="#bun_build-jsx_runtime">jsx_runtime</a>, <a href="#bun_build-jsx_side_effects">jsx_side_effects</a>, <a href="#bun_build-keep_names">keep_names</a>, <a href="#bun_build-loader">loader</a>, <a href="#bun_build-metafile">metafile</a>, <a href="#bun_build-metafile_md">metafile_md</a>, <a href="#bun_build-minify">minify</a>,
-- `working_dir` (string, default: `"package"`, values: `"workspace" | "package"`): runtime working directory. The default is a good fit for Vite and similar package-script based tools.
+          <a href="#bun_build-minify_identifiers">minify_identifiers</a>, <a href="#bun_build-minify_syntax">minify_syntax</a>, <a href="#bun_build-minify_whitespace">minify_whitespace</a>, <a href="#bun_build-no_bundle">no_bundle</a>, <a href="#bun_build-node_modules">node_modules</a>, <a href="#bun_build-packages">packages</a>,
+          <a href="#bun_build-production">production</a>, <a href="#bun_build-public_path">public_path</a>, <a href="#bun_build-react_fast_refresh">react_fast_refresh</a>, <a href="#bun_build-root">root</a>, <a href="#bun_build-sourcemap">sourcemap</a>, <a href="#bun_build-splitting">splitting</a>, <a href="#bun_build-target">target</a>)
+</pre>
+
+Builds one or more entry points with `bun build`.
+
+The rule emits a directory artifact so Bun can materialize multi-file output
+graphs such as HTML, CSS, assets, and split chunks. Optional metafile outputs
+may be requested with `metafile` and `metafile_md`.
+
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="bun_build-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="bun_build-deps"></a>deps |  Source/library dependencies that provide transitive inputs.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_build-data"></a>data |  Additional non-source files needed during building.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_build-asset_naming"></a>asset_naming |  Optional asset naming template.   | String | optional |  `""`  |
+| <a id="bun_build-banner"></a>banner |  Optional bundle banner text.   | String | optional |  `""`  |
+| <a id="bun_build-build_flags"></a>build_flags |  Additional raw flags forwarded to `bun build`.   | List of strings | optional |  `[]`  |
+| <a id="bun_build-chunk_naming"></a>chunk_naming |  Optional chunk naming template.   | String | optional |  `""`  |
+| <a id="bun_build-conditions"></a>conditions |  Custom resolve conditions passed to Bun.   | List of strings | optional |  `[]`  |
+| <a id="bun_build-css_chunking"></a>css_chunking |  If true, Bun chunks CSS across multiple entry points.   | Boolean | optional |  `False`  |
+| <a id="bun_build-define"></a>define |  Repeated `--define` values such as `process.env.NODE_ENV:"production"`.   | List of strings | optional |  `[]`  |
+| <a id="bun_build-drop"></a>drop |  Repeated `--drop` values, for example `console`.   | List of strings | optional |  `[]`  |
+| <a id="bun_build-emit_dce_annotations"></a>emit_dce_annotations |  If true, re-emits DCE annotations in the bundle.   | Boolean | optional |  `False`  |
+| <a id="bun_build-entry_naming"></a>entry_naming |  Optional entry naming template.   | String | optional |  `""`  |
+| <a id="bun_build-entry_points"></a>entry_points |  Entry files to build, including JS/TS or HTML entry points.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | required |  |
+| <a id="bun_build-env"></a>env |  Inline environment variable behavior passed to `--env`.   | String | optional |  `""`  |
+| <a id="bun_build-external"></a>external |  Modules treated as externals (not bundled).   | List of strings | optional |  `[]`  |
+| <a id="bun_build-feature"></a>feature |  Repeated `--feature` values for dead-code elimination.   | List of strings | optional |  `[]`  |
+| <a id="bun_build-footer"></a>footer |  Optional bundle footer text.   | String | optional |  `""`  |
+| <a id="bun_build-format"></a>format |  Output module format.   | String | optional |  `"esm"`  |
+| <a id="bun_build-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages while executing the build.   | String | optional |  `"disable"`  |
+| <a id="bun_build-jsx_factory"></a>jsx_factory |  Optional JSX factory override.   | String | optional |  `""`  |
+| <a id="bun_build-jsx_fragment"></a>jsx_fragment |  Optional JSX fragment override.   | String | optional |  `""`  |
+| <a id="bun_build-jsx_import_source"></a>jsx_import_source |  Optional JSX import source override.   | String | optional |  `""`  |
+| <a id="bun_build-jsx_runtime"></a>jsx_runtime |  Optional JSX runtime override.   | String | optional |  `""`  |
+| <a id="bun_build-jsx_side_effects"></a>jsx_side_effects |  If true, treats JSX as having side effects.   | Boolean | optional |  `False`  |
+| <a id="bun_build-keep_names"></a>keep_names |  If true, preserves function and class names when minifying.   | Boolean | optional |  `False`  |
+| <a id="bun_build-loader"></a>loader |  Repeated `--loader` values such as `.svg:file`.   | List of strings | optional |  `[]`  |
+| <a id="bun_build-metafile"></a>metafile |  If true, emits Bun's JSON metafile alongside the output directory.   | Boolean | optional |  `False`  |
+| <a id="bun_build-metafile_md"></a>metafile_md |  If true, emits Bun's markdown metafile alongside the output directory.   | Boolean | optional |  `False`  |
+| <a id="bun_build-minify"></a>minify |  If true, enables all Bun minification passes.   | Boolean | optional |  `False`  |
+| <a id="bun_build-minify_identifiers"></a>minify_identifiers |  If true, minifies identifiers only.   | Boolean | optional |  `False`  |
+| <a id="bun_build-minify_syntax"></a>minify_syntax |  If true, minifies syntax only.   | Boolean | optional |  `False`  |
+| <a id="bun_build-minify_whitespace"></a>minify_whitespace |  If true, minifies whitespace only.   | Boolean | optional |  `False`  |
+| <a id="bun_build-no_bundle"></a>no_bundle |  If true, transpiles without bundling.   | Boolean | optional |  `False`  |
+| <a id="bun_build-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, for package resolution.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_build-packages"></a>packages |  Whether packages stay bundled or are treated as external.   | String | optional |  `"bundle"`  |
+| <a id="bun_build-production"></a>production |  If true, sets `NODE_ENV=production` and enables Bun production mode.   | Boolean | optional |  `False`  |
+| <a id="bun_build-public_path"></a>public_path |  Optional public path prefix for emitted imports.   | String | optional |  `""`  |
+| <a id="bun_build-react_fast_refresh"></a>react_fast_refresh |  If true, enables Bun's React fast refresh transform.   | Boolean | optional |  `False`  |
+| <a id="bun_build-root"></a>root |  Optional root directory for multiple entry points.   | String | optional |  `""`  |
+| <a id="bun_build-sourcemap"></a>sourcemap |  Sourcemap emission mode.   | String | optional |  `"none"`  |
+| <a id="bun_build-splitting"></a>splitting |  If true, enables code splitting.   | Boolean | optional |  `False`  |
+| <a id="bun_build-target"></a>target |  Bun build target environment.   | String | optional |  `"browser"`  |
+
+
+<a id="bun_bundle"></a>
 
 ## bun_bundle
 
-Bundles one or more JS/TS entry points with Bun build.
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_bundle")
 
-Attributes:
+bun_bundle(<a href="#bun_bundle-name">name</a>, <a href="#bun_bundle-deps">deps</a>, <a href="#bun_bundle-data">data</a>, <a href="#bun_bundle-build_flags">build_flags</a>, <a href="#bun_bundle-entry_points">entry_points</a>, <a href="#bun_bundle-external">external</a>, <a href="#bun_bundle-format">format</a>, <a href="#bun_bundle-install_mode">install_mode</a>, <a href="#bun_bundle-minify">minify</a>,
+           <a href="#bun_bundle-node_modules">node_modules</a>, <a href="#bun_bundle-sourcemap">sourcemap</a>, <a href="#bun_bundle-target">target</a>)
+</pre>
 
-- `entry_points` (label_list, required): entry files to bundle.
+Bundles one or more JS/TS entry points using Bun build.
-- `node_modules` (label, optional): package files from a `node_modules` tree, typically produced by `bun_install`, used for package resolution.
+
-- `deps` (label_list, optional): source/library dependencies for transitive inputs.
+Each entry point produces one output JavaScript artifact.
-- `data` (label_list, optional): additional non-source files needed during bundling.
+
-- `target` (string, default: `"browser"`, values: `"browser" | "node" | "bun"`): Bun build target.
+**ATTRIBUTES**
-- `format` (string, default: `"esm"`, values: `"esm" | "cjs" | "iife"`): module format.
+
-- `minify` (bool, default: `False`): minifies bundle output.
+
-- `sourcemap` (bool, default: `False`): emits source maps.
+| Name  | Description | Type | Mandatory | Default |
-- `external` (string_list, optional): package names treated as external (not bundled).
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="bun_bundle-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="bun_bundle-deps"></a>deps |  Source/library dependencies that provide transitive inputs.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_bundle-data"></a>data |  Additional non-source files needed during bundling.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_bundle-build_flags"></a>build_flags |  Additional raw flags forwarded to `bun build`.   | List of strings | optional |  `[]`  |
+| <a id="bun_bundle-entry_points"></a>entry_points |  Entry files to bundle.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | required |  |
+| <a id="bun_bundle-external"></a>external |  Package names to treat as externals (not bundled).   | List of strings | optional |  `[]`  |
+| <a id="bun_bundle-format"></a>format |  Output module format.   | String | optional |  `"esm"`  |
+| <a id="bun_bundle-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages during bundling.   | String | optional |  `"disable"`  |
+| <a id="bun_bundle-minify"></a>minify |  If true, minifies bundle output.   | Boolean | optional |  `False`  |
+| <a id="bun_bundle-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, for package resolution.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_bundle-sourcemap"></a>sourcemap |  If true, emits source maps.   | Boolean | optional |  `False`  |
+| <a id="bun_bundle-target"></a>target |  Bun build target environment.   | String | optional |  `"browser"`  |
+
+
+<a id="bun_compile"></a>
+
+## bun_compile
+
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_compile")
+
+bun_compile(<a href="#bun_compile-name">name</a>, <a href="#bun_compile-deps">deps</a>, <a href="#bun_compile-data">data</a>, <a href="#bun_compile-asset_naming">asset_naming</a>, <a href="#bun_compile-banner">banner</a>, <a href="#bun_compile-build_flags">build_flags</a>, <a href="#bun_compile-bytecode">bytecode</a>, <a href="#bun_compile-chunk_naming">chunk_naming</a>,
+            <a href="#bun_compile-compile_autoload_bunfig">compile_autoload_bunfig</a>, <a href="#bun_compile-compile_autoload_dotenv">compile_autoload_dotenv</a>, <a href="#bun_compile-compile_autoload_package_json">compile_autoload_package_json</a>,
+            <a href="#bun_compile-compile_autoload_tsconfig">compile_autoload_tsconfig</a>, <a href="#bun_compile-compile_exec_argv">compile_exec_argv</a>, <a href="#bun_compile-compile_executable">compile_executable</a>, <a href="#bun_compile-conditions">conditions</a>,
+            <a href="#bun_compile-css_chunking">css_chunking</a>, <a href="#bun_compile-define">define</a>, <a href="#bun_compile-drop">drop</a>, <a href="#bun_compile-emit_dce_annotations">emit_dce_annotations</a>, <a href="#bun_compile-entry_naming">entry_naming</a>, <a href="#bun_compile-entry_point">entry_point</a>, <a href="#bun_compile-env">env</a>,
+            <a href="#bun_compile-external">external</a>, <a href="#bun_compile-feature">feature</a>, <a href="#bun_compile-footer">footer</a>, <a href="#bun_compile-format">format</a>, <a href="#bun_compile-install_mode">install_mode</a>, <a href="#bun_compile-jsx_factory">jsx_factory</a>, <a href="#bun_compile-jsx_fragment">jsx_fragment</a>,
+            <a href="#bun_compile-jsx_import_source">jsx_import_source</a>, <a href="#bun_compile-jsx_runtime">jsx_runtime</a>, <a href="#bun_compile-jsx_side_effects">jsx_side_effects</a>, <a href="#bun_compile-keep_names">keep_names</a>, <a href="#bun_compile-loader">loader</a>, <a href="#bun_compile-minify">minify</a>,
+            <a href="#bun_compile-minify_identifiers">minify_identifiers</a>, <a href="#bun_compile-minify_syntax">minify_syntax</a>, <a href="#bun_compile-minify_whitespace">minify_whitespace</a>, <a href="#bun_compile-no_bundle">no_bundle</a>, <a href="#bun_compile-node_modules">node_modules</a>, <a href="#bun_compile-packages">packages</a>,
+            <a href="#bun_compile-production">production</a>, <a href="#bun_compile-public_path">public_path</a>, <a href="#bun_compile-react_fast_refresh">react_fast_refresh</a>, <a href="#bun_compile-root">root</a>, <a href="#bun_compile-sourcemap">sourcemap</a>, <a href="#bun_compile-splitting">splitting</a>, <a href="#bun_compile-target">target</a>,
+            <a href="#bun_compile-windows_copyright">windows_copyright</a>, <a href="#bun_compile-windows_description">windows_description</a>, <a href="#bun_compile-windows_hide_console">windows_hide_console</a>, <a href="#bun_compile-windows_icon">windows_icon</a>,
+            <a href="#bun_compile-windows_publisher">windows_publisher</a>, <a href="#bun_compile-windows_title">windows_title</a>, <a href="#bun_compile-windows_version">windows_version</a>)
+</pre>
+
+Compiles a Bun program into a standalone executable with `bun build --compile`.
+
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="bun_compile-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="bun_compile-deps"></a>deps |  Source/library dependencies that provide transitive inputs.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_compile-data"></a>data |  Additional non-source files needed during building.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_compile-asset_naming"></a>asset_naming |  Optional asset naming template.   | String | optional |  `""`  |
+| <a id="bun_compile-banner"></a>banner |  Optional bundle banner text.   | String | optional |  `""`  |
+| <a id="bun_compile-build_flags"></a>build_flags |  Additional raw flags forwarded to `bun build`.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-bytecode"></a>bytecode |  If true, enables Bun bytecode caching in the compiled executable.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-chunk_naming"></a>chunk_naming |  Optional chunk naming template.   | String | optional |  `""`  |
+| <a id="bun_compile-compile_autoload_bunfig"></a>compile_autoload_bunfig |  Whether the compiled executable auto-loads `bunfig.toml` at runtime.   | Boolean | optional |  `True`  |
+| <a id="bun_compile-compile_autoload_dotenv"></a>compile_autoload_dotenv |  Whether the compiled executable auto-loads `.env` files at runtime.   | Boolean | optional |  `True`  |
+| <a id="bun_compile-compile_autoload_package_json"></a>compile_autoload_package_json |  Whether the compiled executable auto-loads `package.json` at runtime.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-compile_autoload_tsconfig"></a>compile_autoload_tsconfig |  Whether the compiled executable auto-loads `tsconfig.json` at runtime.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-compile_exec_argv"></a>compile_exec_argv |  Repeated `--compile-exec-argv` values prepended to the executable's `execArgv`.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-compile_executable"></a>compile_executable |  Optional Bun executable used for cross-compilation via `--compile-executable-path`.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_compile-conditions"></a>conditions |  Custom resolve conditions passed to Bun.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-css_chunking"></a>css_chunking |  If true, Bun chunks CSS across multiple entry points.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-define"></a>define |  Repeated `--define` values such as `process.env.NODE_ENV:"production"`.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-drop"></a>drop |  Repeated `--drop` values, for example `console`.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-emit_dce_annotations"></a>emit_dce_annotations |  If true, re-emits DCE annotations in the bundle.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-entry_naming"></a>entry_naming |  Optional entry naming template.   | String | optional |  `""`  |
+| <a id="bun_compile-entry_point"></a>entry_point |  Entry file to compile into an executable.   | <a href="https://bazel.build/concepts/labels">Label</a> | required |  |
+| <a id="bun_compile-env"></a>env |  Inline environment variable behavior passed to `--env`.   | String | optional |  `""`  |
+| <a id="bun_compile-external"></a>external |  Modules treated as externals (not bundled).   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-feature"></a>feature |  Repeated `--feature` values for dead-code elimination.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-footer"></a>footer |  Optional bundle footer text.   | String | optional |  `""`  |
+| <a id="bun_compile-format"></a>format |  Output module format.   | String | optional |  `"esm"`  |
+| <a id="bun_compile-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages while executing the build.   | String | optional |  `"disable"`  |
+| <a id="bun_compile-jsx_factory"></a>jsx_factory |  Optional JSX factory override.   | String | optional |  `""`  |
+| <a id="bun_compile-jsx_fragment"></a>jsx_fragment |  Optional JSX fragment override.   | String | optional |  `""`  |
+| <a id="bun_compile-jsx_import_source"></a>jsx_import_source |  Optional JSX import source override.   | String | optional |  `""`  |
+| <a id="bun_compile-jsx_runtime"></a>jsx_runtime |  Optional JSX runtime override.   | String | optional |  `""`  |
+| <a id="bun_compile-jsx_side_effects"></a>jsx_side_effects |  If true, treats JSX as having side effects.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-keep_names"></a>keep_names |  If true, preserves function and class names when minifying.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-loader"></a>loader |  Repeated `--loader` values such as `.svg:file`.   | List of strings | optional |  `[]`  |
+| <a id="bun_compile-minify"></a>minify |  If true, enables all Bun minification passes.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-minify_identifiers"></a>minify_identifiers |  If true, minifies identifiers only.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-minify_syntax"></a>minify_syntax |  If true, minifies syntax only.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-minify_whitespace"></a>minify_whitespace |  If true, minifies whitespace only.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-no_bundle"></a>no_bundle |  If true, transpiles without bundling.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, for package resolution.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_compile-packages"></a>packages |  Whether packages stay bundled or are treated as external.   | String | optional |  `"bundle"`  |
+| <a id="bun_compile-production"></a>production |  If true, sets `NODE_ENV=production` and enables Bun production mode.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-public_path"></a>public_path |  Optional public path prefix for emitted imports.   | String | optional |  `""`  |
+| <a id="bun_compile-react_fast_refresh"></a>react_fast_refresh |  If true, enables Bun's React fast refresh transform.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-root"></a>root |  Optional root directory for multiple entry points.   | String | optional |  `""`  |
+| <a id="bun_compile-sourcemap"></a>sourcemap |  Sourcemap emission mode.   | String | optional |  `"none"`  |
+| <a id="bun_compile-splitting"></a>splitting |  If true, enables code splitting.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-target"></a>target |  Bun build target environment for the compiled executable.   | String | optional |  `"bun"`  |
+| <a id="bun_compile-windows_copyright"></a>windows_copyright |  Optional Windows copyright metadata.   | String | optional |  `""`  |
+| <a id="bun_compile-windows_description"></a>windows_description |  Optional Windows description metadata.   | String | optional |  `""`  |
+| <a id="bun_compile-windows_hide_console"></a>windows_hide_console |  When targeting Windows, hides the console window for GUI-style executables.   | Boolean | optional |  `False`  |
+| <a id="bun_compile-windows_icon"></a>windows_icon |  Optional Windows icon path passed directly to Bun.   | String | optional |  `""`  |
+| <a id="bun_compile-windows_publisher"></a>windows_publisher |  Optional Windows publisher metadata.   | String | optional |  `""`  |
+| <a id="bun_compile-windows_title"></a>windows_title |  Optional Windows executable title.   | String | optional |  `""`  |
+| <a id="bun_compile-windows_version"></a>windows_version |  Optional Windows version metadata.   | String | optional |  `""`  |
+
+
+<a id="bun_dev"></a>
+
+## bun_dev
+
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_dev")
+
+bun_dev(<a href="#bun_dev-name">name</a>, <a href="#bun_dev-data">data</a>, <a href="#bun_dev-conditions">conditions</a>, <a href="#bun_dev-entry_point">entry_point</a>, <a href="#bun_dev-env_files">env_files</a>, <a href="#bun_dev-install_mode">install_mode</a>, <a href="#bun_dev-no_clear_screen">no_clear_screen</a>, <a href="#bun_dev-no_env_file">no_env_file</a>,
+        <a href="#bun_dev-node_modules">node_modules</a>, <a href="#bun_dev-preload">preload</a>, <a href="#bun_dev-restart_on">restart_on</a>, <a href="#bun_dev-run_flags">run_flags</a>, <a href="#bun_dev-smol">smol</a>, <a href="#bun_dev-watch_mode">watch_mode</a>, <a href="#bun_dev-working_dir">working_dir</a>)
+</pre>
+
+Runs a JS/TS entry point in Bun development watch mode.
+
+This rule is intended for local dev loops (`bazel run`) and supports Bun
+watch/HMR plus optional full restarts on selected file changes.
+
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="bun_dev-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="bun_dev-data"></a>data |  Additional runtime files required by the dev process.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_dev-conditions"></a>conditions |  Custom package resolve conditions passed to Bun.   | List of strings | optional |  `[]`  |
+| <a id="bun_dev-entry_point"></a>entry_point |  Path to the main JS/TS file to execute in dev mode.   | <a href="https://bazel.build/concepts/labels">Label</a> | required |  |
+| <a id="bun_dev-env_files"></a>env_files |  Additional environment files loaded with `--env-file`.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_dev-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages in dev mode.   | String | optional |  `"disable"`  |
+| <a id="bun_dev-no_clear_screen"></a>no_clear_screen |  If true, disables terminal clearing on Bun reloads.   | Boolean | optional |  `False`  |
+| <a id="bun_dev-no_env_file"></a>no_env_file |  If true, disables Bun's automatic `.env` loading.   | Boolean | optional |  `False`  |
+| <a id="bun_dev-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, in runfiles.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_dev-preload"></a>preload |  Modules to preload with `--preload` before running the entry point.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_dev-restart_on"></a>restart_on |  Files that trigger a full Bun process restart when they change.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_dev-run_flags"></a>run_flags |  Additional raw flags forwarded to `bun run` before the entry point.   | List of strings | optional |  `[]`  |
+| <a id="bun_dev-smol"></a>smol |  If true, enables Bun's lower-memory runtime mode.   | Boolean | optional |  `False`  |
+| <a id="bun_dev-watch_mode"></a>watch_mode |  Bun live-reload mode: `watch` (default) or `hot`.   | String | optional |  `"watch"`  |
+| <a id="bun_dev-working_dir"></a>working_dir |  Working directory at runtime: `workspace` root or nearest `entry_point` ancestor containing `.env`/`package.json`.   | String | optional |  `"workspace"`  |
+
+
+<a id="bun_script"></a>
+
+## bun_script
+
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_script")
+
+bun_script(<a href="#bun_script-name">name</a>, <a href="#bun_script-data">data</a>, <a href="#bun_script-conditions">conditions</a>, <a href="#bun_script-env_files">env_files</a>, <a href="#bun_script-execution_mode">execution_mode</a>, <a href="#bun_script-filters">filters</a>, <a href="#bun_script-install_mode">install_mode</a>, <a href="#bun_script-no_env_file">no_env_file</a>,
+           <a href="#bun_script-no_exit_on_error">no_exit_on_error</a>, <a href="#bun_script-node_modules">node_modules</a>, <a href="#bun_script-package_json">package_json</a>, <a href="#bun_script-preload">preload</a>, <a href="#bun_script-run_flags">run_flags</a>, <a href="#bun_script-script">script</a>, <a href="#bun_script-shell">shell</a>, <a href="#bun_script-silent">silent</a>,
+           <a href="#bun_script-smol">smol</a>, <a href="#bun_script-working_dir">working_dir</a>, <a href="#bun_script-workspaces">workspaces</a>)
+</pre>
+
+Runs a named `package.json` script with Bun as an executable target.
+
+Use this rule to expose existing package scripts such as `dev`, `build`, or
+`check` via `bazel run` without adding wrapper shell scripts. This is a good fit
+for Vite-style workflows, where scripts like `vite dev` or `vite build` are
+declared in `package.json` and expect to run from the package directory with
+`node_modules/.bin` available on `PATH`.
+
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="bun_script-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="bun_script-data"></a>data |  Additional runtime files required by the script.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_script-conditions"></a>conditions |  Custom package resolve conditions passed to Bun.   | List of strings | optional |  `[]`  |
+| <a id="bun_script-env_files"></a>env_files |  Additional environment files loaded with `--env-file`.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_script-execution_mode"></a>execution_mode |  How Bun should execute matching workspace scripts.   | String | optional |  `"single"`  |
+| <a id="bun_script-filters"></a>filters |  Workspace package filters passed via repeated `--filter` flags.   | List of strings | optional |  `[]`  |
+| <a id="bun_script-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages while running the script.   | String | optional |  `"disable"`  |
+| <a id="bun_script-no_env_file"></a>no_env_file |  If true, disables Bun's automatic `.env` loading.   | Boolean | optional |  `False`  |
+| <a id="bun_script-no_exit_on_error"></a>no_exit_on_error |  If true, Bun keeps running other workspace scripts when one fails.   | Boolean | optional |  `False`  |
+| <a id="bun_script-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, in runfiles. Executables from `node_modules/.bin` are added to `PATH`, which is useful for scripts such as `vite`.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_script-package_json"></a>package_json |  Label of the `package.json` file containing the named script.   | <a href="https://bazel.build/concepts/labels">Label</a> | required |  |
+| <a id="bun_script-preload"></a>preload |  Modules to preload with `--preload` before running the script.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_script-run_flags"></a>run_flags |  Additional raw flags forwarded to `bun run` before the script name.   | List of strings | optional |  `[]`  |
+| <a id="bun_script-script"></a>script |  Name of the `package.json` script to execute via `bun run <script>`.   | String | required |  |
+| <a id="bun_script-shell"></a>shell |  Optional shell implementation for package scripts.   | String | optional |  `""`  |
+| <a id="bun_script-silent"></a>silent |  If true, suppresses Bun's command echo for package scripts.   | Boolean | optional |  `False`  |
+| <a id="bun_script-smol"></a>smol |  If true, enables Bun's lower-memory runtime mode.   | Boolean | optional |  `False`  |
+| <a id="bun_script-working_dir"></a>working_dir |  Working directory at runtime: Bazel runfiles `workspace` root or the directory containing `package.json`. The default `package` mode matches tools such as Vite that resolve config and assets relative to the package directory.   | String | optional |  `"package"`  |
+| <a id="bun_script-workspaces"></a>workspaces |  If true, runs the script in all workspace packages.   | Boolean | optional |  `False`  |
+
+
+<a id="bun_test"></a>
 
 ## bun_test
 
-Runs Bun tests as a Bazel test target (`bazel test`).
+<pre>
+load("@rules_bun//bun:defs.bzl", "bun_test")
 
-Attributes:
+bun_test(<a href="#bun_test-name">name</a>, <a href="#bun_test-deps">deps</a>, <a href="#bun_test-srcs">srcs</a>, <a href="#bun_test-data">data</a>, <a href="#bun_test-bail">bail</a>, <a href="#bun_test-concurrent">concurrent</a>, <a href="#bun_test-coverage">coverage</a>, <a href="#bun_test-coverage_reporters">coverage_reporters</a>, <a href="#bun_test-env_files">env_files</a>,
+         <a href="#bun_test-install_mode">install_mode</a>, <a href="#bun_test-max_concurrency">max_concurrency</a>, <a href="#bun_test-no_env_file">no_env_file</a>, <a href="#bun_test-node_modules">node_modules</a>, <a href="#bun_test-only">only</a>, <a href="#bun_test-pass_with_no_tests">pass_with_no_tests</a>, <a href="#bun_test-preload">preload</a>,
+         <a href="#bun_test-randomize">randomize</a>, <a href="#bun_test-reporter">reporter</a>, <a href="#bun_test-rerun_each">rerun_each</a>, <a href="#bun_test-retry">retry</a>, <a href="#bun_test-seed">seed</a>, <a href="#bun_test-smol">smol</a>, <a href="#bun_test-test_flags">test_flags</a>, <a href="#bun_test-timeout_ms">timeout_ms</a>, <a href="#bun_test-todo">todo</a>,
+         <a href="#bun_test-update_snapshots">update_snapshots</a>)
+</pre>
 
-- `srcs` (label_list, required): test source files passed to `bun test`.
+Runs Bun tests as a Bazel test target.
-- `node_modules` (label, optional): package files from a `node_modules` tree, typically produced by `bun_install`, made available in runfiles.
+
-- `deps` (label_list, optional): library dependencies required by tests.
+Supports Bazel test filtering (`--test_filter`) and coverage integration.
-- `data` (label_list, optional): additional runtime files needed by tests.
+
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="bun_test-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="bun_test-deps"></a>deps |  Library dependencies required by test sources.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_test-srcs"></a>srcs |  Test source files passed to `bun test`.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | required |  |
+| <a id="bun_test-data"></a>data |  Additional runtime files needed by tests.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_test-bail"></a>bail |  Optional failure count after which Bun exits the test run.   | Integer | optional |  `0`  |
+| <a id="bun_test-concurrent"></a>concurrent |  If true, treats all tests as concurrent tests.   | Boolean | optional |  `False`  |
+| <a id="bun_test-coverage"></a>coverage |  If true, always enables Bun coverage output.   | Boolean | optional |  `False`  |
+| <a id="bun_test-coverage_reporters"></a>coverage_reporters |  Repeated Bun coverage reporters such as `text` or `lcov`.   | List of strings | optional |  `[]`  |
+| <a id="bun_test-env_files"></a>env_files |  Additional environment files loaded with `--env-file`.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_test-install_mode"></a>install_mode |  Whether Bun may auto-install missing packages while testing.   | String | optional |  `"disable"`  |
+| <a id="bun_test-max_concurrency"></a>max_concurrency |  Optional maximum number of concurrent tests.   | Integer | optional |  `0`  |
+| <a id="bun_test-no_env_file"></a>no_env_file |  If true, disables Bun's automatic `.env` loading.   | Boolean | optional |  `False`  |
+| <a id="bun_test-node_modules"></a>node_modules |  Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, in runfiles.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="bun_test-only"></a>only |  If true, runs only tests marked with `test.only()` or `describe.only()`.   | Boolean | optional |  `False`  |
+| <a id="bun_test-pass_with_no_tests"></a>pass_with_no_tests |  If true, exits successfully when no tests are found.   | Boolean | optional |  `False`  |
+| <a id="bun_test-preload"></a>preload |  Modules to preload with `--preload` before running tests.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="bun_test-randomize"></a>randomize |  If true, runs tests in random order.   | Boolean | optional |  `False`  |
+| <a id="bun_test-reporter"></a>reporter |  Test reporter format.   | String | optional |  `"console"`  |
+| <a id="bun_test-rerun_each"></a>rerun_each |  Optional number of times to rerun each test file.   | Integer | optional |  `0`  |
+| <a id="bun_test-retry"></a>retry |  Optional default retry count for all tests.   | Integer | optional |  `0`  |
+| <a id="bun_test-seed"></a>seed |  Optional randomization seed.   | Integer | optional |  `0`  |
+| <a id="bun_test-smol"></a>smol |  If true, enables Bun's lower-memory runtime mode.   | Boolean | optional |  `False`  |
+| <a id="bun_test-test_flags"></a>test_flags |  Additional raw flags forwarded to `bun test` before the test source list.   | List of strings | optional |  `[]`  |
+| <a id="bun_test-timeout_ms"></a>timeout_ms |  Optional per-test timeout in milliseconds.   | Integer | optional |  `0`  |
+| <a id="bun_test-todo"></a>todo |  If true, includes tests marked with `test.todo()`.   | Boolean | optional |  `False`  |
+| <a id="bun_test-update_snapshots"></a>update_snapshots |  If true, updates Bun snapshot files.   | Boolean | optional |  `False`  |
+
+
+<a id="js_library"></a>
 
 ## js_library
 
+<pre>
+load("@rules_bun//bun:defs.bzl", "js_library")
+
+js_library(<a href="#js_library-name">name</a>, <a href="#js_library-deps">deps</a>, <a href="#js_library-srcs">srcs</a>, <a href="#js_library-data">data</a>, <a href="#js_library-types">types</a>)
+</pre>
+
 Aggregates JavaScript sources and transitive Bun source dependencies.
 
-Attributes:
+**ATTRIBUTES**
 
-- `srcs` (label_list, optional): `.js`, `.jsx`, `.mjs`, `.cjs` files.
+
-- `deps` (label_list, optional): dependent source libraries.
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="js_library-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="js_library-deps"></a>deps |  Other Bun source libraries to include transitively.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="js_library-srcs"></a>srcs |  JavaScript source files in this library.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="js_library-data"></a>data |  Optional runtime files propagated to dependents.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="js_library-types"></a>types |  Optional declaration files associated with this library.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+
+
+<a id="js_run_devserver"></a>
+
+## js_run_devserver
+
+<pre>
+load("@rules_bun//bun:defs.bzl", "js_run_devserver")
+
+js_run_devserver(<a href="#js_run_devserver-name">name</a>, <a href="#js_run_devserver-deps">deps</a>, <a href="#js_run_devserver-data">data</a>, <a href="#js_run_devserver-node_modules">node_modules</a>, <a href="#js_run_devserver-package_dir_hint">package_dir_hint</a>, <a href="#js_run_devserver-package_json">package_json</a>, <a href="#js_run_devserver-tool">tool</a>, <a href="#js_run_devserver-working_dir">working_dir</a>)
+</pre>
+
+Runs an executable target from a staged JS workspace.
+
+This is a Bun-backed compatibility adapter for `rules_js`-style devserver
+targets. It stages the same runtime workspace as the Bun rules, then executes
+the provided tool with any default arguments.
+
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="js_run_devserver-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="js_run_devserver-deps"></a>deps |  Library dependencies required by the dev server.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="js_run_devserver-data"></a>data |  Additional runtime files required by the dev server.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="js_run_devserver-node_modules"></a>node_modules |  Optional label providing package files from a node_modules tree, typically produced by bun_install or npm_translate_lock, in runfiles.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="js_run_devserver-package_dir_hint"></a>package_dir_hint |  Optional package-relative directory hint when package_json is not supplied.   | String | optional |  `"."`  |
+| <a id="js_run_devserver-package_json"></a>package_json |  Optional package.json used to resolve the package working directory.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
+| <a id="js_run_devserver-tool"></a>tool |  Executable target to launch as the dev server.   | <a href="https://bazel.build/concepts/labels">Label</a> | required |  |
+| <a id="js_run_devserver-working_dir"></a>working_dir |  Working directory at runtime: Bazel runfiles workspace root or the resolved package directory.   | String | optional |  `"workspace"`  |
+
+
+<a id="ts_library"></a>
 
 ## ts_library
 
+<pre>
+load("@rules_bun//bun:defs.bzl", "ts_library")
+
+ts_library(<a href="#ts_library-name">name</a>, <a href="#ts_library-deps">deps</a>, <a href="#ts_library-srcs">srcs</a>, <a href="#ts_library-data">data</a>, <a href="#ts_library-types">types</a>)
+</pre>
+
 Aggregates TypeScript sources and transitive Bun source dependencies.
 
-Attributes:
+**ATTRIBUTES**
+
+
+| Name  | Description | Type | Mandatory | Default |
+| :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="ts_library-name"></a>name |  A unique name for this target.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="ts_library-deps"></a>deps |  Other Bun source libraries to include transitively.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="ts_library-srcs"></a>srcs |  TypeScript source files in this library.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="ts_library-data"></a>data |  Optional runtime files propagated to dependents.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+| <a id="ts_library-types"></a>types |  Optional declaration files associated with this library.   | <a href="https://bazel.build/concepts/labels">List of labels</a> | optional |  `[]`  |
+
+
+<a id="js_binary"></a>
+
+## js_binary
+
+<pre>
+load("@rules_bun//bun:defs.bzl", "js_binary")
+
+js_binary(<a href="#js_binary-name">name</a>, <a href="#js_binary-kwargs">**kwargs</a>)
+</pre>
+
+
+
+**PARAMETERS**
+
+
+| Name  | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| <a id="js_binary-name"></a>name |  <p align="center"> - </p>   |  none |
+| <a id="js_binary-kwargs"></a>kwargs |  <p align="center"> - </p>   |  none |
+
+
+<a id="js_test"></a>
+
+## js_test
+
+<pre>
+load("@rules_bun//bun:defs.bzl", "js_test")
+
+js_test(<a href="#js_test-name">name</a>, <a href="#js_test-entry_point">entry_point</a>, <a href="#js_test-srcs">srcs</a>, <a href="#js_test-kwargs">**kwargs</a>)
+</pre>
+
+
+
+**PARAMETERS**
+
+
+| Name  | Description | Default Value |
+| :------------- | :------------- | :------------- |
+| <a id="js_test-name"></a>name |  <p align="center"> - </p>   |  none |
+| <a id="js_test-entry_point"></a>entry_point |  <p align="center"> - </p>   |  `None` |
+| <a id="js_test-srcs"></a>srcs |  <p align="center"> - </p>   |  `None` |
+| <a id="js_test-kwargs"></a>kwargs |  <p align="center"> - </p>   |  none |
+
 
-- `srcs` (label_list, optional): `.ts`, `.tsx` files.
-- `deps` (label_list, optional): dependent source libraries.

examples/basic/BUILD.bazel

@@ -11,3 +11,11 @@ bun_dev(
     name = "web_dev",
     entry_point = "main.ts",
 )
+
+bun_dev(
+    name = "web_dev_hot_restart",
+    entry_point = "main.ts",
+    no_clear_screen = True,
+    restart_on = ["README.md"],
+    watch_mode = "hot",
+)

examples/basic/README.md

@@ -9,3 +9,12 @@ bazel run //examples/basic:web_dev
 ```
 
 This starts Bun in watch mode for `main.ts`.
+
+For the hot-reload launcher variant:
+
+```bash
+bazel run //examples/basic:web_dev_hot_restart
+```
+
+This starts Bun with `watch_mode = "hot"`, disables screen clearing, and wires
+`README.md` through `restart_on` to exercise the custom restart launcher path.

flake.lock

@@ -1,28 +1,5 @@
 {
   "nodes": {
-    "devshell-lib": {
-      "inputs": {
-        "git-hooks": "git-hooks",
-        "nixpkgs": [
-          "nixpkgs"
-        ],
-        "treefmt-nix": "treefmt-nix"
-      },
-      "locked": {
-        "lastModified": 1772815059,
-        "narHash": "sha256-9Mn8t/a7b43omtmKRsF0HmFpCkNpTsvYEq0y85KLL5s=",
-        "ref": "v2.0.1",
-        "rev": "80cc529de7060e079d89a69d8daaf0347b53d8f9",
-        "revCount": 43,
-        "type": "git",
-        "url": "https://git.dgren.dev/eric/nix-flake-lib"
-      },
-      "original": {
-        "ref": "v2.0.1",
-        "type": "git",
-        "url": "https://git.dgren.dev/eric/nix-flake-lib"
-      }
-    },
     "flake-compat": {
       "flake": false,
       "locked": {
@@ -43,7 +20,7 @@
       "inputs": {
         "flake-compat": "flake-compat",
         "gitignore": "gitignore",
-        "nixpkgs": "nixpkgs"
+        "nixpkgs": "nixpkgs_2"
       },
       "locked": {
         "lastModified": 1772024342,
@@ -62,7 +39,7 @@
     "gitignore": {
       "inputs": {
         "nixpkgs": [
-          "devshell-lib",
+          "repo-lib",
           "git-hooks",
           "nixpkgs"
         ]
@@ -82,6 +59,22 @@
       }
     },
     "nixpkgs": {
+      "locked": {
+        "lastModified": 1772542754,
+        "narHash": "sha256-WGV2hy+VIeQsYXpsLjdr4GvHv5eECMISX1zKLTedhdg=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "8c809a146a140c5c8806f13399592dbcb1bb5dc4",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs_2": {
       "locked": {
         "lastModified": 1770073757,
         "narHash": "sha256-Vy+G+F+3E/Tl+GMNgiHl9Pah2DgShmIUBJXmbiQPHbI=",
@@ -97,7 +90,7 @@
         "type": "github"
       }
     },
-    "nixpkgs_2": {
+    "nixpkgs_3": {
       "locked": {
         "lastModified": 1770107345,
         "narHash": "sha256-tbS0Ebx2PiA1FRW8mt8oejR0qMXmziJmPaU1d4kYY9g=",
@@ -113,31 +106,38 @@
         "type": "github"
       }
     },
-    "nixpkgs_3": {
+    "repo-lib": {
+      "inputs": {
+        "git-hooks": "git-hooks",
+        "nixpkgs": [
+          "nixpkgs"
+        ],
+        "treefmt-nix": "treefmt-nix"
+      },
       "locked": {
-        "lastModified": 1772542754,
+        "lastModified": 1772866275,
-        "narHash": "sha256-WGV2hy+VIeQsYXpsLjdr4GvHv5eECMISX1zKLTedhdg=",
+        "narHash": "sha256-lsJrFIbq6OO5wUC648VnvOmJm3qgJrlEugbdjeZsP34=",
-        "owner": "nixos",
+        "ref": "refs/tags/v3.0.0",
-        "repo": "nixpkgs",
+        "rev": "96d2d190466dddcb9e652c38b70152f09b9fcb05",
-        "rev": "8c809a146a140c5c8806f13399592dbcb1bb5dc4",
+        "revCount": 50,
-        "type": "github"
+        "type": "git",
+        "url": "https://git.dgren.dev/eric/nix-flake-lib"
       },
       "original": {
-        "owner": "nixos",
+        "ref": "refs/tags/v3.0.0",
-        "ref": "nixos-unstable",
+        "type": "git",
-        "repo": "nixpkgs",
+        "url": "https://git.dgren.dev/eric/nix-flake-lib"
-        "type": "github"
       }
     },
     "root": {
       "inputs": {
-        "devshell-lib": "devshell-lib",
+        "nixpkgs": "nixpkgs",
-        "nixpkgs": "nixpkgs_3"
+        "repo-lib": "repo-lib"
       }
     },
     "treefmt-nix": {
       "inputs": {
-        "nixpkgs": "nixpkgs_2"
+        "nixpkgs": "nixpkgs_3"
       },
       "locked": {
         "lastModified": 1770228511,

flake.nix

@@ -3,58 +3,34 @@
 
   inputs = {
     nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
-    devshell-lib.url = "git+https://git.dgren.dev/eric/nix-flake-lib?ref=v2.0.1";
+    repo-lib.url = "git+https://git.dgren.dev/eric/nix-flake-lib?ref=refs/tags/v3.0.0";
-    devshell-lib.inputs.nixpkgs.follows = "nixpkgs";
+    repo-lib.inputs.nixpkgs.follows = "nixpkgs";
   };
 
   outputs =
     {
       self,
       nixpkgs,
-      devshell-lib,
+      repo-lib,
       ...
     }:
     let
-      supportedSystems = [
+      bazelVersion = "9.0.0";
-        "x86_64-linux"
-        "aarch64-linux"
-        "x86_64-darwin"
-        "aarch64-darwin"
-      ];
-      forAllSystems = nixpkgs.lib.genAttrs supportedSystems;
     in
-    {
+    repo-lib.lib.mkRepo {
-      devShells = forAllSystems (
+      inherit self nixpkgs;
-        system:
+      src = ./.;
-        let
+
-          pkgs = import nixpkgs { inherit system; };
+      config = {
-          bazel9 = pkgs.writeShellScriptBin "bazel" ''
+        shell.extraShellText = ''
-            export USE_BAZEL_VERSION="''${USE_BAZEL_VERSION:-9.0.0}"
+          export USE_BAZEL_VERSION="''${USE_BAZEL_VERSION:-${bazelVersion}}"
-            exec ${pkgs.bazelisk}/bin/bazelisk "$@"
+          export BUN_INSTALL="''${BUN_INSTALL:-$HOME/.bun}"
+          export PATH="$BUN_INSTALL/bin:$PATH"
         '';
-          env = devshell-lib.lib.mkDevShell {
-            inherit system;
 
-            extraPackages = with pkgs; [
+        formatting = {
-              go
+          programs.shfmt.enable = true;
-              gopls
+          settings.shfmt.options = [
-              gotools
-              bun
-              bazel9
-              bazel-buildtools
-              self.packages.${system}.release
-            ];
-
-            features = {
-              oxfmt = false;
-            };
-
-            formatters = {
-              shfmt.enable = true;
-            };
-
-            formatterSettings = {
-              shfmt.options = [
             "-i"
             "2"
             "-s"
@@ -62,84 +38,15 @@
           ];
         };
 
-            additionalHooks = {
+        release = {
-              tests = {
+          steps = [
-                enable = true;
-                entry = ''
-                  bazel test //tests/...
-                '';
-                pass_filenames = false;
-                stages = [ "pre-push" ];
-              };
-            };
-
-            tools = [
             {
-                name = "Bun";
+              run.script = ''
-                bin = "${pkgs.bun}/bin/bun";
-                versionCmd = "--version";
-                color = "YELLOW";
-              }
-              {
-                name = "Go";
-                bin = "${pkgs.go}/bin/go";
-                versionCmd = "version";
-                color = "CYAN";
-              }
-              {
-                name = "Bazel";
-                bin = "${bazel9}/bin/bazel";
-                versionCmd = "--version";
-                color = "GREEN";
-              }
-            ];
-
-            extraShellHook = ''
-              export USE_BAZEL_VERSION="''${USE_BAZEL_VERSION:-9.0.0}"
-              export BUN_INSTALL="''${BUN_INSTALL:-$HOME/.bun}"
-              export PATH="$BUN_INSTALL/bin:$PATH"
-            '';
-          };
-        in
-        {
-          default = env.shell;
-        }
-      );
-
-      checks = forAllSystems (
-        system:
-        let
-          env = devshell-lib.lib.mkDevShell { inherit system; };
-        in
-        {
-          inherit (env) pre-commit-check;
-        }
-      );
-
-      formatter = forAllSystems (system: (devshell-lib.lib.mkDevShell { inherit system; }).formatter);
-
-      # Optional: release command (`release`)
-      #
-      # The release script always updates VERSION first, then:
-      #   1) runs release steps in order (file writes and scripts)
-      #   2) runs postVersion hook
-      #   3) formats, stages, commits, tags, and pushes
-      #
-      # Runtime env vars available in release.run/postVersion:
-      #   BASE_VERSION, CHANNEL, PRERELEASE_NUM, FULL_VERSION, FULL_TAG
-      #
-      packages = forAllSystems (system: {
-        release = devshell-lib.lib.mkRelease {
-          inherit system;
-
-          release = [
-            {
-              run = ''
                 sed -E -i 's#^([[:space:]]*version[[:space:]]*=[[:space:]]*")[^"]*(",)$#\1'"$FULL_VERSION"'\2#' "$ROOT_DIR/MODULE.bazel"
               '';
             }
             {
-              run = ''
+              run.script = ''
                 README="$ROOT_DIR/README.md"
                 TMP="$README.tmp"
 
@@ -168,14 +75,70 @@
                 ' "$README" > "$TMP" && mv "$TMP" "$README"
               '';
             }
+            {
+              run.script = ''
+                bazel cquery //tests/... >/dev/null
+              '';
+            }
           ];
 
           postVersion = ''
             echo "Released $FULL_TAG"
           '';
         };
-      });
-
       };
 
+      perSystem =
+        {
+          pkgs,
+          system,
+          ...
+        }:
+        let
+          bazel9 = pkgs.writeShellScriptBin "bazel" ''
+            export USE_BAZEL_VERSION="''${USE_BAZEL_VERSION:-${bazelVersion}}"
+            exec ${pkgs.bazelisk}/bin/bazelisk "$@"
+          '';
+        in
+        {
+          tools = [
+            (repo-lib.lib.tools.fromPackage {
+              name = "Bun";
+              package = pkgs.bun;
+              version.args = [ "--version" ];
+              banner.color = "YELLOW";
+            })
+            (repo-lib.lib.tools.fromPackage {
+              name = "Go";
+              package = pkgs.go;
+              version.args = [ "version" ];
+              banner.color = "CYAN";
+            })
+            (repo-lib.lib.tools.fromPackage {
+              name = "Bazel";
+              package = bazel9;
+              version.args = [ "--version" ];
+              banner.color = "GREEN";
+            })
+          ];
+
+          shell.packages = [
+            pkgs.gopls
+            pkgs.gotools
+            pkgs.bazel-buildtools
+            self.packages.${system}.release
+          ];
+
+          checks.tests = {
+            command = "bazel test //tests/...";
+            stage = "pre-push";
+            passFilenames = false;
+            runtimeInputs = [
+              bazel9
+              pkgs.bun
+              pkgs.go
+            ];
+          };
+        };
+    };
 }

internal/BUILD.bazel

@@ -3,29 +3,89 @@ load("@bazel_skylib//:bzl_library.bzl", "bzl_library")
 package(default_visibility = ["//visibility:public"])
 
 exports_files([
+    "bun_build_support.bzl",
     "bun_binary.bzl",
+    "bun_command.bzl",
+    "bun_compile.bzl",
     "bun_bundle.bzl",
     "bun_dev.bzl",
     "bun_install.bzl",
     "bun_script.bzl",
     "bun_test.bzl",
+    "js_compat.bzl",
     "js_library.bzl",
+    "js_run_devserver.bzl",
+    "workspace.bzl",
 ])
 
+filegroup(
+    name = "repo_runtime_files",
+    srcs = [
+        "BUILD.bazel",
+        "bun_binary.bzl",
+        "bun_build_support.bzl",
+        "bun_bundle.bzl",
+        "bun_command.bzl",
+        "bun_compile.bzl",
+        "bun_dev.bzl",
+        "bun_install.bzl",
+        "bun_script.bzl",
+        "bun_test.bzl",
+        "js_compat.bzl",
+        "js_library.bzl",
+        "js_run_devserver.bzl",
+        "workspace.bzl",
+    ],
+    visibility = ["//visibility:public"],
+)
+
+bzl_library(
+    name = "bun_command_bzl",
+    srcs = ["bun_command.bzl"],
+)
+
+bzl_library(
+    name = "bun_build_support_bzl",
+    srcs = ["bun_build_support.bzl"],
+    deps = [
+        ":bun_command_bzl",
+        ":js_library_bzl",
+    ],
+)
+
 bzl_library(
     name = "bun_binary_bzl",
     srcs = ["bun_binary.bzl"],
+    deps = [
+        ":bun_command_bzl",
+        ":js_library_bzl",
+        ":workspace_bzl",
+    ],
+)
+
+bzl_library(
+    name = "bun_compile_bzl",
+    srcs = ["bun_compile.bzl"],
+    deps = [
+        ":bun_build_support_bzl",
+    ],
 )
 
 bzl_library(
     name = "bun_bundle_bzl",
     srcs = ["bun_bundle.bzl"],
-    deps = [":js_library_bzl"],
+    deps = [
+        ":bun_build_support_bzl",
+    ],
 )
 
 bzl_library(
     name = "bun_dev_bzl",
     srcs = ["bun_dev.bzl"],
+    deps = [
+        ":bun_command_bzl",
+        ":workspace_bzl",
+    ],
 )
 
 bzl_library(
@@ -36,15 +96,48 @@ bzl_library(
 bzl_library(
     name = "bun_script_bzl",
     srcs = ["bun_script.bzl"],
+    deps = [
+        ":bun_command_bzl",
+        ":workspace_bzl",
+    ],
 )
 
 bzl_library(
     name = "bun_test_bzl",
     srcs = ["bun_test.bzl"],
-    deps = [":js_library_bzl"],
+    deps = [
+        ":bun_command_bzl",
+        ":js_library_bzl",
+        ":workspace_bzl",
+    ],
+)
+
+bzl_library(
+    name = "js_compat_bzl",
+    srcs = ["js_compat.bzl"],
+    deps = [
+        ":bun_binary_bzl",
+        ":bun_test_bzl",
+        ":js_library_bzl",
+        ":js_run_devserver_bzl",
+    ],
 )
 
 bzl_library(
     name = "js_library_bzl",
     srcs = ["js_library.bzl"],
 )
+
+bzl_library(
+    name = "js_run_devserver_bzl",
+    srcs = ["js_run_devserver.bzl"],
+    deps = [
+        ":js_library_bzl",
+        ":workspace_bzl",
+    ],
+)
+
+bzl_library(
+    name = "workspace_bzl",
+    srcs = ["workspace.bzl"],
+)

internal/bun_binary.bzl

@@ -1,67 +1,61 @@
 """Rule for running JS/TS scripts with Bun."""
 
+load("//internal:bun_command.bzl", "append_shell_flag", "append_shell_flag_files", "append_shell_flag_values", "append_shell_install_mode", "append_shell_raw_flags", "render_shell_array", "shell_quote")
+load("//internal:js_library.bzl", "collect_js_runfiles")
+load("//internal:workspace.bzl", "create_bun_workspace_info", "render_workspace_setup", "workspace_runfiles")
 
 def _bun_binary_impl(ctx):
     toolchain = ctx.toolchains["//bun:toolchain_type"]
     bun_bin = toolchain.bun.bun_bin
     entry_point = ctx.file.entry_point
+    dep_runfiles = [collect_js_runfiles(dep) for dep in ctx.attr.deps]
+    workspace_info = create_bun_workspace_info(
+        ctx,
+        extra_files = ctx.files.data + ctx.files.preload + ctx.files.env_files + [bun_bin],
+        primary_file = entry_point,
+    )
+
+    launcher_lines = [render_shell_array("bun_args", ["--bun", "run"])]
+    append_shell_install_mode(launcher_lines, "bun_args", ctx.attr.install_mode)
+    append_shell_flag_files(launcher_lines, "bun_args", "--preload", ctx.files.preload)
+    append_shell_flag_files(launcher_lines, "bun_args", "--env-file", ctx.files.env_files)
+    append_shell_flag(launcher_lines, "bun_args", "--no-env-file", ctx.attr.no_env_file)
+    append_shell_flag(launcher_lines, "bun_args", "--smol", ctx.attr.smol)
+    append_shell_flag_values(launcher_lines, "bun_args", "--conditions", ctx.attr.conditions)
+    append_shell_raw_flags(launcher_lines, "bun_args", ctx.attr.run_flags)
+    launcher_lines.append('bun_args+=("${primary_source}")')
+    for arg in ctx.attr.args:
+        launcher_lines.append("bun_args+=(%s)" % shell_quote(arg))
+
+    command = """
+trap cleanup_runtime_workspace EXIT
+cd "${runtime_exec_dir}"
+__BUN_ARGS__
+exec "${bun_bin}" "${bun_args[@]}" "$@"
+""".replace("__BUN_ARGS__", "\n".join(launcher_lines))
 
     launcher = ctx.actions.declare_file(ctx.label.name)
     ctx.actions.write(
         output = launcher,
         is_executable = True,
-        content = """#!/usr/bin/env bash
+        content = render_workspace_setup(
-set -euo pipefail
-
-runfiles_dir="${{RUNFILES_DIR:-$0.runfiles}}"
-workspace_root="${{runfiles_dir}}/_main"
-bun_bin="${{runfiles_dir}}/_main/{bun_short_path}"
-entry_point="${{runfiles_dir}}/_main/{entry_short_path}"
-
-resolve_entrypoint_workdir() {{
-    local dir
-    dir="$(dirname "${{entry_point}}")"
-    while [[ "${{dir}}" == "${{workspace_root}}"* ]]; do
-        if [[ -f "${{dir}}/.env" || -f "${{dir}}/package.json" ]]; then
-            echo "${{dir}}"
-            return 0
-        fi
-        if [[ "${{dir}}" == "${{workspace_root}}" ]]; then
-            break
-        fi
-        dir="$(dirname "${{dir}}")"
-    done
-    echo "$(dirname "${{entry_point}}")"
-}}
-
-working_dir="{working_dir}"
-if [[ "${{working_dir}}" == "entry_point" ]]; then
-    cd "$(resolve_entrypoint_workdir)"
-else
-    cd "${{workspace_root}}"
-fi
-
-exec "${{bun_bin}}" --bun run "${{entry_point}}" "$@"
-""".format(
             bun_short_path = bun_bin.short_path,
-            entry_short_path = entry_point.short_path,
+            install_metadata_short_path = workspace_info.install_metadata_file.short_path if workspace_info.install_metadata_file else "",
-            working_dir = ctx.attr.working_dir,
+            primary_source_short_path = entry_point.short_path,
-        ),
+            working_dir_mode = ctx.attr.working_dir,
-    )
+        ) + command,
-
-    transitive_files = []
-    if ctx.attr.node_modules:
-        transitive_files.append(ctx.attr.node_modules[DefaultInfo].files)
-
-    runfiles = ctx.runfiles(
-        files = [bun_bin, entry_point] + ctx.files.data,
-        transitive_files = depset(transitive = transitive_files),
     )
 
     return [
+        workspace_info,
         DefaultInfo(
             executable = launcher,
-            runfiles = runfiles,
+            runfiles = workspace_runfiles(
+                ctx,
+                workspace_info,
+                direct_files = [launcher],
+                transitive_files = dep_runfiles,
+            ),
         ),
     ]
 
@@ -85,6 +79,36 @@ Use this rule for non-test scripts and CLIs that should run via `bazel run`.
             allow_files = True,
             doc = "Additional runtime files required by the program.",
         ),
+        "deps": attr.label_list(
+            doc = "Library dependencies required by the program.",
+        ),
+        "preload": attr.label_list(
+            allow_files = True,
+            doc = "Modules to preload with `--preload` before running the entry point.",
+        ),
+        "env_files": attr.label_list(
+            allow_files = True,
+            doc = "Additional environment files loaded with `--env-file`.",
+        ),
+        "no_env_file": attr.bool(
+            default = False,
+            doc = "If true, disables Bun's automatic `.env` loading.",
+        ),
+        "smol": attr.bool(
+            default = False,
+            doc = "If true, enables Bun's lower-memory runtime mode.",
+        ),
+        "conditions": attr.string_list(
+            doc = "Custom package resolve conditions passed to Bun.",
+        ),
+        "install_mode": attr.string(
+            default = "disable",
+            values = ["disable", "auto", "fallback", "force"],
+            doc = "Whether Bun may auto-install missing packages at runtime.",
+        ),
+        "run_flags": attr.string_list(
+            doc = "Additional raw flags forwarded to `bun run` before the entry point.",
+        ),
         "working_dir": attr.string(
             default = "workspace",
             values = ["workspace", "entry_point"],

internal/bun_build_support.bzl

@@ -0,0 +1,90 @@
+"""Shared helpers for Bun build- and compile-style rules."""
+
+load("//internal:bun_command.bzl", "add_flag", "add_flag_value", "add_flag_values", "add_install_mode", "add_raw_flags")
+load("//internal:js_library.bzl", "collect_js_sources")
+
+def bun_build_transitive_inputs(ctx):
+    transitive_inputs = []
+    if getattr(ctx.attr, "node_modules", None):
+        transitive_inputs.append(ctx.attr.node_modules[DefaultInfo].files)
+    for dep in getattr(ctx.attr, "deps", []):
+        transitive_inputs.append(collect_js_sources(dep))
+    return transitive_inputs
+
+def add_bun_build_common_flags(args, attr, metafile = None, metafile_md = None):
+    add_install_mode(args, getattr(attr, "install_mode", "disable"))
+    add_flag_value(args, "--target", getattr(attr, "target", None))
+    add_flag_value(args, "--format", getattr(attr, "format", None))
+    add_flag(args, "--production", getattr(attr, "production", False))
+    add_flag(args, "--splitting", getattr(attr, "splitting", False))
+    add_flag_value(args, "--root", getattr(attr, "root", None))
+
+    sourcemap = getattr(attr, "sourcemap", None)
+    if sourcemap == True:
+        args.add("--sourcemap")
+    elif sourcemap and sourcemap != "none":
+        add_flag_value(args, "--sourcemap", sourcemap)
+
+    add_flag_value(args, "--banner", getattr(attr, "banner", None))
+    add_flag_value(args, "--footer", getattr(attr, "footer", None))
+    add_flag_value(args, "--public-path", getattr(attr, "public_path", None))
+    add_flag_value(args, "--packages", getattr(attr, "packages", None))
+    add_flag_values(args, "--external", getattr(attr, "external", []))
+    add_flag_value(args, "--entry-naming", getattr(attr, "entry_naming", None))
+    add_flag_value(args, "--chunk-naming", getattr(attr, "chunk_naming", None))
+    add_flag_value(args, "--asset-naming", getattr(attr, "asset_naming", None))
+    add_flag(args, "--minify", getattr(attr, "minify", False))
+    add_flag(args, "--minify-syntax", getattr(attr, "minify_syntax", False))
+    add_flag(args, "--minify-whitespace", getattr(attr, "minify_whitespace", False))
+    add_flag(args, "--minify-identifiers", getattr(attr, "minify_identifiers", False))
+    add_flag(args, "--keep-names", getattr(attr, "keep_names", False))
+    add_flag(args, "--css-chunking", getattr(attr, "css_chunking", False))
+    add_flag_values(args, "--conditions", getattr(attr, "conditions", []))
+    add_flag_value(args, "--env", getattr(attr, "env", None))
+    add_flag_values(args, "--define", getattr(attr, "define", []))
+    add_flag_values(args, "--drop", getattr(attr, "drop", []))
+    add_flag_values(args, "--feature", getattr(attr, "feature", []))
+    add_flag_values(args, "--loader", getattr(attr, "loader", []))
+    add_flag_value(args, "--jsx-factory", getattr(attr, "jsx_factory", None))
+    add_flag_value(args, "--jsx-fragment", getattr(attr, "jsx_fragment", None))
+    add_flag_value(args, "--jsx-import-source", getattr(attr, "jsx_import_source", None))
+    add_flag_value(args, "--jsx-runtime", getattr(attr, "jsx_runtime", None))
+    add_flag(args, "--jsx-side-effects", getattr(attr, "jsx_side_effects", False))
+    add_flag(args, "--react-fast-refresh", getattr(attr, "react_fast_refresh", False))
+    add_flag(args, "--emit-dce-annotations", getattr(attr, "emit_dce_annotations", False))
+    add_flag(args, "--no-bundle", getattr(attr, "no_bundle", False))
+    if metafile:
+        args.add("--metafile=%s" % metafile.path)
+    if metafile_md:
+        args.add("--metafile-md=%s" % metafile_md.path)
+    add_raw_flags(args, getattr(attr, "build_flags", []))
+
+def add_bun_compile_flags(args, attr, compile_executable = None):
+    add_flag(args, "--compile", True)
+    add_flag(args, "--bytecode", getattr(attr, "bytecode", False))
+    add_flag_values(args, "--compile-exec-argv", getattr(attr, "compile_exec_argv", []))
+    if getattr(attr, "compile_autoload_dotenv", True):
+        args.add("--compile-autoload-dotenv")
+    else:
+        args.add("--no-compile-autoload-dotenv")
+    if getattr(attr, "compile_autoload_bunfig", True):
+        args.add("--compile-autoload-bunfig")
+    else:
+        args.add("--no-compile-autoload-bunfig")
+    if getattr(attr, "compile_autoload_tsconfig", False):
+        args.add("--compile-autoload-tsconfig")
+    else:
+        args.add("--no-compile-autoload-tsconfig")
+    if getattr(attr, "compile_autoload_package_json", False):
+        args.add("--compile-autoload-package-json")
+    else:
+        args.add("--no-compile-autoload-package-json")
+    if compile_executable:
+        add_flag_value(args, "--compile-executable-path", compile_executable.path)
+    add_flag(args, "--windows-hide-console", getattr(attr, "windows_hide_console", False))
+    add_flag_value(args, "--windows-icon", getattr(attr, "windows_icon", None))
+    add_flag_value(args, "--windows-title", getattr(attr, "windows_title", None))
+    add_flag_value(args, "--windows-publisher", getattr(attr, "windows_publisher", None))
+    add_flag_value(args, "--windows-version", getattr(attr, "windows_version", None))
+    add_flag_value(args, "--windows-description", getattr(attr, "windows_description", None))
+    add_flag_value(args, "--windows-copyright", getattr(attr, "windows_copyright", None))

internal/bun_bundle.bzl

@@ -1,6 +1,6 @@
 """Rule for bundling JS/TS sources with Bun."""
 
-load("//internal:js_library.bzl", "BunSourcesInfo")
+load("//internal:bun_build_support.bzl", "add_bun_build_common_flags", "bun_build_transitive_inputs")
 
 
 def _output_name(target_name, entry):
@@ -12,14 +12,7 @@ def _bun_bundle_impl(ctx):
     toolchain = ctx.toolchains["//bun:toolchain_type"]
     bun_bin = toolchain.bun.bun_bin
 
-    transitive_inputs = []
+    transitive_inputs = bun_build_transitive_inputs(ctx)
-    if ctx.attr.node_modules:
-        transitive_inputs.append(ctx.attr.node_modules[DefaultInfo].files)
-    for dep in ctx.attr.deps:
-        if BunSourcesInfo in dep:
-            transitive_inputs.append(dep[BunSourcesInfo].transitive_sources)
-        else:
-            transitive_inputs.append(dep[DefaultInfo].files)
 
     outputs = []
     for entry in ctx.files.entry_points:
@@ -29,20 +22,10 @@ def _bun_bundle_impl(ctx):
         args = ctx.actions.args()
         args.add("--bun")
         args.add("build")
-        args.add(entry.path)
+        add_bun_build_common_flags(args, ctx.attr)
         args.add("--outfile")
         args.add(output.path)
-        args.add("--target")
+        args.add(entry.path)
-        args.add(ctx.attr.target)
-        args.add("--format")
-        args.add(ctx.attr.format)
-        if ctx.attr.minify:
-            args.add("--minify")
-        if ctx.attr.sourcemap:
-            args.add("--sourcemap")
-        for package in ctx.attr.external:
-            args.add("--external")
-            args.add(package)
 
         ctx.actions.run(
             executable = bun_bin,
@@ -81,6 +64,11 @@ Each entry point produces one output JavaScript artifact.
             allow_files = True,
             doc = "Additional non-source files needed during bundling.",
         ),
+        "install_mode": attr.string(
+            default = "disable",
+            values = ["disable", "auto", "fallback", "force"],
+            doc = "Whether Bun may auto-install missing packages during bundling.",
+        ),
         "target": attr.string(
             default = "browser",
             values = ["browser", "node", "bun"],
@@ -102,6 +90,9 @@ Each entry point produces one output JavaScript artifact.
         "external": attr.string_list(
             doc = "Package names to treat as externals (not bundled).",
         ),
+        "build_flags": attr.string_list(
+            doc = "Additional raw flags forwarded to `bun build`.",
+        ),
     },
     toolchains = ["//bun:toolchain_type"],
 )

internal/bun_command.bzl

@@ -0,0 +1,84 @@
+"""Shared Bun CLI flag builders for rules and launchers."""
+
+def shell_quote(value):
+    return "'" + str(value).replace("'", "'\"'\"'") + "'"
+
+def _runfiles_workspace(file):
+    workspace_name = file.owner.workspace_name
+    if workspace_name:
+        return workspace_name
+    return "_main"
+
+def runfiles_path_expr(file):
+    return '"${runfiles_dir}/%s/%s"' % (_runfiles_workspace(file), file.short_path)
+
+def render_shell_array(name, values):
+    rendered = [shell_quote(value) for value in values]
+    return "%s=(%s)" % (name, " ".join(rendered))
+
+def append_shell_arg(lines, name, value):
+    lines.append("%s+=(%s)" % (name, shell_quote(value)))
+
+def append_shell_expr(lines, name, expr):
+    lines.append("%s+=(%s)" % (name, expr))
+
+def append_shell_flag(lines, name, flag, enabled):
+    if enabled:
+        append_shell_arg(lines, name, flag)
+
+def append_shell_flag_value(lines, name, flag, value):
+    if value == None:
+        return
+    if type(value) == type("") and not value:
+        return
+    append_shell_arg(lines, name, flag)
+    append_shell_arg(lines, name, value)
+
+def append_shell_flag_values(lines, name, flag, values):
+    for value in values:
+        append_shell_flag_value(lines, name, flag, value)
+
+def append_shell_flag_files(lines, name, flag, files):
+    for file in files:
+        append_shell_arg(lines, name, flag)
+        append_shell_expr(lines, name, runfiles_path_expr(file))
+
+def append_shell_raw_flags(lines, name, values):
+    for value in values:
+        append_shell_arg(lines, name, value)
+
+def append_shell_install_mode(lines, name, install_mode):
+    if install_mode == "disable":
+        append_shell_arg(lines, name, "--no-install")
+    elif install_mode in ["fallback", "force"]:
+        append_shell_flag_value(lines, name, "--install", install_mode)
+
+def add_flag(args, flag, enabled):
+    if enabled:
+        args.add(flag)
+
+def add_flag_value(args, flag, value):
+    if value == None:
+        return
+    if type(value) == type("") and not value:
+        return
+    args.add(flag)
+    args.add(value)
+
+def add_flag_values(args, flag, values):
+    for value in values:
+        add_flag_value(args, flag, value)
+
+def add_flag_files(args, flag, files):
+    for file in files:
+        args.add(flag)
+        args.add(file.path)
+
+def add_raw_flags(args, values):
+    args.add_all(values)
+
+def add_install_mode(args, install_mode):
+    if install_mode == "disable":
+        args.add("--no-install")
+    elif install_mode in ["fallback", "force"]:
+        add_flag_value(args, "--install", install_mode)

internal/bun_compile.bzl

@@ -0,0 +1,315 @@
+"""Rules for Bun build outputs and standalone executables."""
+
+load("//internal:bun_build_support.bzl", "add_bun_build_common_flags", "add_bun_compile_flags", "bun_build_transitive_inputs")
+
+def _bun_build_impl(ctx):
+    toolchain = ctx.toolchains["//bun:toolchain_type"]
+    bun_bin = toolchain.bun.bun_bin
+    output_dir = ctx.actions.declare_directory(ctx.label.name)
+    metafile = ctx.actions.declare_file(ctx.label.name + ".meta.json") if ctx.attr.metafile else None
+    metafile_md = ctx.actions.declare_file(ctx.label.name + ".meta.md") if ctx.attr.metafile_md else None
+
+    args = ctx.actions.args()
+    args.add("--bun")
+    args.add("build")
+    add_bun_build_common_flags(args, ctx.attr, metafile = metafile, metafile_md = metafile_md)
+    args.add("--outdir")
+    args.add(output_dir.path)
+    args.add_all(ctx.files.entry_points)
+
+    outputs = [output_dir]
+    if metafile:
+        outputs.append(metafile)
+    if metafile_md:
+        outputs.append(metafile_md)
+
+    ctx.actions.run(
+        executable = bun_bin,
+        arguments = [args],
+        inputs = depset(
+            direct = ctx.files.entry_points + ctx.files.data,
+            transitive = bun_build_transitive_inputs(ctx),
+        ),
+        outputs = outputs,
+        mnemonic = "BunBuild",
+        progress_message = "Building {} with Bun".format(ctx.label.name),
+    )
+
+    return [DefaultInfo(files = depset(outputs))]
+
+def _bun_compile_impl(ctx):
+    toolchain = ctx.toolchains["//bun:toolchain_type"]
+    bun_bin = toolchain.bun.bun_bin
+    output = ctx.actions.declare_file(ctx.label.name)
+    compile_executable = ctx.file.compile_executable
+
+    args = ctx.actions.args()
+    args.add("--bun")
+    args.add("build")
+    add_bun_build_common_flags(args, ctx.attr)
+    add_bun_compile_flags(args, ctx.attr, compile_executable = compile_executable)
+    args.add("--outfile")
+    args.add(output.path)
+    args.add(ctx.file.entry_point.path)
+
+    direct_inputs = [ctx.file.entry_point] + ctx.files.data
+    if compile_executable:
+        direct_inputs.append(compile_executable)
+
+    ctx.actions.run(
+        executable = bun_bin,
+        arguments = [args],
+        inputs = depset(
+            direct = direct_inputs,
+            transitive = bun_build_transitive_inputs(ctx),
+        ),
+        outputs = [output],
+        mnemonic = "BunCompile",
+        progress_message = "Compiling {} with Bun".format(ctx.file.entry_point.short_path),
+    )
+
+    return [
+        DefaultInfo(
+            executable = output,
+            files = depset([output]),
+        ),
+    ]
+
+_COMMON_BUILD_ATTRS = {
+    "node_modules": attr.label(
+        doc = "Optional label providing package files from a `node_modules` tree, typically produced by `bun_install`, for package resolution.",
+    ),
+    "deps": attr.label_list(
+        doc = "Source/library dependencies that provide transitive inputs.",
+    ),
+    "data": attr.label_list(
+        allow_files = True,
+        doc = "Additional non-source files needed during building.",
+    ),
+    "install_mode": attr.string(
+        default = "disable",
+        values = ["disable", "auto", "fallback", "force"],
+        doc = "Whether Bun may auto-install missing packages while executing the build.",
+    ),
+    "target": attr.string(
+        default = "browser",
+        values = ["browser", "node", "bun"],
+        doc = "Bun build target environment.",
+    ),
+    "format": attr.string(
+        default = "esm",
+        values = ["esm", "cjs", "iife"],
+        doc = "Output module format.",
+    ),
+    "production": attr.bool(
+        default = False,
+        doc = "If true, sets `NODE_ENV=production` and enables Bun production mode.",
+    ),
+    "splitting": attr.bool(
+        default = False,
+        doc = "If true, enables code splitting.",
+    ),
+    "root": attr.string(
+        doc = "Optional root directory for multiple entry points.",
+    ),
+    "sourcemap": attr.string(
+        default = "none",
+        values = ["none", "linked", "inline", "external"],
+        doc = "Sourcemap emission mode.",
+    ),
+    "banner": attr.string(
+        doc = "Optional bundle banner text.",
+    ),
+    "footer": attr.string(
+        doc = "Optional bundle footer text.",
+    ),
+    "public_path": attr.string(
+        doc = "Optional public path prefix for emitted imports.",
+    ),
+    "packages": attr.string(
+        default = "bundle",
+        values = ["bundle", "external"],
+        doc = "Whether packages stay bundled or are treated as external.",
+    ),
+    "external": attr.string_list(
+        doc = "Modules treated as externals (not bundled).",
+    ),
+    "entry_naming": attr.string(
+        doc = "Optional entry naming template.",
+    ),
+    "chunk_naming": attr.string(
+        doc = "Optional chunk naming template.",
+    ),
+    "asset_naming": attr.string(
+        doc = "Optional asset naming template.",
+    ),
+    "minify": attr.bool(
+        default = False,
+        doc = "If true, enables all Bun minification passes.",
+    ),
+    "minify_syntax": attr.bool(
+        default = False,
+        doc = "If true, minifies syntax only.",
+    ),
+    "minify_whitespace": attr.bool(
+        default = False,
+        doc = "If true, minifies whitespace only.",
+    ),
+    "minify_identifiers": attr.bool(
+        default = False,
+        doc = "If true, minifies identifiers only.",
+    ),
+    "keep_names": attr.bool(
+        default = False,
+        doc = "If true, preserves function and class names when minifying.",
+    ),
+    "css_chunking": attr.bool(
+        default = False,
+        doc = "If true, Bun chunks CSS across multiple entry points.",
+    ),
+    "conditions": attr.string_list(
+        doc = "Custom resolve conditions passed to Bun.",
+    ),
+    "env": attr.string(
+        doc = "Inline environment variable behavior passed to `--env`.",
+    ),
+    "define": attr.string_list(
+        doc = "Repeated `--define` values such as `process.env.NODE_ENV:\"production\"`.",
+    ),
+    "drop": attr.string_list(
+        doc = "Repeated `--drop` values, for example `console`.",
+    ),
+    "feature": attr.string_list(
+        doc = "Repeated `--feature` values for dead-code elimination.",
+    ),
+    "loader": attr.string_list(
+        doc = "Repeated `--loader` values such as `.svg:file`.",
+    ),
+    "jsx_factory": attr.string(
+        doc = "Optional JSX factory override.",
+    ),
+    "jsx_fragment": attr.string(
+        doc = "Optional JSX fragment override.",
+    ),
+    "jsx_import_source": attr.string(
+        doc = "Optional JSX import source override.",
+    ),
+    "jsx_runtime": attr.string(
+        values = ["", "automatic", "classic"],
+        default = "",
+        doc = "Optional JSX runtime override.",
+    ),
+    "jsx_side_effects": attr.bool(
+        default = False,
+        doc = "If true, treats JSX as having side effects.",
+    ),
+    "react_fast_refresh": attr.bool(
+        default = False,
+        doc = "If true, enables Bun's React fast refresh transform.",
+    ),
+    "emit_dce_annotations": attr.bool(
+        default = False,
+        doc = "If true, re-emits DCE annotations in the bundle.",
+    ),
+    "no_bundle": attr.bool(
+        default = False,
+        doc = "If true, transpiles without bundling.",
+    ),
+    "build_flags": attr.string_list(
+        doc = "Additional raw flags forwarded to `bun build`.",
+    ),
+}
+
+bun_build = rule(
+    implementation = _bun_build_impl,
+    doc = """Builds one or more entry points with `bun build`.
+
+The rule emits a directory artifact so Bun can materialize multi-file output
+graphs such as HTML, CSS, assets, and split chunks. Optional metafile outputs
+may be requested with `metafile` and `metafile_md`.
+""",
+    attrs = dict(_COMMON_BUILD_ATTRS, **{
+        "entry_points": attr.label_list(
+            mandatory = True,
+            allow_files = True,
+            doc = "Entry files to build, including JS/TS or HTML entry points.",
+        ),
+        "metafile": attr.bool(
+            default = False,
+            doc = "If true, emits Bun's JSON metafile alongside the output directory.",
+        ),
+        "metafile_md": attr.bool(
+            default = False,
+            doc = "If true, emits Bun's markdown metafile alongside the output directory.",
+        ),
+    }),
+    toolchains = ["//bun:toolchain_type"],
+)
+
+bun_compile = rule(
+    implementation = _bun_compile_impl,
+    doc = """Compiles a Bun program into a standalone executable with `bun build --compile`.""",
+    attrs = dict(_COMMON_BUILD_ATTRS, **{
+        "target": attr.string(
+            default = "bun",
+            values = ["browser", "node", "bun"],
+            doc = "Bun build target environment for the compiled executable.",
+        ),
+        "entry_point": attr.label(
+            mandatory = True,
+            allow_single_file = True,
+            doc = "Entry file to compile into an executable.",
+        ),
+        "bytecode": attr.bool(
+            default = False,
+            doc = "If true, enables Bun bytecode caching in the compiled executable.",
+        ),
+        "compile_exec_argv": attr.string_list(
+            doc = "Repeated `--compile-exec-argv` values prepended to the executable's `execArgv`.",
+        ),
+        "compile_executable": attr.label(
+            allow_single_file = True,
+            doc = "Optional Bun executable used for cross-compilation via `--compile-executable-path`.",
+        ),
+        "compile_autoload_dotenv": attr.bool(
+            default = True,
+            doc = "Whether the compiled executable auto-loads `.env` files at runtime.",
+        ),
+        "compile_autoload_bunfig": attr.bool(
+            default = True,
+            doc = "Whether the compiled executable auto-loads `bunfig.toml` at runtime.",
+        ),
+        "compile_autoload_tsconfig": attr.bool(
+            default = False,
+            doc = "Whether the compiled executable auto-loads `tsconfig.json` at runtime.",
+        ),
+        "compile_autoload_package_json": attr.bool(
+            default = False,
+            doc = "Whether the compiled executable auto-loads `package.json` at runtime.",
+        ),
+        "windows_hide_console": attr.bool(
+            default = False,
+            doc = "When targeting Windows, hides the console window for GUI-style executables.",
+        ),
+        "windows_icon": attr.string(
+            doc = "Optional Windows icon path passed directly to Bun.",
+        ),
+        "windows_title": attr.string(
+            doc = "Optional Windows executable title.",
+        ),
+        "windows_publisher": attr.string(
+            doc = "Optional Windows publisher metadata.",
+        ),
+        "windows_version": attr.string(
+            doc = "Optional Windows version metadata.",
+        ),
+        "windows_description": attr.string(
+            doc = "Optional Windows description metadata.",
+        ),
+        "windows_copyright": attr.string(
+            doc = "Optional Windows copyright metadata.",
+        ),
+    }),
+    executable = True,
+    toolchains = ["//bun:toolchain_type"],
+)

internal/bun_dev.bzl

@@ -1,101 +1,91 @@
 """Rule for running JS/TS scripts with Bun in watch mode for development."""
 
+load("//internal:bun_command.bzl", "append_shell_flag", "append_shell_flag_files", "append_shell_flag_values", "append_shell_install_mode", "append_shell_raw_flags", "render_shell_array", "shell_quote")
+load("//internal:workspace.bzl", "create_bun_workspace_info", "render_workspace_setup", "workspace_runfiles")
+
 def _bun_dev_impl(ctx):
     toolchain = ctx.toolchains["//bun:toolchain_type"]
     bun_bin = toolchain.bun.bun_bin
     entry_point = ctx.file.entry_point
+    workspace_info = create_bun_workspace_info(
+        ctx,
+        extra_files = ctx.files.data + ctx.files.restart_on + ctx.files.preload + ctx.files.env_files + [bun_bin],
+        primary_file = entry_point,
+    )
 
     restart_watch_paths = "\n".join([path.short_path for path in ctx.files.restart_on])
+    launcher_lines = [render_shell_array("bun_args", ["--bun", "run"])]
+    append_shell_install_mode(launcher_lines, "bun_args", ctx.attr.install_mode)
+    append_shell_flag_files(launcher_lines, "bun_args", "--preload", ctx.files.preload)
+    append_shell_flag_files(launcher_lines, "bun_args", "--env-file", ctx.files.env_files)
+    append_shell_flag(launcher_lines, "bun_args", "--no-env-file", ctx.attr.no_env_file)
+    append_shell_flag(launcher_lines, "bun_args", "--smol", ctx.attr.smol)
+    append_shell_flag_values(launcher_lines, "bun_args", "--conditions", ctx.attr.conditions)
+    append_shell_flag(launcher_lines, "bun_args", "--no-clear-screen", ctx.attr.no_clear_screen)
+    append_shell_raw_flags(launcher_lines, "bun_args", ctx.attr.run_flags)
+    launcher_lines.append('bun_args+=("${primary_source}")')
+    for arg in ctx.attr.args:
+        launcher_lines.append("bun_args+=(%s)" % shell_quote(arg))
 
-    launcher = ctx.actions.declare_file(ctx.label.name)
+    command = """
-    ctx.actions.write(
+__BUN_ARGS__
-        output = launcher,
+watch_mode="__WATCH_MODE__"
-        is_executable = True,
+if [[ "${watch_mode}" == "hot" ]]; then
-        content = """#!/usr/bin/env bash
+    bun_args+=("--hot")
-set -euo pipefail
-
-runfiles_dir="${{RUNFILES_DIR:-$0.runfiles}}"
-workspace_root="${{runfiles_dir}}/_main"
-bun_bin="${{runfiles_dir}}/_main/{bun_short_path}"
-entry_point="${{runfiles_dir}}/_main/{entry_short_path}"
-
-resolve_entrypoint_workdir() {{
-    local dir
-    dir="$(dirname "${{entry_point}}")"
-    while [[ "${{dir}}" == "${{workspace_root}}"* ]]; do
-        if [[ -f "${{dir}}/.env" || -f "${{dir}}/package.json" ]]; then
-            echo "${{dir}}"
-            return 0
-        fi
-        if [[ "${{dir}}" == "${{workspace_root}}" ]]; then
-            break
-        fi
-        dir="$(dirname "${{dir}}")"
-    done
-    echo "$(dirname "${{entry_point}}")"
-}}
-
-working_dir="{working_dir}"
-if [[ "${{working_dir}}" == "entry_point" ]]; then
-    cd "$(resolve_entrypoint_workdir)"
 else
-    cd "${{workspace_root}}"
+    bun_args+=("--watch")
 fi
 
-watch_mode="{watch_mode}"
+if [[ __RESTART_COUNT__ -eq 0 ]]; then
-if [[ "${{watch_mode}}" == "hot" ]]; then
+    trap cleanup_runtime_workspace EXIT
-    dev_flag="--hot"
+    cd "${runtime_exec_dir}"
-else
+    exec "${bun_bin}" "${bun_args[@]}" "$@"
-    dev_flag="--watch"
-fi
-
-run_dev() {{
-    exec "${{bun_bin}}" --bun "${{dev_flag}}" run "${{entry_point}}" "$@"
-}}
-
-if [[ {restart_count} -eq 0 ]]; then
-    run_dev "$@"
 fi
 
 readarray -t restart_paths <<'EOF_RESTART_PATHS'
-{restart_watch_paths}
+__RESTART_PATHS__
 EOF_RESTART_PATHS
 
-file_mtime() {{
+file_mtime() {
-    local p="$1"
+    local path="$1"
-    if stat -f '%m' "${{p}}" >/dev/null 2>&1; then
+    if stat -f '%m' "${path}" >/dev/null 2>&1; then
-        stat -f '%m' "${{p}}"
+        stat -f '%m' "${path}"
         return 0
     fi
-    stat -c '%Y' "${{p}}"
+    stat -c '%Y' "${path}"
-}}
+}
 
 declare -A mtimes
-for rel in "${{restart_paths[@]}}"; do
+for rel in "${restart_paths[@]}"; do
-    path="${{runfiles_dir}}/_main/${{rel}}"
+    path="${runfiles_dir}/_main/${rel}"
-    if [[ -e "${{path}}" ]]; then
+    if [[ -e "${path}" ]]; then
-        mtimes["${{rel}}"]="$(file_mtime "${{path}}")"
+        mtimes["${rel}"]="$(file_mtime "${path}")"
     else
-        mtimes["${{rel}}"]="missing"
+        mtimes["${rel}"]="missing"
     fi
 done
 
 child_pid=""
-restart_child() {{
+restart_child() {
-    if [[ -n "${{child_pid}}" ]] && kill -0 "${{child_pid}}" 2>/dev/null; then
+    if [[ -n "${child_pid}" ]] && kill -0 "${child_pid}" 2>/dev/null; then
-        kill "${{child_pid}}"
+        kill "${child_pid}"
-        wait "${{child_pid}}" || true
+        wait "${child_pid}" || true
     fi
-    "${{bun_bin}}" --bun "${{dev_flag}}" run "${{entry_point}}" "$@" &
-    child_pid=$!
-}}
 
-cleanup() {{
+    (
-    if [[ -n "${{child_pid}}" ]] && kill -0 "${{child_pid}}" 2>/dev/null; then
+        cd "${runtime_exec_dir}"
-        kill "${{child_pid}}"
+        exec "${bun_bin}" "${bun_args[@]}" "$@"
-        wait "${{child_pid}}" || true
+    ) &
+    child_pid=$!
+}
+
+cleanup() {
+    if [[ -n "${child_pid}" ]] && kill -0 "${child_pid}" 2>/dev/null; then
+        kill "${child_pid}"
+        wait "${child_pid}" || true
     fi
-}}
+    cleanup_runtime_workspace
+}
 
 trap cleanup EXIT INT TERM
 
@@ -104,45 +94,50 @@ restart_child "$@"
 while true; do
     sleep 1
     changed=0
-    for rel in "${{restart_paths[@]}}"; do
+    for rel in "${restart_paths[@]}"; do
-        path="${{runfiles_dir}}/_main/${{rel}}"
+        path="${runfiles_dir}/_main/${rel}"
-        if [[ -e "${{path}}" ]]; then
+        if [[ -e "${path}" ]]; then
-            current="$(file_mtime "${{path}}")"
+            current="$(file_mtime "${path}")"
         else
             current="missing"
         fi
-        if [[ "${{current}}" != "${{mtimes[${{rel}}]}}" ]]; then
+        if [[ "${current}" != "${mtimes[${rel}]}" ]]; then
-            mtimes["${{rel}}"]="${{current}}"
+            mtimes["${rel}"]="${current}"
             changed=1
         fi
     done
-    if [[ "${{changed}}" -eq 1 ]]; then
+    if [[ "${changed}" -eq 1 ]]; then
         restart_child "$@"
     fi
 done
-""".format(
+""".replace("__WATCH_MODE__", ctx.attr.watch_mode).replace(
-            bun_short_path = bun_bin.short_path,
+        "__RESTART_COUNT__",
-            entry_short_path = entry_point.short_path,
+        str(len(ctx.files.restart_on)),
-            watch_mode = ctx.attr.watch_mode,
+    ).replace(
-            working_dir = ctx.attr.working_dir,
+        "__RESTART_PATHS__",
-            restart_count = len(ctx.files.restart_on),
+        restart_watch_paths,
-            restart_watch_paths = restart_watch_paths,
+    ).replace(
-        ),
+        "__BUN_ARGS__",
+        "\n".join(launcher_lines),
     )
 
-    transitive_files = []
+    launcher = ctx.actions.declare_file(ctx.label.name)
-    if ctx.attr.node_modules:
+    ctx.actions.write(
-        transitive_files.append(ctx.attr.node_modules[DefaultInfo].files)
+        output = launcher,
-
+        is_executable = True,
-    runfiles = ctx.runfiles(
+        content = render_workspace_setup(
-        files = [bun_bin, entry_point] + ctx.files.data + ctx.files.restart_on,
+            bun_short_path = bun_bin.short_path,
-        transitive_files = depset(transitive = transitive_files),
+            install_metadata_short_path = workspace_info.install_metadata_file.short_path if workspace_info.install_metadata_file else "",
+            primary_source_short_path = entry_point.short_path,
+            working_dir_mode = ctx.attr.working_dir,
+        ) + command,
     )
 
     return [
+        workspace_info,
         DefaultInfo(
             executable = launcher,
-            runfiles = runfiles,
+            runfiles = workspace_runfiles(ctx, workspace_info, direct_files = [launcher]),
         ),
     ]
 
@@ -175,6 +170,37 @@ watch/HMR plus optional full restarts on selected file changes.
             allow_files = True,
             doc = "Additional runtime files required by the dev process.",
         ),
+        "preload": attr.label_list(
+            allow_files = True,
+            doc = "Modules to preload with `--preload` before running the entry point.",
+        ),
+        "env_files": attr.label_list(
+            allow_files = True,
+            doc = "Additional environment files loaded with `--env-file`.",
+        ),
+        "no_env_file": attr.bool(
+            default = False,
+            doc = "If true, disables Bun's automatic `.env` loading.",
+        ),
+        "smol": attr.bool(
+            default = False,
+            doc = "If true, enables Bun's lower-memory runtime mode.",
+        ),
+        "conditions": attr.string_list(
+            doc = "Custom package resolve conditions passed to Bun.",
+        ),
+        "install_mode": attr.string(
+            default = "disable",
+            values = ["disable", "auto", "fallback", "force"],
+            doc = "Whether Bun may auto-install missing packages in dev mode.",
+        ),
+        "no_clear_screen": attr.bool(
+            default = False,
+            doc = "If true, disables terminal clearing on Bun reloads.",
+        ),
+        "run_flags": attr.string_list(
+            doc = "Additional raw flags forwarded to `bun run` before the entry point.",
+        ),
         "working_dir": attr.string(
             default = "workspace",
             values = ["workspace", "entry_point"],

internal/bun_install.bzl

@@ -6,6 +6,13 @@ _DEFAULT_INSTALL_INPUTS = [
     "bunfig.toml",
 ]
 
+_MANIFEST_DEP_FIELDS = [
+    "dependencies",
+    "devDependencies",
+    "optionalDependencies",
+    "peerDependencies",
+]
+
 def _normalize_path(path):
     normalized = path.replace("\\", "/")
     if normalized.endswith("/") and normalized != "/":
@@ -96,10 +103,82 @@ def _workspace_patterns(repository_ctx, package_json):
 
     return patterns
 
+def _validate_catalog_shape(field, value):
+    if value == None:
+        return
+
+    if type(value) != type({}):
+        fail("bun_install: `{}` must be an object".format(field))
+
+    if field not in ["catalogs", "workspaces.catalogs"]:
+        return
+
+    for name, catalog in value.items():
+        if type(name) != type(""):
+            fail("bun_install: `catalogs` keys must be strings, got {}".format(type(name)))
+        if type(catalog) != type({}):
+            fail("bun_install: `catalogs.{}` must be an object".format(name))
+
+def _copy_json_value(value):
+    return json.decode(json.encode(value))
+
+def _package_target_name(package_name):
+    sanitized = package_name
+    sanitized = sanitized.replace("@", "at_")
+    sanitized = sanitized.replace("/", "_")
+    sanitized = sanitized.replace("-", "_")
+    sanitized = sanitized.replace(".", "_")
+    sanitized = sanitized.replace("__", "_").replace("__", "_").replace("__", "_")
+    sanitized = sanitized.strip("_")
+    if not sanitized:
+        sanitized = "package"
+    return "npm__" + sanitized
+
+def _manifest_dependency_names(manifest):
+    names = {}
+    for field in _MANIFEST_DEP_FIELDS:
+        dependencies = manifest.get(field)
+        if dependencies == None:
+            continue
+        if type(dependencies) != type({}):
+            fail("bun_install: `{}` must be an object when present".format(field))
+        for name in dependencies.keys():
+            names[name] = True
+    return names
+
+def _normalized_root_manifest(repository_ctx, package_json):
+    manifest = json.decode(repository_ctx.read(package_json))
+    workspaces = manifest.get("workspaces")
+
+    for field in ["catalog", "catalogs"]:
+        manifest_value = manifest.get(field)
+        _validate_catalog_shape(field, manifest_value)
+
+        if type(workspaces) != type({}):
+            continue
+
+        workspace_value = workspaces.get(field)
+        _validate_catalog_shape("workspaces.{}".format(field), workspace_value)
+
+        if workspace_value == None:
+            continue
+
+        if manifest_value == None:
+            manifest[field] = _copy_json_value(workspace_value)
+            continue
+
+        if manifest_value != workspace_value:
+            fail(
+                "bun_install: `{}` conflicts with `workspaces.{}`; use one source of truth or keep both values identical".format(field, field),
+            )
+
+    return json.encode(manifest)
+
 def _materialize_workspace_packages(repository_ctx, package_json):
     package_root = package_json.dirname
     package_root_str = str(package_root)
     written = {}
+    workspace_packages = {}
 
     for pattern in _workspace_patterns(repository_ctx, package_json):
         segments = pattern.split("/")
@@ -121,6 +200,15 @@ def _materialize_workspace_packages(repository_ctx, package_json):
                 repository_ctx.read(workspace_package_json),
             )
             written[relative_dir] = True
+            manifest = json.decode(repository_ctx.read(workspace_package_json))
+            package_name = manifest.get("name")
+            workspace_packages[relative_dir] = package_name if type(package_name) == type("") else ""
+
+    package_dirs = sorted(workspace_packages.keys())
+    return struct(
+        package_dirs = package_dirs,
+        package_names = [workspace_packages[package_dir] for package_dir in package_dirs if workspace_packages[package_dir]],
+    )
 
 def _materialize_install_inputs(repository_ctx, package_json):
     package_root = package_json.dirname
@@ -171,6 +259,68 @@ def _select_bun_binary(repository_ctx):
 
     fail("Unsupported host platform: os={}, arch={}".format(repository_ctx.os.name, repository_ctx.os.arch))
 
+def _render_package_targets_file(package_names):
+    lines = ["NPM_PACKAGE_TARGETS = {"]
+    for package_name in package_names:
+        lines.append('    "{}": "{}",'.format(package_name, _package_target_name(package_name)))
+    lines.extend([
+        "}",
+        "",
+    ])
+    return "\n".join(lines)
+
+def _render_repo_defs_bzl(repo_name):
+    return """load(":packages.bzl", "NPM_PACKAGE_TARGETS")
+
+def package_target_name(package_name):
+    return NPM_PACKAGE_TARGETS.get(package_name)
+
+def npm_link_all_packages(name = "node_modules", imported_links = []):
+    if not native.existing_rule(name):
+        native.alias(
+            name = name,
+            actual = "@{repo_name}//:node_modules",
+        )
+
+    requested = {{}}
+    for package_name in imported_links:
+        requested[package_name] = True
+
+    for package_name, target_name in NPM_PACKAGE_TARGETS.items():
+        if imported_links and package_name not in requested:
+            continue
+        if native.existing_rule(target_name):
+            continue
+        native.alias(
+            name = target_name,
+            actual = "@{repo_name}//:%s" % target_name,
+        )
+""".format(repo_name = repo_name)
+
+def _render_repo_build(package_names):
+    lines = [
+        'exports_files(["defs.bzl", "packages.bzl"])',
+        "",
+        "filegroup(",
+        '    name = "node_modules",',
+        '    srcs = glob(["**/node_modules/**"], allow_empty = False),',
+        '    visibility = ["//visibility:public"],',
+        ")",
+        "",
+    ]
+
+    for package_name in package_names:
+        lines.extend([
+            "filegroup(",
+            '    name = "{}",'.format(_package_target_name(package_name)),
+            '    srcs = glob(["node_modules/{}/**"], allow_empty = True),'.format(package_name),
+            '    visibility = ["//visibility:public"],',
+            ")",
+            "",
+        ])
+
+    return "\n".join(lines)
+
 def _bun_install_repository_impl(repository_ctx):
     package_json = repository_ctx.path(repository_ctx.attr.package_json)
     bun_lockfile = repository_ctx.path(repository_ctx.attr.bun_lockfile)
@@ -183,16 +333,28 @@ def _bun_install_repository_impl(repository_ctx):
 
     bun_bin = _select_bun_binary(repository_ctx)
     lockfile_name = bun_lockfile.basename
+    root_manifest = json.decode(repository_ctx.read(package_json))
 
     if lockfile_name not in ["bun.lock", "bun.lockb"]:
         lockfile_name = "bun.lock"
 
-    repository_ctx.file("package.json", repository_ctx.read(package_json))
+    repository_ctx.file("package.json", _normalized_root_manifest(repository_ctx, package_json))
     repository_ctx.symlink(bun_lockfile, lockfile_name)
     _materialize_install_inputs(repository_ctx, package_json)
-    _materialize_workspace_packages(repository_ctx, package_json)
+    workspace_packages = _materialize_workspace_packages(repository_ctx, package_json)
 
     install_args = [str(bun_bin), "--bun", "install", "--frozen-lockfile", "--no-progress"]
+    if repository_ctx.attr.production:
+        install_args.append("--production")
+    for omit in repository_ctx.attr.omit:
+        install_args.extend(["--omit", omit])
+    if repository_ctx.attr.linker:
+        install_args.extend(["--linker", repository_ctx.attr.linker])
+    if repository_ctx.attr.backend:
+        install_args.extend(["--backend", repository_ctx.attr.backend])
+    if repository_ctx.attr.ignore_scripts:
+        install_args.append("--ignore-scripts")
+    install_args.extend(repository_ctx.attr.install_flags)
     if repository_ctx.attr.isolated_home:
         result = repository_ctx.execute(
             install_args,
@@ -216,15 +378,26 @@ stderr:
 """.format(result.stdout, result.stderr))
 
     repository_ctx.file(
-        "BUILD.bazel",
+        "node_modules/.rules_bun/install.json",
-        """filegroup(
+        json.encode({
-    name = "node_modules",
+            "bun_lockfile": lockfile_name,
-    srcs = glob(["**/node_modules/**"], allow_empty = False),
+            "package_json": "package.json",
-    visibility = ["//visibility:public"],
+            "workspace_package_dirs": workspace_packages.package_dirs,
-)
+        }) + "\n",
-""",
     )
 
+    package_names = {}
+    for package_name in _manifest_dependency_names(root_manifest).keys():
+        package_names[package_name] = True
+    for package_name in workspace_packages.package_names:
+        package_names[package_name] = True
+
+    sorted_package_names = sorted(package_names.keys())
+    visible_repo_name = repository_ctx.attr.visible_repo_name or repository_ctx.name
+    repository_ctx.file("packages.bzl", _render_package_targets_file(sorted_package_names))
+    repository_ctx.file("defs.bzl", _render_repo_defs_bzl(visible_repo_name))
+    repository_ctx.file("BUILD.bazel", _render_repo_build(sorted_package_names))
+
 bun_install_repository = repository_rule(
     implementation = _bun_install_repository_impl,
     attrs = {
@@ -232,6 +405,13 @@ bun_install_repository = repository_rule(
         "bun_lockfile": attr.label(mandatory = True, allow_single_file = True),
         "install_inputs": attr.label_list(allow_files = True),
         "isolated_home": attr.bool(default = True),
+        "production": attr.bool(default = False),
+        "omit": attr.string_list(),
+        "linker": attr.string(),
+        "backend": attr.string(),
+        "ignore_scripts": attr.bool(default = False),
+        "install_flags": attr.string_list(),
+        "visible_repo_name": attr.string(),
         "bun_linux_x64": attr.label(default = "@bun_linux_x64//:bun-linux-x64/bun", allow_single_file = True),
         "bun_linux_aarch64": attr.label(default = "@bun_linux_aarch64//:bun-linux-aarch64/bun", allow_single_file = True),
         "bun_darwin_x64": attr.label(default = "@bun_darwin_x64//:bun-darwin-x64/bun", allow_single_file = True),
@@ -240,7 +420,18 @@ bun_install_repository = repository_rule(
     },
 )
 
-def bun_install(name, package_json, bun_lockfile, install_inputs = [], isolated_home = True):
+def bun_install(
+        name,
+        package_json,
+        bun_lockfile,
+        install_inputs = [],
+        isolated_home = True,
+        production = False,
+        omit = [],
+        linker = "",
+        backend = "",
+        ignore_scripts = False,
+        install_flags = []):
     """Create an external repository containing installed node_modules.
 
     Args:
@@ -251,6 +442,12 @@ def bun_install(name, package_json, bun_lockfile, install_inputs = [], isolated_
                 into the install context, such as patch files or auth/config files.
             isolated_home: Whether to run Bun with HOME set to the generated
                 repository root for a more isolated install context.
+            production: Whether to omit devDependencies during install.
+            omit: Optional Bun dependency groups to omit, such as `dev` or `peer`.
+            linker: Optional Bun linker strategy, such as `isolated` or `hoisted`.
+            backend: Optional Bun install backend, such as `hardlink` or `copyfile`.
+            ignore_scripts: Whether to skip lifecycle scripts in the project manifest.
+            install_flags: Additional raw flags forwarded to `bun install`.
 
     Usage (WORKSPACE):
       bun_install(
@@ -266,4 +463,11 @@ def bun_install(name, package_json, bun_lockfile, install_inputs = [], isolated_
         bun_lockfile = bun_lockfile,
         install_inputs = install_inputs,
         isolated_home = isolated_home,
+        production = production,
+        omit = omit,
+        linker = linker,
+        backend = backend,
+        ignore_scripts = ignore_scripts,
+        install_flags = install_flags,
+        visible_repo_name = name,
     )

internal/bun_script.bzl

@@ -1,182 +1,68 @@
 """Rule for running package.json scripts with Bun."""
 
-
+load("//internal:bun_command.bzl", "append_shell_flag", "append_shell_flag_files", "append_shell_flag_value", "append_shell_flag_values", "append_shell_install_mode", "append_shell_raw_flags", "render_shell_array", "shell_quote")
-def _shell_quote(value):
+load("//internal:workspace.bzl", "create_bun_workspace_info", "render_workspace_setup", "workspace_runfiles")
-    return "'" + value.replace("'", "'\"'\"'") + "'"
 
 
 def _bun_script_impl(ctx):
     toolchain = ctx.toolchains["//bun:toolchain_type"]
     bun_bin = toolchain.bun.bun_bin
     package_json = ctx.file.package_json
+    workspace_info = create_bun_workspace_info(
+        ctx,
+        extra_files = ctx.files.data + ctx.files.preload + ctx.files.env_files + [bun_bin],
+        package_dir_hint = package_json.dirname or ".",
+        package_json = package_json,
+        primary_file = package_json,
+    )
+
+    launcher_lines = [render_shell_array("bun_args", ["--bun", "run"])]
+    append_shell_install_mode(launcher_lines, "bun_args", ctx.attr.install_mode)
+    append_shell_flag_files(launcher_lines, "bun_args", "--preload", ctx.files.preload)
+    append_shell_flag_files(launcher_lines, "bun_args", "--env-file", ctx.files.env_files)
+    append_shell_flag(launcher_lines, "bun_args", "--no-env-file", ctx.attr.no_env_file)
+    append_shell_flag(launcher_lines, "bun_args", "--smol", ctx.attr.smol)
+    append_shell_flag_values(launcher_lines, "bun_args", "--conditions", ctx.attr.conditions)
+    append_shell_flag(launcher_lines, "bun_args", "--workspaces", ctx.attr.workspaces)
+    append_shell_flag_values(launcher_lines, "bun_args", "--filter", ctx.attr.filters)
+    if ctx.attr.execution_mode == "parallel":
+        append_shell_flag(launcher_lines, "bun_args", "--parallel", True)
+    elif ctx.attr.execution_mode == "sequential":
+        append_shell_flag(launcher_lines, "bun_args", "--sequential", True)
+    append_shell_flag(launcher_lines, "bun_args", "--no-exit-on-error", ctx.attr.no_exit_on_error)
+    append_shell_flag_value(launcher_lines, "bun_args", "--shell", ctx.attr.shell)
+    append_shell_flag(launcher_lines, "bun_args", "--silent", ctx.attr.silent)
+    append_shell_raw_flags(launcher_lines, "bun_args", ctx.attr.run_flags)
+    launcher_lines.append('bun_args+=(%s)' % shell_quote(ctx.attr.script))
+    for arg in ctx.attr.args:
+        launcher_lines.append("bun_args+=(%s)" % shell_quote(arg))
+
+    command = """
+trap cleanup_runtime_workspace EXIT
+cd "${runtime_exec_dir}"
+__BUN_ARGS__
+exec "${bun_bin}" "${bun_args[@]}" "$@"
+""".replace("__BUN_ARGS__", "\n".join(launcher_lines))
 
     launcher = ctx.actions.declare_file(ctx.label.name)
     ctx.actions.write(
         output = launcher,
         is_executable = True,
-        content = """#!/usr/bin/env bash
+        content = render_workspace_setup(
-set -euo pipefail
-
-runfiles_dir="${{RUNFILES_DIR:-$0.runfiles}}"
-workspace_root="${{runfiles_dir}}/_main"
-workspace_root="$(cd "${{workspace_root}}" && pwd -P)"
-bun_bin="${{runfiles_dir}}/_main/{bun_short_path}"
-package_json="${{runfiles_dir}}/_main/{package_json_short_path}"
-package_dir="$(cd "$(dirname "${{package_json}}")" && pwd -P)"
-package_rel_dir="{package_rel_dir}"
-
-select_primary_node_modules() {{
-    local selected=""
-    local fallback=""
-    while IFS= read -r node_modules_dir; do
-        if [[ -z "${{fallback}}" ]]; then
-            fallback="${{node_modules_dir}}"
-        fi
-
-        if [[ ! -d "${{node_modules_dir}}/.bun" ]]; then
-            continue
-        fi
-
-        if [[ "${{node_modules_dir}}" != *"/runfiles/_main/"* ]]; then
-            selected="${{node_modules_dir}}"
-            break
-        fi
-
-        if [[ -z "${{selected}}" ]]; then
-            selected="${{node_modules_dir}}"
-        fi
-    done < <(find -L "${{runfiles_dir}}" -type d -name node_modules 2>/dev/null | sort)
-
-    if [[ -n "${{selected}}" ]]; then
-        echo "${{selected}}"
-    else
-        echo "${{fallback}}"
-    fi
-}}
-
-primary_node_modules="$(select_primary_node_modules)"
-
-runtime_workspace="$(mktemp -d)"
-cleanup_runtime_workspace() {{
-    rm -rf "${{runtime_workspace}}"
-}}
-trap cleanup_runtime_workspace EXIT
-
-runtime_package_dir="${{runtime_workspace}}/${{package_rel_dir}}"
-mkdir -p "${{runtime_package_dir}}"
-cp -RL "${{package_dir}}/." "${{runtime_package_dir}}/"
-
-install_repo_root=""
-if [[ -n "${{primary_node_modules}}" ]]; then
-    install_repo_root="$(dirname "${{primary_node_modules}}")"
-    ln -s "${{primary_node_modules}}" "${{runtime_workspace}}/node_modules"
-fi
-
-find_node_modules() {{
-    local dir="$1"
-    local root="$2"
-
-    while [[ "$dir" == "$root"* ]]; do
-        if [[ -d "$dir/node_modules" ]]; then
-            echo "$dir/node_modules"
-            return 0
-        fi
-
-        if [[ "$dir" == "$root" ]]; then
-            break
-        fi
-
-        dir="$(dirname "$dir")"
-    done
-
-    return 1
-}}
-
-find_install_repo_node_modules() {{
-    local repo_root="$1"
-    local rel_dir="$2"
-    local candidate="${{rel_dir}}"
-
-    while [[ -n "${{candidate}}" ]]; do
-        if [[ -d "${{repo_root}}/${{candidate}}/node_modules" ]]; then
-            echo "${{repo_root}}/${{candidate}}/node_modules"
-            return 0
-        fi
-
-        if [[ "${{candidate}}" != */* ]]; then
-            break
-        fi
-
-        candidate="${{candidate#*/}}"
-    done
-
-    if [[ -d "${{repo_root}}/node_modules" ]]; then
-        echo "${{repo_root}}/node_modules"
-        return 0
-    fi
-
-    return 1
-}}
-
-resolved_install_node_modules=""
-if [[ -n "${{install_repo_root}}" ]]; then
-    resolved_install_node_modules="$(find_install_repo_node_modules "${{install_repo_root}}" "${{package_rel_dir}}" || true)"
-fi
-
-if [[ -n "${{resolved_install_node_modules}}" ]]; then
-    rm -rf "${{runtime_package_dir}}/node_modules"
-    ln -s "${{resolved_install_node_modules}}" "${{runtime_package_dir}}/node_modules"
-else
-    resolved_node_modules="$(find_node_modules "${{runtime_package_dir}}" "${{runtime_workspace}}" || true)"
-    if [[ -n "${{resolved_node_modules}}" && "${{resolved_node_modules}}" != "${{runtime_package_dir}}/node_modules" ]]; then
-        rm -rf "${{runtime_package_dir}}/node_modules"
-        ln -s "${{resolved_node_modules}}" "${{runtime_package_dir}}/node_modules"
-    fi
-fi
-
-path_entries=()
-if [[ -d "${{runtime_package_dir}}/node_modules/.bin" ]]; then
-    path_entries+=("${{runtime_package_dir}}/node_modules/.bin")
-fi
-
-if [[ -d "${{runtime_workspace}}/node_modules/.bin" && "${{runtime_workspace}}/node_modules/.bin" != "${{runtime_package_dir}}/node_modules/.bin" ]]; then
-    path_entries+=("${{runtime_workspace}}/node_modules/.bin")
-fi
-
-if [[ ${{#path_entries[@]}} -gt 0 ]]; then
-    export PATH="$(IFS=:; echo "${{path_entries[*]}}"):${{PATH}}"
-fi
-
-working_dir="{working_dir}"
-if [[ "${{working_dir}}" == "package" ]]; then
-    cd "${{runtime_package_dir}}"
-else
-    cd "${{runtime_workspace}}"
-fi
-
-exec "${{bun_bin}}" --bun run {script} "$@"
-""".format(
             bun_short_path = bun_bin.short_path,
+            package_dir_hint = package_json.dirname or ".",
             package_json_short_path = package_json.short_path,
-            package_rel_dir = package_json.dirname,
+            primary_source_short_path = package_json.short_path,
-            working_dir = ctx.attr.working_dir,
+            install_metadata_short_path = workspace_info.install_metadata_file.short_path if workspace_info.install_metadata_file else "",
-            script = _shell_quote(ctx.attr.script),
+            working_dir_mode = ctx.attr.working_dir,
-        ),
+        ) + command,
-    )
-
-    transitive_files = []
-    if ctx.attr.node_modules:
-        transitive_files.append(ctx.attr.node_modules[DefaultInfo].files)
-
-    runfiles = ctx.runfiles(
-        files = [bun_bin, package_json] + ctx.files.data,
-        transitive_files = depset(transitive = transitive_files),
     )
 
     return [
+        workspace_info,
         DefaultInfo(
             executable = launcher,
-            runfiles = runfiles,
+            runfiles = workspace_runfiles(ctx, workspace_info, direct_files = [launcher]),
         ),
     ]
 
@@ -208,6 +94,58 @@ declared in `package.json` and expect to run from the package directory with
             allow_files = True,
             doc = "Additional runtime files required by the script.",
         ),
+        "preload": attr.label_list(
+            allow_files = True,
+            doc = "Modules to preload with `--preload` before running the script.",
+        ),
+        "env_files": attr.label_list(
+            allow_files = True,
+            doc = "Additional environment files loaded with `--env-file`.",
+        ),
+        "no_env_file": attr.bool(
+            default = False,
+            doc = "If true, disables Bun's automatic `.env` loading.",
+        ),
+        "smol": attr.bool(
+            default = False,
+            doc = "If true, enables Bun's lower-memory runtime mode.",
+        ),
+        "conditions": attr.string_list(
+            doc = "Custom package resolve conditions passed to Bun.",
+        ),
+        "install_mode": attr.string(
+            default = "disable",
+            values = ["disable", "auto", "fallback", "force"],
+            doc = "Whether Bun may auto-install missing packages while running the script.",
+        ),
+        "filters": attr.string_list(
+            doc = "Workspace package filters passed via repeated `--filter` flags.",
+        ),
+        "workspaces": attr.bool(
+            default = False,
+            doc = "If true, runs the script in all workspace packages.",
+        ),
+        "execution_mode": attr.string(
+            default = "single",
+            values = ["single", "parallel", "sequential"],
+            doc = "How Bun should execute matching workspace scripts.",
+        ),
+        "no_exit_on_error": attr.bool(
+            default = False,
+            doc = "If true, Bun keeps running other workspace scripts when one fails.",
+        ),
+        "shell": attr.string(
+            default = "",
+            values = ["", "bun", "system"],
+            doc = "Optional shell implementation for package scripts.",
+        ),
+        "silent": attr.bool(
+            default = False,
+            doc = "If true, suppresses Bun's command echo for package scripts.",
+        ),
+        "run_flags": attr.string_list(
+            doc = "Additional raw flags forwarded to `bun run` before the script name.",
+        ),
         "working_dir": attr.string(
             default = "package",
             values = ["workspace", "package"],

internal/bun_test.bzl

@@ -1,62 +1,101 @@
 """Rule for running test suites with Bun."""
 
-load("//internal:js_library.bzl", "BunSourcesInfo")
+load("//internal:bun_command.bzl", "append_shell_flag", "append_shell_flag_files", "append_shell_flag_value", "append_shell_flag_values", "append_shell_install_mode", "append_shell_raw_flags", "render_shell_array", "shell_quote")
-
+load("//internal:js_library.bzl", "collect_js_runfiles")
-
+load("//internal:workspace.bzl", "create_bun_workspace_info", "render_workspace_setup", "workspace_runfiles")
-def _shell_quote(value):
-    return "'" + value.replace("'", "'\"'\"'") + "'"
 
 
 def _bun_test_impl(ctx):
     toolchain = ctx.toolchains["//bun:toolchain_type"]
     bun_bin = toolchain.bun.bun_bin
+    primary_file = ctx.files.srcs[0]
+    dep_runfiles = [collect_js_runfiles(dep) for dep in ctx.attr.deps]
+    workspace_info = create_bun_workspace_info(
+        ctx,
+        extra_files = ctx.files.srcs + ctx.files.data + ctx.files.preload + ctx.files.env_files + [bun_bin],
+        primary_file = primary_file,
+    )
+
+    launcher_lines = [render_shell_array("bun_args", ["--bun", "test"])]
+    append_shell_install_mode(launcher_lines, "bun_args", ctx.attr.install_mode)
+    append_shell_flag_files(launcher_lines, "bun_args", "--preload", ctx.files.preload)
+    append_shell_flag_files(launcher_lines, "bun_args", "--env-file", ctx.files.env_files)
+    append_shell_flag(launcher_lines, "bun_args", "--no-env-file", ctx.attr.no_env_file)
+    append_shell_flag(launcher_lines, "bun_args", "--smol", ctx.attr.smol)
+    append_shell_flag_value(launcher_lines, "bun_args", "--timeout", str(ctx.attr.timeout_ms) if ctx.attr.timeout_ms > 0 else None)
+    append_shell_flag(launcher_lines, "bun_args", "--update-snapshots", ctx.attr.update_snapshots)
+    append_shell_flag_value(launcher_lines, "bun_args", "--rerun-each", str(ctx.attr.rerun_each) if ctx.attr.rerun_each > 0 else None)
+    append_shell_flag_value(launcher_lines, "bun_args", "--retry", str(ctx.attr.retry) if ctx.attr.retry > 0 else None)
+    append_shell_flag(launcher_lines, "bun_args", "--todo", ctx.attr.todo)
+    append_shell_flag(launcher_lines, "bun_args", "--only", ctx.attr.only)
+    append_shell_flag(launcher_lines, "bun_args", "--pass-with-no-tests", ctx.attr.pass_with_no_tests)
+    append_shell_flag(launcher_lines, "bun_args", "--concurrent", ctx.attr.concurrent)
+    append_shell_flag(launcher_lines, "bun_args", "--randomize", ctx.attr.randomize)
+    append_shell_flag_value(launcher_lines, "bun_args", "--seed", str(ctx.attr.seed) if ctx.attr.seed > 0 else None)
+    append_shell_flag_value(launcher_lines, "bun_args", "--bail", str(ctx.attr.bail) if ctx.attr.bail > 0 else None)
+    append_shell_flag_value(launcher_lines, "bun_args", "--max-concurrency", str(ctx.attr.max_concurrency) if ctx.attr.max_concurrency > 0 else None)
+    append_shell_raw_flags(launcher_lines, "bun_args", ctx.attr.test_flags)
+    launcher_lines.append('coverage_requested="0"')
+    launcher_lines.append('coverage_dir=""')
+    launcher_lines.append('if [[ "${COVERAGE_DIR:-}" != "" ]]; then')
+    launcher_lines.append('  coverage_requested="1"')
+    launcher_lines.append('  coverage_dir="${COVERAGE_DIR}"')
+    launcher_lines.append('elif [[ "%s" == "1" ]]; then' % ("1" if ctx.attr.coverage else "0"))
+    launcher_lines.append('  coverage_requested="1"')
+    launcher_lines.append('  coverage_dir="${TEST_UNDECLARED_OUTPUTS_DIR:-${runtime_workspace}/coverage}"')
+    launcher_lines.append('fi')
+    launcher_lines.append('if [[ "${coverage_requested}" == "1" ]]; then')
+    launcher_lines.append('  bun_args+=("--coverage")')
+    launcher_lines.append('  bun_args+=("--coverage-dir" "${coverage_dir}")')
+    if ctx.attr.coverage_reporters:
+        for reporter in ctx.attr.coverage_reporters:
+            launcher_lines.append('  bun_args+=("--coverage-reporter" %s)' % shell_quote(reporter))
+    else:
+        launcher_lines.append('  if [[ "${COVERAGE_DIR:-}" != "" ]]; then')
+        launcher_lines.append('    bun_args+=("--coverage-reporter" "lcov")')
+        launcher_lines.append('  fi')
+    launcher_lines.append('fi')
+    launcher_lines.append('if [[ -n "${TESTBRIDGE_TEST_ONLY:-}" ]]; then')
+    launcher_lines.append('  bun_args+=("--test-name-pattern" "${TESTBRIDGE_TEST_ONLY}")')
+    launcher_lines.append('fi')
+    if ctx.attr.reporter == "junit":
+        launcher_lines.append('reporter_out="${XML_OUTPUT_FILE:-${runtime_workspace}/junit.xml}"')
+        launcher_lines.append('bun_args+=("--reporter" "junit" "--reporter-outfile" "${reporter_out}")')
+    elif ctx.attr.reporter == "dots":
+        launcher_lines.append('bun_args+=("--reporter" "dots")')
+    for src in ctx.files.srcs:
+        launcher_lines.append("bun_args+=(%s)" % shell_quote(src.short_path))
+    for arg in ctx.attr.args:
+        launcher_lines.append("bun_args+=(%s)" % shell_quote(arg))
+
+    command = """
+trap cleanup_runtime_workspace EXIT
+cd "${runtime_workspace}"
+__BUN_ARGS__
+exec "${bun_bin}" "${bun_args[@]}" "$@"
+""".replace("__BUN_ARGS__", "\n".join(launcher_lines))
 
-    src_args = " ".join([_shell_quote(src.short_path) for src in ctx.files.srcs])
     launcher = ctx.actions.declare_file(ctx.label.name)
     ctx.actions.write(
         output = launcher,
         is_executable = True,
-        content = """#!/usr/bin/env bash
+        content = render_workspace_setup(
-set -euo pipefail
-
-runfiles_dir="${{RUNFILES_DIR:-$0.runfiles}}"
-bun_bin="${{runfiles_dir}}/_main/{bun_short_path}"
-cd "${{runfiles_dir}}/_main"
-
-if [[ -n "${{TESTBRIDGE_TEST_ONLY:-}}" && -n "${{COVERAGE_DIR:-}}" ]]; then
-    exec "${{bun_bin}}" --bun test {src_args} --test-name-pattern "${{TESTBRIDGE_TEST_ONLY}}" --coverage "$@"
-fi
-if [[ -n "${{TESTBRIDGE_TEST_ONLY:-}}" ]]; then
-    exec "${{bun_bin}}" --bun test {src_args} --test-name-pattern "${{TESTBRIDGE_TEST_ONLY}}" "$@"
-fi
-if [[ -n "${{COVERAGE_DIR:-}}" ]]; then
-    exec "${{bun_bin}}" --bun test {src_args} --coverage "$@"
-fi
-exec "${{bun_bin}}" --bun test {src_args} "$@"
-""".format(
             bun_short_path = bun_bin.short_path,
-            src_args = src_args,
+            install_metadata_short_path = workspace_info.install_metadata_file.short_path if workspace_info.install_metadata_file else "",
-        ),
+            primary_source_short_path = primary_file.short_path,
+            working_dir_mode = "workspace",
+        ) + command,
     )
-
-    transitive_files = []
-    if ctx.attr.node_modules:
-        transitive_files.append(ctx.attr.node_modules[DefaultInfo].files)
-    for dep in ctx.attr.deps:
-        if BunSourcesInfo in dep:
-            transitive_files.append(dep[BunSourcesInfo].transitive_sources)
-        else:
-            transitive_files.append(dep[DefaultInfo].files)
-
-    runfiles = ctx.runfiles(
-        files = [bun_bin] + ctx.files.srcs + ctx.files.data,
-        transitive_files = depset(transitive = transitive_files),
-    )
-
     return [
+        workspace_info,
         DefaultInfo(
             executable = launcher,
-            runfiles = runfiles,
+            runfiles = workspace_runfiles(
+                ctx,
+                workspace_info,
+                direct_files = [launcher],
+                transitive_files = dep_runfiles,
+            ),
         ),
     ]
 
@@ -83,6 +122,90 @@ Supports Bazel test filtering (`--test_filter`) and coverage integration.
             allow_files = True,
             doc = "Additional runtime files needed by tests.",
         ),
+        "preload": attr.label_list(
+            allow_files = True,
+            doc = "Modules to preload with `--preload` before running tests.",
+        ),
+        "env_files": attr.label_list(
+            allow_files = True,
+            doc = "Additional environment files loaded with `--env-file`.",
+        ),
+        "no_env_file": attr.bool(
+            default = False,
+            doc = "If true, disables Bun's automatic `.env` loading.",
+        ),
+        "smol": attr.bool(
+            default = False,
+            doc = "If true, enables Bun's lower-memory runtime mode.",
+        ),
+        "install_mode": attr.string(
+            default = "disable",
+            values = ["disable", "auto", "fallback", "force"],
+            doc = "Whether Bun may auto-install missing packages while testing.",
+        ),
+        "timeout_ms": attr.int(
+            default = 0,
+            doc = "Optional per-test timeout in milliseconds.",
+        ),
+        "update_snapshots": attr.bool(
+            default = False,
+            doc = "If true, updates Bun snapshot files.",
+        ),
+        "rerun_each": attr.int(
+            default = 0,
+            doc = "Optional number of times to rerun each test file.",
+        ),
+        "retry": attr.int(
+            default = 0,
+            doc = "Optional default retry count for all tests.",
+        ),
+        "todo": attr.bool(
+            default = False,
+            doc = "If true, includes tests marked with `test.todo()`.",
+        ),
+        "only": attr.bool(
+            default = False,
+            doc = "If true, runs only tests marked with `test.only()` or `describe.only()`.",
+        ),
+        "pass_with_no_tests": attr.bool(
+            default = False,
+            doc = "If true, exits successfully when no tests are found.",
+        ),
+        "concurrent": attr.bool(
+            default = False,
+            doc = "If true, treats all tests as concurrent tests.",
+        ),
+        "randomize": attr.bool(
+            default = False,
+            doc = "If true, runs tests in random order.",
+        ),
+        "seed": attr.int(
+            default = 0,
+            doc = "Optional randomization seed.",
+        ),
+        "bail": attr.int(
+            default = 0,
+            doc = "Optional failure count after which Bun exits the test run.",
+        ),
+        "reporter": attr.string(
+            default = "console",
+            values = ["console", "dots", "junit"],
+            doc = "Test reporter format.",
+        ),
+        "max_concurrency": attr.int(
+            default = 0,
+            doc = "Optional maximum number of concurrent tests.",
+        ),
+        "coverage": attr.bool(
+            default = False,
+            doc = "If true, always enables Bun coverage output.",
+        ),
+        "coverage_reporters": attr.string_list(
+            doc = "Repeated Bun coverage reporters such as `text` or `lcov`.",
+        ),
+        "test_flags": attr.string_list(
+            doc = "Additional raw flags forwarded to `bun test` before the test source list.",
+        ),
     },
     test = True,
     toolchains = ["//bun:toolchain_type"],

internal/js_compat.bzl

@@ -0,0 +1,29 @@
+"""rules_js-style compatibility exports backed by Bun."""
+
+load("//internal:bun_binary.bzl", _bun_binary = "bun_binary")
+load("//internal:bun_test.bzl", _bun_test = "bun_test")
+load("//internal:js_library.bzl", _JsInfo = "JsInfo", _js_library = "js_library", _ts_library = "ts_library")
+load("//internal:js_run_devserver.bzl", _js_run_devserver = "js_run_devserver")
+
+JsInfo = _JsInfo
+js_library = _js_library
+ts_library = _ts_library
+js_run_devserver = _js_run_devserver
+
+def js_binary(name, **kwargs):
+    _bun_binary(name = name, **kwargs)
+
+def js_test(name, entry_point = None, srcs = None, **kwargs):
+    if entry_point != None:
+        if srcs != None:
+            fail("js_test accepts either `entry_point` or `srcs`, but not both")
+        srcs = [entry_point]
+
+    if srcs == None:
+        fail("js_test requires `entry_point` or `srcs`")
+
+    _bun_test(
+        name = name,
+        srcs = srcs,
+        **kwargs
+    )

internal/js_library.bzl

@@ -1,23 +1,74 @@
 """Lightweight JS/TS source grouping rules."""
 
+JsInfo = provider(
+    doc = "Provides transitive JavaScript/TypeScript metadata for Bun and JS compatibility rules.",
+    fields = {
+        "sources": "Direct source files owned by this target.",
+        "transitive_sources": "Transitive source files from this target and its deps.",
+        "types": "Direct type files owned by this target.",
+        "transitive_types": "Transitive type files from this target and its deps.",
+        "data_files": "Direct runtime data files owned by this target.",
+        "transitive_runfiles": "Transitive runtime files from this target and its deps.",
+    },
+)
+
 BunSourcesInfo = provider(
     "Provides transitive sources for Bun libraries.",
     fields = ["transitive_sources"],
 )
 
+def collect_js_sources(dep):
+    if JsInfo in dep:
+        return dep[JsInfo].transitive_sources
+    if BunSourcesInfo in dep:
+        return dep[BunSourcesInfo].transitive_sources
+    return dep[DefaultInfo].files
+
+def collect_js_runfiles(dep):
+    if JsInfo in dep:
+        return dep[JsInfo].transitive_runfiles
+    if BunSourcesInfo in dep:
+        return dep[BunSourcesInfo].transitive_sources
+    return dep[DefaultInfo].files
+
 def _bun_library_impl(ctx):
-    transitive_sources = [
+    transitive_sources = [collect_js_sources(dep) for dep in ctx.attr.deps]
-        dep[BunSourcesInfo].transitive_sources
+    transitive_types = [
+        dep[JsInfo].transitive_types
         for dep in ctx.attr.deps
-        if BunSourcesInfo in dep
+        if JsInfo in dep
     ]
+    transitive_runfiles = [collect_js_runfiles(dep) for dep in ctx.attr.deps]
+
     all_sources = depset(
         direct = ctx.files.srcs,
         transitive = transitive_sources,
     )
+    all_types = depset(
+        direct = ctx.files.types,
+        transitive = transitive_types,
+    )
+    all_runfiles = depset(
+        direct = ctx.files.srcs + ctx.files.types + ctx.files.data,
+        transitive = transitive_runfiles,
+    )
+    default_files = depset(
+        direct = ctx.files.srcs + ctx.files.types + ctx.files.data,
+        transitive = transitive_sources + transitive_types + transitive_runfiles,
+    )
+
+    js_info = JsInfo(
+        sources = depset(ctx.files.srcs),
+        transitive_sources = all_sources,
+        types = depset(ctx.files.types),
+        transitive_types = all_types,
+        data_files = depset(ctx.files.data),
+        transitive_runfiles = all_runfiles,
+    )
     return [
+        js_info,
         BunSourcesInfo(transitive_sources = all_sources),
-        DefaultInfo(files = all_sources),
+        DefaultInfo(files = default_files),
     ]
 
 js_library = rule(
@@ -28,6 +79,14 @@ js_library = rule(
             allow_files = [".js", ".jsx", ".mjs", ".cjs"],
             doc = "JavaScript source files in this library.",
         ),
+        "types": attr.label_list(
+            allow_files = [".d.ts"],
+            doc = "Optional declaration files associated with this library.",
+        ),
+        "data": attr.label_list(
+            allow_files = True,
+            doc = "Optional runtime files propagated to dependents.",
+        ),
         "deps": attr.label_list(
             doc = "Other Bun source libraries to include transitively.",
         ),
@@ -42,6 +101,14 @@ ts_library = rule(
             allow_files = [".ts", ".tsx"],
             doc = "TypeScript source files in this library.",
         ),
+        "types": attr.label_list(
+            allow_files = [".d.ts"],
+            doc = "Optional declaration files associated with this library.",
+        ),
+        "data": attr.label_list(
+            allow_files = True,
+            doc = "Optional runtime files propagated to dependents.",
+        ),
         "deps": attr.label_list(
             doc = "Other Bun source libraries to include transitively.",
         ),

internal/js_run_devserver.bzl

@@ -0,0 +1,101 @@
+"""Compatibility rule for running an executable target as a dev server."""
+
+load("//internal:js_library.bzl", "collect_js_runfiles")
+load("//internal:workspace.bzl", "create_bun_workspace_info", "render_workspace_setup", "workspace_runfiles")
+
+def _shell_quote(value):
+    return "'" + value.replace("'", "'\"'\"'") + "'"
+
+def _js_run_devserver_impl(ctx):
+    toolchain = ctx.toolchains["//bun:toolchain_type"]
+    bun_bin = toolchain.bun.bun_bin
+    package_json = ctx.file.package_json
+    dep_runfiles = [collect_js_runfiles(dep) for dep in ctx.attr.deps]
+    tool_default_info = ctx.attr.tool[DefaultInfo]
+
+    workspace_info = create_bun_workspace_info(
+        ctx,
+        primary_file = package_json or tool_default_info.files_to_run.executable,
+        package_json = package_json,
+        package_dir_hint = ctx.attr.package_dir_hint,
+        extra_files = ctx.files.data + [bun_bin, tool_default_info.files_to_run.executable],
+    )
+
+    tool_workspace = ctx.attr.tool.label.workspace_name or "_main"
+    tool_path = "{}/{}".format(tool_workspace, tool_default_info.files_to_run.executable.short_path)
+    default_args = " ".join([_shell_quote(arg) for arg in ctx.attr.args])
+
+    launcher = ctx.actions.declare_file(ctx.label.name)
+    ctx.actions.write(
+        output = launcher,
+        is_executable = True,
+        content = render_workspace_setup(
+            bun_short_path = bun_bin.short_path,
+            install_metadata_short_path = workspace_info.install_metadata_file.short_path if workspace_info.install_metadata_file else "",
+            primary_source_short_path = package_json.short_path if package_json else tool_default_info.files_to_run.executable.short_path,
+            package_json_short_path = package_json.short_path if package_json else "",
+            package_dir_hint = ctx.attr.package_dir_hint,
+            working_dir_mode = ctx.attr.working_dir,
+        ) + """
+trap cleanup_runtime_workspace EXIT
+cd "${runtime_exec_dir}"
+tool="${runfiles_dir}/__TOOL_SHORT_PATH__"
+exec "${tool}" __DEFAULT_ARGS__ "$@"
+""".replace("__TOOL_SHORT_PATH__", tool_path).replace("__DEFAULT_ARGS__", default_args),
+    )
+
+    return [
+        workspace_info,
+        DefaultInfo(
+            executable = launcher,
+            runfiles = workspace_runfiles(
+                ctx,
+                workspace_info,
+                direct_files = [launcher, tool_default_info.files_to_run.executable],
+                transitive_files = dep_runfiles,
+            ).merge(tool_default_info.default_runfiles),
+        ),
+    ]
+
+js_run_devserver = rule(
+    implementation = _js_run_devserver_impl,
+    doc = """Runs an executable target from a staged JS workspace.
+
+This is a Bun-backed compatibility adapter for `rules_js`-style devserver
+targets. It stages the same runtime workspace as the Bun rules, then executes
+the provided tool with any default arguments.
+""",
+    attrs = {
+        "tool": attr.label(
+            mandatory = True,
+            executable = True,
+            cfg = "target",
+            doc = "Executable target to launch as the dev server.",
+        ),
+        "package_json": attr.label(
+            allow_single_file = True,
+            doc = "Optional package.json used to resolve the package working directory.",
+        ),
+        "package_dir_hint": attr.string(
+            default = ".",
+            doc = "Optional package-relative directory hint when package_json is not supplied.",
+        ),
+        "node_modules": attr.label(
+            doc = "Optional label providing package files from a node_modules tree, typically produced by bun_install or npm_translate_lock, in runfiles.",
+        ),
+        "deps": attr.label_list(
+            doc = "Library dependencies required by the dev server.",
+        ),
+        "data": attr.label_list(
+            allow_files = True,
+            doc = "Additional runtime files required by the dev server.",
+        ),
+        "working_dir": attr.string(
+            default = "workspace",
+            values = ["workspace", "package"],
+            doc = "Working directory at runtime: Bazel runfiles workspace root or the resolved package directory.",
+        ),
+    },
+    executable = True,
+    toolchains = ["//bun:toolchain_type"],
+)

internal/workspace.bzl

@@ -0,0 +1,776 @@
+"""Shared Bun workspace metadata and launcher helpers."""
+
+BunWorkspaceInfo = provider(
+    doc = "Workspace/runtime metadata shared by Bun rules and adapters.",
+    fields = {
+        "install_metadata_file": "Optional install metadata file from bun_install.",
+        "metadata_file": "Rule-local metadata file describing the staged workspace inputs.",
+        "node_modules_files": "Depset of node_modules files from bun_install.",
+        "package_dir_hint": "Package-relative directory when known at analysis time.",
+        "package_json": "Package manifest file when explicitly provided.",
+        "primary_file": "Primary source file used to resolve the runtime package context.",
+        "runtime_files": "Depset of runtime files required to stage the workspace.",
+    },
+)
+
+_WORKSPACE_SETUP_TEMPLATE = """#!/usr/bin/env bash
+set -euo pipefail
+
+runfiles_dir="${RUNFILES_DIR:-$0.runfiles}"
+workspace_root="${runfiles_dir}/_main"
+workspace_root="$(cd "${workspace_root}" && pwd -P)"
+bun_bin="${runfiles_dir}/_main/__BUN_SHORT_PATH__"
+primary_source=""
+if [[ -n "__PRIMARY_SOURCE_SHORT_PATH__" ]]; then
+    primary_source="${runfiles_dir}/_main/__PRIMARY_SOURCE_SHORT_PATH__"
+fi
+package_json=""
+if [[ -n "__PACKAGE_JSON_SHORT_PATH__" ]]; then
+    package_json="${runfiles_dir}/_main/__PACKAGE_JSON_SHORT_PATH__"
+fi
+package_rel_dir_hint="__PACKAGE_DIR_HINT__"
+install_root_rel_dir_hint="__INSTALL_ROOT_REL_DIR__"
+install_metadata=""
+if [[ -n "__INSTALL_METADATA_SHORT_PATH__" ]]; then
+    install_metadata="${runfiles_dir}/_main/__INSTALL_METADATA_SHORT_PATH__"
+fi
+working_dir_mode="__WORKING_DIR_MODE__"
+
+normalize_rel_dir() {
+    local value="$1"
+    if [[ -z "${value}" || "${value}" == "." ]]; then
+        echo "."
+    else
+        echo "${value#./}"
+    fi
+}
+
+dirname_rel_dir() {
+    local value
+    value="$(normalize_rel_dir "$1")"
+    if [[ "${value}" == "." || "${value}" != */* ]]; then
+        echo "."
+        return 0
+    fi
+    echo "${value%/*}"
+}
+
+first_path_component() {
+    local value
+    value="$(normalize_rel_dir "$1")"
+    if [[ "${value}" == "." ]]; then
+        echo ""
+        return 0
+    fi
+    echo "${value%%/*}"
+}
+
+rel_dir_from_abs_path() {
+    local absolute_path="$1"
+    if [[ "${absolute_path}" == "${workspace_root}" ]]; then
+        echo "."
+        return 0
+    fi
+    echo "${absolute_path#"${workspace_root}/"}"
+}
+
+find_package_rel_dir_for_path() {
+    local path="$1"
+    local dir="$1"
+    if [[ -f "${dir}" ]]; then
+        dir="$(dirname "${dir}")"
+    fi
+
+    while [[ "${dir}" == "${workspace_root}"* ]]; do
+        if [[ -f "${dir}/package.json" ]]; then
+            rel_dir_from_abs_path "${dir}"
+            return 0
+        fi
+        if [[ "${dir}" == "${workspace_root}" ]]; then
+            break
+        fi
+        dir="$(dirname "${dir}")"
+    done
+
+    rel_dir_from_abs_path "$(dirname "${path}")"
+}
+
+find_working_rel_dir_for_path() {
+    local path="$1"
+    local dir="$1"
+    if [[ -f "${dir}" ]]; then
+        dir="$(dirname "${dir}")"
+    fi
+
+    while [[ "${dir}" == "${workspace_root}"* ]]; do
+        if [[ -f "${dir}/.env" || -f "${dir}/package.json" ]]; then
+            rel_dir_from_abs_path "${dir}"
+            return 0
+        fi
+        if [[ "${dir}" == "${workspace_root}" ]]; then
+            break
+        fi
+        dir="$(dirname "${dir}")"
+    done
+
+    rel_dir_from_abs_path "$(dirname "${path}")"
+}
+
+strip_rel_prefix() {
+    local child
+    child="$(normalize_rel_dir "$1")"
+    local parent
+    parent="$(normalize_rel_dir "$2")"
+
+    if [[ "${parent}" == "." ]]; then
+        echo "${child}"
+        return 0
+    fi
+    if [[ "${child}" == "${parent}" ]]; then
+        echo "."
+        return 0
+    fi
+    if [[ "${child}" == "${parent}/"* ]]; then
+        echo "${child#"${parent}/"}"
+        return 0
+    fi
+    echo "${child}"
+}
+
+select_primary_node_modules() {
+    local selected=""
+    local fallback=""
+    while IFS= read -r node_modules_dir; do
+        if [[ -z "${fallback}" ]]; then
+            fallback="${node_modules_dir}"
+        fi
+
+        if [[ ! -d "${node_modules_dir}/.bun" ]]; then
+            continue
+        fi
+
+        if [[ "${node_modules_dir}" != *"/runfiles/_main/"* ]]; then
+            selected="${node_modules_dir}"
+            break
+        fi
+
+        if [[ -z "${selected}" ]]; then
+            selected="${node_modules_dir}"
+        fi
+    done < <(find -L "${runfiles_dir}" -type d -name node_modules 2>/dev/null | sort)
+
+    if [[ -n "${selected}" ]]; then
+        echo "${selected}"
+    else
+        echo "${fallback}"
+    fi
+}
+
+link_top_level_entries() {
+    local source_root="$1"
+    local destination_root="$2"
+    local skipped_entry="$3"
+    local entry=""
+    local entry_name=""
+
+    shopt -s dotglob nullglob
+    for entry in "${source_root}"/* "${source_root}"/.[!.]* "${source_root}"/..?*; do
+        entry_name="$(basename "${entry}")"
+        if [[ "${entry_name}" == "." || "${entry_name}" == ".." ]]; then
+            continue
+        fi
+        if [[ -n "${skipped_entry}" && "${entry_name}" == "${skipped_entry}" ]]; then
+            continue
+        fi
+        ln -s "${entry}" "${destination_root}/${entry_name}"
+    done
+    shopt -u dotglob nullglob
+}
+
+materialize_package_path() {
+    local source_root="$1"
+    local destination_root="$2"
+    local package_rel_dir
+    package_rel_dir="$(normalize_rel_dir "$3")"
+
+    if [[ "${package_rel_dir}" == "." ]]; then
+        return 0
+    fi
+
+    local source_cursor="${source_root}"
+    local destination_cursor="${destination_root}"
+    local parts=()
+    local current="${package_rel_dir}"
+
+    while [[ -n "${current}" ]]; do
+        if [[ "${current}" == */* ]]; then
+            parts+=("${current%%/*}")
+            current="${current#*/}"
+        else
+            parts+=("${current}")
+            break
+        fi
+    done
+
+    local index=0
+    while [[ ${index} -lt $((${#parts[@]} - 1)) ]]; do
+        local part="${parts[${index}]}"
+        local next_part="${parts[$((index + 1))]}"
+        source_cursor="${source_cursor}/${part}"
+        destination_cursor="${destination_cursor}/${part}"
+        mkdir -p "${destination_cursor}"
+
+        local sibling=""
+        local sibling_name=""
+        shopt -s dotglob nullglob
+        for sibling in "${source_cursor}"/* "${source_cursor}"/.[!.]* "${source_cursor}"/..?*; do
+            sibling_name="$(basename "${sibling}")"
+            if [[ "${sibling_name}" == "." || "${sibling_name}" == ".." || "${sibling_name}" == "${next_part}" ]]; then
+                continue
+            fi
+            if [[ ! -e "${destination_cursor}/${sibling_name}" ]]; then
+                ln -s "${sibling}" "${destination_cursor}/${sibling_name}"
+            fi
+        done
+        shopt -u dotglob nullglob
+        index=$((index + 1))
+    done
+
+    mkdir -p "${destination_root}/${package_rel_dir}"
+}
+
+materialize_directory_entries() {
+    local source_root="$1"
+    local destination_root="$2"
+    local entry=""
+    local entry_name=""
+
+    mkdir -p "${destination_root}"
+    shopt -s dotglob nullglob
+    for entry in "${source_root}"/* "${source_root}"/.[!.]* "${source_root}"/..?*; do
+        entry_name="$(basename "${entry}")"
+        if [[ "${entry_name}" == "." || "${entry_name}" == ".." ]]; then
+            continue
+        fi
+        rm -rf "${destination_root}/${entry_name}"
+        ln -s "${entry}" "${destination_root}/${entry_name}"
+    done
+    shopt -u dotglob nullglob
+}
+
+stage_workspace_view() {
+    local source_root="$1"
+    local destination_root="$2"
+    local package_rel_dir
+    package_rel_dir="$(normalize_rel_dir "$3")"
+    local skipped_entry
+    skipped_entry="$(first_path_component "${package_rel_dir}")"
+
+    link_top_level_entries "${source_root}" "${destination_root}" "${skipped_entry}"
+
+    if [[ "${package_rel_dir}" == "." ]]; then
+        return 0
+    fi
+
+    materialize_package_path "${source_root}" "${destination_root}" "${package_rel_dir}"
+    materialize_directory_entries "${source_root}/${package_rel_dir}" "${destination_root}/${package_rel_dir}"
+}
+
+materialize_tree_contents() {
+    local source_root="$1"
+    local destination_root="$2"
+
+    rm -rf "${destination_root}"
+    mkdir -p "${destination_root}"
+    cp -RL "${source_root}/." "${destination_root}"
+}
+
+build_workspace_package_map() {
+    local root="$1"
+    local out="$2"
+
+    python3 - "${root}" >"${out}" <<'PY'
+import json
+import os
+import sys
+
+root = os.path.abspath(sys.argv[1])
+
+for dirpath, dirnames, filenames in os.walk(root):
+    dirnames[:] = [name for name in dirnames if name != "node_modules"]
+    if "package.json" not in filenames:
+        continue
+
+    manifest_path = os.path.join(dirpath, "package.json")
+    try:
+        with open(manifest_path, "r", encoding="utf-8") as manifest_file:
+            package_name = json.load(manifest_file).get("name")
+    except Exception:
+        continue
+
+    if not isinstance(package_name, str):
+        continue
+
+    rel_dir = os.path.relpath(dirpath, root)
+    if rel_dir == ".":
+        rel_dir = "."
+    print(f"{package_name}\t{rel_dir}")
+PY
+}
+
+workspace_package_rel_dir_for_source() {
+    local source="$1"
+    local manifest_path="${source}/package.json"
+    local package_name=""
+
+    if [[ ! -f "${manifest_path}" ]]; then
+        return 1
+    fi
+
+    package_name="$(python3 - "${manifest_path}" <<'PY'
+import json
+import sys
+
+try:
+    with open(sys.argv[1], "r", encoding="utf-8") as manifest_file:
+        package_name = json.load(manifest_file).get("name", "")
+except Exception:
+    package_name = ""
+
+if isinstance(package_name, str):
+    print(package_name)
+PY
+)"
+
+    if [[ -z "${package_name}" ]]; then
+        return 1
+    fi
+
+    awk -F '\t' -v name="${package_name}" '$1 == name { print $2; exit }' "${workspace_package_map}"
+}
+
+link_node_modules_entry() {
+    local source="$1"
+    local destination="$2"
+    local workspace_rel_dir=""
+
+    rm -rf "${destination}"
+    workspace_rel_dir="$(workspace_package_rel_dir_for_source "${source}" || true)"
+    if [[ -n "${workspace_rel_dir}" ]]; then
+        ln -s "${runtime_workspace}/${workspace_rel_dir}" "${destination}"
+        return 0
+    fi
+
+    if [[ -L "${source}" ]]; then
+        ln -s "$(readlink "${source}")" "${destination}"
+    else
+        ln -s "${source}" "${destination}"
+    fi
+}
+
+mirror_node_modules_dir() {
+    local source_dir="$1"
+    local destination_dir="$2"
+    local entry=""
+    local entry_name=""
+    local scoped_entry=""
+    local scoped_name=""
+
+    rm -rf "${destination_dir}"
+    mkdir -p "${destination_dir}"
+
+    shopt -s dotglob nullglob
+    for entry in "${source_dir}"/* "${source_dir}"/.[!.]* "${source_dir}"/..?*; do
+        entry_name="$(basename "${entry}")"
+        if [[ "${entry_name}" == "." || "${entry_name}" == ".." || "${entry_name}" == ".rules_bun" ]]; then
+            continue
+        fi
+
+        if [[ -d "${entry}" && ! -L "${entry}" && "${entry_name}" == @* ]]; then
+            mkdir -p "${destination_dir}/${entry_name}"
+            for scoped_entry in "${entry}"/* "${entry}"/.[!.]* "${entry}"/..?*; do
+                scoped_name="$(basename "${scoped_entry}")"
+                if [[ "${scoped_name}" == "." || "${scoped_name}" == ".." ]]; then
+                    continue
+                fi
+                link_node_modules_entry "${scoped_entry}" "${destination_dir}/${entry_name}/${scoped_name}"
+            done
+            continue
+        fi
+
+        link_node_modules_entry "${entry}" "${destination_dir}/${entry_name}"
+    done
+    shopt -u dotglob nullglob
+}
+
+find_install_repo_node_modules() {
+    local repo_root="$1"
+    local package_rel_dir
+    package_rel_dir="$(normalize_rel_dir "$2")"
+
+    if [[ "${package_rel_dir}" != "." ]]; then
+        local candidate="${package_rel_dir}"
+        while true; do
+            if [[ -d "${repo_root}/${candidate}/node_modules" ]]; then
+                echo "${repo_root}/${candidate}/node_modules"
+                return 0
+            fi
+
+            if [[ "${candidate}" != */* ]]; then
+                break
+            fi
+            candidate="${candidate%/*}"
+        done
+    fi
+
+    if [[ -d "${repo_root}/node_modules" ]]; then
+        echo "${repo_root}/node_modules"
+        return 0
+    fi
+
+    return 1
+}
+
+mirror_install_repo_workspace_node_modules() {
+    local repo_root="$1"
+    local destination_root="$2"
+
+    while IFS= read -r install_node_modules; do
+        local rel_path="${install_node_modules#${repo_root}/}"
+        local destination="${destination_root}/${rel_path}"
+
+        mkdir -p "$(dirname "${destination}")"
+        mirror_node_modules_dir "${install_node_modules}" "${destination}"
+    done < <(find "${repo_root}" \
+        -path "${repo_root}/node_modules" -prune -o \
+        -type d -name node_modules -print 2>/dev/null | sort)
+}
+
+build_runtime_path() {
+    local workspace_dir="$1"
+    local package_dir="$2"
+    local install_root_dir="$3"
+    local entries=()
+
+    if [[ -d "${install_root_dir}/node_modules/.bin" ]]; then
+        entries+=("${install_root_dir}/node_modules/.bin")
+    fi
+    if [[ -d "${package_dir}/node_modules/.bin" ]]; then
+        if [[ "${package_dir}/node_modules/.bin" != "${install_root_dir}/node_modules/.bin" ]]; then
+            entries+=("${package_dir}/node_modules/.bin")
+        fi
+    fi
+    if [[ -d "${workspace_dir}/node_modules/.bin" && "${workspace_dir}/node_modules/.bin" != "${package_dir}/node_modules/.bin" && "${workspace_dir}/node_modules/.bin" != "${install_root_dir}/node_modules/.bin" ]]; then
+        entries+=("${workspace_dir}/node_modules/.bin")
+    fi
+    if [[ -n "${PATH:-}" ]]; then
+        entries+=("${PATH}")
+    fi
+
+    if [[ ${#entries[@]} -eq 0 ]]; then
+        echo ""
+        return 0
+    fi
+
+    local path_value=""
+    local entry=""
+    for entry in "${entries[@]}"; do
+        if [[ -z "${path_value}" ]]; then
+            path_value="${entry}"
+        else
+            path_value="${path_value}:${entry}"
+        fi
+    done
+    echo "${path_value}"
+}
+
+resolve_package_rel_dir() {
+    if [[ -n "${package_rel_dir_hint}" && "${package_rel_dir_hint}" != "." ]]; then
+        normalize_rel_dir "${package_rel_dir_hint}"
+        return 0
+    fi
+    if [[ -n "${package_json}" ]]; then
+        find_package_rel_dir_for_path "${package_json}"
+        return 0
+    fi
+    if [[ -n "${primary_source}" ]]; then
+        find_package_rel_dir_for_path "${primary_source}"
+        return 0
+    fi
+    echo "."
+}
+
+resolve_execution_rel_dir() {
+    local package_rel_dir="$1"
+    case "${working_dir_mode}" in
+        workspace)
+            echo "."
+            ;;
+        package)
+            echo "${package_rel_dir}"
+            ;;
+        entry_point)
+            if [[ -n "${primary_source}" ]]; then
+                find_working_rel_dir_for_path "${primary_source}"
+            else
+                echo "${package_rel_dir}"
+            fi
+            ;;
+        *)
+            echo "${package_rel_dir}"
+            ;;
+    esac
+}
+
+resolve_install_root_rel_dir() {
+    if [[ -n "${install_metadata}" && -f "${install_metadata}" ]]; then
+        local resolved_from_metadata=""
+        resolved_from_metadata="$(
+            python3 - "${install_metadata}" "${package_rel_dir}" <<'PY'
+import json
+import sys
+
+install_metadata_path = sys.argv[1]
+package_rel_dir = sys.argv[2]
+
+try:
+    with open(install_metadata_path, "r", encoding="utf-8") as install_metadata_file:
+        workspace_package_dirs = json.load(install_metadata_file).get("workspace_package_dirs", [])
+except Exception:
+    workspace_package_dirs = []
+
+normalized_package_rel_dir = package_rel_dir.strip("./") or "."
+matches = []
+for workspace_package_dir in workspace_package_dirs:
+    normalized_workspace_package_dir = workspace_package_dir.strip("./")
+    if not normalized_workspace_package_dir:
+        continue
+    if normalized_package_rel_dir == normalized_workspace_package_dir:
+        matches.append((len(normalized_workspace_package_dir), "."))
+        continue
+    suffix = "/" + normalized_workspace_package_dir
+    if normalized_package_rel_dir.endswith(suffix):
+        prefix = normalized_package_rel_dir[:-len(suffix)].strip("/") or "."
+        matches.append((len(normalized_workspace_package_dir), prefix))
+
+if matches:
+    matches.sort(reverse = True)
+    print(matches[0][1])
+PY
+        )"
+        if [[ -n "${resolved_from_metadata}" ]]; then
+            echo "${resolved_from_metadata}"
+            return 0
+        fi
+    fi
+    if [[ -n "${install_root_rel_dir_hint}" && "${install_root_rel_dir_hint}" != "." ]]; then
+        normalize_rel_dir "${install_root_rel_dir_hint}"
+        return 0
+    fi
+    if [[ -n "${package_json}" ]]; then
+        find_package_rel_dir_for_path "${package_json}"
+        return 0
+    fi
+    if [[ -n "${primary_source}" ]]; then
+        find_package_rel_dir_for_path "${primary_source}"
+        return 0
+    fi
+    echo "."
+}
+
+package_rel_dir="$(resolve_package_rel_dir)"
+execution_rel_dir="$(resolve_execution_rel_dir "${package_rel_dir}")"
+install_root_rel_dir="$(resolve_install_root_rel_dir)"
+package_rel_dir_in_install_root="$(strip_rel_prefix "${package_rel_dir}" "${install_root_rel_dir}")"
+
+runtime_workspace="$(mktemp -d)"
+cleanup_runtime_workspace() {
+    rm -rf "${runtime_workspace}"
+}
+
+stage_workspace_view "${workspace_root}" "${runtime_workspace}" "${package_rel_dir}"
+runtime_package_dir="${runtime_workspace}"
+if [[ "${package_rel_dir}" != "." ]]; then
+    runtime_package_dir="${runtime_workspace}/${package_rel_dir}"
+fi
+runtime_install_root="${runtime_workspace}"
+if [[ "${install_root_rel_dir}" != "." ]]; then
+    runtime_install_root="${runtime_workspace}/${install_root_rel_dir}"
+fi
+runtime_exec_dir="${runtime_workspace}"
+if [[ "${execution_rel_dir}" != "." ]]; then
+    runtime_exec_dir="${runtime_workspace}/${execution_rel_dir}"
+fi
+
+if [[ -n "${primary_source}" ]]; then
+    materialize_tree_contents "${workspace_root}/${package_rel_dir}" "${runtime_package_dir}"
+fi
+
+if [[ -n "${package_json}" ]]; then
+    materialize_tree_contents "${workspace_root}/${install_root_rel_dir}" "${runtime_install_root}"
+fi
+
+if [[ -n "${primary_source}" && "${primary_source}" == "${workspace_root}"* ]]; then
+    primary_source="${runtime_workspace}/$(rel_dir_from_abs_path "${primary_source}")"
+fi
+
+if [[ -n "${package_json}" && "${package_json}" == "${workspace_root}"* ]]; then
+    package_json="${runtime_workspace}/$(rel_dir_from_abs_path "${package_json}")"
+fi
+
+workspace_package_map="${runtime_workspace}/.rules_bun_workspace_packages.tsv"
+build_workspace_package_map "${runtime_workspace}" "${workspace_package_map}"
+
+primary_node_modules="$(select_primary_node_modules)"
+install_repo_root=""
+if [[ -n "${primary_node_modules}" ]]; then
+    install_repo_root="$(dirname "${primary_node_modules}")"
+    mkdir -p "${runtime_install_root}"
+    mirror_node_modules_dir "${primary_node_modules}" "${runtime_install_root}/node_modules"
+fi
+
+if [[ -n "${install_repo_root}" ]]; then
+    resolved_install_node_modules="$(find_install_repo_node_modules "${install_repo_root}" "${package_rel_dir_in_install_root}" || true)"
+    if [[ -n "${resolved_install_node_modules}" && "${resolved_install_node_modules}" != "${install_repo_root}/node_modules" ]]; then
+        mirror_node_modules_dir "${resolved_install_node_modules}" "${runtime_package_dir}/node_modules"
+    fi
+    mirror_install_repo_workspace_node_modules "${install_repo_root}" "${runtime_install_root}"
+fi
+
+if [[ ! -e "${runtime_package_dir}/node_modules" && -e "${runtime_install_root}/node_modules" && "${runtime_package_dir}" != "${runtime_install_root}" ]]; then
+    ln -s "${runtime_install_root}/node_modules" "${runtime_package_dir}/node_modules"
+fi
+
+runtime_path="$(build_runtime_path "${runtime_workspace}" "${runtime_package_dir}" "${runtime_install_root}")"
+if [[ -n "${runtime_path}" ]]; then
+    export PATH="${runtime_path}"
+fi
+"""
+
+def _shell_quote(value):
+    return "'" + value.replace("'", "'\"'\"'") + "'"
+
+def _dirname(path):
+    if not path or path == ".":
+        return "."
+
+    index = path.rfind("/")
+    if index < 0:
+        return "."
+    if index == 0:
+        return "/"
+    return path[:index]
+
+def find_install_metadata_file(files):
+    for file in files:
+        if file.short_path.endswith("node_modules/.rules_bun/install.json"):
+            return file
+    return None
+
+def resolve_node_modules_roots(files, workspace_dir = ""):
+    install_metadata_file = find_install_metadata_file(files)
+    shared_node_modules_root = None
+    workspace_node_modules_root = None
+
+    if install_metadata_file:
+        shared_node_modules_root = _dirname(_dirname(install_metadata_file.path))
+
+    workspace_marker = ""
+    if workspace_dir:
+        workspace_marker = "/%s/node_modules/" % workspace_dir.strip("/")
+
+    shortest_path = None
+    for src in files:
+        if workspace_marker and workspace_marker in src.path and workspace_node_modules_root == None:
+            workspace_node_modules_root = src.path[:src.path.find(workspace_marker) + len(workspace_marker) - 1]
+        if shortest_path == None or len(src.path) < len(shortest_path):
+            shortest_path = src.path
+
+    if shared_node_modules_root == None and shortest_path:
+        marker = "/node_modules/"
+        marker_index = shortest_path.find(marker)
+        if marker_index >= 0:
+            shared_node_modules_root = shortest_path[:marker_index + len("/node_modules")]
+
+    return struct(
+        install_metadata_file = install_metadata_file,
+        node_modules_root = workspace_node_modules_root or shared_node_modules_root,
+        shared_node_modules_root = shared_node_modules_root,
+    )
+
+def create_bun_workspace_info(ctx, primary_file = None, package_json = None, package_dir_hint = ".", extra_files = None):
+    direct_runtime_files = []
+    if primary_file:
+        direct_runtime_files.append(primary_file)
+    if package_json and package_json != primary_file:
+        direct_runtime_files.append(package_json)
+    direct_runtime_files.extend(extra_files or [])
+
+    node_modules_files = depset()
+    install_metadata_file = None
+    if getattr(ctx.attr, "node_modules", None):
+        node_modules_files = ctx.attr.node_modules[DefaultInfo].files
+        install_metadata_file = find_install_metadata_file(node_modules_files.to_list())
+
+    metadata_file = ctx.actions.declare_file(ctx.label.name + ".bun_workspace.json")
+    ctx.actions.write(
+        output = metadata_file,
+        content = json.encode({
+            "install_metadata": install_metadata_file.short_path if install_metadata_file else "",
+            "package_dir_hint": package_dir_hint or ".",
+            "package_json": package_json.short_path if package_json else "",
+            "primary_file": primary_file.short_path if primary_file else "",
+        }) + "\n",
+    )
+    direct_runtime_files.append(metadata_file)
+
+    runtime_files = depset(
+        direct = direct_runtime_files,
+        transitive = [node_modules_files],
+    )
+
+    return BunWorkspaceInfo(
+        install_metadata_file = install_metadata_file,
+        metadata_file = metadata_file,
+        node_modules_files = node_modules_files,
+        package_dir_hint = package_dir_hint or ".",
+        package_json = package_json,
+        primary_file = primary_file,
+        runtime_files = runtime_files,
+    )
+
+def workspace_runfiles(ctx, workspace_info, direct_files = None, transitive_files = None):
+    return ctx.runfiles(
+        files = direct_files or [],
+        transitive_files = depset(
+            transitive = [workspace_info.runtime_files] + (transitive_files or []),
+        ),
+    )
+
+def render_workspace_setup(
+        bun_short_path,
+        working_dir_mode,
+        primary_source_short_path = "",
+        package_json_short_path = "",
+        package_dir_hint = ".",
+        install_root_rel_dir = ".",
+        install_metadata_short_path = ""):
+    return _WORKSPACE_SETUP_TEMPLATE.replace("__BUN_SHORT_PATH__", bun_short_path).replace(
+        "__PRIMARY_SOURCE_SHORT_PATH__",
+        primary_source_short_path,
+    ).replace(
+        "__PACKAGE_JSON_SHORT_PATH__",
+        package_json_short_path,
+    ).replace(
+        "__PACKAGE_DIR_HINT__",
+        package_dir_hint or ".",
+    ).replace(
+        "__INSTALL_ROOT_REL_DIR__",
+        install_root_rel_dir or ".",
+    ).replace(
+        "__INSTALL_METADATA_SHORT_PATH__",
+        install_metadata_short_path,
+    ).replace(
+        "__WORKING_DIR_MODE__",
+        working_dir_mode,
+    )

js/BUILD.bazel

@@ -0,0 +1,21 @@
+load("@bazel_skylib//:bzl_library.bzl", "bzl_library")
+
+package(default_visibility = ["//visibility:public"])
+
+exports_files(["defs.bzl"])
+
+filegroup(
+    name = "repo_runtime_files",
+    srcs = [
+        "BUILD.bazel",
+        "defs.bzl",
+    ],
+    visibility = ["//visibility:public"],
+)
+
+bzl_library(
+    name = "defs_bzl",
+    srcs = ["defs.bzl"],
+    visibility = ["//visibility:public"],
+    deps = ["//internal:js_compat_bzl"],
+)

js/defs.bzl

@@ -0,0 +1,12 @@
+"""rules_js-style public API backed by Bun."""
+
+load("//internal:js_compat.bzl", _JsInfo = "JsInfo", _js_binary = "js_binary", _js_library = "js_library", _js_run_devserver = "js_run_devserver", _js_test = "js_test", _ts_library = "ts_library")
+
+visibility("public")
+
+JsInfo = _JsInfo
+js_binary = _js_binary
+js_test = _js_test
+js_run_devserver = _js_run_devserver
+js_library = _js_library
+ts_library = _ts_library

npm/BUILD.bazel

@@ -0,0 +1,32 @@
+load("@bazel_skylib//:bzl_library.bzl", "bzl_library")
+
+package(default_visibility = ["//visibility:public"])
+
+exports_files([
+    "extensions.bzl",
+    "repositories.bzl",
+])
+
+filegroup(
+    name = "repo_runtime_files",
+    srcs = [
+        "BUILD.bazel",
+        "extensions.bzl",
+        "repositories.bzl",
+    ],
+    visibility = ["//visibility:public"],
+)
+
+bzl_library(
+    name = "extensions_bzl",
+    srcs = ["extensions.bzl"],
+    visibility = ["//visibility:public"],
+    deps = ["//internal:bun_install_bzl"],
+)
+
+bzl_library(
+    name = "repositories_bzl",
+    srcs = ["repositories.bzl"],
+    visibility = ["//visibility:public"],
+    deps = ["//internal:bun_install_bzl"],
+)

npm/extensions.bzl

@@ -0,0 +1,28 @@
+load("//internal:bun_install.bzl", "bun_install_repository")
+
+_translate = tag_class(
+    attrs = {
+        "name": attr.string(mandatory = True),
+        "package_json": attr.label(mandatory = True),
+        "lockfile": attr.label(mandatory = True),
+        "install_inputs": attr.label_list(allow_files = True),
+        "isolated_home": attr.bool(default = True),
+    },
+)
+
+def _npm_translate_lock_impl(ctx):
+    for mod in ctx.modules:
+        for install in mod.tags.translate:
+            bun_install_repository(
+                name = install.name,
+                package_json = install.package_json,
+                bun_lockfile = install.lockfile,
+                install_inputs = install.install_inputs,
+                isolated_home = install.isolated_home,
+                visible_repo_name = install.name,
+            )
+
+npm_translate_lock = module_extension(
+    implementation = _npm_translate_lock_impl,
+    tag_classes = {"translate": _translate},
+)

npm/repositories.bzl

@@ -0,0 +1,11 @@
+load("//internal:bun_install.bzl", "bun_install_repository")
+
+def npm_translate_lock(name, package_json, lockfile, install_inputs = [], isolated_home = True):
+    bun_install_repository(
+        name = name,
+        package_json = package_json,
+        bun_lockfile = lockfile,
+        install_inputs = install_inputs,
+        isolated_home = isolated_home,
+        visible_repo_name = name,
+    )

result

@@ -1 +0,0 @@
-/nix/store/742k6q4hns9h1wj61y90glqwfmn2y7pa-release

tests/binary_test/.env

@@ -0,0 +1 @@
+BUN_ENV_CWD_TEST=from-dotenv

tests/binary_test/BUILD.bazel

@@ -71,3 +71,49 @@ sh_test(
     args = ["$(location :env_parent_cwd_bin)"],
     data = [":env_parent_cwd_bin"],
 )
+
+bun_binary(
+    name = "runtime_flag_bin",
+    entry_point = "flag_probe.ts",
+    args = ["one", "two"],
+    preload = ["preload.ts"],
+    env_files = ["runtime.env"],
+)
+
+sh_test(
+    name = "bun_binary_runtime_flags_test",
+    srcs = ["run_flag_binary.sh"],
+    args = ["$(location :runtime_flag_bin)"],
+    data = [":runtime_flag_bin"],
+)
+
+sh_test(
+    name = "bun_binary_runtime_flags_shape_test",
+    srcs = ["verify_runtime_flags_shape.sh"],
+    args = ["$(location :runtime_flag_bin)"],
+    data = [":runtime_flag_bin"],
+)
+
+bun_binary(
+    name = "configured_launcher_bin",
+    entry_point = "hello.ts",
+    node_modules = "@script_test_vite_node_modules//:node_modules",
+    smol = True,
+    conditions = [
+        "browser",
+        "development",
+    ],
+    install_mode = "force",
+    run_flags = [
+        "--hot",
+        "--console-depth",
+        "4",
+    ],
+)
+
+sh_test(
+    name = "bun_binary_configured_launcher_shape_test",
+    srcs = ["verify_configured_launcher_shape.sh"],
+    args = ["$(location :configured_launcher_bin)"],
+    data = [":configured_launcher_bin"],
+)

tests/binary_test/env_parent/.env

@@ -0,0 +1 @@
+BUN_ENV_PARENT_TEST=from-parent-dotenv

tests/binary_test/flag_probe.ts

@@ -0,0 +1,7 @@
+const state = globalThis as typeof globalThis & { __rules_bun_preloaded?: string };
+
+console.log(JSON.stringify({
+  preloaded: state.__rules_bun_preloaded ?? null,
+  env: process.env.RUNTIME_FLAG_TEST ?? null,
+  argv: process.argv.slice(2),
+}));

tests/binary_test/preload.ts

@@ -0,0 +1 @@
+(globalThis as typeof globalThis & { __rules_bun_preloaded?: string }).__rules_bun_preloaded = "yes";

tests/binary_test/run_binary.sh

@@ -5,7 +5,7 @@ binary="$1"
 expected="$2"
 output="$(${binary})"
 
-if [[ "${output}" != "${expected}" ]]; then
+if [[ ${output} != "${expected}" ]]; then
   echo "Unexpected output from ${binary}: ${output}" >&2
   exit 1
 fi

tests/binary_test/run_flag_binary.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+output="$(${binary})"
+
+expected='{"preloaded":"yes","env":"from-env-file","argv":["one","two"]}'
+
+if [[ ${output} != "${expected}" ]]; then
+  echo "Unexpected output from ${binary}: ${output}" >&2
+  exit 1
+fi

tests/binary_test/runtime.env

@@ -0,0 +1 @@
+RUNTIME_FLAG_TEST=from-env-file

tests/binary_test/verify_configured_launcher_shape.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+
+grep -Fq -- 'install_metadata="${runfiles_dir}/_main/' "${binary}"
+grep -Fq -- 'node_modules/.rules_bun/install.json' "${binary}"
+grep -Fq -- "--smol" "${binary}"
+grep -Fq -- "--conditions" "${binary}"
+grep -Fq -- "'browser'" "${binary}"
+grep -Fq -- "'development'" "${binary}"
+grep -Fq -- "--install" "${binary}"
+grep -Fq -- "'force'" "${binary}"
+grep -Fq -- "'--hot'" "${binary}"
+grep -Fq -- "'--console-depth'" "${binary}"
+grep -Fq -- "'4'" "${binary}"

tests/binary_test/verify_data_shape.sh

@@ -4,6 +4,6 @@ set -euo pipefail
 rule_file="$1"
 build_file="$2"
 
-grep -Eq 'files = \[bun_bin, entry_point\] \+ ctx\.files\.data' "${rule_file}"
+grep -Eq 'extra_files = ctx\.files\.data \+ ctx\.files\.preload \+ ctx\.files\.env_files \+ \[bun_bin\]' "${rule_file}"
 grep -Eq 'name = "hello_js_with_data_bin"' "${build_file}"
 grep -Eq 'data = \["payload\.txt"\]' "${build_file}"

tests/binary_test/verify_runtime_flags_shape.sh

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+
+grep -Fq -- '--no-install' "${binary}"
+grep -Fq -- '--preload' "${binary}"
+grep -Fq -- '--env-file' "${binary}"

tests/bun_test_test/BUILD.bazel

@@ -11,6 +11,32 @@ bun_test(
     srcs = ["failing.test.ts"],
 )
 
+bun_test(
+    name = "configured_suite",
+    srcs = ["passing.test.ts"],
+    preload = ["preload.ts"],
+    env_files = ["test.env"],
+    no_env_file = True,
+    timeout_ms = 250,
+    update_snapshots = True,
+    rerun_each = 2,
+    concurrent = True,
+    randomize = True,
+    seed = 7,
+    bail = 1,
+    reporter = "junit",
+    max_concurrency = 4,
+    coverage = True,
+    coverage_reporters = ["lcov"],
+    test_flags = ["--only-failures"],
+)
+
+bun_test(
+    name = "configured_retry_suite",
+    srcs = ["passing.test.ts"],
+    retry = 3,
+)
+
 sh_test(
     name = "bun_test_failing_suite_test",
     srcs = ["failing_suite_shape.sh"],
@@ -38,3 +64,16 @@ sh_test(
     args = ["$(location //internal:bun_test.bzl)"],
     data = ["//internal:bun_test.bzl"],
 )
+
+sh_test(
+    name = "bun_test_configured_suite_shape_test",
+    srcs = ["configured_suite_shape.sh"],
+    args = [
+        "$(location :configured_suite)",
+        "$(location :configured_retry_suite)",
+    ],
+    data = [
+        ":configured_suite",
+        ":configured_retry_suite",
+    ],
+)

tests/bun_test_test/cache_hit_shape.sh

@@ -3,6 +3,5 @@ set -euo pipefail
 
 rule_file="$1"
 
-grep -Fq 'set -euo pipefail' "${rule_file}"
+grep -Fq 'launcher_lines = [render_shell_array("bun_args", ["--bun", "test"])]' "${rule_file}"
-grep -Fq 'src_args = " ".join([_shell_quote(src.short_path) for src in ctx.files.srcs])' "${rule_file}"
+grep -Fq 'exec "${bun_bin}" "${bun_args[@]}" "$@"' "${rule_file}"
-grep -Fq 'exec "${{bun_bin}}" --bun test {src_args} "$@"' "${rule_file}"

tests/bun_test_test/cache_miss_shape.sh

@@ -3,5 +3,6 @@ set -euo pipefail
 
 rule_file="$1"
 
-grep -Eq 'files = \[bun_bin\] \+ ctx\.files\.srcs \+ ctx\.files\.data' "${rule_file}"
+grep -Fq 'extra_files = ctx.files.srcs + ctx.files.data + ctx.files.preload + ctx.files.env_files + [bun_bin]' "${rule_file}"
 grep -Eq '"srcs": attr\.label_list\(' "${rule_file}"
+grep -Eq '"coverage": attr\.bool\(' "${rule_file}"

tests/bun_test_test/configured_suite_shape.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+launcher="$1"
+retry_launcher="$2"
+
+grep -Fq -- '--no-install' "${launcher}"
+grep -Fq -- '--preload' "${launcher}"
+grep -Fq -- '--env-file' "${launcher}"
+grep -Fq -- '--no-env-file' "${launcher}"
+grep -Fq -- '--timeout' "${launcher}"
+grep -Fq -- '--update-snapshots' "${launcher}"
+grep -Fq -- '--rerun-each' "${launcher}"
+grep -Fq -- '--concurrent' "${launcher}"
+grep -Fq -- '--randomize' "${launcher}"
+grep -Fq -- '--seed' "${launcher}"
+grep -Fq -- '--bail' "${launcher}"
+grep -Fq -- '--max-concurrency' "${launcher}"
+grep -Fq -- '--reporter' "${launcher}"
+grep -Fq -- '--reporter-outfile' "${launcher}"
+grep -Fq -- '--coverage' "${launcher}"
+grep -Fq -- '--coverage-dir' "${launcher}"
+grep -Fq -- '--coverage-reporter' "${launcher}"
+grep -Fq -- '--retry' "${retry_launcher}"

tests/bun_test_test/junit_shape.sh

@@ -3,5 +3,5 @@ set -euo pipefail
 
 rule_file="$1"
 
-grep -Fq 'exec "${{bun_bin}}" --bun test {src_args} --test-name-pattern "${{TESTBRIDGE_TEST_ONLY}}" "$@"' "${rule_file}"
+grep -Fq 'reporter_out="${XML_OUTPUT_FILE:-${runtime_workspace}/junit.xml}"' "${rule_file}"
-grep -Fq 'if [[ -n "${{TESTBRIDGE_TEST_ONLY:-}}" ]]' "${rule_file}"
+grep -Fq 'bun_args+=("--reporter" "junit" "--reporter-outfile" "${reporter_out}")' "${rule_file}"

tests/bun_test_test/preload.ts

@@ -0,0 +1 @@
+(globalThis as typeof globalThis & { __rules_bun_test_preloaded?: boolean }).__rules_bun_test_preloaded = true;

tests/bun_test_test/test.env

@@ -0,0 +1 @@
+TEST_FROM_ENV=1

tests/bundle_test/BUILD.bazel

@@ -1,4 +1,4 @@
-load("//bun:defs.bzl", "bun_bundle")
+load("//bun:defs.bzl", "bun_build", "bun_bundle", "bun_compile")
 load("@rules_shell//shell:sh_test.bzl", "sh_test")
 
 bun_bundle(
@@ -18,6 +18,122 @@ bun_bundle(
     external = ["left-pad"],
 )
 
+bun_build(
+    name = "site_build",
+    entry_points = ["site/index.html"],
+    data = [
+        "site/main.ts",
+        "site/styles.css",
+    ],
+    splitting = True,
+)
+
+bun_build(
+    name = "site_build_with_meta",
+    entry_points = ["site/index.html"],
+    data = [
+        "site/main.ts",
+        "site/styles.css",
+    ],
+    metafile = True,
+    metafile_md = True,
+)
+
+bun_build(
+    name = "advanced_site_build",
+    tags = ["manual"],
+    entry_points = ["site/index.html"],
+    data = [
+        "site/main.ts",
+        "site/styles.css",
+    ],
+    install_mode = "fallback",
+    target = "node",
+    format = "cjs",
+    production = True,
+    splitting = True,
+    root = "tests/bundle_test/site",
+    sourcemap = "linked",
+    banner = "/* bundle banner */",
+    footer = "// bundle footer",
+    public_path = "/static/",
+    packages = "external",
+    external = [
+        "left-pad",
+        "react",
+    ],
+    entry_naming = "entries/[name]-[hash].[ext]",
+    chunk_naming = "chunks/[name]-[hash].[ext]",
+    asset_naming = "assets/[name]-[hash].[ext]",
+    minify = True,
+    minify_syntax = True,
+    minify_whitespace = True,
+    minify_identifiers = True,
+    keep_names = True,
+    css_chunking = True,
+    conditions = [
+        "browser",
+        "custom",
+    ],
+    env = "PUBLIC_*",
+    define = [
+        "process.env.NODE_ENV:\"production\"",
+        "__DEV__:false",
+    ],
+    drop = [
+        "console",
+        "debugger",
+    ],
+    feature = [
+        "react_fast_refresh",
+        "server_components",
+    ],
+    loader = [
+        ".svg:file",
+        ".txt:text",
+    ],
+    jsx_factory = "h",
+    jsx_fragment = "Fragment",
+    jsx_import_source = "preact",
+    jsx_runtime = "automatic",
+    jsx_side_effects = True,
+    react_fast_refresh = True,
+    emit_dce_annotations = True,
+    no_bundle = True,
+    build_flags = [
+        "--app",
+        "--server-components",
+    ],
+)
+
+bun_compile(
+    name = "compiled_cli",
+    entry_point = "cli.ts",
+)
+
+bun_compile(
+    name = "compiled_cli_with_flags",
+    tags = ["manual"],
+    entry_point = "cli.ts",
+    bytecode = True,
+    compile_exec_argv = [
+        "--smol",
+        "--inspect-wait",
+    ],
+    compile_executable = "fake_cross_bun.bin",
+    compile_autoload_dotenv = False,
+    compile_autoload_bunfig = False,
+    compile_autoload_tsconfig = True,
+    compile_autoload_package_json = True,
+    windows_hide_console = True,
+    windows_icon = "branding/icon.ico",
+    windows_title = "Rules Bun Test App",
+    windows_publisher = "rules_bun",
+    windows_version = "1.2.3.4",
+    windows_description = "compile flag coverage",
+    windows_copyright = "(c) rules_bun",
+)
+
 sh_test(
     name = "bundle_output_test",
     srcs = ["verify_bundle.sh"],
@@ -57,3 +173,55 @@ sh_test(
         "//tests/bundle_test:BUILD.bazel",
     ],
 )
+
+sh_test(
+    name = "bundle_sourcemap_shape_test",
+    srcs = ["verify_sourcemap_shape.sh"],
+    env_inherit = ["PATH"],
+    data = [
+        "//:repo_runtime_files",
+        "//bun:repo_runtime_files",
+        "//internal:repo_runtime_files",
+        "BUILD.bazel",
+        "//tests/bundle_test/sourcemap_case:BUILD.bazel",
+        "//tests/bundle_test/sourcemap_case:entry.ts",
+    ],
+)
+
+sh_test(
+    name = "bun_build_site_output_test",
+    srcs = ["verify_site_build.sh"],
+    args = ["$(location :site_build)"],
+    data = [":site_build"],
+)
+
+sh_test(
+    name = "bun_build_site_meta_test",
+    srcs = ["verify_site_build_meta.sh"],
+    args = ["$(locations :site_build_with_meta)"],
+    data = [":site_build_with_meta"],
+)
+
+sh_test(
+    name = "bun_compile_output_test",
+    srcs = ["run_compiled_binary.sh"],
+    args = ["$(location :compiled_cli)"],
+    data = [":compiled_cli"],
+)
+
+sh_test(
+    name = "bun_build_compile_flag_shape_test",
+    srcs = ["verify_flag_aquery.sh"],
+    env_inherit = ["PATH"],
+    data = [
+        "//:repo_runtime_files",
+        "//bun:repo_runtime_files",
+        "//internal:repo_runtime_files",
+        "BUILD.bazel",
+        "cli.ts",
+        "fake_cross_bun.bin",
+        "site/index.html",
+        "site/main.ts",
+        "site/styles.css",
+    ],
+)

tests/bundle_test/cli.ts

@@ -0,0 +1 @@
+console.log("compiled-cli");

tests/bundle_test/fake_cross_bun.bin

@@ -0,0 +1 @@
+placeholder

tests/bundle_test/out.js

@@ -0,0 +1,11 @@
+// tests/bundle_test/main.ts
+function greet(name) {
+  return `Hello ${name}`;
+}
+console.log(greet("bundle"));
+export {
+  greet
+};
+
+//# debugId=A86FEBA7FCC390B664756E2164756E21
+//# sourceMappingURL=out.js.map

tests/bundle_test/out.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["tests/bundle_test/main.ts"],
+  "sourcesContent": [
+    "export function greet(name: string): string {\n  return `Hello ${name}`;\n}\n\nconsole.log(greet(\"bundle\"));\n"
+  ],
+  "mappings": ";AAAO,SAAS,KAAK,CAAC,MAAsB;AAAA,EAC1C,OAAO,SAAS;AAAA;AAGlB,QAAQ,IAAI,MAAM,QAAQ,CAAC;",
+  "debugId": "A86FEBA7FCC390B664756E2164756E21",
+  "names": []
+}

tests/bundle_test/run_compiled_binary.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+output="$(${binary})"
+
+if [[ ${output} != "compiled-cli" ]]; then
+  echo "Unexpected output from compiled binary ${binary}: ${output}" >&2
+  exit 1
+fi

tests/bundle_test/site/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>rules_bun site build</title>
+    <link rel="stylesheet" href="./styles.css">
+  </head>
+  <body>
+    <div id="app">rules_bun</div>
+    <script type="module" src="./main.ts"></script>
+  </body>
+</html>

tests/bundle_test/site/main.ts

@@ -0,0 +1 @@
+document.getElementById("app")?.setAttribute("data-built", "yes");

tests/bundle_test/site/styles.css

@@ -0,0 +1,4 @@
+body {
+  background: #f5efe2;
+  color: #1f1b14;
+}

tests/bundle_test/sourcemap_bundle__main.js

@@ -0,0 +1,11 @@
+// ../../../../../../../Projects/rules_bun/tests/bundle_test/main.ts
+function greet(name) {
+  return `Hello ${name}`;
+}
+console.log(greet("bundle"));
+export {
+  greet
+};
+
+//# debugId=D8717FECBBDCEC7764756E2164756E21
+//# sourceMappingURL=sourcemap_bundle__main.js.map

tests/bundle_test/sourcemap_bundle__main.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../Projects/rules_bun/tests/bundle_test/main.ts"],
+  "sourcesContent": [
+    "export function greet(name: string): string {\n  return `Hello ${name}`;\n}\n\nconsole.log(greet(\"bundle\"));\n"
+  ],
+  "mappings": ";AAAO,SAAS,KAAK,CAAC,MAAsB;AAAA,EAC1C,OAAO,SAAS;AAAA;AAGlB,QAAQ,IAAI,MAAM,QAAQ,CAAC;",
+  "debugId": "D8717FECBBDCEC7764756E2164756E21",
+  "names": []
+}

tests/bundle_test/sourcemap_case/BUILD.bazel

@@ -0,0 +1,13 @@
+load("//bun:defs.bzl", "bun_bundle")
+
+exports_files([
+    "BUILD.bazel",
+    "entry.ts",
+])
+
+bun_bundle(
+    name = "sourcemap_bundle",
+    tags = ["manual"],
+    entry_points = ["entry.ts"],
+    sourcemap = True,
+)

tests/bundle_test/sourcemap_case/entry.ts

@@ -0,0 +1,3 @@
+const message: string = "sourcemap coverage";
+
+console.log(message);

tests/bundle_test/verify_bundle.sh

@@ -3,12 +3,12 @@ set -euo pipefail
 
 bundle="$1"
 
-if [[ ! -f "${bundle}" ]]; then
+if [[ ! -f ${bundle} ]]; then
   echo "Bundle output not found: ${bundle}" >&2
   exit 1
 fi
 
-if [[ ! -s "${bundle}" ]]; then
+if [[ ! -s ${bundle} ]]; then
   echo "Bundle output is empty: ${bundle}" >&2
   exit 1
 fi

tests/bundle_test/verify_external_shape.sh

@@ -4,7 +4,7 @@ set -euo pipefail
 rule_file="$1"
 build_file="$2"
 
-grep -Eq 'for package in ctx\.attr\.external:' "${rule_file}"
+grep -Eq 'add_bun_build_common_flags\(args, ctx\.attr\)' "${rule_file}"
-grep -Eq 'args\.add\("--external"\)' "${rule_file}"
+grep -Eq '"external": attr\.string_list\(' "${rule_file}"
 grep -Eq 'name = "external_bundle"' "${build_file}"
 grep -Eq 'external = \["left-pad"\]' "${build_file}"

tests/bundle_test/verify_flag_aquery.sh

@@ -0,0 +1,162 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if command -v bazel >/dev/null 2>&1; then
+  bazel_cmd=(bazel)
+elif command -v bazelisk >/dev/null 2>&1; then
+  bazel_cmd=(bazelisk)
+else
+  echo "bazel or bazelisk is required on PATH" >&2
+  exit 1
+fi
+
+find_workspace_root() {
+  local candidate
+  local module_path
+  local script_dir
+
+  for candidate in \
+    "${TEST_SRCDIR:-}/${TEST_WORKSPACE:-}" \
+    "${TEST_SRCDIR:-}/_main"; do
+    if [[ -n ${candidate} && -f "${candidate}/MODULE.bazel" ]]; then
+      printf '%s\n' "${candidate}"
+      return 0
+    fi
+  done
+
+  if [[ -n ${TEST_SRCDIR:-} ]]; then
+    module_path="$(find "${TEST_SRCDIR}" -maxdepth 3 -name MODULE.bazel -print -quit 2>/dev/null || true)"
+    if [[ -n ${module_path} ]]; then
+      dirname "${module_path}"
+      return 0
+    fi
+  fi
+
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+  candidate="$(cd "${script_dir}/../.." && pwd -P)"
+  if [[ -f "${candidate}/MODULE.bazel" ]]; then
+    printf '%s\n' "${candidate}"
+    return 0
+  fi
+
+  echo "Unable to locate rules_bun workspace root" >&2
+  exit 1
+}
+
+rules_bun_root="$(find_workspace_root)"
+
+run_aquery() {
+  local mnemonic="$1"
+  local target="$2"
+
+  (
+    cd "${rules_bun_root}" &&
+      "${bazel_cmd[@]}" aquery "mnemonic(\"${mnemonic}\", ${target})" --output=textproto
+  )
+}
+
+expect_line() {
+  local output="$1"
+  local expected="$2"
+
+  if ! grep -Fq -- "${expected}" <<<"${output}"; then
+    echo "Expected aquery output to contain: ${expected}" >&2
+    exit 1
+  fi
+}
+
+build_output="$(run_aquery "BunBuild" "//tests/bundle_test:advanced_site_build")"
+
+for expected in \
+  'arguments: "--install"' \
+  'arguments: "fallback"' \
+  'arguments: "--target"' \
+  'arguments: "node"' \
+  'arguments: "--format"' \
+  'arguments: "cjs"' \
+  'arguments: "--production"' \
+  'arguments: "--splitting"' \
+  'arguments: "--root"' \
+  'arguments: "tests/bundle_test/site"' \
+  'arguments: "--sourcemap"' \
+  'arguments: "linked"' \
+  'arguments: "--banner"' \
+  'arguments: "/* bundle banner */"' \
+  'arguments: "--footer"' \
+  'arguments: "// bundle footer"' \
+  'arguments: "--public-path"' \
+  'arguments: "/static/"' \
+  'arguments: "--packages"' \
+  'arguments: "external"' \
+  'arguments: "left-pad"' \
+  'arguments: "react"' \
+  'arguments: "--entry-naming"' \
+  'arguments: "entries/[name]-[hash].[ext]"' \
+  'arguments: "--chunk-naming"' \
+  'arguments: "chunks/[name]-[hash].[ext]"' \
+  'arguments: "--asset-naming"' \
+  'arguments: "assets/[name]-[hash].[ext]"' \
+  'arguments: "--minify"' \
+  'arguments: "--minify-syntax"' \
+  'arguments: "--minify-whitespace"' \
+  'arguments: "--minify-identifiers"' \
+  'arguments: "--keep-names"' \
+  'arguments: "--css-chunking"' \
+  'arguments: "--conditions"' \
+  'arguments: "browser"' \
+  'arguments: "custom"' \
+  'arguments: "--env"' \
+  'arguments: "PUBLIC_*"' \
+  'arguments: "process.env.NODE_ENV:\"production\""' \
+  'arguments: "__DEV__:false"' \
+  'arguments: "console"' \
+  'arguments: "debugger"' \
+  'arguments: "react_fast_refresh"' \
+  'arguments: "server_components"' \
+  'arguments: ".svg:file"' \
+  'arguments: ".txt:text"' \
+  'arguments: "--jsx-factory"' \
+  'arguments: "h"' \
+  'arguments: "--jsx-fragment"' \
+  'arguments: "Fragment"' \
+  'arguments: "--jsx-import-source"' \
+  'arguments: "preact"' \
+  'arguments: "--jsx-runtime"' \
+  'arguments: "automatic"' \
+  'arguments: "--jsx-side-effects"' \
+  'arguments: "--react-fast-refresh"' \
+  'arguments: "--emit-dce-annotations"' \
+  'arguments: "--no-bundle"' \
+  'arguments: "--app"' \
+  'arguments: "--server-components"'; do
+  expect_line "${build_output}" "${expected}"
+done
+
+compile_output="$(run_aquery "BunCompile" "//tests/bundle_test:compiled_cli_with_flags")"
+
+for expected in \
+  'arguments: "--bytecode"' \
+  'arguments: "--compile-exec-argv"' \
+  'arguments: "--smol"' \
+  'arguments: "--inspect-wait"' \
+  'arguments: "--no-compile-autoload-dotenv"' \
+  'arguments: "--no-compile-autoload-bunfig"' \
+  'arguments: "--compile-autoload-tsconfig"' \
+  'arguments: "--compile-autoload-package-json"' \
+  'arguments: "--compile-executable-path"' \
+  'arguments: "tests/bundle_test/fake_cross_bun.bin"' \
+  'arguments: "--windows-hide-console"' \
+  'arguments: "--windows-icon"' \
+  'arguments: "branding/icon.ico"' \
+  'arguments: "--windows-title"' \
+  'arguments: "Rules Bun Test App"' \
+  'arguments: "--windows-publisher"' \
+  'arguments: "rules_bun"' \
+  'arguments: "--windows-version"' \
+  'arguments: "1.2.3.4"' \
+  'arguments: "--windows-description"' \
+  'arguments: "compile flag coverage"' \
+  'arguments: "--windows-copyright"' \
+  'arguments: "(c) rules_bun"'; do
+  expect_line "${compile_output}" "${expected}"
+done

tests/bundle_test/verify_minify.sh

@@ -4,10 +4,10 @@ set -euo pipefail
 bundle="$1"
 minified="$2"
 
-bundle_size="$(wc -c < "${bundle}")"
+bundle_size="$(wc -c <"${bundle}")"
-minified_size="$(wc -c < "${minified}")"
+minified_size="$(wc -c <"${minified}")"
 
-if (( minified_size >= bundle_size )); then
+if ((minified_size >= bundle_size)); then
   echo "Expected minified bundle (${minified_size}) to be smaller than regular bundle (${bundle_size})" >&2
   exit 1
 fi

tests/bundle_test/verify_site_build.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+output_dir="$1"
+
+if [[ ! -d ${output_dir} ]]; then
+  echo "Expected output directory: ${output_dir}" >&2
+  exit 1
+fi
+
+if ! find -L "${output_dir}" -type f \( -name '*.js' -o -name '*.css' \) | grep -q .; then
+  echo "Expected Bun build assets in ${output_dir}" >&2
+  exit 1
+fi

tests/bundle_test/verify_site_build_meta.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+output_dir=""
+meta_json=""
+meta_md=""
+
+for path in "$@"; do
+  case "${path}" in
+  *.meta.json) meta_json="${path}" ;;
+  *.meta.md) meta_md="${path}" ;;
+  *) output_dir="${path}" ;;
+  esac
+done
+
+if [[ ! -d ${output_dir} ]]; then
+  echo "Expected directory output, got: ${output_dir}" >&2
+  exit 1
+fi
+
+if [[ ! -f ${meta_json} ]]; then
+  echo "Expected JSON metafile output" >&2
+  exit 1
+fi
+
+if [[ ! -f ${meta_md} ]]; then
+  echo "Expected markdown metafile output" >&2
+  exit 1
+fi

tests/bundle_test/verify_sourcemap_shape.sh

@@ -0,0 +1,60 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if command -v bazel >/dev/null 2>&1; then
+  bazel_cmd=(bazel)
+elif command -v bazelisk >/dev/null 2>&1; then
+  bazel_cmd=(bazelisk)
+else
+  echo "bazel or bazelisk is required on PATH" >&2
+  exit 1
+fi
+
+find_workspace_root() {
+  local candidate
+  local module_path
+  local script_dir
+
+  for candidate in \
+    "${TEST_SRCDIR:-}/${TEST_WORKSPACE:-}" \
+    "${TEST_SRCDIR:-}/_main"; do
+    if [[ -n ${candidate} && -f "${candidate}/MODULE.bazel" ]]; then
+      printf '%s\n' "${candidate}"
+      return 0
+    fi
+  done
+
+  if [[ -n ${TEST_SRCDIR:-} ]]; then
+    module_path="$(find "${TEST_SRCDIR}" -maxdepth 3 -name MODULE.bazel -print -quit 2>/dev/null || true)"
+    if [[ -n ${module_path} ]]; then
+      dirname "${module_path}"
+      return 0
+    fi
+  fi
+
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+  candidate="$(cd "${script_dir}/../.." && pwd -P)"
+  if [[ -f "${candidate}/MODULE.bazel" ]]; then
+    printf '%s\n' "${candidate}"
+    return 0
+  fi
+
+  echo "Unable to locate rules_bun workspace root" >&2
+  exit 1
+}
+
+rules_bun_root="$(find_workspace_root)"
+
+bundle_output="$(
+  cd "${rules_bun_root}" &&
+    "${bazel_cmd[@]}" aquery 'mnemonic("BunBundle", //tests/bundle_test/sourcemap_case:sourcemap_bundle)' --output=textproto
+)"
+
+count="$(grep -Fc 'arguments: "--sourcemap"' <<<"${bundle_output}")"
+if [[ ${count} != "1" ]]; then
+  echo "Expected bun_bundle(sourcemap = True) to emit exactly one --sourcemap flag, got ${count}" >&2
+  exit 1
+fi
+
+grep -Fq 'arguments: "--outfile"' <<<"${bundle_output}"
+grep -Fq 'arguments: "tests/bundle_test/sourcemap_case/entry.ts"' <<<"${bundle_output}"

tests/install_extension_test/BUILD.bazel

@@ -6,3 +6,10 @@ sh_test(
     args = ["$(location //bun:extensions.bzl)"],
     data = ["//bun:extensions.bzl"],
 )
+
+sh_test(
+    name = "npm_translate_lock_extension_shape_test",
+    srcs = ["npm_extension_shape_test.sh"],
+    args = ["$(location //npm:extensions.bzl)"],
+    data = ["//npm:extensions.bzl"],
+)

tests/install_extension_test/npm_extension_shape_test.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+extension_file="$1"
+
+grep -Eq 'npm_translate_lock[[:space:]]*=[[:space:]]*module_extension\(' "${extension_file}"
+grep -Eq 'tag_classes[[:space:]]*=[[:space:]]*\{"translate":[[:space:]]*_translate\}' "${extension_file}"
+grep -Eq '"name":[[:space:]]*attr\.string\(mandatory[[:space:]]*=[[:space:]]*True\)' "${extension_file}"
+grep -Eq '"package_json":[[:space:]]*attr\.label\(mandatory[[:space:]]*=[[:space:]]*True\)' "${extension_file}"
+grep -Eq '"lockfile":[[:space:]]*attr\.label\(mandatory[[:space:]]*=[[:space:]]*True\)' "${extension_file}"

tests/install_test/BUILD.bazel

@@ -102,3 +102,53 @@ sh_test(
         "//conditions:default": ["@bun_linux_x64//:bun"],
     }),
 )
+
+sh_test(
+    name = "bun_install_workspaces_catalog_test",
+    srcs = ["workspaces_catalog.sh"],
+    args = select({
+        ":linux_x86_64": ["$(location @bun_linux_x64//:bun)"],
+        ":linux_aarch64": ["$(location @bun_linux_aarch64//:bun)"],
+        ":darwin_x86_64": ["$(location @bun_darwin_x64//:bun)"],
+        ":darwin_aarch64": ["$(location @bun_darwin_aarch64//:bun)"],
+        "//conditions:default": ["$(location @bun_linux_x64//:bun)"],
+    }),
+    data = select({
+        ":linux_x86_64": ["@bun_linux_x64//:bun"],
+        ":linux_aarch64": ["@bun_linux_aarch64//:bun"],
+        ":darwin_x86_64": ["@bun_darwin_x64//:bun"],
+        ":darwin_aarch64": ["@bun_darwin_aarch64//:bun"],
+        "//conditions:default": ["@bun_linux_x64//:bun"],
+    }),
+)
+
+sh_test(
+    name = "bun_install_workspace_parity_test",
+    srcs = ["workspace_parity.sh"],
+    env_inherit = ["PATH"],
+    args = select({
+        ":linux_x86_64": ["$(location @bun_linux_x64//:bun)"],
+        ":linux_aarch64": ["$(location @bun_linux_aarch64//:bun)"],
+        ":darwin_x86_64": ["$(location @bun_darwin_x64//:bun)"],
+        ":darwin_aarch64": ["$(location @bun_darwin_aarch64//:bun)"],
+        "//conditions:default": ["$(location @bun_linux_x64//:bun)"],
+    }),
+    data = select({
+        ":linux_x86_64": ["@bun_linux_x64//:bun"],
+        ":linux_aarch64": ["@bun_linux_aarch64//:bun"],
+        ":darwin_x86_64": ["@bun_darwin_x64//:bun"],
+        ":darwin_aarch64": ["@bun_darwin_aarch64//:bun"],
+        "//conditions:default": ["@bun_linux_x64//:bun"],
+    }) + [
+        "//:repo_runtime_files",
+        "//bun:repo_runtime_files",
+        "//internal:repo_runtime_files",
+    ],
+)
+
+sh_test(
+    name = "bun_install_install_flags_shape_test",
+    srcs = ["install_flags_shape.sh"],
+    args = ["$(location //internal:bun_install.bzl)"],
+    data = ["//internal:bun_install.bzl"],
+)

tests/install_test/clean_install.sh

@@ -5,7 +5,7 @@ bun_path="$1"
 workdir="$(mktemp -d)"
 trap 'rm -rf "${workdir}"' EXIT
 
-cat > "${workdir}/package.json" <<'JSON'
+cat >"${workdir}/package.json" <<'JSON'
 {
   "name": "clean-install-test",
   "version": "1.0.0"

tests/install_test/determinism.sh

@@ -4,10 +4,11 @@ set -euo pipefail
 rule_file="$1"
 
 grep -Eq 'install", "--frozen-lockfile", "--no-progress"' "${rule_file}"
-grep -Eq 'repository_ctx\.file\("package\.json", repository_ctx\.read\(package_json\)\)' "${rule_file}"
+grep -Eq 'repository_ctx\.file\("package\.json", _normalized_root_manifest\(repository_ctx, package_json\)\)' "${rule_file}"
 grep -Eq 'lockfile_name = bun_lockfile\.basename' "${rule_file}"
 grep -Eq 'if lockfile_name not in \["bun\.lock", "bun\.lockb"\]:' "${rule_file}"
 grep -Eq 'repository_ctx\.symlink\(bun_lockfile, lockfile_name\)' "${rule_file}"
 grep -Eq 'glob\(\["\*\*/node_modules/\*\*"\]' "${rule_file}"
 grep -Eq '_DEFAULT_INSTALL_INPUTS = \[' "${rule_file}"
 grep -Eq '"install_inputs": attr\.label_list\(allow_files = True\)' "${rule_file}"
+grep -Eq '_materialize_install_inputs\(repository_ctx, package_json\)' "${rule_file}"

tests/install_test/environment_shape.sh

@@ -7,3 +7,4 @@ grep -Eq 'install_args = \[str\(bun_bin\), "--bun", "install", "--frozen-lockfil
 grep -Eq 'if repository_ctx\.attr\.isolated_home:' "${rule_file}"
 grep -Eq 'environment[[:space:]]*=[[:space:]]*\{"HOME":[[:space:]]*str\(repository_ctx\.path\("\."\)\)\}' "${rule_file}"
 grep -Eq '"isolated_home": attr\.bool\(default = True\)' "${rule_file}"
+grep -Eq '"install_flags": attr\.string_list\(\)' "${rule_file}"

tests/install_test/install_flags_shape.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+rule_file="$1"
+
+grep -Fq 'repository_ctx.attr.production' "${rule_file}"
+grep -Fq '"--production"' "${rule_file}"
+grep -Fq 'for omit in repository_ctx.attr.omit' "${rule_file}"
+grep -Fq '"--omit"' "${rule_file}"
+grep -Fq 'repository_ctx.attr.linker' "${rule_file}"
+grep -Fq '"--linker"' "${rule_file}"
+grep -Fq 'repository_ctx.attr.backend' "${rule_file}"
+grep -Fq '"--backend"' "${rule_file}"
+grep -Fq 'repository_ctx.attr.ignore_scripts' "${rule_file}"
+grep -Fq '"--ignore-scripts"' "${rule_file}"
+grep -Fq 'repository_ctx.attr.install_flags' "${rule_file}"

tests/install_test/workspace_parity.sh

@@ -3,8 +3,12 @@ set -euo pipefail
 
 bun_path="${1:-bun}"
 
-if ! command -v bazel >/dev/null 2>&1; then
+if command -v bazel >/dev/null 2>&1; then
-  echo "bazel is required on PATH" >&2
+  bazel_cmd=(bazel)
+elif command -v bazelisk >/dev/null 2>&1; then
+  bazel_cmd=(bazelisk)
+else
+  echo "bazel or bazelisk is required on PATH" >&2
   exit 1
 fi
 
@@ -199,12 +203,12 @@ chmod +x "${bazel_dir}/node_modules_smoke_test.sh"
 
 (
   cd "${bazel_dir}"
-  bazel build @node_modules//:node_modules >/dev/null
+  "${bazel_cmd[@]}" build @node_modules//:node_modules >/dev/null
-  bazel test //:node_modules_smoke_test >/dev/null
+  "${bazel_cmd[@]}" test //:node_modules_smoke_test >/dev/null
-  bazel run //:web_build -- --emptyOutDir >/dev/null
+  "${bazel_cmd[@]}" run //:web_build -- --emptyOutDir >/dev/null
 )
 
-output_base="$(cd "${bazel_dir}" && bazel info output_base)"
+output_base="$(cd "${bazel_dir}" && "${bazel_cmd[@]}" info output_base)"
 bazel_repo_dir="$(find "${output_base}/external" -maxdepth 1 -type d -name '*+node_modules' | head -n 1)"
 
 if [[ -z ${bazel_repo_dir} ]]; then
@@ -238,6 +242,8 @@ root = sys.argv[1]
 
 def include(rel):
     if rel == "node_modules" or rel.startswith("node_modules/"):
+        if rel == "node_modules/.rules_bun" or rel.startswith("node_modules/.rules_bun/"):
+            return False
         return True
     if rel.startswith("packages/") and "/node_modules" in rel:
         return True
@@ -283,6 +289,8 @@ root = sys.argv[1]
 
 def include(rel):
     if rel == "node_modules" or rel.startswith("node_modules/"):
+        if rel == "node_modules/.rules_bun" or rel.startswith("node_modules/.rules_bun/"):
+            return False
         return True
     if rel.startswith("packages/") and "/node_modules" in rel:
         return True
@@ -343,6 +351,8 @@ for dirpath, dirnames, filenames in os.walk(root, topdown=True, followlinks=Fals
     for name in dirnames + filenames:
         full = os.path.join(dirpath, name)
         rel = os.path.join(rel_dir, name) if rel_dir else name
+        if rel == ".rules_bun" or rel.startswith(".rules_bun/"):
+            continue
         st = os.lstat(full)
         mode = st.st_mode
         if stat.S_ISLNK(mode):
@@ -379,6 +389,8 @@ for dirpath, dirnames, filenames in os.walk(root, topdown=True, followlinks=Fals
     for name in dirnames + filenames:
         full = os.path.join(dirpath, name)
         rel = os.path.join(rel_dir, name) if rel_dir else name
+        if rel == ".rules_bun" or rel.startswith(".rules_bun/"):
+            continue
         st = os.lstat(full)
         mode = st.st_mode
         if stat.S_ISLNK(mode):
@@ -411,7 +423,7 @@ rm -rf "${plain_dist_dir}" "${bazel_dist_dir}"
 
 (
   cd "${bazel_dir}"
-  bazel run //:web_build -- --emptyOutDir --outDir "${bazel_dist_dir}" >/dev/null
+  "${bazel_cmd[@]}" run //:web_build -- --emptyOutDir --outDir "${bazel_dist_dir}" >/dev/null
 )
 
 if [[ ! -d ${plain_dist_dir} ]]; then

tests/install_test/workspaces_catalog.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+bun_path="$1"
+workdir="$(mktemp -d)"
+trap 'rm -rf "${workdir}"' EXIT
+
+mkdir -p "${workdir}/packages/pkg-a" "${workdir}/packages/pkg-b" "${workdir}/packages/web"
+
+cat >"${workdir}/package.json" <<'JSON'
+{
+  "name": "workspace-catalog-root",
+  "private": true,
+  "workspaces": {
+    "packages": ["packages/*"],
+    "catalog": {
+      "is-number": "7.0.0",
+      "vite": "5.4.14"
+    },
+    "catalogs": {
+      "testing": {
+        "vitest": "3.2.4"
+      }
+    }
+  }
+}
+JSON
+
+cat >"${workdir}/packages/pkg-a/package.json" <<'JSON'
+{
+  "name": "@workspace/pkg-a",
+  "version": "1.0.0",
+  "main": "index.js",
+  "dependencies": {
+    "is-number": "catalog:"
+  },
+  "scripts": {
+    "check": "bun -e \"const version = require('is-number/package.json').version; if (version !== '7.0.0') { console.error(version); process.exit(1); }\""
+  }
+}
+JSON
+
+cat >"${workdir}/packages/pkg-a/index.js" <<'JS'
+module.exports = { value: 42 };
+JS
+
+cat >"${workdir}/packages/pkg-b/package.json" <<'JSON'
+{
+  "name": "@workspace/pkg-b",
+  "version": "1.0.0",
+  "dependencies": {
+    "@workspace/pkg-a": "workspace:*",
+    "is-number": "catalog:"
+  },
+  "scripts": {
+    "check": "bun -e \"const { value } = require('@workspace/pkg-a'); const version = require('is-number/package.json').version; if (value !== 42 || version !== '7.0.0') { console.error({ value, version }); process.exit(1); }\""
+  }
+}
+JSON
+
+cat >"${workdir}/packages/web/package.json" <<'JSON'
+{
+  "name": "@workspace/web",
+  "private": true,
+  "devDependencies": {
+    "vite": "catalog:",
+    "vitest": "catalog:testing"
+  },
+  "scripts": {
+    "check": "bun -e \"const viteVersion = require('vite/package.json').version; const vitestVersion = require('vitest/package.json').version; if (viteVersion !== '5.4.14' || vitestVersion !== '3.2.4') { console.error({ viteVersion, vitestVersion }); process.exit(1); }\""
+  }
+}
+JSON
+
+"${bun_path}" install --cwd "${workdir}" >/dev/null
+rm -rf "${workdir}/node_modules" "${workdir}/packages/"*/node_modules
+"${bun_path}" install --cwd "${workdir}" --frozen-lockfile >/dev/null
+
+"${bun_path}" run --cwd "${workdir}/packages/pkg-a" check >/dev/null
+"${bun_path}" run --cwd "${workdir}/packages/pkg-b" check >/dev/null
+"${bun_path}" run --cwd "${workdir}/packages/web" check >/dev/null

tests/integration_test/BUILD.bazel

@@ -4,6 +4,7 @@ test_suite(
     name = "examples_test",
     tests = [
         ":examples_basic_run_e2e_test",
+        ":examples_basic_hot_restart_shape_test",
         ":examples_workspace_bundle_e2e_test",
         ":examples_workspace_catalog_shape_test",
         ":examples_vite_monorepo_catalog_shape_test",
@@ -31,6 +32,13 @@ sh_test(
     data = ["//examples/basic:web_dev"],
 )
 
+sh_test(
+    name = "examples_basic_hot_restart_shape_test",
+    srcs = ["examples_basic_hot_restart_shape_test.sh"],
+    args = ["$(location //examples/basic:web_dev_hot_restart)"],
+    data = ["//examples/basic:web_dev_hot_restart"],
+)
+
 sh_test(
     name = "examples_workspace_bundle_e2e_test",
     srcs = ["examples_workspace_bundle_e2e_test.sh"],

tests/integration_test/examples_basic_e2e_build_test.sh

@@ -4,6 +4,6 @@ set -euo pipefail
 build_file="$1"
 readme_file="$2"
 
-[[ -f "${build_file}" ]]
+[[ -f ${build_file} ]]
-[[ -f "${readme_file}" ]]
+[[ -f ${readme_file} ]]
 grep -Eq '^package\(default_visibility = \["//visibility:public"\]\)$' "${build_file}"

tests/integration_test/examples_basic_hot_restart_shape_test.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+
+grep -Fq -- 'watch_mode="hot"' "${binary}"
+grep -Fq -- 'bun_args+=("--hot")' "${binary}"
+grep -Fq -- '--no-clear-screen' "${binary}"
+grep -Fq -- 'if [[ 1 -eq 0 ]]; then' "${binary}"
+grep -Fq -- 'readarray -t restart_paths' "${binary}"
+grep -Fq -- 'examples/basic/README.md' "${binary}"

tests/js_compat_test/BUILD.bazel

@@ -0,0 +1,68 @@
+load("//js:defs.bzl", "js_binary", "js_run_devserver", "js_test", "ts_library")
+load("@rules_shell//shell:sh_test.bzl", "sh_test")
+
+ts_library(
+    name = "helper_lib",
+    srcs = ["helper.ts"],
+    data = ["payload.txt"],
+)
+
+js_binary(
+    name = "compat_bin",
+    entry_point = "main.ts",
+    deps = [":helper_lib"],
+    args = ["compat-mode"],
+)
+
+sh_test(
+    name = "js_binary_compat_test",
+    srcs = ["run_binary.sh"],
+    args = ["$(location :compat_bin)"],
+    data = [":compat_bin"],
+)
+
+js_test(
+    name = "compat_suite",
+    entry_point = "app.test.ts",
+    deps = [":helper_lib"],
+)
+
+js_run_devserver(
+    name = "compat_devserver",
+    tool = ":compat_bin",
+    args = ["devserver-mode"],
+)
+
+sh_test(
+    name = "js_run_devserver_compat_test",
+    srcs = ["run_devserver.sh"],
+    args = ["$(location :compat_devserver)"],
+    data = [":compat_devserver"],
+)
+
+js_run_devserver(
+    name = "compat_devserver_with_package_json",
+    tool = ":compat_bin",
+    package_json = "app/package.json",
+    working_dir = "package",
+)
+
+js_run_devserver(
+    name = "compat_devserver_with_package_dir_hint",
+    tool = ":compat_bin",
+    package_dir_hint = "app",
+    working_dir = "package",
+)
+
+sh_test(
+    name = "js_run_devserver_workspace_shape_test",
+    srcs = ["verify_workspace_shape.sh"],
+    args = [
+        "$(location :compat_devserver_with_package_json)",
+        "$(location :compat_devserver_with_package_dir_hint)",
+    ],
+    data = [
+        ":compat_devserver_with_package_json",
+        ":compat_devserver_with_package_dir_hint",
+    ],
+)

tests/js_compat_test/app.test.ts

@@ -0,0 +1,7 @@
+import { expect, test } from "bun:test";
+
+import { helperMessage } from "./helper.ts";
+
+test("js_test compatibility layer propagates deps and data", () => {
+  expect(helperMessage()).toBe("helper:payload-from-lib");
+});

tests/js_compat_test/app/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "js-compat-app",
+  "private": true
+}

tests/js_compat_test/helper.ts

@@ -0,0 +1,6 @@
+import { readFileSync } from "node:fs";
+
+export function helperMessage(): string {
+  const payload = readFileSync(new URL("./payload.txt", import.meta.url), "utf8").trim();
+  return `helper:${payload}`;
+}

tests/js_compat_test/main.ts

@@ -0,0 +1,3 @@
+import { helperMessage } from "./helper.ts";
+
+console.log(`${helperMessage()} ${Bun.argv.slice(2).join(" ")}`.trim());

tests/js_compat_test/payload.txt

@@ -0,0 +1 @@
+payload-from-lib

tests/js_compat_test/run_binary.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+output="$("${binary}")"
+
+if [[ ${output} != "helper:payload-from-lib compat-mode" ]]; then
+  echo "unexpected output: ${output}" >&2
+  exit 1
+fi

tests/js_compat_test/run_devserver.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+output="$("${binary}")"
+
+if [[ ${output} != "helper:payload-from-lib compat-mode devserver-mode" ]]; then
+  echo "unexpected output: ${output}" >&2
+  exit 1
+fi

tests/js_compat_test/verify_workspace_shape.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+package_json_launcher="$1"
+package_dir_hint_launcher="$2"
+
+grep -Fq -- 'package_json="${runfiles_dir}/_main/tests/js_compat_test/app/package.json"' "${package_json_launcher}"
+grep -Fq -- 'package_rel_dir_hint="."' "${package_json_launcher}"
+grep -Fq -- 'working_dir_mode="package"' "${package_json_launcher}"
+
+grep -Fq -- 'package_json=""' "${package_dir_hint_launcher}"
+grep -Fq -- 'package_rel_dir_hint="app"' "${package_dir_hint_launcher}"
+grep -Fq -- 'working_dir_mode="package"' "${package_dir_hint_launcher}"

tests/library_test/verify_bundle.sh

@@ -3,7 +3,7 @@ set -euo pipefail
 
 bundle="$1"
 
-if [[ ! -s "${bundle}" ]]; then
+if [[ ! -s ${bundle} ]]; then
   echo "Expected bundled output to exist and be non-empty: ${bundle}" >&2
   exit 1
 fi

tests/npm_compat_test/BUILD.bazel

@@ -0,0 +1,59 @@
+load("@rules_shell//shell:sh_test.bzl", "sh_test")
+
+config_setting(
+    name = "linux_x86_64",
+    constraint_values = [
+        "@platforms//os:linux",
+        "@platforms//cpu:x86_64",
+    ],
+)
+
+config_setting(
+    name = "linux_aarch64",
+    constraint_values = [
+        "@platforms//os:linux",
+        "@platforms//cpu:aarch64",
+    ],
+)
+
+config_setting(
+    name = "darwin_x86_64",
+    constraint_values = [
+        "@platforms//os:macos",
+        "@platforms//cpu:x86_64",
+    ],
+)
+
+config_setting(
+    name = "darwin_aarch64",
+    constraint_values = [
+        "@platforms//os:macos",
+        "@platforms//cpu:aarch64",
+    ],
+)
+
+sh_test(
+    name = "npm_translate_lock_workspace_test",
+    srcs = ["npm_translate_lock_workspace_test.sh"],
+    env_inherit = ["PATH"],
+    args = select({
+        ":linux_x86_64": ["$(location @bun_linux_x64//:bun)"],
+        ":linux_aarch64": ["$(location @bun_linux_aarch64//:bun)"],
+        ":darwin_x86_64": ["$(location @bun_darwin_x64//:bun)"],
+        ":darwin_aarch64": ["$(location @bun_darwin_aarch64//:bun)"],
+        "//conditions:default": ["$(location @bun_linux_x64//:bun)"],
+    }),
+    data = select({
+        ":linux_x86_64": ["@bun_linux_x64//:bun"],
+        ":linux_aarch64": ["@bun_linux_aarch64//:bun"],
+        ":darwin_x86_64": ["@bun_darwin_x64//:bun"],
+        ":darwin_aarch64": ["@bun_darwin_aarch64//:bun"],
+        "//conditions:default": ["@bun_linux_x64//:bun"],
+    }) + [
+        "//:repo_runtime_files",
+        "//bun:repo_runtime_files",
+        "//internal:repo_runtime_files",
+        "//js:repo_runtime_files",
+        "//npm:repo_runtime_files",
+    ],
+)