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

Submit entity — configures the create / update / cancel buttons.

The `submit` block is a singleton composed of three button
sub-entities (`create`, `update`, `cancel`), an optional `ui`
sub-entity for shared button styling, and a `position` field
(`:top` or `:bottom`). Each button supports inline keyword form for
static options and full block form when you need function-based
predicates (`disabled` / `restricted` / `visible`).

## Example — populated buttons

    submit do
      create label: "Create Post"
      update label: "Save Post"
      cancel label: "Discard"
      position :bottom

      ui do
        submit_class "bg-blue-600 text-white"
        cancel_class "bg-gray-200"
        wrapper_class "flex gap-4"
      end
    end

## Example — function-based predicates (block form)

    submit do
      create label: "Create Item", restricted: true

      update do
        label "Save Item"
        disabled fn _state -> false end
        restricted fn _state -> false end
        visible fn _state -> true end
      end

      cancel label: "Go Back", visible: false
      position :top
    end

## Inheritance

Resources without a `submit` block inherit the entire submit map from
the domain (see `MishkaGervaz.Form.Dsl.DomainDefaults`). Resources
with a partial block inherit per-button: missing buttons fall back to
the domain's, present buttons override them.

See `MishkaGervaz.Form.Entities.Submit` and
`MishkaGervaz.Form.Entities.Submit.Button` for the full option list.

# `entity`

Returns the submit entity definition.

---

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