Allow modal close button (or other dismissive actions) to cancel parent actions

[CamKemBell]

Description

In workflows with chained nested actions, closing a modal only dismisses the innermost modal, leaving parent modals open with any prefilled form state intact. This means a user intending to abandon a multi-step flow has to close each modal individually, and there is no way to collapse the
entire action stack in one interaction.

This PR adds modalDismissesParentActions() as a dedicated, first-class method on actions to control what happens when a modal is dismissed. When set, dismissing the modal in any way — close button, Esc key, or clicking the backdrop — will cancel the configured parent actions.

API:

• ->modalDismissesParentActions() — dismiss all parent actions when this modal is closed
• ->modalDismissesParentActions('parentActionName') — dismiss up to a named parent action

Docs:

• new section under the modal docs to explain the functionality.

How it works:
The modal component fires a modal-closed event for every dismissal method (close button, Esc, backdrop click). The action-modal blade template listens for this event and calls unmountAction() with the configured cancellation behaviour.

// Cancel all parent actions when a modal is dismissed via any method                                                                                                                                                                                                                                                           
Action::make('confirmCreation')
    ->requiresConfirmation()
    ->modalCloseButton()
    ->modalDismissesParentActions();

// Cancel back to a specific named parent                                                                                                                                                                                                                                                                       
Action::make('editPostMetadata')
    ->requiresConfirmation()                                                                                                                                                                                                                                                                                    
    ->modalDismissesParentActions(cancelParentActions: 'createPost')

Visual changes

None.

Functional changes

• Code style has been fixed by running the composer cs command.
• Changes have been tested to not break existing functionality.
• Documentation is up-to-date.

[danharrin]

There's more than just the close button that closes the modal (Esc key, clicking backdrop, etc) so it feels a bit weird that the API is centered around that. Thoughts?

[CamKemBell]

There's more than just the close button that closes the modal (Esc key, clicking backdrop, etc) so it feels a bit weird that the API is centered around that. Thoughts?

@danharrin - Good point, I have reworked the PR (and updated the description) to move to a chainable method called ->modalDismissesParentActions() that will cancel parent actions for any dismissive action such as esc, close button or clicking backdrop.

Happy for any terminology changes if you don't like the dismissed wording, feel free to update it as you see fit, otherwise tell me what you'd like an I can made appropriate changes.

Originally was thinking along the lines of ->closingModalClosesParentActions(to: 'actionName') but happy to go with whatever wording you'd prefer.

[CamKemBell]

@danharrin - wanted to get some feedback on the rework done on this PR, happy to make further changes if needed to help move it along.