chore(release): v0.1.0

.direnv/bin/nix-direnv-reload

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -e
+if [[ ! -d "/Users/eric/Projects/rules_bun" ]]; then
+  echo "Cannot find source directory; Did you move it?"
+  echo "(Looking for "/Users/eric/Projects/rules_bun")"
+  echo 'Cannot force reload with this script - use "direnv reload" manually and then try again'
+  exit 1
+fi
+
+# rebuild the cache forcefully
+_nix_direnv_force_reload=1 direnv exec "/Users/eric/Projects/rules_bun" true
+
+# Update the mtime for .envrc.
+# This will cause direnv to reload again - but without re-building.
+touch "/Users/eric/Projects/rules_bun/.envrc"
+
+# Also update the timestamp of whatever profile_rc we have.
+# This makes sure that we know we are up to date.
+touch -r "/Users/eric/Projects/rules_bun/.envrc" "/Users/eric/Projects/rules_bun/.direnv"/*.rc

.direnv/flake-inputs/7f0478ddr51i3r708dpkljnvmzwc2fhn-source

@@ -0,0 +1 @@
+/nix/store/7f0478ddr51i3r708dpkljnvmzwc2fhn-source

.direnv/flake-inputs/affmc6lhad8f6q3iaa3iydcdjwr8lwgp-source

@@ -0,0 +1 @@
+/nix/store/affmc6lhad8f6q3iaa3iydcdjwr8lwgp-source

.direnv/flake-inputs/arl2vkxnjyw2zri2g2v6g4k6x165iidj-source

@@ -0,0 +1 @@
+/nix/store/arl2vkxnjyw2zri2g2v6g4k6x165iidj-source

.direnv/flake-inputs/g5v3sgqy6a0fsmas7mnapc196flrplix-source

@@ -0,0 +1 @@
+/nix/store/g5v3sgqy6a0fsmas7mnapc196flrplix-source

.direnv/flake-inputs/jzfmmjnq1cip816awnliw7ir69pcyg00-source

@@ -0,0 +1 @@
+/nix/store/jzfmmjnq1cip816awnliw7ir69pcyg00-source

.direnv/flake-inputs/kx00h535s3jzb9803vnylxllij3zhix5-source

@@ -0,0 +1 @@
+/nix/store/kx00h535s3jzb9803vnylxllij3zhix5-source

.direnv/flake-inputs/ngdfag0pfs1h54pbjs9ywah4zhqsphf1-source

@@ -0,0 +1 @@
+/nix/store/ngdfag0pfs1h54pbjs9ywah4zhqsphf1-source

.direnv/flake-inputs/nk13680f34w3q01a1q69c48my6fi7cxz-source

@@ -0,0 +1 @@
+/nix/store/nk13680f34w3q01a1q69c48my6fi7cxz-source

.direnv/flake-profile-a5d5b61aa8a61b7d9d765e1daf971a9a578f1cfa

@@ -0,0 +1 @@
+/nix/store/khk85hba90fc8fa8h8b920qqry6nz0qw-nix-shell-env

.github/workflows/ci.yml

@@ -5,6 +5,10 @@ on:
     branches: ["main"]
   pull_request:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   test:
     permissions:
@@ -25,6 +29,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: bazel-contrib/setup-bazel@0.15.0
+        with:
+          bazelisk-cache: true
+          repository-cache: true
+          external-cache: true
+          disk-cache: ci-${{ matrix.phase8_target }}
+          cache-save: ${{ github.event_name != 'pull_request' }}
       - name: Run tests (${{ matrix.phase8_target }})
         run: |
           echo "Phase 8 target: ${{ matrix.phase8_target }}"

.github/workflows/pages.yml

@@ -3,6 +3,11 @@ name: Docs Pages
 on:
   push:
     branches: ["main"]
+    paths:
+      - "docs/**"
+      - "bun/**/*.bzl"
+      - "internal/**/*.bzl"
+      - ".github/workflows/pages.yml"
   workflow_dispatch:
 
 permissions:
