@k2works/claude-code-booster 2.7.1 → 3.1.0

package/lib/assets/docs/article/functional-desgin-ppp/elixir/11-command-pattern.md

@@ -0,0 +1,148 @@
+# 第11章: Command パターン
+
+## はじめに
+
+Command パターンは、リクエストをオブジェクト（データ）としてカプセル化し、異なるリクエストでクライアントをパラメータ化したり、操作の履歴を記録したり、Undo/Redo 機能を実装できるようにするパターンです。
+
+Elixir では、プロトコルを使用してコマンドインターフェースを定義し、構造体でコマンドを表現します。
+
+## 1. Command プロトコル
+
+```elixir
+defprotocol Command do
+  @doc "コマンドを実行し、新しい状態を返す"
+  def execute(command, state)
+
+  @doc "コマンドを取り消し、以前の状態を返す"
+  def undo(command, state)
+end
+```
+
+## 2. テキスト操作コマンド
+
+### InsertCommand
+
+```elixir
+defmodule InsertCommand do
+  defstruct [:position, :text]
+
+  def new(position, text), do: %__MODULE__{position: position, text: text}
+end
+
+defimpl Command, for: InsertCommand do
+  def execute(%InsertCommand{position: pos, text: text}, document) do
+    before = String.slice(document, 0, pos)
+    after_text = String.slice(document, pos..-1//1)
+    before <> text <> after_text
+  end
+
+  def undo(%InsertCommand{position: pos, text: text}, document) do
+    len = String.length(text)
+    before = String.slice(document, 0, pos)
+    after_text = String.slice(document, (pos + len)..-1//1)
+    before <> after_text
+  end
+end
+```
+
+### 使用例
+
+```elixir
+cmd = InsertCommand.new(5, " World")
+result = Command.execute(cmd, "Hello")
+# => "Hello World"
+
+restored = Command.undo(cmd, "Hello World")
+# => "Hello"
+```
+
+## 3. コマンド実行器
+
+```elixir
+defmodule CommandExecutor do
+  defstruct [:state, undo_stack: [], redo_stack: []]
+
+  def new(initial_state), do: %__MODULE__{state: initial_state}
+
+  def execute(%__MODULE__{state: state, undo_stack: undo} = executor, command) do
+    new_state = Command.execute(command, state)
+    %{executor |
+      state: new_state,
+      undo_stack: [command | undo],
+      redo_stack: []
+    }
+  end
+
+  def undo(%__MODULE__{undo_stack: []} = executor), do: executor
+  def undo(%__MODULE__{state: state, undo_stack: [cmd | rest], redo_stack: redo} = executor) do
+    new_state = Command.undo(cmd, state)
+    %{executor |
+      state: new_state,
+      undo_stack: rest,
+      redo_stack: [cmd | redo]
+    }
+  end
+
+  def redo(%__MODULE__{redo_stack: []} = executor), do: executor
+  def redo(%__MODULE__{state: state, undo_stack: undo, redo_stack: [cmd | rest]} = executor) do
+    new_state = Command.execute(cmd, state)
+    %{executor |
+      state: new_state,
+      undo_stack: [cmd | undo],
+      redo_stack: rest
+    }
+  end
+end
+```
+
+## 4. マクロコマンド
+
+複数のコマンドを1つにまとめて実行：
+
+```elixir
+defmodule MacroCommand do
+  defstruct [:commands]
+
+  def new(commands), do: %__MODULE__{commands: commands}
+end
+
+defimpl Command, for: MacroCommand do
+  def execute(%MacroCommand{commands: commands}, state) do
+    Enum.reduce(commands, state, &Command.execute(&1, &2))
+  end
+
+  def undo(%MacroCommand{commands: commands}, state) do
+    Enum.reduce(Enum.reverse(commands), state, &Command.undo(&1, &2))
+  end
+end
+```
+
+## 5. キャンバス操作
+
+図形の追加・移動・削除もコマンドで表現：
+
+```elixir
+defmodule AddShapeCommand do
+  defstruct [:shape]
+end
+
+defimpl Command, for: AddShapeCommand do
+  def execute(%{shape: shape}, %{shapes: shapes} = canvas) do
+    %{canvas | shapes: shapes ++ [shape]}
+  end
+
+  def undo(%{shape: shape}, %{shapes: shapes} = canvas) do
+    %{canvas | shapes: Enum.reject(shapes, &(&1.id == shape.id))}
+  end
+end
+```
+
+## まとめ
+
+Elixir での Command パターンのポイント：
+
+- **Protocol** でコマンドインターフェースを定義
+- **Struct** でコマンドデータを表現
+- **不変性** を活かした状態管理
+- **Undo/Redo** スタックによる履歴管理
+- **MacroCommand** で複合操作をサポート

package/lib/assets/docs/article/functional-desgin-ppp/elixir/12-visitor-pattern.md

