# `OzMcp.Structs.MultiSelectEnumSchema`
[🔗](https://github.com/oz-elixir/oz_mcp/blob/v0.9.0/lib/oz_mcp/structs/multi_select_enum_schema.ex#L1)

Helper module used to build a multi-select enum field of an elicitation
form (`UntitledMultiSelectEnumSchema` or `TitledMultiSelectEnumSchema`).

_(MCP protocol: 2025-11-25)_

The options are the same as for `OzMcp.Structs.EnumSchema`. Without
titles the items use `enum`; with at least one title they use `anyOf`.

## Short example:

```elixir
%MultiSelectEnumSchema{}
  |> MultiSelectEnumSchema.options(["a", "b", "c"])
  |> MultiSelectEnumSchema.min_items(1)
  |> MultiSelectEnumSchema.default(["a"])
  |> MultiSelectEnumSchema.build()
```

Result:

```elixir
%{type: "array", items: %{type: "string", enum: ["a", "b", "c"]}, minItems: 1, default: ["a"]}
```

Specification: [EnumSchema](https://modelcontextprotocol.io/specification/2025-11-25/schema#enumschema)

## Fields

| Field | Setter | Type | Required |
|---|---|---|---|
| `title` | `title/2` | string | no |
| `description` | `description/2` | string | no |
| `options` | `options/2` | list(OzMcp.Structs.EnumOptions.option()) | no |
| `minItems` | `min_items/2` | non-negative integer | no |
| `maxItems` | `max_items/2` | non-negative integer | no |
| `default` | `default/2` | list(String.t()) \| nil | no |

# `t`

```elixir
@type t() :: %OzMcp.Structs.MultiSelectEnumSchema{
  default: [String.t()] | nil,
  description: String.t() | nil,
  maxItems: non_neg_integer() | nil,
  minItems: non_neg_integer() | nil,
  options: [OzMcp.Structs.EnumOptions.option()],
  title: String.t() | nil
}
```

# `build`

```elixir
@spec build(t()) :: map()
```

# `default`

```elixir
@spec default(t(), [String.t()] | nil) :: t()
```

# `description`

```elixir
@spec description(t(), String.t() | nil) :: t()
```

# `max_items`

```elixir
@spec max_items(t(), non_neg_integer() | nil) :: t()
```

# `min_items`

```elixir
@spec min_items(t(), non_neg_integer() | nil) :: t()
```

# `options`

```elixir
@spec options(t(), [OzMcp.Structs.EnumOptions.option()]) :: t()
```

# `title`

```elixir
@spec title(t(), String.t() | nil) :: t()
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*
