crabrave

near-zero-cost abstractions ported from Rust to TypeScript

features:

very simple API that closely follows Rust's
rust style enums with packed data
Option<T> and Result<T> types
match(), and unwrap()
about as performant as doing the comparisons by hand
very lightweight, you won't notice it's even there in prod
works in all environments (browser, node, bun, deno)
(soon) helpers to wrap existing functions
(soon) wrappers over built-in web APIs and external libraries (a very simple and incomplete fetch wrapper is already included)

Check /examples and /test for code examples.

To install development dependencies:

bun install

To run:

bun run index.ts

To test:

bun test

questions you might have

why is everything arrow functions?
- smaller bundle size.
more fluent api? 🥺
- sorry, fluent APIs are not tree-shakable, and I can't add them until they are otherwise the bundle size will explode :( (ideally there would just be a macro system and then this whole thing becomes a zero-cost abstraction instead of an almost-zero-cost one)
but the bundle size is already so small! your competiton is an order of magnitude bigger!
- I guess.
~~why are there errors all over the code?~~
- ~~because we're lying to typescript and it's not a very big fan of our dishonesty.~~
- I managed to shut typescript up somehow
what is the performance impact?
- not too bad probably since it's just one extra function call. if macros were a thing you could make it zero-cost, I'll try to experiment with that in the future probably with bun or vite.
ok but like, benchmark it.
- there are too many factors to even consider doing this. (did you know that v8 uses four compilers? or that other engines exist?)
this is disgusting
- that's not a question but yes it is

This project was created using bun init in bun v1.0.7. Bun is a fast all-in-one JavaScript runtime.