@@ -0,0 +1,176 @@
+# 第12章: Visitor パターン
+
+## はじめに
+
+Visitor パターンは、データ構造と操作を分離し、既存のデータ構造を変更することなく新しい操作を追加できるようにするパターンです。
+
+Elixir では、プロトコルを使用して Visitor インターフェースを定義し、各図形タイプに対する実装を提供します。
+
+## 1. Element: 図形の定義
+
+```elixir
+defmodule Circle do
+  defstruct [:center, :radius]
+  def new(center, radius), do: %__MODULE__{center: center, radius: radius}
+end
+
+defmodule Square do
+  defstruct [:top_left, :side]
+  def new(top_left, side), do: %__MODULE__{top_left: top_left, side: side}
+end
+
+defmodule Rectangle do
+  defstruct [:top_left, :width, :height]
+  def new(top_left, width, height) do
+    %__MODULE__{top_left: top_left, width: width, height: height}
+  end
+end
+```
+
+## 2. Visitor プロトコル
+
+```elixir
+defprotocol ShapeVisitor do
+  @doc "図形を訪問して処理を行う"
+  def visit(visitor, shape)
+end
+```
+
+## 3. JSON Visitor
+
+```elixir
+defmodule JsonVisitor do
+  defstruct []
+  def new, do: %__MODULE__{}
+
+  def to_json(shape), do: ShapeVisitor.visit(new(), shape)
+end
+
+defimpl ShapeVisitor, for: JsonVisitor do
+  def visit(_visitor, %Circle{center: {x, y}, radius: r}) do
+    ~s({"type":"circle","center":[#{x},#{y}],"radius":#{r}})
+  end
+
+  def visit(_visitor, %Square{top_left: {x, y}, side: s}) do
+    ~s({"type":"square","topLeft":[#{x},#{y}],"side":#{s}})
+  end
+
+  def visit(_visitor, %Rectangle{top_left: {x, y}, width: w, height: h}) do
+    ~s({"type":"rectangle","topLeft":[#{x},#{y}],"width":#{w},"height":#{h}})
+  end
+end
+```
+
+## 4. Area Visitor
+
+```elixir
+defmodule AreaVisitor do
+  defstruct []
+  def new, do: %__MODULE__{}
+
+  def calculate_area(shape), do: ShapeVisitor.visit(new(), shape)
+
+  def total_area(shapes) do
+    Enum.reduce(shapes, 0, &(&2 + calculate_area(&1)))
+  end
+end
+
+defimpl ShapeVisitor, for: AreaVisitor do
+  def visit(_visitor, %Circle{radius: r}) do
+    :math.pi() * r * r
+  end
+
+  def visit(_visitor, %Square{side: s}) do
+    s * s
+  end
+
+  def visit(_visitor, %Rectangle{width: w, height: h}) do
+    w * h
+  end
+end
+```
+
+## 5. Perimeter Visitor
+
+```elixir
+defmodule PerimeterVisitor do
+  defstruct []
+  def new, do: %__MODULE__{}
+
+  def calculate_perimeter(shape), do: ShapeVisitor.visit(new(), shape)
+end
+
+defimpl ShapeVisitor, for: PerimeterVisitor do
+  def visit(_visitor, %Circle{radius: r}), do: 2 * :math.pi() * r
+  def visit(_visitor, %Square{side: s}), do: 4 * s
+  def visit(_visitor, %Rectangle{width: w, height: h}), do: 2 * (w + h)
+end
+```
+
+## 6. SVG Visitor
+
+```elixir
+defmodule SvgVisitor do
+  defstruct fill: "none", stroke: "black", stroke_width: 1
+
+  def new(opts \\ []) do
+    %__MODULE__{
+      fill: Keyword.get(opts, :fill, "none"),
+      stroke: Keyword.get(opts, :stroke, "black"),
+      stroke_width: Keyword.get(opts, :stroke_width, 1)
+    }
+  end
+end
+
+defimpl ShapeVisitor, for: SvgVisitor do
+  def visit(%{fill: f, stroke: s, stroke_width: sw}, %Circle{center: {cx, cy}, radius: r}) do
+    ~s(<circle cx="#{cx}" cy="#{cy}" r="#{r}" fill="#{f}" stroke="#{s}" stroke-width="#{sw}"/>)
+  end
+  # ... 他の図形も同様
+end
+```
+
+## 7. 複合 Visitor
+
+```elixir
+defmodule CompositeVisitor do
+  def apply_all(shape, visitors) do
+    Map.new(visitors, fn {key, visitor} ->
+      {key, ShapeVisitor.visit(visitor, shape)}
+    end)
+  end
+end
+
+# 使用例
+results = CompositeVisitor.apply_all(circle, [
+  {:json, JsonVisitor.new()},
+  {:area, AreaVisitor.new()}
+])
+```
+
+## 8. DrawingContext
+
+```elixir
+defmodule DrawingContext do
+  defstruct shapes: []
+
+  def add_shape(ctx, shape), do: %{ctx | shapes: ctx.shapes ++ [shape]}
+
+  def to_json(%{shapes: shapes}) do
+    json_items = Enum.map(shapes, &JsonVisitor.to_json/1)
+    "[" <> Enum.join(json_items, ",") <> "]"
+  end
+
+  def total_area(%{shapes: shapes}), do: AreaVisitor.total_area(shapes)
+end
+```
+
+## まとめ
+
+Elixir での Visitor パターンのポイント：
+
+- **Protocol** で Visitor インターフェースを定義
+- **defimpl** で各図形タイプに対する実装を提供
+- 新しい操作を追加する際は新しい Visitor を作成
+- 既存の図形コードを変更せずに拡張可能
+- **CompositeVisitor** で複数の操作を一度に適用