# goesm: Go のパッケージを、ネイティブな ES モジュールに

> TypeScript の型が付いた素の JavaScript。WebAssembly もグルーコードもなく、バンドラーは Go を他のモジュールと同じように import します。

[はじめる](https://goesm.dev/ja/guide/getting-started.md) · [goesm とは](https://goesm.dev/ja/guide.md) · [GitHub](https://github.com/goesm-dev/goesm)

- **Go の関数が JS の関数になる**: wasm のインスタンスも wasm_exec.js も値の変換もありません。export した Go の関数の呼び出しコストは、普通の JS 関数と同じです。
- **パッケージごとに 1 つの ES モジュール**: 相対 .ts import でつながる TypeScript モジュールのツリーを出力します。Vite・Rolldown・esbuild・Bun が tree shaking、分割、minify を行い、source map は .go まで戻ります。
- [**ネイティブ Go と突き合わせて検証**](https://goesm.dev/ja/reference/conformance.md): すべての fixture をネイティブ Go と ESM の両方で実行し、結果の一致を確認しています。Go 自身のテストスイートは 961 件中 898 件が通ります。
- **Go は Go のまま**: フロントエンドは go/packages と go/types です。go.mod、gopls、go vet、go test は同じコードでそのまま動きます。
- [**Vue と Astro**](https://goesm.dev/ja/guide/vue.md): gosfc を使うと、Vue コンポーネントの <script setup lang="go"> と .astro ファイルの ---go のフロントマターで本物の Go が動きます。
- [**ゼロコード計装**](https://goesm.dev/ja/reference/otelc.md): goesm build -toolexec "otelc toolexec" で、ネイティブのビルドと同じ OpenTelemetry の span を出力します。

## Go を書いて、ESM として import する

```go
package cart

type Item struct {
	Name     string
	Price    int
	Quantity int
}

func Total(items []Item) int {
	total := 0
	for _, item := range items {
		total += item.Price * item.Quantity
	}
	return total
}
```

```sh
go tool goesm emit-ts ./cart   # goesm-ts/example.com/app/cart.ts とランタイム
```

```ts
import { Item, Total, $runtime as rt } from "./goesm-ts/example.com/app/cart.ts";

Total(rt.sliceLit([new Item(rt.fromJSString("apple"), 120, 3)])); // 360
```
