MishkaGervaz.Table.Web.AutoState (MishkaGervaz v0.0.5)

Built-in state-transition rules for tables.

Configured under the hooks.builtins DSL section. Each rule is opt-in (default false) except :clear_selection_after_bulk, which defaults to true.

Rules:

:switch_to_active_on_empty_archive — after a successful unarchive / permanent_destroy in :archived mode, switch to :active mode once the archive list is observed empty on the next load.
:switch_to_archive_on_empty_active — symmetric (rare; opt-in).
:clear_selection_after_bulk — read by the bulk action handler.
:reset_page_on_empty_current_page — if the current page becomes empty and page > 1, reload page 1.
:redirect_on_empty — when total_count == 0 after a load, navigate to a path (string) or fn state -> path end.

Flow

A row action that takes its row out of the view takes it off the total too, so after_row_action/3 answers the rules at once from that total, reading no rows. Bulk actions reload; after_bulk_action/3 arms the flag on the socket assigns. after_load/2 (called from DataLoader.handle_async) reads the armed flag, applies the relevant rule, and clears the flag.

See MishkaGervaz.Table.Web.State, MishkaGervaz.Table.Web.DataLoader, MishkaGervaz.Table.Web.Refresh, MishkaGervaz.Table.Dsl.Hooks (rules live under the hooks DSL section).

Summary

Types

socket()

Functions

after_bulk_action(socket, state, arg3)

Arm flags after a bulk action — the bulk handler already triggers a reload.

after_load(socket, state)

Apply built-in rules right after DataLoader.handle_async finishes loading.

after_row_action(socket, state, action_name)

Apply rules after a row action took its row out of the view.

config(state)

The built-in state-transition flags declared in hooks do … end.

enabled?(state, key)

Whether one built-in transition is switched on.

value(state, key)

The raw value of one built-in, for the flags that carry more than a boolean.