# gosfc とは

> gosfc は、Vue コンポーネントの <script setup> と .astro ファイルのフロントマターと <script> を本物の Go にする薄い統合レイヤーです。Go は goesm がコンパイルします。

Vue Single File Component の `<script setup>` と、`.astro` ファイルのフロントマターと `<script>` で本物の Go を使うための統合レイヤーです。

```vue
<template>
  <div>
    合計: {{ total }}
  </div>
</template>

<script setup lang="go">
import cart "example.com/app/src/features/cart/pkg"

items := []cart.Item{
	{
		Price:    100,
		Quantity: 2,
	},
}

total := cart.Total(items)
</script>
```

`.go` は普通の Go パッケージ、インポートは普通の Go のインポートです。Go のコンパイルは [goesm](https://github.com/goesm-dev/goesm)、SFC とテンプレートは Vue tooling、`.astro` のテンプレートは Astro、ビルドは Vite、ページと SSR は Astro が担当します。設計は [ARCHITECTURE.ja.md](https://goesm.dev/gosfc/ja/reference/architecture.md) を見てください。

**状態：PoC。** 未実装の項目は ARCHITECTURE.ja.md の「未実装・未決事項」にあります。

## 役割分担

gosfc は `.vue` ファイルと `.astro` ファイルの Go を見つけて普通の Go ファイルに組み直し、
goesm がコンパイルしたものを Vue と Astro につなぎます。それ以外は、それを本来担当するツールが行います。

| | 担当すること | 担当しないこと |
| --- | --- | --- |
| gosfc | Go ブロックの検出、Go ファイルの構築、goesm の呼び出し、テンプレートへのバインディングの公開、ソース位置の維持、Vite プラグインと Astro インテグレーション | Go の構文解析・型検査、モジュールの解決、テンプレートやスタイルのコンパイル、バンドル、描画 |
| goesm | Go のパッケージとモジュール、構文解析、型検査、Go の意味論、`.go` へのソースマップ付きの TypeScript 出力 | Vue や Astro に関すること |
| Vue のツール | SFC の解析、テンプレートのコンパイル、scoped CSS、HMR | Go |
| Vite | 開発サーバー、TypeScript から JavaScript への変換、バンドル | Go、SFC |
| Astro | ページ、SSR、静的ビルド、アイランド | Go、SFC の中身 |

各ステップは [アーキテクチャ](https://goesm.dev/gosfc/ja/reference/architecture.md) で説明しています。
