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/js
moon add mizchi/npm_typed

Add to your moon.pkg.json:

{
  "import": [
    "mizchi/js",
    "mizchi/js/core",
    "mizchi/npm_typed/react",
    "mizchi/npm_typed/hono"
  ]
}

Available Packages

UI Frameworks

Package	npm	Status	Note
react	react	🧪 Tested	Core React API
react_element	-	🧪 Tested	Typed HTML elements for React
react_dom	react-dom	🧪 Tested	React DOM
react_dom_client	react-dom/client	🧪 Tested	Client-side rendering
react_dom_server	react-dom/server	🧪 Tested	Server-side rendering
react_dom_static	react-dom/static	🤖 AI Generated	Static rendering
react_router	react-router	🧪 Tested	Client-side routing
testing_library_react	@testing-library/react	🧪 Tested	React testing utilities
preact	preact	🧪 Tested	Lightweight React alternative
testing_library_preact	@testing-library/preact	🤖 AI Generated	Preact testing utilities
ink	ink	🧪 Tested	React for CLI apps
ink_ui	@inkjs/ui	🧪 Tested	Ink UI components

Web Frameworks

Package	npm	Status	Note
hono	hono	🧪 Tested	Fast web framework, middleware support
better_auth	better-auth	🤖 AI Generated	Authentication library
helmet	helmet	🧪 Tested	Security headers middleware

AI / LLM

Package	npm	Status	Note
ai	ai (Vercel AI SDK)	🧪 Tested	AI/LLM integration
modelcontextprotocol	@modelcontextprotocol/sdk	🧪 Tested	MCP server/client
claude_code	@anthropic-ai/claude-code	🤖 AI Generated	Claude Code SDK

Cloud Services

Package	npm	Status	Note
client_s3	@aws-sdk/client-s3	🧪 Tested	S3-compatible storage (AWS, GCS, R2, MinIO)

Database

Package	npm	Status	Note
pglite	@electric-sql/pglite	🧪 Tested	Embedded PostgreSQL
duckdb	@duckdb/duckdb-wasm	🤖 AI Generated	Analytical database
drizzle	drizzle-orm	🤖 AI Generated	TypeScript ORM (see limitations)
pg	pg	🤖 AI Generated	PostgreSQL client

Validation / Schema

Package	npm	Status	Note
zod	zod	🧪 Tested	Schema validation
ajv	ajv	🧪 Tested	JSON Schema validator

Build Tools

Package	npm	Status	Note
terser	terser	🧪 Tested	JavaScript minifier
vite	vite	🧪 Tested	Next-gen build tool
unplugin	unplugin	🤖 AI Generated	Unified plugin system
lighthouse	lighthouse	🤖 AI Generated	Web performance auditing
esbuild	esbuild	🧪 Tested	Fast bundler
oxc_minify	oxc-minify	🧪 Tested	Oxc minifier

Utilities

Package	npm	Status	Note
date_fns	date-fns	🧪 Tested	Date manipulation
semver	semver	🧪 Tested	Semantic versioning
chalk	chalk	🧪 Tested	Terminal styling
colorette	colorette	🧪 Tested	Terminal colors
dotenv	dotenv	🧪 Tested	Environment variables
chokidar	chokidar	🧪 Tested	File watching
yargs	yargs	🤖 AI Generated	CLI argument parsing
debug	debug	🤖 AI Generated	Debug logging
jose	jose	🧪 Tested	JWT/JWE/JWS
comlink	comlink	🤖 AI Generated	Web Worker RPC
simple_git	simple-git	🤖 AI Generated	Git operations
ignore	ignore	🤖 AI Generated	.gitignore parsing
memfs	memfs	🧪 Tested	In-memory file system
minimatch	minimatch	🧪 Tested	Glob matching
execa	execa	🧪 Tested	Process execution
pino	pino	🧪 Tested	Fast logging
magic_string	magic-string	🧪 Tested	String manipulation

Testing / Development

Package	npm	Status	Note
vitest	vitest	🚧 Partial	Test runner
puppeteer	puppeteer	🧪 Tested	Browser automation
playwright	playwright	🧪 Tested	Browser automation
playwright_test	@playwright/test	🤖 AI Generated	Playwright test framework
jsdom	jsdom	🧪 Tested	DOM implementation
happy_dom	happy-dom	🧪 Tested	Fast DOM implementation
global_jsdom	global-jsdom	🧪 Tested	JSDOM for testing
testing_library	@testing-library/dom	🧪 Tested	DOM testing utilities
msw	msw	🧪 Tested	Mock Service Worker
ink_testing_library	ink-testing-library	🧪 Tested	Ink testing utilities

Parsing

Package	npm	Status	Note
htmlparser2	htmlparser2	🧪 Tested	HTML/XML parser
js_yaml	js-yaml	🤖 AI Generated	YAML parser
source_map	source-map	🧪 Tested	Source map utilities
error_stack_parser	error-stack-parser	🧪 Tested	Stack trace 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