Skip to content

Conversation

@bdraco
Copy link
Member

@bdraco bdraco commented Dec 7, 2025

Add blog post for light listener pattern migration (PR esphome/esphome#12166)

Documents the breaking change from CallbackManager to listener interfaces for light state callbacks in ESPHome 2025.12.0.

  • Migration guide from add_new_*_callback() to add_*_listener() methods
  • New LightRemoteValuesListener and LightTargetStateReachedListener interfaces
  • Version guard examples for backwards compatibility
  • Verified example compiles against ESPHome dev

@netlify
Copy link

netlify bot commented Dec 7, 2025

Deploy Preview for esphome-dev-docs ready!

Name Link
🔨 Latest commit 8439156
🔍 Latest deploy log https://app.netlify.com/projects/esphome-dev-docs/deploys/693604ade5d581000852fd93
😎 Deploy Preview https://deploy-preview-79--esphome-dev-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@bdraco bdraco changed the title Light State Callbacks: Listener Pattern Migration Light State Callbacks: Listener Pattern Migration blog post Dec 7, 2025
@bdraco bdraco marked this pull request as ready for review December 8, 2025 01:51
Copilot AI review requested due to automatic review settings December 8, 2025 01:51
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds comprehensive documentation for a breaking change in ESPHome 2025.12.0 that migrates light state callbacks from CallbackManager to a listener interface pattern. The blog post provides clear migration guidance for external component developers.

Key Changes:

  • Documents migration from add_new_*_callback() methods to add_*_listener() methods
  • Introduces LightRemoteValuesListener and LightTargetStateReachedListener interfaces
  • Provides version guard examples for backward compatibility

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants