Can I use this to speed up existing JavaScript methods?

Yes, by moving heavy logic into a Zig implementation and using these bindings, you can bypass the overhead of standard JS execution for performance-critical tasks.

What is the role of the .classes.ts file in Bun development?

The .classes.ts file acts as a definition schema that tells Bun's generator how to create the C++ and Zig boilerplate required to expose Zig structures as JavaScript classes.

What is the benefit of using the property caching feature?

Setting 'cache: true' in your class definition allows Bun to store results in a hidden slot, avoiding repeated calls to Zig logic for values that haven't changed.

How does memory management work with Zig-implemented JS classes?

It uses a dual-layered approach: deinit() handles resource cleanup, while finalize() is called by the JavaScriptCore garbage collector to destroy the Zig object instance.

Bun Zig-JS Class Generator

Name: Bun Zig-JS Class Generator
Author: oven-sh

byoven-sh

•

86,659

•

API開発

Generates high-performance JavaScriptCore class bindings from Zig implementations using Bun's codegen tools.

This skill streamlines the process of bridging JavaScript and Zig within the Bun runtime environment by utilizing the .classes.ts bindings generator. It provides specialized patterns for defining class interfaces, managing memory through Zig's ownership model, handling JavaScriptCore (JSC) call frames, and implementing advanced property caching to ensure peak performance when implementing native JavaScript APIs.

主な機能

0186,659 GitHub stars

02Integrated memory management with Zig deinit and GC finalize cycles

03High-performance property caching via WriteBarrier integration

04Automated JSC binding generation using .classes.ts definition templates

05Standardized Zig implementation patterns for JS constructors and methods

06Typesafe error handling using Bun's JSError and JSGlobalObject patterns

ユースケース

01Optimizing internal Bun APIs by bridging Zig logic to the JavaScriptCore engine

02Implementing new Web APIs (like TextDecoder) within the Bun runtime

03Creating high-performance Zig-backed JavaScript classes for native speed

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add oven-sh/bun implementing-jsc-classes-zig

For use in Claude.ai and ChatGPT

Download Skill