Files
bun.sh/src/bun.js/bindings/ExposeNodeModuleGlobals.cpp
robobun fa3a30f075 feat(repl): implement native Zig REPL with full TUI support (#26304)
## Summary

This PR implements a native Zig REPL for Bun with full TUI (Text User
Interface) support, providing a modern and feature-rich interactive
experience.

### Features

- **Syntax highlighting** using `QuickAndDirtySyntaxHighlighter` for
colorized JavaScript code
- **Full line editing** with Emacs-style keybindings:
  - `Ctrl+A/E` - Move to start/end of line
  - `Ctrl+B/F` - Move backward/forward one character
  - `Ctrl+K/U` - Kill to end/start of line
  - `Ctrl+W` - Delete word backward
  - `Ctrl+L` - Clear screen
  - Arrow keys for cursor movement
- **Persistent history** with file storage (`~/.bun_repl_history`)
  - Up/Down arrow for history navigation
  - `Ctrl+P/N` also works for history
- **Tab completion** for properties and commands
- **Multi-line input support** with automatic continuation detection
- **REPL commands**: `.help`, `.exit`, `.clear`, `.load`, `.save`,
`.editor`
- **Special variables**:
  - `_` - Contains the result of the last expression
  - `_error` - Contains the last error that occurred
- **Result formatting** with `util.inspect` integration
- **replMode transforms** for proper REPL semantics:
  - Expression result capture via `{ value: expr }` wrapper
- Variable hoisting for persistence across REPL lines (`const`/`let` →
`var`)
  - Function and class declaration hoisting
  - Top-level await support with async IIFE wrapper
  - Object literal detection (no parentheses needed for `{ a: 1 }`)

### Implementation

The REPL is implemented in pure Zig (`src/repl.zig`) with C++ bindings
for JSC integration:
- Uses raw terminal mode for character-by-character input
- Integrates with Bun's existing `VirtualMachine` for JavaScript
evaluation
- Uses the parser with `repl_mode=true` to apply REPL-specific AST
transforms
- Provides access to all Bun globals (`Bun`, `Buffer`, `console`,
`process`, etc.)

### Files Changed

- `src/repl.zig` - Main REPL implementation (~1500 lines)
- `src/cli/repl_command.zig` - CLI entry point
- `src/bun.js/bindings/bindings.cpp` - C++ REPL functions
- `src/bun.js/bindings/headers.h` - C++ declarations
- `src/ast/repl_transforms.zig` - REPL-specific AST transforms
(cherry-picked from jarred/repl-mode)
- `test/js/bun/repl/repl.test.ts` - Comprehensive tests

## Test Plan

- [x] Run `bun bd test test/js/bun/repl/repl.test.ts` - 27 tests pass
- [x] Manual testing of interactive features:
  - Basic expression evaluation
  - Special variables `_` and `_error`
  - History navigation
  - Tab completion
  - Multi-line input
  - REPL commands
  - Top-level await
  - Variable persistence
- [x] Verified REPL starts without downloading packages (fixes #26058)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Bot <claude-bot@bun.sh>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>
Co-authored-by: Jarred Sumner <jarred@jarredsumner.com>
2026-02-25 15:15:37 -08:00

134 lines
6.5 KiB
C++

// clang-format off
#include "root.h"
#include "ModuleLoader.h"
#include "headers-handwritten.h"
#include "PathInlines.h"
#include "JSCommonJSModule.h"
#include <JavaScriptCore/JSBoundFunction.h>
#include <JavaScriptCore/PropertySlot.h>
#include <JavaScriptCore/JSMap.h>
#include <JavaScriptCore/JSString.h>
#include <JavaScriptCore/SourceCode.h>
#include "ZigGlobalObject.h"
#include "InternalModuleRegistry.h"
#undef assert
#define FOREACH_EXPOSED_BUILTIN_IMR(v) \
v(ffi, Bun::InternalModuleRegistry::BunFFI) \
v(assert, Bun::InternalModuleRegistry::NodeAssert) \
v(async_hooks, Bun::InternalModuleRegistry::NodeAsyncHooks) \
v(child_process, Bun::InternalModuleRegistry::NodeChildProcess) \
v(cluster, Bun::InternalModuleRegistry::NodeCluster) \
v(dgram, Bun::InternalModuleRegistry::NodeDgram) \
v(diagnostics_channel, Bun::InternalModuleRegistry::NodeDiagnosticsChannel) \
v(dns, Bun::InternalModuleRegistry::NodeDNS) \
v(domain, Bun::InternalModuleRegistry::NodeDomain) \
v(events, Bun::InternalModuleRegistry::NodeEvents) \
v(fs, Bun::InternalModuleRegistry::NodeFS) \
v(http, Bun::InternalModuleRegistry::NodeHttp) \
v(http2, Bun::InternalModuleRegistry::NodeHttp2) \
v(https, Bun::InternalModuleRegistry::NodeHttps) \
v(inspector, Bun::InternalModuleRegistry::NodeInspector) \
v(net, Bun::InternalModuleRegistry::NodeNet) \
v(os, Bun::InternalModuleRegistry::NodeOS) \
v(path, Bun::InternalModuleRegistry::NodePath) \
v(perf_hooks, Bun::InternalModuleRegistry::NodePerfHooks) \
v(punycode, Bun::InternalModuleRegistry::NodePunycode) \
v(querystring, Bun::InternalModuleRegistry::NodeQuerystring) \
v(readline, Bun::InternalModuleRegistry::NodeReadline) \
v(stream, Bun::InternalModuleRegistry::NodeStream) \
v(sys, Bun::InternalModuleRegistry::NodeUtil) \
v(timers, Bun::InternalModuleRegistry::NodeTimers) \
v(tls, Bun::InternalModuleRegistry::NodeTLS) \
v(trace_events, Bun::InternalModuleRegistry::NodeTraceEvents) \
v(tty, Bun::InternalModuleRegistry::NodeTty) \
v(url, Bun::InternalModuleRegistry::NodeUrl) \
v(util, Bun::InternalModuleRegistry::NodeUtil) \
v(v8, Bun::InternalModuleRegistry::NodeV8) \
v(vm, Bun::InternalModuleRegistry::NodeVM) \
v(wasi, Bun::InternalModuleRegistry::NodeWasi) \
v(sqlite, Bun::InternalModuleRegistry::BunSqlite) \
v(worker_threads, Bun::InternalModuleRegistry::NodeWorkerThreads) \
v(zlib, Bun::InternalModuleRegistry::NodeZlib) \
v(constants, Bun::InternalModuleRegistry::NodeConstants) \
v(string_decoder, Bun::InternalModuleRegistry::NodeStringDecoder) \
v(buffer, Bun::InternalModuleRegistry::NodeBuffer) \
v(jsc, Bun::InternalModuleRegistry::BunJSC) \
namespace ExposeNodeModuleGlobalGetters {
#define DECL_GETTER(id, field) \
JSC_DEFINE_CUSTOM_GETTER(id, (JSC::JSGlobalObject * lexicalGlobalObject, JSC::EncodedJSValue thisValue, JSC::PropertyName)) \
{ \
Zig::GlobalObject* thisObject = defaultGlobalObject(lexicalGlobalObject); \
JSC::VM& vm = thisObject->vm(); \
return JSC::JSValue::encode(thisObject->internalModuleRegistry()->requireId(thisObject, vm, field)); \
}
FOREACH_EXPOSED_BUILTIN_IMR(DECL_GETTER)
#undef DECL_GETTER
} // namespace ExposeNodeModuleGlobalGetters
extern "C" [[ZIG_EXPORT(nothrow)]] void Bun__ExposeNodeModuleGlobals(Zig::GlobalObject* globalObject)
{
auto& vm = JSC::getVM(globalObject);
#define PUT_CUSTOM_GETTER_SETTER(id, field) \
globalObject->putDirectCustomAccessor( \
vm, \
JSC::Identifier::fromString(vm, #id##_s), \
JSC::CustomGetterSetter::create( \
vm, \
ExposeNodeModuleGlobalGetters::id, \
nullptr), \
0 | JSC::PropertyAttribute::CustomValue \
);
FOREACH_EXPOSED_BUILTIN_IMR(PUT_CUSTOM_GETTER_SETTER)
#undef PUT_CUSTOM_GETTER_SETTER
}
// Set up require(), module, __filename, __dirname on globalThis for the REPL.
// Creates a CommonJS module object rooted at the given directory so require() resolves correctly.
extern "C" [[ZIG_EXPORT(check_slow)]] void Bun__REPL__setupGlobalRequire(
Zig::GlobalObject* globalObject,
const unsigned char* cwdPtr,
size_t cwdLen)
{
using namespace JSC;
auto& vm = getVM(globalObject);
auto scope = DECLARE_THROW_SCOPE(vm);
auto cwdStr = WTF::String::fromUTF8(std::span { cwdPtr, cwdLen });
auto* filename = jsString(vm, makeString(cwdStr, PLATFORM_SEP_s, "[repl]"_s));
auto* dirname = jsString(vm, WTF::String(cwdStr));
auto* moduleObject = Bun::JSCommonJSModule::create(vm,
globalObject->CommonJSModuleObjectStructure(),
filename, filename, dirname, SourceCode());
moduleObject->hasEvaluated = true;
auto* resolveFunction = JSBoundFunction::create(vm, globalObject,
globalObject->requireResolveFunctionUnbound(), filename,
ArgList(), 1, globalObject->commonStrings().resolveString(globalObject),
makeSource("resolve"_s, SourceOrigin(), SourceTaintedOrigin::Untainted));
RETURN_IF_EXCEPTION(scope, );
auto* requireFunction = JSBoundFunction::create(vm, globalObject,
globalObject->requireFunctionUnbound(), moduleObject,
ArgList(), 1, globalObject->commonStrings().requireString(globalObject),
makeSource("require"_s, SourceOrigin(), SourceTaintedOrigin::Untainted));
RETURN_IF_EXCEPTION(scope, );
requireFunction->putDirect(vm, vm.propertyNames->resolve, resolveFunction, 0);
moduleObject->putDirect(vm, WebCore::clientData(vm)->builtinNames().requirePublicName(), requireFunction, 0);
globalObject->putDirect(vm, WebCore::builtinNames(vm).requirePublicName(), requireFunction, 0);
globalObject->putDirect(vm, Identifier::fromString(vm, "module"_s), moduleObject, 0);
globalObject->putDirect(vm, Identifier::fromString(vm, "__filename"_s), filename, 0);
globalObject->putDirect(vm, Identifier::fromString(vm, "__dirname"_s), dirname, 0);
}