mizchi/npm_typed

Typed npm package bindings for MoonBit, built on top of mizchi/js.

Inspired by DefinitelyTyped - the repository for high quality TypeScript type definitions. This project aims to be the MoonBit equivalent, providing type-safe FFI bindings for popular npm packages.

Note: These bindings require installing the corresponding npm packages.

# Example: Install React dependencies
npm install react react-dom

# Example: Install Hono
npm install hono

Installation

moon add mizchi/npm_typed

The bindings are built on mizchi/js, which is split into per-environment modules. Add the ones your package needs:

moon add mizchi/js          # facade: re-exports js_core + js_builtin
moon add mizchi/js_core     # Any, Promise, Nullable, interop primitives
moon add mizchi/js_builtin  # Object, Array, JSON, RegExp, Symbol, ...
moon add mizchi/js_web      # fetch, Streams, Blob, URL, Crypto, ...
moon add mizchi/js_node     # fs, http, stream, process, ...
moon add mizchi/js_browser  # dom, history, storage, ...
moon add mizchi/js_convert  # MoonBit <-> JS value conversion

Add to your moon.pkg:

import {
  "mizchi/js",
  "mizchi/js_core" @core,
  "mizchi/npm_typed/react",
  "mizchi/npm_typed/hono",
}

Available Packages

UI Frameworks

Web Frameworks

AI / LLM

Cloud Services

Database

Validation / Schema

Build Tools

Utilities

Testing / Development

Parsing

Status Legend

• 🧪 Tested: Comprehensive test coverage
• 🚧 Partial: Core functionality implemented
• 🤖 AI Generated: Needs testing

Can't find your library?

You can easily add new bindings with AI assistance:

./_scripts/new-library.sh <package_name>

See CONTRIBUTING.md for details. Most bindings in this repository were generated with AI agents.

Quick Start

React Example

// moon.pkg.json: import mizchi/npm_typed/react, mizchi/npm_typed/react_element

fn counter(_props : Unit) -> @react.Element {
  let (count, set_count) = @react.useState(0)
  @react_element.div([
    @react_element.span(["Count: \{count}"]),
    @react_element.button(on_click=fn(_) { set_count(count + 1) }, ["+"]),
  ])
}

Hono Example

// moon.pkg.json: import mizchi/npm_typed/hono

async fn main {
  let app : @hono.Hono[@core.Any, @core.Any] = @hono.Hono::new()
  app.get("/", fn(c) { c.text("Hello, Hono!") }) |> ignore
}

Zod Example

// moon.pkg.json: import mizchi/npm_typed/zod

fn main {
  let user_schema = @zod.object({
    "name": @zod.string(),
    "age": @zod.number().int(),
  })
  let data = @core.new_object()
  data["name"] = @core.any("Alice")
  data["age"] = @core.any(30)
  match user_schema.safeParse(data) {
    Ok(_) => println("Valid!")
    Err(_) => println("Invalid!")
  }
}

Requirements

This package requires:

• MoonBit nightly 2025-12-09 or later for ESM #module directive support
• mizchi/js v0.9.0 or later as a peer dependency

Related Projects

• mizchi/js - Core JavaScript FFI bindings
• @mizchi/cloudflare-mbt - Cloudflare Workers bindings

LICENSE

MIT