@homebridge-plugins/homebridge-matter 0.1.3 → 0.1.4

package/dist/devices/section-4-lighting/extended-color-light.js

@@ -5,32 +5,13 @@
  * - Color Light (HS): Hue/Saturation only
  * - Extended Color Light (HS+CCT): Hue/Saturation + Color Temperature
  *
- * Both use the same Matter device type (ExtendedColorLight) but with different
- * cluster configurations.
+ * For comprehensive documentation, see: ../../../MATTER_API.md
  *
- * ═══════════════════════════════════════════════════════════════════════════════
- * ARCHITECTURE: THE TWO-WAY FLOW (applies to all Matter accessories)
- * ═══════════════════════════════════════════════════════════════════════════════
- *
- * FLOW A: Home App → Physical Device (AUTOMATIC - via handlers)
- * ────────────────────────────────────────────────────────────────
- * 1. User controls via Home App
- * 2. Matter command → Homebridge → Your handler runs
- * 3. You control your physical device (API, MQTT, etc.)
- * 4. Homebridge AUTOMATICALLY updates Matter state
- * 5. All controllers are notified
- * ✅ No manual state update needed!
- *
- * FLOW B: Physical Device → Home App (MANUAL - you must update state)
- * ────────────────────────────────────────────────────────────────
- * 1. Physical device changes (button, cloud app, automation)
- * 2. ❌ Homebridge has NO IDEA this happened!
- * 3. You MUST monitor device and detect changes
- * 4. You MUST call api.matter.updateAccessoryState() for changed clusters
- * 5. Then all controllers are notified
- *
- * This demonstrates the MOST COMPLEX case with multiple color modes and clusters.
- * ═══════════════════════════════════════════════════════════════════════════════
+ * This example demonstrates:
+ * - Multiple color modes (HS, XY, Color Temperature)
+ * - Color value conversions (hue/saturation, mireds/Kelvin, XY)
+ * - Type-safe handlers with MatterRequests
+ * - Most complex lighting scenario with mode switching
  */
 export function registerExtendedColorLight(context) {
     const { api, log, config } = context;
@@ -64,16 +45,20 @@ export function registerExtendedColorLight(context) {
             handlers: {
                 onOff: {
                     on: async () => {
-                        log.info('[Colour Light HS] ✓ Handler `on` called (user controlled via Home app)');
+                        log.info('[Colour Light HS] Turning ON');
+                        // TODO: await myLightAPI.turnOn()
                     },
                     off: async () => {
-                        log.info('[Colour Light HS] ✓ Handler `off` called (user controlled via Home app)');
+                        log.info('[Colour Light HS] Turning OFF');
+                        // TODO: await myLightAPI.turnOff()
                     },
                 },
                 levelControl: {
                     moveToLevelWithOnOff: async (request) => {
                         const { level } = request;
-                        log.info(`[Colour Light HS] ✓ Handler \`moveToLevel\` called with ${level} (${Math.round(level / 254 * 100)}%)`);
+                        const brightnessPercent = Math.round((level / 254) * 100);
+                        log.info(`[Colour Light HS] Setting brightness to ${brightnessPercent}%`);
+                        // TODO: await myLightAPI.setBrightness(brightnessPercent)
                     },
                 },
                 colorControl: {
@@ -81,29 +66,23 @@ export function registerExtendedColorLight(context) {
                         const { targetX, targetY, transitionTime } = request;
                         const xFloat = (targetX / 65535).toFixed(4);
                         const yFloat = (targetY / 65535).toFixed(4);
-                        log.info(`[Colour Light HS] ✓ Handler \`moveToColorLogic\` called with x=${targetX} (~${xFloat}), y=${targetY} (~${yFloat}), transition: ${transitionTime}s`);
+                        log.info(`[Colour Light HS] Setting XY color to (${xFloat}, ${yFloat})`);
+                        // TODO: await myLightAPI.setXY(xFloat, yFloat, transitionTime)
                     },
                     moveToHueAndSaturationLogic: async (request) => {
                         const { targetHue, targetSaturation, transitionTime } = request;
                         const hueDegrees = Math.round((targetHue / 254) * 360);
                         const saturationPercent = Math.round((targetSaturation / 254) * 100);
-                        log.info(`[Colour Light HS] ✓ Handler \`moveToHueAndSaturationLogic\` called with hue=${targetHue} (~${hueDegrees}°), saturation=${targetSaturation} (~${saturationPercent}%), transition: ${transitionTime}s`);
+                        log.info(`[Colour Light HS] Setting color to ${hueDegrees}°, ${saturationPercent}%`);
+                        // TODO: await myLightAPI.setColor(hueDegrees, saturationPercent, transitionTime)
                     },
-                    // NOTE: No moveToColorTemperatureLogic handler - this variant only supports color, not CCT
+                    // NOTE: No moveToColorTemperatureLogic - this variant only supports color, not CCT
                 },
             },
         });
     }
