2026.4.3

What's changed

single_press — architecture restored (fire-on-press)

single_press now fires immediately on the first valid signal of an interaction:

• on press (robust to a lost release telegram), or
• on a coherent orphan_release (press was lost, sequence gap == 2)

This restores robustness to both BLE telegram losses. One single_press per interaction, including long press cycles — use in simple mode only (do not combine with long_press/long_release on the same button).

Documentation — Usage rules + rewritten examples

• Usage rules section added: simple vs advanced mode, reliability table, why not to mix modes
• Example 1 (A0 — simple toggle): single_press → light.toggle
• Example 2 (A1 — advanced on/off): wait_for_trigger pattern — triggers on press, waits for release (short → turn on) or long_press (long → turn off); release_timeout terminates cleanly if release is lost
• Example 3 (B0/B1 — dimming): unchanged, already includes to: press Rule 3 stop trigger

Upgrade notes

• Simple mode (single_press): no automation change needed — more reliable than before
• Advanced mode: if you used from: press to: release as a short-press discriminator, replace with the wait_for_trigger pattern shown in Example 2 (the sensor state now passes through single_press between press and release)