Behaviours

MishkaGervaz.Behaviours.UIAdapter declares 69 one-argument component functions, each taking an assigns map. use MishkaGervaz.Behaviours.UIAdapter writes a defdelegate to a fallback module for every function and marks them all overridable, so an adapter defines only what differs. One adapter serves both the table and the form. MishkaGervaz.Behaviours.UIAdapter.component_functions/0 returns the live list.

Options of use

Option	Type	Default	Description
:fallback	module	MishkaGervaz.UIAdapters.Tailwind	Where an undefined component goes. A fallback may itself fall back to another adapter.
:components	module	none	A components module. Each function is wired to it when the module is loaded and exports a matching one-argument function.
:nested_components	boolean	false	Looks for Components.Button.button/1 instead of Components.button/1.
:module_prefix	string	none	Prepended to the submodule name, so "Mishka" gives Components.MishkaButton.button/1. It applies only with nested_components: true.
:component_prefix	string	none	Prepended to the function name, so "mc_" gives mc_button/1.

Built-in adapters

Module	Purpose
MishkaGervaz.UIAdapters.Tailwind	Plain Tailwind CSS. The default adapter.
MishkaGervaz.UIAdapters.MediaGallery	Overrides button/1 for the cards of the media gallery template and inherits the rest. The gallery template uses it in place of the Tailwind adapter.
MishkaGervaz.UIAdapters.Dynamic	Renders components resolved at run time and falls back per component. Options: :site (default "Global"), :component_renderer, :module_resolver and :fallback.

Component functions

Inputs

Function	Renders
text_input/1	Render a text input.
select/1	Render a select dropdown.
multi_select/1	Render a multi-select with search support.
search_select/1	Render a single-select with search support.
load_more_select/1	Render a single-select with paginated load-more (no search input).
checkbox/1	Render a checkbox.
date_input/1	Render a date input.
datetime_input/1	Render a datetime input.
number_input/1	Render a number input.
textarea/1	Render a multi-line text input.
json_editor/1	Render a JSON editor (textarea with formatting).
toggle_input/1	Render a boolean toggle switch.
range_input/1	Render a range slider input.
string_list_input/1	Render a dynamic string list input with add/remove buttons.
password_input/1	Render a password input (masked text entry).
combobox/1	Render a combobox (text input with dropdown suggestions).

Actions and display

Function	Renders
button/1	Render a button.
icon/1	Render an icon.
badge/1	Render a badge/tag (variant :tag or :pill, optional leading dot).
copy_button/1	Render a copy-to-clipboard button for a value.
spinner/1	Render a loading spinner.
nav_link/1	Render a navigation link.
dropdown/1	Render a dropdown menu.

State and status

Function	Renders
empty_state/1	Render empty state.
error_state/1	Render error state.
loading_state/1	Render loading state.
alert/1	Render a static alert/notice (info/warning/error/success/neutral).

Table

Function	Renders
table/1	Render table wrapper.
table_header/1	Render table header row.
th/1	Render a table header cell.
tr/1	Render a table row.
td/1	Render a table cell.
date_range_container/1	Render a date range container.
cell_empty/1	Render empty cell value (nil/missing data).
cell_text/1	Render text cell value.
cell_number/1	Render number cell value.
cell_date/1	Render date cell value.
cell_datetime/1	Render datetime cell value.
cell_code/1	Render code/monospace cell value.
cell_array/1	Render array/list container.
cell_tags/1	Render a list of tags/chips with a +N inline expand/collapse toggle.
cell_avatars/1	Render an overlapping avatar stack with a +N inline expand/collapse toggle.
cell_stacked/1	Render a two-line cell: a primary line over a quieter secondary one.
cell_stats/1	Render a wrapping row of icon+count markers and chips.
cell_bars/1	Render a bar-gauge cell (a numeric value as filled bars + the number).
filter_reset_button/1	Render filter reset/clear button.
archive_toggle/1	Render archive status toggle.
bulk_action_bar/1	Render bulk actions bar container.
bulk_action_button/1	Render individual bulk action button.
pagination_container/1	Render pagination container with page info.
pagination_nav_button/1	Render pagination nav button (prev/next/first/last).
pagination_page_button/1	Render pagination page number button.
template_switcher/1	Render template switcher container with buttons.
template_switcher_button/1	Render template switcher button.

Form

Function	Renders
form_container/1	Render the main form wrapper (phx-change, phx-submit).
form_header/1	Render a form header (title + description).
form_footer/1	Render a form footer (static content below the submit row).
field_wrapper/1	Render a field wrapper with label, input, and error display.
field_group/1	Render a collapsible group of fields.
field_error/1	Render a field error message display.
step_indicator/1	Render wizard/tabs step progress indicator.
step_navigation/1	Render wizard prev/next/submit navigation controls.
upload_dropzone/1	Render a drag-drop file upload zone.
upload_preview/1	Render a file preview thumbnail.
upload_progress/1	Render an upload progress bar.
upload_file_input/1	Render a styled file input (non-dropzone) upload control.
upload_existing_file/1	Render an existing file card with remove button (for edit mode).
nested_fields/1	Render a container for nested form fields.
array_fields/1	Render a container for array-of-maps fields.

