spec: align FEATURE_ROW_ACTIONS.md with implementation

FEATURE_ROW_ACTIONS.md

@@ -6,64 +6,166 @@ Row actions are buttons or menu items displayed in a dedicated actions column, c
 
 ### `EasyGrid<T>` methods
 
+#### Adding row actions
+
+All `addRowAction` overloads append a new action to the actions column and return an `EasyRowAction<T>` that can be further configured via its fluent API (visibility, enablement, tooltip, confirmation).
+
+```java
+EasyRowAction<T> addRowAction(String label, SerializableConsumer<T> handler);
+```
+Adds a text-only action button. When the user clicks it, `handler` is invoked with the corresponding row item.
+
+---
+
+```java
+EasyRowAction<T> addRowAction(String label, Icon icon, SerializableConsumer<T> handler);
+EasyRowAction<T> addRowAction(String label, IconFactory iconFactory, SerializableConsumer<T> handler);
+```
+Adds an action button with both a label and a static icon rendered alongside it. `VaadinIcon` implements `IconFactory` and can be passed directly.
+
+---
+
 ```java
-// Add an action button (label + icon)
-EasyRowAction<T> addRowAction(String label, VaadinIcon icon, SerializableConsumer<T> handler);
+EasyRowAction<T> addRowAction(Icon icon, SerializableConsumer<T> handler);
+EasyRowAction<T> addRowAction(IconFactory iconFactory, SerializableConsumer<T> handler);
+```
+Adds an icon-only action button with no visible label. Useful when space is limited and the icon alone conveys the action.
 
-// Add an action button with a theme variant
-EasyRowAction<T> addRowAction(String label, VaadinIcon icon, ButtonVariant variant, SerializableConsumer<T> handler);
+---
 
-// Render all actions as a context menu (overflow menu) instead of inline buttons
+```java
+<ICON extends AbstractIcon<ICON>>
+EasyRowAction<T> addRowAction(ValueProvider<T, ICON> iconProvider, SerializableConsumer<T> handler);
+
+<ICON extends AbstractIcon<ICON>>
+EasyRowAction<T> addRowAction(String label, ValueProvider<T, ICON> iconProvider, SerializableConsumer<T> handler);
+```
+Adds an action button whose icon is resolved per row by calling `iconProvider` with the row item, so different rows may show a different icon for the same action. The optional `label` is shown alongside the dynamic icon.
+
+---
+
+#### Removing row actions
+
+```java
+void removeRowAction(EasyRowAction<T> action);
+```
+Removes the specified action from the actions column. Equivalent to calling `action.remove()`.
+
+---
+
+#### Rendering mode
+
+```java
 void setRowActionsAsMenu(boolean asMenu);
+```
+Controls how row actions are rendered. When `true`, all actions are presented as items in an overflow (context) menu triggered by a single button per row. When `false` (the default), each action is rendered as a separate inline button in the actions column.
 
-// Access the underlying Grid.Column for header, width, freezing, etc.
+---
+
+#### Accessing the actions column
+
+```java
 Grid.Column<T> getActionsColumn();
 ```
+Returns the `Grid.Column<T>` backing the actions column, allowing the caller to configure its header text, width, freeze position, or any other `Grid.Column` property. The actions column is created automatically when the first action is added.
+
+---
 
 ### `EasyRowAction<T>`
 
