@@ -8,6 +8,16 @@ part 'confirm_action.g.dart';
 
 /// Asks the user to confirm, e.g. "Leave album?", then runs [actions] when
 /// they confirm and [cancelActions] when they cancel or dismiss the dialog.
+///
+/// By default the dialog is built by the runtime and takes the app's look:
+/// its font, primary color and surface come from the layout that shows it.
+/// The optional color and radius fields override that look.
+///
+/// With a [dialogId] the dialog is that canvas instead, like
+/// [ShowDialogAction]. A button in it answers the dialog with a "Navigate
+/// back" action whose params hold [resultKey]: `true` confirms, anything else
+/// cancels. Closing the dialog any other way cancels. The params popped with a
+/// confirm are the `${result}` the [actions] read.
 @JsonSerializable()
 class ConfirmAction extends ActionModel with Equatable, SerializableMixin {
   /// The dialog's title. Supports variables and formulas.
@@ -32,6 +42,54 @@ class ConfirmAction extends ActionModel with Equatable, SerializableMixin {
   /// Actions to run, in order, when the user cancels.
   final List<ActionModel> cancelActions;
 
+  /// Id of a canvas to show as the dialog instead of the built-in one, or
+  /// null for the built-in dialog.
+  final String? dialogId;
+
+  /// Parameters passed to the [dialogId] canvas, like
+  /// [ShowDialogAction.params].
+  final Map<String, dynamic> params;
+
+  /// Whether tapping outside the dialog dismisses it, which cancels.
+  final bool barrierDismissible;
+
+  /// Color of the barrier behind the dialog. Null uses the platform's
+  /// default scrim.
+  final ColorRGBA? barrierColor;
+
+  /// Background of the built-in dialog. Null uses the app's surface color.
+  final ColorRGBA? backgroundColor;
+
+  /// Title and message color of the built-in dialog. Null uses the app's
+  /// text color.
+  final ColorRGBA? textColor;
+
+  /// Fill of the built-in dialog's confirm button. Null uses the app's
+  /// primary color, or its error color when [destructive].
+  final ColorRGBA? confirmColor;
+
+  /// Corner radius of the built-in dialog. Null follows the app's buttons.
+  final double? cornerRadius;
+
+  /// The key of the "Navigate back" params that answers a [dialogId] dialog.
+  static const String resultKey = 'confirmed';
+
+  /// Whether a dialog that closed with [result] was confirmed: a map (the
+  /// params of a "Navigate back" action) whose [resultKey] is true, or true.
+  static bool isConfirmResult(Object? result) {
+    final Object? value = result is Map ? result[resultKey] : result;
+    if (value is bool) return value;
+    if (value is num) return value != 0;
+    if (value is String) {
+      final String text = value.trim().toLowerCase();
+      return text == 'true' ||
+          text == 'yes' ||
+          text == '1' ||
+          text == 'confirm';
+    }
+    return false;
+  }
+
   /// Creates a [ConfirmAction].
   ConfirmAction({
     required this.title,
@@ -41,10 +99,19 @@ class ConfirmAction extends ActionModel with Equatable, SerializableMixin {
     this.destructive = false,
     List<ActionModel>? actions,
     List<ActionModel>? cancelActions,
+    this.dialogId,
+    Map<String, dynamic>? params,
+    this.barrierDismissible = true,
+    this.barrierColor,
+    this.backgroundColor,
+    this.textColor,
+    this.confirmColor,
+    this.cornerRadius,
     super.nonBlocking,
     super.enabled,
   }) : actions = actions ?? [],
        cancelActions = cancelActions ?? [],
+       params = params ?? {},
        super(type: ActionType.confirm);
 
   /// Duplicates this action with the given values replaced.
@@ -56,6 +123,20 @@ class ConfirmAction extends ActionModel with Equatable, SerializableMixin {
     bool? destructive,
     List<ActionModel>? actions,
     List<ActionModel>? cancelActions,
+    String? dialogId,
+    bool clearDialogId = false,
+    Map<String, dynamic>? params,
+    bool? barrierDismissible,
+    ColorRGBA? barrierColor,
+    bool clearBarrierColor = false,
+    ColorRGBA? backgroundColor,
+    bool clearBackgroundColor = false,
+    ColorRGBA? textColor,
+    bool clearTextColor = false,
+    ColorRGBA? confirmColor,
+    bool clearConfirmColor = false,
+    double? cornerRadius,
+    bool clearCornerRadius = false,
   }) => ConfirmAction(
     title: title ?? this.title,
     message: message ?? this.message,
@@ -64,6 +145,16 @@ class ConfirmAction extends ActionModel with Equatable, SerializableMixin {
     destructive: destructive ?? this.destructive,
     actions: actions ?? this.actions,
     cancelActions: cancelActions ?? this.cancelActions,
+    dialogId: clearDialogId ? null : dialogId ?? this.dialogId,
+    params: params ?? this.params,
+    barrierDismissible: barrierDismissible ?? this.barrierDismissible,
+    barrierColor: clearBarrierColor ? null : barrierColor ?? this.barrierColor,
+    backgroundColor: clearBackgroundColor
+        ? null
+        : backgroundColor ?? this.backgroundColor,
+    textColor: clearTextColor ? null : textColor ?? this.textColor,
+    confirmColor: clearConfirmColor ? null : confirmColor ?? this.confirmColor,
+    cornerRadius: clearCornerRadius ? null : cornerRadius ?? this.cornerRadius,
     nonBlocking: nonBlocking,
     enabled: enabled,
   );
@@ -77,6 +168,14 @@ class ConfirmAction extends ActionModel with Equatable, SerializableMixin {
     destructive,
     actions,
     cancelActions,
+    dialogId,
+    params,
+    barrierDismissible,
+    barrierColor,
+    backgroundColor,
+    textColor,
+    confirmColor,
+    cornerRadius,
   ];
 
   /// Creates an instance from a JSON object.
 
@@ -6,8 +6,54 @@ import '../models.dart';
 
 part 'show_toast_action.g.dart';
 
-/// An action that shows a short message in a pill near the bottom of the
-/// screen, then hides it.
+/// The look of a [ShowToastAction], colored from the app's theme.
+enum ToastStyle {
+  /// Dark on a light app and light on a dark one, like a snackbar.
+  neutral,
+
+  /// The app's primary color.
+  info,
+
+  /// Green.
+  success,
+
+  /// Amber.
+  warning,
+
+  /// The app's error color.
+  error;
+
+  /// Displayable name.
+  String get prettify => switch (this) {
+    ToastStyle.neutral => 'Neutral',
+    ToastStyle.info => 'Info',
+    ToastStyle.success => 'Success',
+    ToastStyle.warning => 'Warning',
+    ToastStyle.error => 'Error',
+  };
+}
+
+/// Where a [ShowToastAction] shows on screen.
+enum ToastPosition {
+  /// Above the bottom edge.
+  bottom,
+
+  /// Below the top edge and its safe area.
+  top;
+
+  /// Displayable name.
+  String get prettify => switch (this) {
+    ToastPosition.bottom => 'Bottom',
+    ToastPosition.top => 'Top',
+  };
+}
+
+/// An action that shows a short message near the bottom or top of the screen,
+/// then hides it. The toast can carry a button, e.g. Undo, that runs
+/// [actions].
+///
+/// Its colors come from [style] and the app's theme unless [backgroundColor]
+/// or [textColor] are set. Its font is the app's.
 @JsonSerializable()
 class ShowToastAction extends ActionModel with Equatable, SerializableMixin {
   /// The message. Supports variables and formulas, e.g.
@@ -17,36 +63,64 @@ class ShowToastAction extends ActionModel with Equatable, SerializableMixin {
   /// How long the message stays on screen, in milliseconds.
   final int duration;
 
-  /// Pill color.
-  final ColorRGBA backgroundColor;
+  /// Background color. Null takes the [style]'s color from the app's theme.
+  final ColorRGBA? backgroundColor;
+
+  /// Message color. Null takes the color that reads on the background.
+  final ColorRGBA? textColor;
 
-  /// Message color.
-  final ColorRGBA textColor;
+  /// Which theme color the toast takes.
+  @JsonKey(unknownEnumValue: ToastStyle.neutral)
+  final ToastStyle style;
+
+  /// Where the toast shows.
+  @JsonKey(unknownEnumValue: ToastPosition.bottom)
+  final ToastPosition position;
+
+  /// Label of the toast's button, e.g. Undo. Supports variables. The toast
+  /// has no button when it is empty.
+  final String actionLabel;
+
+  /// Actions to run, in order, when the toast's button is tapped.
+  final List<ActionModel> actions;
 
   /// Optional icon before the message.
   final MultiSourceIconModel? icon;
 
-  /// Distance from the bottom of the screen.
+  /// Distance from the bottom of the screen when [position] is
+  /// [ToastPosition.bottom].
   final double bottomOffset;
 
   /// Creates a new [ShowToastAction].
   ShowToastAction({
     required this.message,
     this.duration = 2600,
-    this.backgroundColor = const ColorRGBA(r: 0.169, g: 0.141, b: 0.125, a: 1),
-    this.textColor = ColorRGBA.white,
+    this.backgroundColor,
+    this.textColor,
+    this.style = ToastStyle.neutral,
+    this.position = ToastPosition.bottom,
+    this.actionLabel = '',
+    List<ActionModel>? actions,
     this.icon,
     this.bottomOffset = 104,
     super.nonBlocking,
     super.enabled,
-  }) : super(type: ActionType.showToast);
+  }) : actions = actions ?? [],
+       super(type: ActionType.showToast);
+
+  /// Whether the toast shows a button.
+  bool get hasAction => actionLabel.trim().isNotEmpty;
 
   @override
   List<Object?> get props => [
     message,
     duration,
     backgroundColor,
     textColor,
+    style,
+    position,
+    actionLabel,
+    actions,
     icon,
     bottomOffset,
   ];
@@ -56,15 +130,27 @@ class ShowToastAction extends ActionModel with Equatable, SerializableMixin {
     String? message,
     int? duration,
     ColorRGBA? backgroundColor,
+    bool clearBackgroundColor = false,
     ColorRGBA? textColor,
+    bool clearTextColor = false,
+    ToastStyle? style,
+    ToastPosition? position,
+    String? actionLabel,
+    List<ActionModel>? actions,
     MultiSourceIconModel? icon,
     bool clearIcon = false,
     double? bottomOffset,
   }) => ShowToastAction(
     message: message ?? this.message,
     duration: duration ?? this.duration,
-    backgroundColor: backgroundColor ?? this.backgroundColor,
-    textColor: textColor ?? this.textColor,
+    backgroundColor: clearBackgroundColor
+        ? null
+        : backgroundColor ?? this.backgroundColor,
+    textColor: clearTextColor ? null : textColor ?? this.textColor,
+    style: style ?? this.style,
+    position: position ?? this.position,
+    actionLabel: actionLabel ?? this.actionLabel,
+    actions: actions ?? this.actions,
     icon: clearIcon ? null : icon ?? this.icon,
     bottomOffset: bottomOffset ?? this.bottomOffset,
     nonBlocking: nonBlocking,