godot-theme-easter

Overview

Seasonal "Easter-fy" toolkit: bright pastels, bouncy juice, egg/bunny iconography — gated by calendar + settings.

MANDATORY first read: easter_seasonal_activation_gate.gd — date window, Disable Seasonal Themes opt-out (user://settings.cfg), and Dev Override. Call refresh_activation() when settings change; never poll the calendar in _process.

Prerequisite: Do NOT Load godot-ui-theming until a base Theme resource exists — seasonal overlays inject StyleBox overrides; they do not replace foundational Theme authoring.

Seasonal Bootstrap (ordered)

1. Gate — Attach easter_seasonal_activation_gate.gd; call refresh_activation() on _ready and when settings change.
2. Theme — If gate active: MANDATORY easter_runtime_ui_themer.gd using tokens from easter_pastel_color_palette.gd.
3. Audio — MANDATORY easter_seasonal_audio_swapper.gd to map standard UI SFX → seasonal streams.
4. Juice — Layer confetti/shimmer/cursor/wobble scripts only after steps 1–3 pass (gate off = skip 2–4 entirely).

Decision Tree — Alternate Painters (pick one)