@@ -26,6 +31,11 @@ jobs:
       - uses: actions/checkout@v4
 
       - uses: bazel-contrib/setup-bazel@0.15.0
+        with:
+          bazelisk-cache: true
+          repository-cache: true
+          external-cache: true
+          disk-cache: docs-pages
 
       - name: Generate rule docs
         run: |

.pre-commit-config.yaml

@@ -0,0 +1 @@
+/nix/store/mgb6bn9dy5bpczkl81jp4r03bplwfd8w-pre-commit-config.json

MODULE.bazel

@@ -1,6 +1,6 @@
 module(
     name = "rules_bun",
-    version = "0.0.8",
+    version = "0.1.0",
 )
 
 bazel_dep(name = "platforms", version = "1.0.0")

README.md

@@ -17,24 +17,24 @@ These steps show how to consume a tagged release of `rules_bun` in a separate Ba
 In your project's `MODULE.bazel`, add:
 
 ```starlark
-bazel_dep(name = "rules_bun", version = "0.0.8")
+bazel_dep(name = "rules_bun", version = "0.1.0")
 
 archive_override(
 	module_name = "rules_bun",
 	urls = ["https://github.com/Eriyc/rules_bun/archiv0.0.5.tar.gz"],
-	strip_prefix = "rules_bun-v0.0.8",
+	strip_prefix = "rules_bun-v0.1.0",
 )
 ```
 
-For channel/pre-release tags (for example `v0.0.8-rc.1`), use the matching folder prefix:
+For channel/pre-release tags (for example `v0.1.0-rc.1`), use the matching folder prefix:
 
 ```starlark
-bazel_dep(name = "rules_bun", version = "0.0.8-rc.1")
+bazel_dep(name = "rules_bun", version = "0.1.0-rc.1")
 
 archive_override(
 	module_name = "rules_bun",
 	urls = ["https://github.com/Eriyc/rules_bun/archiv0.0.5-rc.1.tar.gz"],
-	strip_prefix = "rules_bun-v0.0.8-rc.1",
+	strip_prefix = "rules_bun-v0.1.0-rc.1",
 )
 ```
 
