# メモ: Go 標準ライブラリだけの SSR 設計方針

## 目的

Go の標準ライブラリだけで、古典的な SSR（サーバサイドレンダリング）の Web サービスを作る。gomponents の思想を取り入れるが、依存はゼロ。テンプレートエンジン（`html/template`）も使わない。

## 信念・原則

### 1. 依存は標準ライブラリのみ
- `html`, `io`, `net/http`, `log/slog`, `fmt` だけで完結させる。
- 外部モジュールを足さない。gomponents は「思想の参照元」であって依存先ではない。

### 2. Node は純粋なデータ
- `Node` はマーカーインタフェース（`node()` メソッドだけ）。
- 具象ノード（`TextNode`, `ElementNode`, `AttrNode` など）は **描画ロジックを持たない**。
- 値型（`string` ラップや構造体）にして、`reflect.DeepEqual` や `==` で比較・テストしやすくする。
- `Node` に `Render` メソッドを生やさない。描画は Node の責務ではない。

### 3. 描画は Renderer（visitor パターン）
- `Renderer` インタフェースが各ノード型ごとのメソッドを持つ。
- `Render(w io.Writer, n Node, r Renderer)` が型 switch で 1 箇所にディスパッチする。
- ノード種を増やすときに触るのは「`Render` の switch」と「各 Renderer」だけ。
- **出力形式を差し替え可能**にする:
  - `HTMLRenderer` … 正しい HTML5
  - `PlainRenderer` … タグ・属性を捨ててテキストだけ抽出
  - 将来: Pretty 出力、サニタイザ、XML、Markdown なども同じ Node ツリーから作れる
- Renderer はゼロ値で安全に使えるようにする。

### 4. 要素・属性は const だけ
- ヘルパー関数（`Div()`, `Class()` など）を **生やさない**。
- `Tag` / `AttrName` という別々の型を定義し、`const` で要素名・属性名を列挙する。
- 唯一の生成関数は `El(name Tag, children ...Node)` と `Attr(key AttrName, val string)`。
- 型が違うので `El(Class, ...)` のような取り違えはコンパイルエラーで防げる。
- 新しい要素・属性は `const` を 1 行足すだけ。動的な名前は `Tag("my-widget")`, `AttrName("data-id")` でキャストして渡す。

### 5. HTML の正しさを守る
- `Text()` は必ず `html.EscapeString` を通す（XSS 対策）。
- `Raw()` はエスケープしない。静的な CSS など信頼できる文字列のみ。
- void 要素（`meta`, `input`, `link`, `br`, `hr` など）は閉じタグを出さない。
- `ElementNode.Children` の中で `AttrNode` / `BoolAttrNode` は開始タグ内に、それ以外は中身として出力する。

### 6. SSR の流れ
- `http.ResponseWriter` は `io.Writer` を満たすので、`Render` に直接渡してストリーム出力する。
- `Content-Type: text/html; charset=utf-8` を必ずセットする。
- `render(w, node)` のようなラッパーを 1 つ用意し、`Renderer` の選択はアプリ全体で 1 箇所（`var renderer el.Renderer = el.HTMLRenderer{}`）に集約する。
- デバッグ時は `PlainRenderer{}` に差し替えるだけで中身を確認できる。

## アンチパターン（やらないこと）

- ❌ `Node` に `Render(w io.Writer)` を生やす（→ Renderer に分離する）
- ❌ `Div()`, `Class()` のような要素/属性ヘルパー関数を量産する（→ `const` のみ）
- ❌ `html/template` を混ぜる（→ エスケープは `Text()` が担う）
- ❌ 外部モジュール（gomponents 本体など）に依存する
- ❌ `Raw()` にユーザ入力を通す

## 拡張の方向性

- `If(cond, node)` / `Map(slice, fn)` のような合成ヘルパを `el` に追加。
- Pretty 出力 Renderer、属性フィルタ付きサニタイザ Renderer。
- `func(n Node) http.HandlerFunc` でハンドラ化する糖衣。
- `bytes.Buffer` に一度書いて `Content-Length` を付与する最適化。

## 一言でまとめると

> **Node はデータ、描画は Renderer。要素と属性は const。依存は標準ライブラリだけ。**