Single state struct for MishkaGervaz table.

All table state is held in this struct rather than in separate assigns.

State shape

State is split into two parts:

• static - Configuration that never changes (same reference for O(1) comparison)
• Dynamic fields - User interaction state that triggers re-renders

This separation allows LiveView to skip re-rendering static parts (columns, filters, etc.) when only dynamic state (page, filter_values, etc.) changes.

Sub-builders

State initialization is composed of sub-builders that can be overridden:

• ColumnBuilder - Builds columns from DSL and resource
• FilterBuilder - Builds filters from DSL and resource
• ActionBuilder - Builds row/bulk actions
• Presentation - Resolves UI adapter and templates
• UrlSync - Handles URL state synchronization
• Access - Handles access control

User Override

Override the entire state module:

defmodule MyApp.Table.State do
  use MishkaGervaz.Table.Web.State

  def init(id, resource, user) do
    state = super(id, resource, user)
    %{state | custom_field: :value}
  end
end

Override specific sub-builders:

defmodule MyApp.Table.State do
  use MishkaGervaz.Table.Web.State,
    column: MyApp.Table.ColumnBuilder,
    filter: MyApp.Table.FilterBuilder
end

Or override via DSL:

mishka_gervaz do
  table do
    state do
      column MyApp.Table.ColumnBuilder
      filter MyApp.Table.FilterBuilder
    end
  end
end

Override entire state module via DSL:

mishka_gervaz do
  table do
    state module: MyApp.Table.CustomState
  end
end

Helper Functions

Helper functions are available in MishkaGervaz.Table.Web.State.Helpers and can be used when overriding state functions:

defmodule MyApp.Table.State do
  use MishkaGervaz.Table.Web.State
  alias MishkaGervaz.Table.Web.State.Helpers, as: StateHelpers

  def hydrate_relation_filter_labels(state) do
    # Use helpers in your override
    StateHelpers.hydrate_filter(filter, acc, state)
  end
end

See MishkaGervaz.Table.Web.State.Helpers, MishkaGervaz.Table.Web.State.ColumnBuilder, MishkaGervaz.Table.Web.State.FilterBuilder, MishkaGervaz.Table.Web.State.ActionBuilder, MishkaGervaz.Table.Web.State.Presentation, MishkaGervaz.Table.Web.State.UrlSync, MishkaGervaz.Table.Web.State.Access, MishkaGervaz.Table.Web.AutoState, MishkaGervaz.Table.Web.Refresh, MishkaGervaz.Table.Web.UrlSync.