@@ -79,6 +79,7 @@ load(
 	"bun_binary",
 	"bun_bundle",
 	"bun_dev",
+	"bun_script",
 	"bun_test",
 	"js_library",
 	"ts_library",
@@ -111,6 +112,36 @@ bazel test //path/to:your_bun_test
 
 All `rules_bun` rule-driven Bun invocations pass `--bun`.
 
+## Package scripts (`bun_script`)
+
+Use `bun_script` to expose a `package.json` script as a Bazel executable target.
+
+```starlark
+load("@rules_bun//bun:defs.bzl", "bun_script")
+
+bun_script(
+	name = "web_dev",
+	script = "dev",
+	package_json = "package.json",
+	node_modules = "@npm//:node_modules",
+	data = glob([
+		"src/**",
+		"static/**",
+		"vite.config.*",
+		"svelte.config.*",
+		"tsconfig*.json",
+	]),
+)
+```
+
+Run it with:
+
+```bash
+bazel run //path/to:web_dev -- --host
+```
+
+`bun_script` defaults to running from the directory containing `package.json`, which matches the usual expectations for `vite`, `svelte-kit`, and similar package scripts.
+
 ## Development mode (`bun_dev`)
 
 Use `bun_dev` for long-running local development with Bun watch mode.

VERSION

@@ -1,3 +1,3 @@
-0.0.8
+0.1.0
 stable
 0

bun/BUILD.bazel

@@ -22,6 +22,7 @@ bzl_library(
         "//internal:bun_binary_bzl",
         "//internal:bun_bundle_bzl",
         "//internal:bun_dev_bzl",
+        "//internal:bun_script_bzl",
         "//internal:bun_test_bzl",
         "//internal:js_library_bzl",
     ],

bun/defs.bzl

@@ -2,6 +2,7 @@
 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_library.bzl", _js_library = "js_library", _ts_library = "ts_library")
 load(":toolchain.bzl", _BunToolchainInfo = "BunToolchainInfo", _bun_toolchain = "bun_toolchain")
@@ -11,6 +12,7 @@ visibility("public")
 bun_binary = _bun_binary
 bun_bundle = _bun_bundle
 bun_dev = _bun_dev
+bun_script = _bun_script
 bun_test = _bun_test
 js_library = _js_library
 ts_library = _ts_library

docs/BUILD.bazel

@@ -10,6 +10,7 @@ stardoc(
         "bun_binary",
         "bun_bundle",
         "bun_dev",
+        "bun_script",
         "bun_test",
         "js_library",
         "ts_library",

docs/rules.md

@@ -26,6 +26,18 @@ Attributes:
 - `data` (label_list, optional): additional runtime files for dev process.
 - `working_dir` (string, default: `"workspace"`, values: `"workspace" | "entry_point"`): runtime working directory.
 
+## bun_script
+
+Runs a named `package.json` script with Bun as an executable target (`bazel run`).
+
+Attributes:
+
+- `script` (string, required): package script name passed to `bun run <script>`.
+- `package_json` (label, required): `package.json` file containing the named script.
+- `node_modules` (label, optional): Bun/npm package files in runfiles.
+- `data` (label_list, optional): additional runtime files for the script.
+- `working_dir` (string, default: `"package"`, values: `"workspace" | "package"`): runtime working directory.
+
 ## bun_bundle
 
 Bundles one or more JS/TS entry points with Bun build.

internal/BUILD.bazel

@@ -7,6 +7,7 @@ exports_files([
     "bun_bundle.bzl",
     "bun_dev.bzl",
     "bun_install.bzl",
+    "bun_script.bzl",
     "bun_test.bzl",
     "js_library.bzl",
 ])
@@ -27,6 +28,11 @@ bzl_library(
     srcs = ["bun_dev.bzl"],
 )
 
+bzl_library(
+    name = "bun_script_bzl",
+    srcs = ["bun_script.bzl"],
+)
+
 bzl_library(
     name = "bun_test_bzl",
     srcs = ["bun_test.bzl"],

internal/bun_install.bzl

@@ -19,7 +19,6 @@ def _select_bun_binary(repository_ctx):
 
     fail("Unsupported host platform: os={}, arch={}".format(repository_ctx.os.name, repository_ctx.os.arch))
 
-
 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)
@@ -60,7 +59,6 @@ stderr:
 """,
     )
 
-
 bun_install_repository = repository_rule(
     implementation = _bun_install_repository_impl,
     attrs = {
@@ -74,9 +72,6 @@ bun_install_repository = repository_rule(
     },
 )
 
-_bun_install_repository = bun_install_repository
-
-
 def bun_install(name, package_json, bun_lockfile):
     """Create an external repository containing installed node_modules.
 

internal/bun_script.bzl

@@ -0,0 +1,91 @@
+"""Rule for running package.json scripts with Bun."""
+
+
+def _shell_quote(value):
+    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
+
+    launcher = ctx.actions.declare_file(ctx.label.name)
+    ctx.actions.write(
+        output = launcher,
+        is_executable = True,
+        content = """#!/usr/bin/env bash
+set -euo pipefail
+
+runfiles_dir="${{RUNFILES_DIR:-$0.runfiles}}"
+workspace_root="${{runfiles_dir}}/_main"
+bun_bin="${{runfiles_dir}}/_main/{bun_short_path}"
+package_json="${{runfiles_dir}}/_main/{package_json_short_path}"
+package_dir="$(dirname "${{package_json}}")"
+
+working_dir="{working_dir}"
+if [[ "${{working_dir}}" == "package" ]]; then
+    cd "${{package_dir}}"
+else
+    cd "${{workspace_root}}"
+fi
+
+exec "${{bun_bin}}" --bun run {script} "$@"
+""".format(
+            bun_short_path = bun_bin.short_path,
+            package_json_short_path = package_json.short_path,
+            working_dir = ctx.attr.working_dir,
+            script = _shell_quote(ctx.attr.script),
+        ),
+    )
+
+    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 [
+        DefaultInfo(
+            executable = launcher,
+            runfiles = runfiles,
+        ),
+    ]
+
+
+bun_script = rule(
+    implementation = _bun_script_impl,
+    doc = """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.
+""",
+    attrs = {
+        "script": attr.string(
+            mandatory = True,
+            doc = "Name of the `package.json` script to execute via `bun run <script>`.",
+        ),
+        "package_json": attr.label(
+            mandatory = True,
+            allow_single_file = True,
+            doc = "Label of the `package.json` file containing the named script.",
+        ),
+        "node_modules": attr.label(
+            doc = "Optional label providing Bun/npm package files in runfiles.",
+        ),
+        "data": attr.label_list(
+            allow_files = True,
+            doc = "Additional runtime files required by the script.",
+        ),
+        "working_dir": attr.string(
+            default = "package",
+            values = ["workspace", "package"],
+            doc = "Working directory at runtime: Bazel runfiles `workspace` root or the directory containing `package.json`.",
+        ),
+    },
+    executable = True,
+    toolchains = ["//bun:toolchain_type"],
+)

internal/js_library.bzl

@@ -1,7 +1,9 @@
 """Lightweight JS/TS source grouping rules."""
 
-BunSourcesInfo = provider(fields = ["transitive_sources"])
-
+BunSourcesInfo = provider(
+    "Provides transitive sources for Bun libraries.",
+    fields = ["transitive_sources"],
+)
 
 def _bun_library_impl(ctx):
     transitive_sources = [
@@ -18,7 +20,6 @@ def _bun_library_impl(ctx):
         DefaultInfo(files = all_sources),
     ]
 
-
 js_library = rule(
     implementation = _bun_library_impl,
     doc = "Aggregates JavaScript sources and transitive Bun source dependencies.",

tests/script_test/BUILD.bazel

@@ -0,0 +1,33 @@
+load("//bun:defs.bzl", "bun_script")
+load("@rules_shell//shell:sh_test.bzl", "sh_test")
+
+bun_script(
+    name = "hello_script",
+    script = "hello",
+    package_json = "package.json",
+    data = ["hello.ts"],
+)
+
+sh_test(
+    name = "bun_script_ts_test",
+    srcs = ["run_script.sh"],
+    args = ["$(location :hello_script)", "hello-script"],
+    data = [":hello_script"],
+)
+
+bun_script(
+    name = "env_script",
+    script = "print-env",
+    package_json = "package.json",
+    data = [
+        ".env",
+        "env.ts",
+    ],
+)
+
+sh_test(
+    name = "bun_script_package_cwd_test",
+    srcs = ["run_env_script.sh"],
+    args = ["$(location :env_script)"],
+    data = [":env_script"],
+)

tests/script_test/env.ts

@@ -0,0 +1,2 @@
+const value = process.env.BUN_SCRIPT_ENV_TEST ?? "missing";
+console.log(value);

tests/script_test/hello.ts

@@ -0,0 +1 @@
+console.log("hello-script");

tests/script_test/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "script-test",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "hello": "bun ./hello.ts",
+    "print-env": "bun ./env.ts"
+  }
+}

tests/script_test/run_env_script.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+binary="$1"
+output="$(${binary})"
+
+if [[ ${output} != "from-dotenv" ]]; then
+  echo "Expected .env value from package directory, got: ${output}" >&2
+  exit 1
+fi

tests/script_test/run_script.sh

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