# `MishkaGervaz.Form.Dsl.Groups`
[🔗](https://github.com/mishka-group/mishka_gervaz/blob/v0.0.1-alpha.3/lib/mishka_gervaz/form/dsl/groups.ex#L1)

Groups section — bundles fields into named groups for layout and
access control.

A group references field names; the layout (and any wizard/tabs steps)
arranges the fields inside each group. Groups also carry the standard
`visible` / `restricted` predicates and an optional `ui` sub-entity
for label, icon, description, and CSS classes. Groups are reusable
units — wizard `step do groups [:basic, :meta] end` maps a step to a
set of groups by name.

## Example

    groups do
      group :general do
        fields [:title, :content, :status, :language]
        position :first

        ui do
          label "General"
          icon "hero-pencil"
          description "Core fields"
          class "border p-4"
        end
      end

      group :settings do
        fields [:priority, :featured, :metadata, :user_id]
        collapsible true
        collapsed true

        ui do
          label "Settings"
        end
      end
    end

See `MishkaGervaz.Form.Entities.Group` for the full option list.

# `section`

Returns the groups section definition.

---

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