+All mutator methods return `this` to support method chaining.
+
+#### Visibility
+
+```java
+EasyRowAction<T> visibleWhen(SerializablePredicate<T> predicate);
+```
+Makes the action conditionally visible on a per-row basis. The predicate is evaluated against each row's item when the row is rendered; the action button is hidden for rows where the predicate returns `false`.
+
+---
+
+#### Enablement
+
+```java
+EasyRowAction<T> enabledWhen(SerializablePredicate<T> predicate);
+```
+Makes the action conditionally enabled on a per-row basis. The action button is shown in a disabled state (visible but not clickable) for rows where the predicate returns `false`.
+
+---
+
+#### Tooltip
+
 ```java
-public class EasyRowAction<T> {
-    // Conditional visibility
-    EasyRowAction<T> withVisibleWhen(SerializablePredicate<T> predicate);
+EasyRowAction<T> tooltip(String tooltip);
+```
+Sets a fixed tooltip displayed when the user hovers over the action button.
+
+```java
+EasyRowAction<T> tooltip(ValueProvider<T, String> tooltipProvider);
+```
+Sets a per-row tooltip resolved by calling `tooltipProvider` with the row item, so different rows may show different tooltip text for the same action.
 
-    // Conditional enablement
-    EasyRowAction<T> withEnabledWhen(SerializablePredicate<T> predicate);
+---
 
-    // Tooltip
-    EasyRowAction<T> withTooltip(String tooltip);
-    EasyRowAction<T> withTooltip(SerializableFunction<T, String> tooltipProvider);
+#### Confirmation
 
-    // Confirmation dialog before executing the action
-    EasyRowAction<T> withConfirmation(String message);
-    EasyRowAction<T> withConfirmation(String title, String message);
-}
+```java
+EasyRowAction<T> withConfirmation(String message);
+EasyRowAction<T> withConfirmation(String title, String message);
 ```
+Intercepts button clicks and presents a confirmation dialog before invoking the action handler. The handler is only called if the user confirms. `message` is the confirmation prompt shown to the user; the optional `title` sets the dialog heading.
+
+---
+
+#### Removal
+
+```java
+void remove();
+```
+Removes this action from the actions column and triggers an immediate re-render so the change is visible without waiting for a data refresh. Equivalent to calling `easyGrid.removeRowAction(this)`. If the action has already been removed, this call is a no-op. After removal the `EasyRowAction` reference is considered dead and cannot be re-added; call `addRowAction` again to create a new action.
+
+---
 
 ## Usage
 
 ```java
-// Inline action buttons
+// Label + VaadinIcon (VaadinIcon implements IconFactory)
 easyGrid.addRowAction("Edit", VaadinIcon.EDIT, person -> {
     editPerson(person);
 });
 
-easyGrid.addRowAction("Delete", VaadinIcon.TRASH, ButtonVariant.LUMO_ERROR, person -> {
+easyGrid.addRowAction("Delete", VaadinIcon.TRASH, person -> {
     personService.delete(person);
     easyGrid.getDataProvider().refreshAll();
 }).withConfirmation("Are you sure you want to delete this person?");
 
+// Label only
+easyGrid.addRowAction("Details", person -> showDetails(person));
+
+// Per-row dynamic icon
+easyGrid.addRowAction(
+    person -> person.isActive() ? VaadinIcon.CHECK.create() : VaadinIcon.CLOSE.create(),
+    person -> toggleActive(person)
+);
+
 // Actions as a context menu (overflow menu) instead of inline buttons
 easyGrid.setRowActionsAsMenu(true);
 
 // Conditional visibility
 easyGrid.addRowAction("Activate", VaadinIcon.CHECK, person -> {
     personService.activate(person);
-}).withVisibleWhen(person -> !person.isActive());
+}).visibleWhen(person -> !person.isActive());
 
 easyGrid.addRowAction("Deactivate", VaadinIcon.CLOSE, person -> {
     personService.deactivate(person);
-}).withVisibleWhen(person -> person.isActive());
+}).visibleWhen(person -> person.isActive());
+
+// Removing an action
+EasyRowAction<Person> adminAction = easyGrid.addRowAction("Purge", VaadinIcon.TRASH, item -> purge(item));
+// later:
+easyGrid.removeRowAction(adminAction);
+// or equivalently, if only the action reference is in scope:
+adminAction.remove();
 
 // Configure the actions column via the underlying Grid.Column
 easyGrid.getActionsColumn()