Merge branch 'next' into tuya-string-doc

Author: dwmw2

.claude/instructions.md

@@ -197,6 +197,7 @@ Use GitHub-style alert syntax:
 - **Bug fixes and documentation corrections**: Target the `current` branch
 - **New features and new component docs**: Target the `next` branch
 - **Create separate branches** for each pull request (one PR per feature/fix)
+- **Always branch from the target branch**: Use `git checkout -b <branch-name> current` or `git checkout -b <branch-name> next` to ensure you're branching from the correct base, not whatever branch is currently checked out
 
 ### Commit Messages
 - Use clear, descriptive commit messages
@@ -209,8 +210,9 @@ Use GitHub-style alert syntax:
 ### Pull Request Process
 1. Ensure all changes are committed to the feature branch
 2. Push to origin: `git push -u origin <branch-name>`
-3. All automated tests must pass before review
-4. Follow retry logic for network failures (exponential backoff: 2s, 4s, 8s, 16s)
+3. Create the PR using the `.github/PULL_REQUEST_TEMPLATE.md` template - fill out all sections completely without removing any parts of the template
+4. All automated tests must pass before review
+5. Follow retry logic for network failures (exponential backoff: 2s, 4s, 8s, 16s)
 
 ## Testing and Preview
 

.github/workflows/auto-label-pr.yml

@@ -30,7 +30,7 @@ jobs:
 
       - name: Generate a token
         id: generate-token
-        uses: actions/create-github-app-token@67018539274d69449ef7c02e8e71183d1719ab42 # v2.1.4
+        uses: actions/create-github-app-token@29824e69f54612133e76f7eaac726eef6c875baf # v2.2.1
         with:
           app-id: ${{ secrets.ESPHOME_GITHUB_APP_ID }}
           private-key: ${{ secrets.ESPHOME_GITHUB_APP_PRIVATE_KEY }}

content/changelog/2025.12.0.md

@@ -12,7 +12,7 @@ params:
 "CC1101","components/cc1101","cc1101.webp",""
 "HC8","components/sensor/hc8","hc8.png",""
 "HLW8032","components/sensor/hlw8032","hlw8032.png",""
-"HUB75","components/display/hub75","hub75.svg",""
+"HUB75 LED Matrix","components/display/hub75","hub75.svg",""
 "STTS22H","components/sensor/stts22h","stts22h.jpg",""
 "ThermoPro BLE","components/sensor/thermopro_ble","thermopro_tp357.jpg",""
 "USB CDC-ACM","components/usb_cdc_acm","usb.svg","dark-invert"
@@ -588,6 +588,10 @@ For detailed migration guides and API documentation, see the [ESPHome Developers
 - [micronova] Fix test UART package key to match directory name [esphome#12391](https://github.com/esphome/esphome/pull/12391) by [@bdraco](https://github.com/bdraco)
 - [tests] Fix clang-tidy warnings in custom_api_device_component fixture [esphome#12390](https://github.com/esphome/esphome/pull/12390) by [@bdraco](https://github.com/bdraco)
 - [core] Packages refactor and conditional package inclusion (package refactor part 1) [esphome#11605](https://github.com/esphome/esphome/pull/11605) by [@jpeletier](https://github.com/jpeletier) (new-feature)
+- [light] Add zero-copy support for API effect commands [esphome#12384](https://github.com/esphome/esphome/pull/12384) by [@bdraco](https://github.com/bdraco)
+- [api] Fix potential buffer overflow in noise PSK base64 decode [esphome#12395](https://github.com/esphome/esphome/pull/12395) by [@bdraco](https://github.com/bdraco)
+- [esp8266] Eliminate up to 16ms socket latency [esphome#12397](https://github.com/esphome/esphome/pull/12397) by [@bdraco](https://github.com/bdraco)
+- [http_request] Skip update check when network not connected [esphome#12418](https://github.com/esphome/esphome/pull/12418) by [@swoboda1337](https://github.com/swoboda1337)
 
 </details>
 

content/components/openthread.md

@@ -58,10 +58,12 @@ openthread:
 - **channel** (int): Channel number from 11 to 26
 - **network_name** (string): A human-readable Network Name
 - **network_key** (string): OpenThread network key
-- **panid** (string): 2-byte Personal Area Network ID (PAN ID)
-- **extpanid** (string): 8-byte Extended Personal Area Network ID (XPAN ID)
+- **pan_id** (string): 2-byte Personal Area Network ID (PAN ID)
+- **ext_pan_id** (string): 8-byte Extended Personal Area Network ID (XPAN ID)
 - **pskc** (string): PSKc is used to authenticate an external Thread Commissioner to a Thread network
 - **mesh_local_prefix** (ipv6network): Used to build Mesh-Local IPv6 addresses (ML-EIDs), which are unique to each Thread device within the network partition
+- **force_dataset** (*Optional*, bool): Forces ESPHome configuration to override any previously stored OpenThread
+  network dataset on the device, ensuring configured parameters are always applied at startup. Defaults to `false`
 - **use_address** (*Optional*, string): Manually override what address to use to connect
   to the ESP. Defaults to auto-generated value.
 - **poll_period** (*Optional*, [Time](/guides/configuration-types#config-time)): When Poll_Period is set on an MTD device, the parent router will enqueue any messages and wait for the child to submit a poll data request

content/components/output/ac_dimmer.md

@@ -7,13 +7,6 @@ params:
     image: ac_dimmer.svg
 ---
 
-> [!WARNING]
-> This component has not been fully tested yet, if you are testing this component
-> please share your experience with the dimmer hardware and light model and
-> configuration here <https://github.com/esphome/feature-requests/issues/278>
->
-> Thanks!
-
 The `ac_dimmer` component allows you to connect a dimmable light or other load
 which supports phase control dimming to your ESPHome project.
 

content/components/update/esp32_hosted.md

@@ -64,14 +64,14 @@ firmware should be built using the ESP-IDF framework and the resulting `.bin` fi
 configuration directory.
 
 ```sh
-# Build instructions for IDF 5.5.1 and ESP Hosted 2.6.1
+# Build instructions for IDF 5.5.1 and ESP Hosted 2.7.0
 git clone -b v5.5.1 --recursive https://github.com/espressif/esp-idf.git
 cd esp-idf
 ./install.sh esp32c6
 source export.sh  # for Linux/macOS
 export.bat        # for Windows
 cd ..
-idf.py create-project-from-example "espressif/esp_hosted^2.6.1:slave"
+idf.py create-project-from-example "espressif/esp_hosted^2.7.0:slave"
 cd slave/
 idf.py set-target esp32c6
 idf.py build

content/guides/supporters.md

@@ -2290,4 +2290,4 @@ ESPHome was originally founded by [Otto Winter (@OttoWinter)](https://github.com
 - [Christian Zufferey (@zuzu59)](https://github.com/zuzu59)
 - [Zynth-dev (@Zynth-dev)](https://github.com/Zynth-dev)
 
-*This page was last updated December 9, 2025.*
+*This page was last updated December 12, 2025.*