implementing-jsc-classes-cpp

What problem does it solve?

This skill provides a structured approach to exposing native C++ classes to JavaScript in Bun's JavaScriptCore (JSC) runtime, enabling JS code to instantiate and interact with high-performance native objects.

Core Features & Use Cases

• Bind C++ classes to JS by defining a FooPrototype and a FooConstructor, with a public Foo class and optional internal fields.
• Create robust prototypes and constructors that integrate with Bun's memory spaces and subspaces to ensure proper lifecycle and performance.
• Use cases include building native bindings for graphics, data processing, or system-level APIs that require JS-facing wrappers.

Quick Start

Define your C++ class, implement FooPrototype and FooConstructor following the pattern in the example, hook into Bun's Zig registration, and compile Bun to expose the new JS type.