feat: Add festive visual effects (#2252)

<!-- CURSOR_SUMMARY -->
> [!NOTE]
> Introduces an effects system (fireworks, ghost, hearts, shamrocks,
snow), a new `effect` action, and optional date-based loading effects,
integrated into the card with docs, schema, editor, and tests.
> 
> - **Effects System**:
> - Add `EffectsController` and `advanced-camera-card-effects` host with
lazy-loaded effect modules (`fireworks`, `ghost`, `hearts`, `shamrocks`,
`snow`).
> - New base effect component with fade-in/out; SCSS and z-index
updates.
> - **Actions**:
> - New custom action `advanced_camera_card_action: effect` with
`effect_action` (`start`|`stop`|`toggle`).
>   - Wire into `ActionFactory` and add `EffectAction` executor.
> - **Card Integration**:
> - Mount effects host in `advanced-camera-card` and expose
`getEffectsControllerAPI()` via `CardController`.
> - Loading component can trigger date-based effects (e.g., New Year
fireworks) when enabled.
> - **Configuration & Editor**:
> - Add `performance.features.card_loading_effects` (default `true`)
alongside `card_loading_indicator`.
> - Update schemas, defaults, low-performance profile (disables
effects), and editor toggles.
> - **Docs & Examples**:
>   - Document `effect` action parameters and add menu example.
>   - Update performance docs with new option.
> - **Localization & Tests**:
>   - Update i18n strings for new performance option.
> - Add comprehensive tests for effects controller, action, factory,
config defaults/profiles, and utilities.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
cffd4304fe3bd22340316f9cec53e341379b1756. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

docs/configuration/actions/custom/README.md

@@ -94,6 +94,23 @@ advanced_camera_card_action: display_mode_select
 | `advanced_camera_card_action` | Must be `display_mode_select`.                                                                 |
 | `display_mode`                | `single` to show a single camera at a time in a carousel, or `grid` to show a grid of cameras. |
 
+## `effect`
+
+Trigger a visual effect.
+
+```yaml
+action: custom:advanced-camera-card-action
+advanced_camera_card_action: effect
+# [...]
+```
+
+| Parameter                     | Description                                                                           |
+| ----------------------------- | ------------------------------------------------------------------------------------- |
+| `action`                      | Must be `custom:advanced-camera-card-action`.                                         |
+| `advanced_camera_card_action` | Must be `effect`.                                                                     |
+| `effect`                      | The name of the effect, one of [`fireworks`, `ghost`, `hearts`, `shamrocks`, `snow`]. |
+| `effect_action`               | One of `start`, `stop` or `toggle`.                                                   |
+
 ## `download`
 
 Download the displayed media.
@@ -869,4 +886,12 @@ elements:
     tap_action:
       - action: custom:advanced-camera-card-action
         advanced_camera_card_action: reload
+  - type: custom:advanced-camera-card-menu-icon
+    icon: mdi:snow
+    title: Snow Effect
+    tap_action:
+      - action: custom:advanced-camera-card-action
+        advanced_camera_card_action: effect
+        effect: snow
+        effect_action: toggle
 ```