MishkaGervaz.Table.Behaviours.Template arranges a table. use MishkaGervaz.Table.Behaviours.Template supplies the optional callbacks from MishkaGervaz.Table.Templates.Shared and imports get_cell_value/2. The renderer passes @static, @state, @stream, @empty? and @myself.

Callback	Required	Returns or renders
name/0	Yes	An atom. It is what state.template.name() returns.
label/0	Yes	The label in the template switcher.
icon/0	Yes	The icon in the template switcher.
description/0	Yes	A short description. Gervaz does not call it.
features/0	Yes	The list of features the template draws, or :all.
default_options/0	Yes	A keyword list of defaults for template_options. Only the built-in templates merge their own. Gervaz does not merge the list of a custom template, so call it from render/1 if you want it.
render/1	Yes	The whole table.
render_item/1	Yes	One record.
render_header/1	No	The header. Default from Shared.
render_empty/1	No	The empty state, read from the DSL empty_state.
render_error/1	No	The error state, read from the DSL error_state.
render_loading/1	No	The loading state.
render_pagination/1	No	The pagination row.
render_filters/1	No	The filter bar.
render_bulk_actions/1	No	The bulk action bar.
render_template_switcher/1	No	The template switcher.

The accepted values of features/0, besides :all, are :sort, :filter, :select, :bulk_actions, :paginate, :export, :expand, :reorder and :inline_edit.

MishkaGervaz.Form.Behaviours.Template arranges a form. use MishkaGervaz.Form.Behaviours.Template delegates the four optional callbacks to MishkaGervaz.Form.Templates.Standard. The renderer passes @static, @state, @myself and @uploads.

Callback	Required	Returns or renders
name/0	Yes	An atom.
label/0	Yes	A label.
icon/0	Yes	An icon.
render/1	Yes	The whole form.
render_loading/1	No	The loading state.
render_field/1	No	One field, dispatched by field type.
render_group/1	No	One group.
render_step_indicator/1	No	The step indicator of a wizard or tabs form.

MishkaGervaz.Table.Behaviours.ColumnType draws one cell.

Callback	Required	Receives
render/4	Yes	value (after format), the column config map, the full record and the UI adapter module.
cell_class/1	No	The column config map. Returns a class string or nil. Gervaz does not call it.

MishkaGervaz.Table.Behaviours.FilterType draws a filter input, parses its raw value and applies it to the query. Gervaz calls parse_value/2 and build_query/4 for any filter module. It does not call render_input/3 of a custom module, because the built-in table template draws a filter itself by its type name.

Callback	Required	Receives
render_input/3	Yes	The filter config map, the current value and the UI adapter module. The built-in table template does not call it for a custom module.
parse_value/2	Yes	The raw form value and the filter config map. Returns the value build_query expects.
build_query/3	Yes	The query, the field name and the parsed value. Returns the query. Gervaz calls build_query/4 and not this one.
build_query/4	No	The same, plus the full filter config map, for multi-field search. This is the one Gervaz calls. Define it, or give the last argument of build_query/3 a default.
label/1	No	The filter config map. Returns a label. Gervaz does not call it.

MishkaGervaz.Table.Behaviours.ActionType draws one row action.

Callback	Required	Receives
render/5	Yes	The assigns map (with :action, :record, :state, :static, :ui_adapter and :myself), the action config map, the record, the UI adapter module and the phx-target.

MishkaGervaz.Form.Behaviours.FieldType draws one form input and prepares its value. Gervaz calls sanitize/2, parse_params/2 and validate/2. The Standard form template does not call render/2 or default_ui/0, and draws a field with a module type as a text input.

Callback	Required	Receives or returns
render/2	Yes	The assigns map and the field config. Returns the markup. The behaviour requires it, and the Standard form template does not call it.
sanitize/2	No	The value and the config. Runs before validation. Text types strip HTML here.
parse_params/2	No	The raw value and the config. Returns the typed value.
validate/2	No	The value and the config. Returns {:ok, value} or {:error, message}.
default_ui/0	No	Returns the baseline UI map of the type. Gervaz does not call it.

The column, filter, action and field registries (MishkaGervaz.Table.Types.Column, MishkaGervaz.Table.Types.Filter, MishkaGervaz.Table.Types.Action and MishkaGervaz.Form.Types.Field) share one macro. Each gives you get/1, builtin_types/0, builtin?/1, default/0 and get_or_passthrough/1. The column and field registries add infer_from_ash_type/1. The DSL does not use the field registry's version to infer a field type. The ResolveFields transformer does, with the rules on Form fields DSL.

• Write a table or form template, Write a custom type and Change how the admin looks: guides that implement these behaviours.
• Built-in types: the types that ship with Gervaz.