# WASI Preview 1 implementation for MoonBit

⚠️ It's a complete rewrite since 0.17.0

- [x] Wasm Backend
- [ ] Wasm-GC Backend

Note: not all APIs are fully tested.

## ABI compatibility

This package uses inline wasm helpers to pass MoonBit strings, bytes, and
arrays to WASIp1 calls. MoonBit changed the ABI layout for these values so the
data pointer no longer needs the old 8-byte offset. This is a breaking change
for packages that use inline wasm, but it is not something the MoonBit compiler
can detect at the type level.

Use this package with a MoonBit toolchain that has the updated ABI layout. If an
older toolchain or older generated bindings are mixed with this package, programs
may still compile but fail at runtime with corrupted strings/bytes or traps.

## Implemented functions

- [x] `args_get`
- [x] `args_sizes_get`
- [x] `environ_get`
- [x] `environ_sizes_get`
- [x] `clock_res_get`
- [x] `clock_time_get`
- [x] `fd_advise`
- [x] `fd_allocate`
- [x] `fd_close`
- [x] `fd_datasync`
- [x] `fd_fdstat_get`
- [x] `fd_fdstat_set_flags`
- [x] `fd_fdstat_set_rights`
- [x] `fd_filestat_get`
- [x] `fd_filestat_set_size`
- [x] `fd_filestat_set_times`
- [x] `fd_pread`
- [x] `fd_prestat_get`
- [x] `fd_prestat_dir_name`
- [x] `fd_pwrite`
- [x] `fd_read`
- [x] `fd_readdir`
- [x] `fd_renumber`
- [x] `fd_seek`
- [x] `fd_sync`
- [x] `fd_tell`
- [x] `fd_write`
- [x] `path_create_directory`
- [x] `path_filestat_get`
- [x] `path_filestat_set_times`
- [x] `path_link`
- [x] `path_open`
- [x] `path_readlink`
- [x] `path_remove_directory`
- [x] `path_rename`
- [x] `path_symlink`
- [x] `path_unlink_file`
- [x] `poll_oneoff`
- [x] `proc_exit`
- [x] `proc_raise`
- [x] `sched_yield`
- [x] `random_get`
- [x] `sock_accept`
- [x] `sock_recv`
- [x] `sock_send`
- [x] `sock_shutdown`

## Develop

### Testing

- Requirements: you need wasmtime & deno. You may use wasmedge or wamr if you replace the `wasmtime` in `test.ts`, but it may cause different testing result.
- Comamnds: `deno task test:build && deno task test`