-    // ═══════════════════════════════════════════════════════════════════════════
-    // Variant 2: Extended Color Light (HS + CCT) - THE FULL EXAMPLE
-    // ═══════════════════════════════════════════════════════════════════════════
-    //
-    // This variant supports BOTH color modes:
-    // - Color mode (Hue/Saturation or XY)
-    // - White mode (Color Temperature in Mireds/Kelvin)
-    //
-    // HomeKit switches between these modes automatically based on user selection
-    // in the Home app.
+    // Variant 2: Extended Color Light (HS + CCT)
+    // Supports both color (Hue/Saturation or XY) and white (Color Temperature) modes
     if (config.enableExtendedColourLight) {
         const accessory = {
             uuid: api.matter.uuid.generate('matter-extended-colour-light'),
@@ -136,16 +115,20 @@ export function registerExtendedColorLight(context) {
             handlers: {
                 onOff: {
                     on: async () => {
-                        log.info('[Extended Colour Light] ✓ Handler `on` called (user controlled via Home app)');
+                        log.info('[Extended Colour Light] Turning ON');
+                        // TODO: await myLightAPI.turnOn()
                     },
                     off: async () => {
-                        log.info('[Extended Colour Light] ✓ Handler `off` called (user controlled via Home app)');
+                        log.info('[Extended Colour Light] Turning OFF');
+                        // TODO: await myLightAPI.turnOff()
                     },
                 },
                 levelControl: {
                     moveToLevelWithOnOff: async (request) => {
                         const { level } = request;
-                        log.info(`[Extended Colour Light] ✓ Handler \`moveToLevel\` called with ${level} (${Math.round(level / 254 * 100)}%)`);
+                        const brightnessPercent = Math.round((level / 254) * 100);
+                        log.info(`[Extended Colour Light] Setting brightness to ${brightnessPercent}%`);
+                        // TODO: await myLightAPI.setBrightness(brightnessPercent)
                     },
                 },
                 colorControl: {
@@ -153,375 +136,26 @@ export function registerExtendedColorLight(context) {
                         const { targetX, targetY, transitionTime } = request;
                         const xFloat = (targetX / 65535).toFixed(4);
                         const yFloat = (targetY / 65535).toFixed(4);
-                        log.info(`[Extended Colour Light] ✓ Handler \`moveToColorLogic\` called with x=${targetX} (~${xFloat}), y=${targetY} (~${yFloat}), transition: ${transitionTime}s`);
+                        log.info(`[Extended Colour Light] Setting XY color to (${xFloat}, ${yFloat})`);
+                        // TODO: await myLightAPI.setXY(xFloat, yFloat, transitionTime)
                     },
                     moveToHueAndSaturationLogic: async (request) => {
                         const { targetHue, targetSaturation, transitionTime } = request;
                         const hueDegrees = Math.round((targetHue / 254) * 360);
                         const saturationPercent = Math.round((targetSaturation / 254) * 100);
-                        log.info(`[Extended Colour Light] ✓ Handler \`moveToHueAndSaturationLogic\` called with hue=${targetHue} (~${hueDegrees}°), saturation=${targetSaturation} (~${saturationPercent}%), transition: ${transitionTime}s`);
+                        log.info(`[Extended Colour Light] Setting color to ${hueDegrees}°, ${saturationPercent}%`);
+                        // TODO: await myLightAPI.setColor(hueDegrees, saturationPercent, transitionTime)
                     },
                     moveToColorTemperatureLogic: async (request) => {
                         const { targetMireds, transitionTime } = request;
                         const kelvin = Math.round(1000000 / targetMireds);
-                        log.info(`[Extended Colour Light] ✓ Handler \`moveToColorTemperatureLogic\` called with ${targetMireds} mireds (~${kelvin}K), transition: ${transitionTime}s`);
+                        log.info(`[Extended Colour Light] Setting color temp to ${kelvin}K`);
+                        // TODO: await myLightAPI.setColorTemperature(kelvin, transitionTime)
                     },
                 },
             },
         };
         accessories.push(accessory);
-        // ═════════════════════════════════════════════════════════════════════════════
-        // READING STATE: Understanding Extended Color Light State
-        // ═════════════════════════════════════════════════════════════════════════════
-        //
-        // An Extended Color Light has MULTIPLE properties across THREE clusters:
-        //
-        // 1. onOff cluster (power state):
-        //    - onOff: boolean (true = on, false = off)
-        //
-        // 2. levelControl cluster (brightness):
-        //    - currentLevel: number (1-254, where 254 = 100%)
-        //
-        // 3. colorControl cluster (color/white):
-        //    - colorMode: number (0 = HS, 1 = XY, 2 = ColorTemp)
-        //    - currentHue: number (0-254, maps to 0-360 degrees)
-        //    - currentSaturation: number (0-254, maps to 0-100%)
-        //    - currentX: number (0-65535, CIE 1931 x coordinate)
-        //    - currentY: number (0-65535, CIE 1931 y coordinate)
-        //    - colorTemperatureMireds: number (147-454, reciprocal megakelvin)
-        //
-        // Example: Reading all properties at once
-        const readAllStateExample = () => {
-            // Power state
-            const isOn = accessory.clusters.onOff.onOff;
-            // Brightness
-            const level = accessory.clusters.levelControl.currentLevel;
-            const brightnessPercent = Math.round((level / 254) * 100);
-            // Color mode
-            const mode = accessory.clusters.colorControl.colorMode;
-            const modeNames = {
-                [api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation]: 'Hue/Saturation',
-                [api.matter.types.ColorControl.ColorMode.CurrentXAndCurrentY]: 'XY',
-                [api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds]: 'Color Temperature',
-            };
-            const modeName = modeNames[mode] || 'Unknown';
-            // Color values (HS)
-            const hue = accessory.clusters.colorControl.currentHue;
-            const saturation = accessory.clusters.colorControl.currentSaturation;
-            const hueDegrees = Math.round((hue / 254) * 360);
-            const saturationPercent = Math.round((saturation / 254) * 100);
-            // Color values (XY)
-            const x = accessory.clusters.colorControl.currentX;
-            const y = accessory.clusters.colorControl.currentY;
-            const xFloat = (x / 65535).toFixed(4);
-            const yFloat = (y / 65535).toFixed(4);
-            // White values (Color Temperature)
-            const mireds = accessory.clusters.colorControl.colorTemperatureMireds;
-            const kelvin = Math.round(1000000 / mireds);
-            log.info('[Extended Color Light] Complete State:');
-            log.info(`  Power: ${isOn ? 'ON' : 'OFF'}`);
-            log.info(`  Brightness: ${brightnessPercent}%`);
-            log.info(`  Color Mode: ${modeName}`);
-            log.info(`  Hue: ${hueDegrees}° (${hue})`);
-            log.info(`  Saturation: ${saturationPercent}% (${saturation})`);
-            log.info(`  X/Y: ${xFloat}, ${yFloat}`);
-            log.info(`  Color Temp: ${kelvin}K (${mireds} mireds)`);
-        };
-        // Uncomment to log complete state:
-        // readAllStateExample()
-        // ═════════════════════════════════════════════════════════════════════════════
-        // EXTERNAL UPDATES: Updating Extended Color Light State
-        // ═════════════════════════════════════════════════════════════════════════════
-        //
-        // With color lights, you need to handle different scenarios:
-        // 1. User changes power (on/off)
-        // 2. User changes brightness
-        // 3. User changes color (hue/saturation)
-        // 4. User changes to white mode (color temperature)
-        // 5. Any combination of the above!
-        //
-        // The key challenge: Your device API might use different formats than Matter
-        /**
-         * Example: Comprehensive polling for Extended Color Light
-         */
-        const startPollingExample = () => {
-            setInterval(async () => {
-                try {
-                    // ──────────────────────────────────────────────────────────────────────
-                    // STEP 1: Fetch state from your device
-                    // ──────────────────────────────────────────────────────────────────────
-                    // TODO: Replace with your actual device API
-                    // const state = await myLightAPI.getState(accessory.context.deviceId)
-                    //
-                    // Your device might return data like:
-                    // {
-                    //   "power": "on",
-                    //   "brightness": 75,        // 0-100%
-                    //   "mode": "color",         // "color" or "white"
-                    //   "hue": 180,              // 0-360 degrees
-                    //   "saturation": 100,       // 0-100%
-                    //   "colorTemp": 4000        // Kelvin
-                    // }
-                    // For this example, simulate device state:
-                    // const deviceState = {
-                    //   power: 'on',
-                    //   brightness: 75,
-                    //   mode: 'color',
-                    //   hue: 180,
-                    //   saturation: 100,
-                    //   colorTemp: 4000,
-                    // }
-                    // ──────────────────────────────────────────────────────────────────────
-                    // STEP 2: Read current HomeKit state
-                    // ──────────────────────────────────────────────────────────────────────
-                    const homekitIsOn = accessory.clusters.onOff.onOff;
-                    const homekitLevel = accessory.clusters.levelControl.currentLevel;
-                    const homekitBrightnessPercent = Math.round((homekitLevel / 254) * 100);
-                    const homekitColorMode = accessory.clusters.colorControl.colorMode;
-                    const homekitHue = accessory.clusters.colorControl.currentHue;
-                    const homekitSaturation = accessory.clusters.colorControl.currentSaturation;
-                    const homekitMireds = accessory.clusters.colorControl.colorTemperatureMireds;
-                    // ──────────────────────────────────────────────────────────────────────
-                    // STEP 3: Compare and update as needed
-                    // ──────────────────────────────────────────────────────────────────────
-                    // Power changed?
-                    // const deviceIsOn = deviceState.power === 'on'
-                    // if (deviceIsOn !== homekitIsOn) {
-                    //   log.info(`[Extended Color Light] Power changed: ${deviceIsOn ? 'ON' : 'OFF'}`)
-                    //   accessory.clusters.onOff.onOff = deviceIsOn
-                    //   await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.OnOff, { onOff: deviceIsOn })
-                    // }
-                    // Brightness changed?
-                    // if (deviceState.brightness !== homekitBrightnessPercent) {
-                    //   log.info(`[Extended Color Light] Brightness changed: ${deviceState.brightness}%`)
-                    //   const newLevel = Math.max(1, Math.round((deviceState.brightness / 100) * 254))
-                    //   accessory.clusters.levelControl.currentLevel = newLevel
-                    //   await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.LevelControl, { currentLevel: newLevel })
-                    // }
-                    // Color mode or values changed?
-                    // if (deviceState.mode === 'color') {
-                    //   // ────────────────────────────────────────────────────────────────
-                    //   // SCENARIO A: Device is in COLOR mode
-                    //   // ────────────────────────────────────────────────────────────────
-                    //
-                    //   // Convert device hue (0-360) to Matter hue (0-254)
-                    //   const newHue = Math.round((deviceState.hue / 360) * 254)
-                    //
-                    //   // Convert device saturation (0-100) to Matter saturation (0-254)
-                    //   const newSaturation = Math.round((deviceState.saturation / 100) * 254)
-                    //
-                    //   // Check if color actually changed
-                    //   const hueChanged = newHue !== homekitHue
-                    //   const saturationChanged = newSaturation !== homekitSaturation
-                    //   const modeChanged = homekitColorMode !== 0 // Not in HS mode
-                    //
-                    //   if (hueChanged || saturationChanged || modeChanged) {
-                    //     log.info(`[Extended Color Light] Color changed: H=${deviceState.hue}° S=${deviceState.saturation}%`)
-                    //
-                    //     // IMPORTANT: When updating color, you should update MULTIPLE properties
-                    //     // to keep HS and XY in sync (HomeKit can use either)
-                    //
-                    //     // Update colorMode to indicate we're using Hue/Saturation
-                    //     accessory.clusters.colorControl.colorMode = api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation
-                    //
-                    //     // Update hue and saturation
-                    //     accessory.clusters.colorControl.currentHue = newHue
-                    //     accessory.clusters.colorControl.currentSaturation = newSaturation
-                    //
-                    //     // Optional but recommended: Calculate and update XY values too
-                    //     // This ensures compatibility with controllers that prefer XY
-                    //     // You can use a color conversion library for this, or approximate:
-                    //     // const { x, y } = hueAndSaturationToXY(deviceState.hue, deviceState.saturation)
-                    //     // accessory.clusters.colorControl.currentX = Math.round(x * 65535)
-                    //     // accessory.clusters.colorControl.currentY = Math.round(y * 65535)
-                    //
-                    //     // Notify HomeKit of all color control changes at once
-                    //     await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.ColorControl, {
-                    //       colorMode: api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
-                    //       currentHue: newHue,
-                    //       currentSaturation: newSaturation,
-                    //       // currentX: Math.round(x * 65535),
-                    //       // currentY: Math.round(y * 65535),
-                    //     })
-                    //
-                    //     log.info(`[Extended Color Light] ✓ Updated to color mode: H=${deviceState.hue}° S=${deviceState.saturation}%`)
-                    //   }
-                    // } else if (deviceState.mode === 'white') {
-                    //   // ────────────────────────────────────────────────────────────────
-                    //   // SCENARIO B: Device is in WHITE mode (Color Temperature)
-                    //   // ────────────────────────────────────────────────────────────────
-                    //
-                    //   // Convert Kelvin to Mireds: mireds = 1,000,000 / kelvin
-                    //   const newMireds = Math.round(1000000 / deviceState.colorTemp)
-                    //
-                    //   // Check if color temp actually changed or mode switched
-                    //   const miredsChanged = newMireds !== homekitMireds
-                    //   const modeChanged = homekitColorMode !== api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds // Not in ColorTemp mode
-                    //
-                    //   if (miredsChanged || modeChanged) {
-                    //     log.info(`[Extended Color Light] Color temp changed: ${deviceState.colorTemp}K (${newMireds} mireds)`)
-                    //
-                    //     // Update colorMode to indicate we're using Color Temperature
-                    //     accessory.clusters.colorControl.colorMode = api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds
-                    //
-                    //     // Update color temperature
-                    //     accessory.clusters.colorControl.colorTemperatureMireds = newMireds
-                    //
-                    //     // Notify HomeKit
-                    //     await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.ColorControl, {
-                    //       colorMode: api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds,
-                    //       colorTemperatureMireds: newMireds,
-                    //     })
-                    //
-                    //     log.info(`[Extended Color Light] ✓ Updated to white mode: ${deviceState.colorTemp}K`)
-                    //   }
-                    // }
-                }
-                catch (error) {
-                    log.error(`[Extended Color Light] Error polling device state: ${error}`);
-                }
-            }, 5000);
-        };
-        // Uncomment to enable polling:
-        // startPollingExample()
-        /**
-         * Example: Event-based updates (MQTT example with color support)
-         */
-        const startEventListenerExample = () => {
-            // Example: MQTT listener that handles color changes
-            // mqttClient.subscribe('home/extended-light/state')
-            // mqttClient.on('message', async (topic, message) => {
-            //   if (topic === 'home/extended-light/state') {
-            //     const deviceState = JSON.parse(message.toString())
-            //     // Example: { "power": "on", "brightness": 75, "mode": "color", "hue": 180, "saturation": 100 }
-            //
-            //     let updated = false
-            //
-            //     // Update power
-            //     const deviceIsOn = deviceState.power === 'on'
-            //     if (deviceIsOn !== accessory.clusters.onOff.onOff) {
-            //       accessory.clusters.onOff.onOff = deviceIsOn
-            //       await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.OnOff, { onOff: deviceIsOn })
-            //       updated = true
-            //     }
-            //
-            //     // Update brightness
-            //     const currentPercent = Math.round((accessory.clusters.levelControl.currentLevel / 254) * 100)
-            //     if (deviceState.brightness !== currentPercent) {
-            //       const newLevel = Math.max(1, Math.round((deviceState.brightness / 100) * 254))
-            //       accessory.clusters.levelControl.currentLevel = newLevel
-            //       await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.LevelControl, { currentLevel: newLevel })
-            //       updated = true
-            //     }
-            //
-            //     // Update color
-            //     if (deviceState.mode === 'color') {
-            //       const newHue = Math.round((deviceState.hue / 360) * 254)
-            //       const newSat = Math.round((deviceState.saturation / 100) * 254)
-            //       if (newHue !== accessory.clusters.colorControl.currentHue ||
-            //           newSat !== accessory.clusters.colorControl.currentSaturation ||
-            //           accessory.clusters.colorControl.colorMode !== api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation) {
-            //         accessory.clusters.colorControl.colorMode = api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation
-            //         accessory.clusters.colorControl.currentHue = newHue
-            //         accessory.clusters.colorControl.currentSaturation = newSat
-            //         await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.ColorControl, {
-            //           colorMode: api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation,
-            //           currentHue: newHue,
-            //           currentSaturation: newSat,
-            //         })
-            //         updated = true
-            //       }
-            //     } else if (deviceState.mode === 'white' && deviceState.colorTemp) {
-            //       const newMireds = Math.round(1000000 / deviceState.colorTemp)
-            //       if (newMireds !== accessory.clusters.colorControl.colorTemperatureMireds ||
-            //           accessory.clusters.colorControl.colorMode !== api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds) {
-            //         accessory.clusters.colorControl.colorMode = api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds
-            //         accessory.clusters.colorControl.colorTemperatureMireds = newMireds
-            //         await api.matter.updateAccessoryState(accessory.uuid, api.matter.clusterNames.ColorControl, {
-            //           colorMode: api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds,
-            //           colorTemperatureMireds: newMireds,
-            //         })
-            //         updated = true
-            //       }
-            //     }
-            //
-            //     if (updated) {
-            //       log.info(`[Extended Color Light] ✓ Updated from MQTT`)
-            //     }
-            //   }
-            // })
-        };
-        // Uncomment to enable event listeners:
-        // startEventListenerExample()
-        // ═════════════════════════════════════════════════════════════════════════════
-        // KEY TAKEAWAYS FOR EXTENDED COLOR LIGHTS:
-        // ═════════════════════════════════════════════════════════════════════════════
-        //
-        // 0. TWO SEPARATE FLOWS (applies to all devices):
-        //    FLOW A (Home App → Physical Device):
-        //    - Handlers run when user controls via Home app
-        //    - You control the physical device
-        //    - Homebridge AUTOMATICALLY updates Matter state after handler
-        //    - DO NOT call api.matter.updateAccessoryState() in handlers!
-        //
-        //    FLOW B (Physical Device → Home App):
-        //    - Physical device changes externally
-        //    - You MUST monitor device and detect changes
-        //    - You MUST call api.matter.updateAccessoryState() for changed clusters
-        //    - Then all controllers are notified
-        //
-        // 1. COLOR MODES:
-        //    - api.matter.types.ColorControl.ColorMode.CurrentHueAndCurrentSaturation (0): Hue/Saturation (0-254 each)
-        //    - api.matter.types.ColorControl.ColorMode.CurrentXAndCurrentY (1): CIE 1931 color space (0-65535 each)
-        //    - api.matter.types.ColorControl.ColorMode.ColorTemperatureMireds (2): Color Temperature in mireds
-        //    - Always update colorMode when switching between color and white
-        //
-        // 2. VALUE CONVERSIONS:
-        //    Hue:
-        //      - Device (degrees): 0-360
-        //      - Matter: 0-254
-        //      - To Matter: Math.round((degrees / 360) * 254)
-        //      - From Matter: Math.round((value / 254) * 360)
-        //
-        //    Saturation:
-        //      - Device (percent): 0-100
-        //      - Matter: 0-254
-        //      - To Matter: Math.round((percent / 100) * 254)
-        //      - From Matter: Math.round((value / 254) * 100)
-        //
-        //    Color Temperature:
-        //      - Device (Kelvin): 2200-6800
-        //      - Matter (Mireds): 147-454
-        //      - To Mireds: Math.round(1000000 / kelvin)
-        //      - To Kelvin: Math.round(1000000 / mireds)
-        //
-        //    XY (if needed):
-        //      - Device (float): 0.0-1.0
-        //      - Matter: 0-65535
-        //      - To Matter: Math.round(float * 65535)
-        //      - From Matter: (value / 65535)
-        //
-        // 3. UPDATING COLOR STATE (Physical Device → Home App):
-        //    - Always update colorMode when switching between color and white
-        //    - Use api.matter.updateAccessoryState(uuid, api.matter.clusterNames.ColorControl, { ... })
-        //    - Update all color values at once in the attributes object
-        //    - Keep HS and XY in sync for best compatibility (use color conversion)
-        //    - ONLY use this for FLOW B (external changes), NOT in handlers!
-        //
-        // 4. READING STATE:
-        //    - Check colorMode to know which values are currently active
-        //    - CurrentHueAndCurrentSaturation or CurrentXAndCurrentY: Use color values (hue/sat or XY)
-        //    - ColorTemperatureMireds: Use colorTemperatureMireds
-        //    - Brightness (currentLevel) is independent of color mode
-        //    - Access via: accessory.clusters.colorControl.colorMode, etc.
-        //
-        // 5. COMMON PITFALLS:
-        //    - Calling updateAccessoryState() in handlers (it's automatic!)
-        //    - Forgetting to update colorMode when switching between color and white
-        //    - Using wrong conversion formulas (degrees vs 0-254 range)
-        //    - Not handling all three color modes your device supports
-        //    - Using old api.matter.updateCluster() instead of updateAccessoryState()
-        // ═════════════════════════════════════════════════════════════════════════════
     }
     return accessories;
 }

package/dist/devices/section-4-lighting/extended-color-light.js.map

@@ -1 +1 @@
-{"version":3,"file":"extended-color-light.js","sourceRoot":"","sources":["../../../src/devices/section-4-lighting/extended-color-light.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extended-color-light.js","sourceRoot":"","sources":["../../../src/devices/section-4-lighting/extended-color-light.ts"],"names":[],"mappings":"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"}

package/dist/devices/section-4-lighting/on-off-light.d.ts

@@ -1,36 +1,16 @@
 /**
  * On/Off Light Device (Matter Spec § 4.1)
  *
- * The On/Off Light is a lighting device that is capable of being switched on or off.
+ * A basic lighting device that can be switched on or off.
  *
- * ═══════════════════════════════════════════════════════════════════════════════
- * CRITICAL ARCHITECTURE UNDERSTANDING - THE TWO-WAY FLOW:
- * ═══════════════════════════════════════════════════════════════════════════════
+ * For comprehensive documentation on Matter concepts, handlers, state management,
+ * and the two-way flow architecture, see:
+ * ../../../MATTER_API.md
  *
- * There are TWO separate flows for a Homebridge Matter plugin:
- *
- * FLOW A: Home App → Physical Device (AUTOMATIC - via handlers)
- * ────────────────────────────────────────────────────────────────
- * 1. User taps in Home App
- * 2. Matter command received by Homebridge
- * 3. Your handler runs (on/off methods below)
- * 4. You control your physical device (API call, MQTT, etc.)
- * 5. Homebridge AUTOMATICALLY updates Matter state
- * 6. All controllers (iPhone, iPad, etc.) are notified
- * ✅ No manual state update needed!
- *
- * FLOW B: Physical Device → Home App (MANUAL - you must update state)
- * ────────────────────────────────────────────────────────────────
- * 1. User presses physical button on device (OR cloud app, automation, etc.)
- * 2. Physical device changes state
- * 3. ❌ Homebridge has NO IDEA this happened!
- * 4. You MUST detect the change (via polling, MQTT, webhook, etc.)
- * 5. You MUST call api.matter.updateAccessoryState() to update Matter
- * 6. Then all controllers are notified
- * ⚠️  If you don't do step 5, Home App shows wrong state!
- *
- * This example demonstrates BOTH flows in detail.
- * ═══════════════════════════════════════════════════════════════════════════════
+ * This example demonstrates:
+ * - Basic OnOff cluster implementation
+ * - Handler setup for on/off commands (Flow A)
+ * - Event-based state monitoring (Flow B)
  */
 import type { DeviceContext } from '../types.js';
 export declare function registerOnOffLight(context: DeviceContext): any[];