@homebridge-plugins/homebridge-matter 0.0.6 → 0.1.0

package/dist/devices/section-8-closure/door-lock.js

@@ -0,0 +1,48 @@
+/**
+ * Door Lock Device (Matter Spec § 8.1)
+ *
+ * A lock that can be locked and unlocked remotely.
+ */
+export function registerDoorLock(context) {
+    const { api, log, config } = context;
+    const accessories = [];
+    if (!config.enableDoorLock) {
+        return accessories;
+    }
+    accessories.push({
+        uuid: api.matter.uuid.generate('matter-door-lock'),
+        displayName: 'Door Lock',
+        deviceType: api.matter.deviceTypes.DoorLock,
+        serialNumber: 'LOCK-001',
+        manufacturer: 'Matter Examples',
+        model: 'DoorLock v1',
+        clusters: {
+            doorLock: {
+                // Lock state: 0=NotFullyLocked, 1=Locked, 2=Unlocked
+                lockState: 2, // Unlocked
+                // Lock type: 0=Deadbolt, 1=Magnetic, 2=Other, etc.
+                lockType: 0, // Deadbolt
+                // Actuator enabled (can be locked/unlocked)
+                actuatorEnabled: true,
+            },
+        },
+        handlers: {
+            doorLock: {
+                // Called when user locks the door
+                lockDoor: async () => {
+                    log.info('[Door Lock] ✓ Handler `lockDoor` called - Locking door');
+                    // Update the lock state to "Locked" (1)
+                    await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-door-lock'), 'doorLock', { lockState: 1 });
+                },
+                // Called when user unlocks the door
+                unlockDoor: async () => {
+                    log.info('[Door Lock] ✓ Handler `unlockDoor` called - Unlocking door');
+                    // Update the lock state to "Unlocked" (2)
+                    await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-door-lock'), 'doorLock', { lockState: 2 });
+                },
+            },
+        },
+    });
+    return accessories;
+}
+//# sourceMappingURL=door-lock.js.map

package/dist/devices/section-8-closure/door-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"door-lock.js","sourceRoot":"","sources":["../../../src/devices/section-8-closure/door-lock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACpC,MAAM,WAAW,GAAU,EAAE,CAAA;IAE7B,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAC3B,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,WAAW,CAAC,IAAI,CAAC;QACf,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAClD,WAAW,EAAE,WAAW;QACxB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ;QAC3C,YAAY,EAAE,UAAU;QACxB,YAAY,EAAE,iBAAiB;QAC/B,KAAK,EAAE,aAAa;QAEpB,QAAQ,EAAE;YACR,QAAQ,EAAE;gBACR,qDAAqD;gBACrD,SAAS,EAAE,CAAC,EAAE,WAAW;gBAEzB,mDAAmD;gBACnD,QAAQ,EAAE,CAAC,EAAE,WAAW;gBAExB,4CAA4C;gBAC5C,eAAe,EAAE,IAAI;aACtB;SACF;QAED,QAAQ,EAAE;YACR,QAAQ,EAAE;gBACR,kCAAkC;gBAClC,QAAQ,EAAE,KAAK,IAAI,EAAE;oBACnB,GAAG,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAA;oBAElE,wCAAwC;oBACxC,MAAM,GAAG,CAAC,MAAM,CAAC,oBAAoB,CACnC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAC5C,UAAU,EACV,EAAE,SAAS,EAAE,CAAC,EAAE,CACjB,CAAA;gBACH,CAAC;gBAED,oCAAoC;gBACpC,UAAU,EAAE,KAAK,IAAI,EAAE;oBACrB,GAAG,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAA;oBAEtE,0CAA0C;oBAC1C,MAAM,GAAG,CAAC,MAAM,CAAC,oBAAoB,CACnC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAC5C,UAAU,EACV,EAAE,SAAS,EAAE,CAAC,EAAE,CACjB,CAAA;gBACH,CAAC;aACF;SACF;KACF,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/devices/section-8-closure/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Section 8: Closure Devices
+ *
+ * Matter Specification § 8 - Locks and window coverings
+ */
+export { registerDoorLock } from './door-lock.js';
+export { registerWindowCovering } from './window-covering.js';

package/dist/devices/section-8-closure/index.js

@@ -0,0 +1,8 @@
+/**
+ * Section 8: Closure Devices
+ *
+ * Matter Specification § 8 - Locks and window coverings
+ */
+export { registerDoorLock } from './door-lock.js';
+export { registerWindowCovering } from './window-covering.js';
+//# sourceMappingURL=index.js.map

package/dist/devices/section-8-closure/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/devices/section-8-closure/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/devices/section-8-closure/window-covering.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Window Covering Device (Matter Spec § 8.3)
+ *
+ * Handles multiple variants:
+ * - Window Blind: Standard lift-only window covering
+ * - Venetian Blind: Window covering with both lift and tilt control
+ */
+import type { DeviceContext } from '../types.js';
+export declare function registerWindowCovering(context: DeviceContext): any[];

package/dist/devices/section-8-closure/window-covering.js

@@ -0,0 +1,154 @@
+/**
+ * Window Covering Device (Matter Spec § 8.3)
+ *
+ * Handles multiple variants:
+ * - Window Blind: Standard lift-only window covering
+ * - Venetian Blind: Window covering with both lift and tilt control
+ */
+export function registerWindowCovering(context) {
+    const { api, log, config } = context;
+    const accessories = [];
+    // Variant 1: Window Blind (lift only)
+    if (config.enableWindowBlind) {
+        accessories.push({
+            uuid: api.matter.uuid.generate('matter-window-blind'),
+            displayName: 'Window Blind',
+            deviceType: api.matter.deviceTypes.WindowCovering,
+            serialNumber: 'BLIND-001',
+            manufacturer: 'Matter Examples',
+            model: 'WindowBlind v1',
+            clusters: {
+                windowCovering: {
+                    // Target position (0 = fully closed, 10000 = fully open, in hundredths of percent)
+                    targetPositionLiftPercent100ths: 5000, // 50% open
+                    currentPositionLiftPercent100ths: 5000, // 50% open
+                    // Operational status
+                    operationalStatus: {
+                        global: 0, // Not moving
+                        lift: 0,
+                        tilt: 0,
+                    },
+                    // End product type
+                    endProductType: 0, // Rollershade
+                    // Configuration
+                    configStatus: {
+                        operational: true,
+                        onlineReserved: true,
+                        liftMovementReversed: false,
+                        liftPositionAware: true,
+                        tiltPositionAware: false,
+                        liftEncoderControlled: true,
+                        tiltEncoderControlled: false,
+                    },
+                },
+            },
+            handlers: {
+                windowCovering: {
+                    goToLiftPercentage: async (request) => {
+                        const percent = (request.targetPercent / 100).toFixed(0);
+                        log.info(`[Window Blind] ✓ Handler \`goToLiftPercentage\` called: ${request.targetPercent} (${percent}% open)`);
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-window-blind'), 'windowCovering', {
+                            currentPositionLiftPercent100ths: request.targetPercent,
+                            targetPositionLiftPercent100ths: request.targetPercent,
+                        });
+                    },
+                    upOrOpen: async () => {
+                        log.info('[Window Blind] ✓ Handler `upOrOpen` called - Opening blind');
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-window-blind'), 'windowCovering', {
+                            currentPositionLiftPercent100ths: 10000, // Fully open
+                            targetPositionLiftPercent100ths: 10000,
+                        });
+                    },
+                    downOrClose: async () => {
+                        log.info('[Window Blind] ✓ Handler `downOrClose` called - Closing blind');
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-window-blind'), 'windowCovering', {
+                            currentPositionLiftPercent100ths: 0, // Fully closed
+                            targetPositionLiftPercent100ths: 0,
+                        });
+                    },
+                    stopMotion: async () => {
+                        log.info('[Window Blind] ✓ Handler `stopMotion` called - Stopping blind');
+                    },
+                },
+            },
+        });
+    }
+    // Variant 2: Venetian Blind (lift + tilt)
+    if (config.enableVenetianBlind) {
+        accessories.push({
+            uuid: api.matter.uuid.generate('matter-venetian-blind'),
+            displayName: 'Venetian Blind (Tilt)',
+            deviceType: api.matter.deviceTypes.WindowCovering,
+            serialNumber: 'BLIND-002',
+            manufacturer: 'Matter Examples',
+            model: 'VenetianBlind v1',
+            clusters: {
+                windowCovering: {
+                    // Lift position (vertical position)
+                    targetPositionLiftPercent100ths: 5000, // 50% open
+                    currentPositionLiftPercent100ths: 5000,
+                    // Tilt position (slat angle: 0 = closed, 10000 = fully open)
+                    targetPositionTiltPercent100ths: 5000, // 50% tilted
+                    currentPositionTiltPercent100ths: 5000,
+                    // Operational status
+                    operationalStatus: {
+                        global: 0,
+                        lift: 0,
+                        tilt: 0,
+                    },
+                    // End product type
+                    endProductType: 8, // Venetian blind
+                    // Configuration: supports both lift and tilt
+                    configStatus: {
+                        operational: true,
+                        onlineReserved: true,
+                        liftMovementReversed: false,
+                        liftPositionAware: true,
+                        tiltPositionAware: true,
+                        liftEncoderControlled: true,
+                        tiltEncoderControlled: true,
+                    },
+                },
+            },
+            handlers: {
+                windowCovering: {
+                    goToLiftPercentage: async (request) => {
+                        const percent = (request.targetPercent / 100).toFixed(0);
+                        log.info(`[Venetian Blind] ✓ Handler \`goToLiftPercentage\` called: ${request.targetPercent} (${percent}% open)`);
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-venetian-blind'), 'windowCovering', {
+                            currentPositionLiftPercent100ths: request.targetPercent,
+                            targetPositionLiftPercent100ths: request.targetPercent,
+                        });
+                    },
+                    goToTiltPercentage: async (request) => {
+                        const percent = (request.targetPercent / 100).toFixed(0);
+                        log.info(`[Venetian Blind] ✓ Handler \`goToTiltPercentage\` called: ${request.targetPercent} (${percent}% tilted)`);
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-venetian-blind'), 'windowCovering', {
+                            currentPositionTiltPercent100ths: request.targetPercent,
+                            targetPositionTiltPercent100ths: request.targetPercent,
+                        });
+                    },
+                    upOrOpen: async () => {
+                        log.info('[Venetian Blind] ✓ Handler `upOrOpen` called - Opening blind');
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-venetian-blind'), 'windowCovering', {
+                            currentPositionLiftPercent100ths: 10000, // Fully open
+                            targetPositionLiftPercent100ths: 10000,
+                        });
+                    },
+                    downOrClose: async () => {
+                        log.info('[Venetian Blind] ✓ Handler `downOrClose` called - Closing blind');
+                        await api.matter.updateAccessoryState(api.matter.uuid.generate('matter-venetian-blind'), 'windowCovering', {
+                            currentPositionLiftPercent100ths: 0, // Fully closed
+                            targetPositionLiftPercent100ths: 0,
+                        });
+                    },
+                    stopMotion: async () => {
+                        log.info('[Venetian Blind] ✓ Handler `stopMotion` called - Stopping blind');
+                    },
+                },
+            },
+        });
+    }
+    return accessories;
+}
+//# sourceMappingURL=window-covering.js.map

package/dist/devices/section-8-closure/window-covering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-covering.js","sourceRoot":"","sources":["../../../src/devices/section-8-closure/window-covering.ts"],"names":[],"mappings":"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"}

package/dist/devices/section-9-hvac/fan.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Fan Device (Matter Spec § 9.2)
+ *
+ * A fan with speed control and mode selection.
+ */
+import type { DeviceContext } from '../types.js';
+export declare function registerFan(context: DeviceContext): any[];

package/dist/devices/section-9-hvac/fan.js

@@ -0,0 +1,56 @@
+/**
+ * Fan Device (Matter Spec § 9.2)
+ *
+ * A fan with speed control and mode selection.
+ */
+export function registerFan(context) {
+    const { api, log, config } = context;
+    const accessories = [];
+    if (!config.enableFan) {
+        return accessories;
+    }
+    accessories.push({
+        uuid: api.matter.uuid.generate('matter-fan'),
+        displayName: 'Fan',
+        deviceType: api.matter.deviceTypes.Fan,
+        serialNumber: 'FAN-001',
+        manufacturer: 'Matter Examples',
+        model: 'Fan v1',
+        clusters: {
+            fanControl: {
+                // Fan mode: 0=Off, 1=Low, 2=Medium, 3=High, 4=On, 5=Auto, 6=Smart
+                fanMode: 0, // Off
+                // Fan mode sequence: indicates which modes are supported
+                // 0=OffLowMedHigh, 1=OffLowHigh, 2=OffLowMedHighAuto, 3=OffLowHighAuto, 4=OffOnAuto, 5=OffOn
+                fanModeSequence: 0, // OffLowMedHigh
+                // Percent setting (0-100)
+                percentSetting: 0,
+                percentCurrent: 0,
+                // Speed setting (0-100, some fans use this instead of percent)
+                speedSetting: 0,
+                speedCurrent: 0,
+            },
+        },
+        handlers: {
+            fanControl: {
+                // Called when user changes fan speed via percent slider
+                setPercentSetting: async (request) => {
+                    log.info(`[Fan] ✓ Handler \`setPercentSetting\` called: ${request.percentSetting}%`);
+                },
+                // Called when user changes fan mode
+                setFanMode: async (request) => {
+                    const modes = ['Off', 'Low', 'Medium', 'High', 'On', 'Auto', 'Smart'];
+                    const modeName = modes[request.fanMode] || `Unknown (${request.fanMode})`;
+                    log.info(`[Fan] ✓ Handler \`setFanMode\` called: ${request.fanMode} (${modeName})`);
+                },
+                // Called when user presses up/down buttons to adjust speed
+                step: async (request) => {
+                    const dir = request.direction === 0 ? 'Up' : 'Down';
+                    log.info(`[Fan] ✓ Handler \`step\` called: direction=${dir}, wrap=${request.wrap}, lowestOff=${request.lowestOff}`);
+                },
+            },
+        },
+    });
+    return accessories;
+}
+//# sourceMappingURL=fan.js.map

package/dist/devices/section-9-hvac/fan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fan.js","sourceRoot":"","sources":["../../../src/devices/section-9-hvac/fan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACpC,MAAM,WAAW,GAAU,EAAE,CAAA;IAE7B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,WAAW,CAAC,IAAI,CAAC;QACf,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC5C,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG;QACtC,YAAY,EAAE,SAAS;QACvB,YAAY,EAAE,iBAAiB;QAC/B,KAAK,EAAE,QAAQ;QAEf,QAAQ,EAAE;YACR,UAAU,EAAE;gBACV,kEAAkE;gBAClE,OAAO,EAAE,CAAC,EAAE,MAAM;gBAElB,yDAAyD;gBACzD,6FAA6F;gBAC7F,eAAe,EAAE,CAAC,EAAE,gBAAgB;gBAEpC,0BAA0B;gBAC1B,cAAc,EAAE,CAAC;gBACjB,cAAc,EAAE,CAAC;gBAEjB,+DAA+D;gBAC/D,YAAY,EAAE,CAAC;gBACf,YAAY,EAAE,CAAC;aAChB;SACF;QAED,QAAQ,EAAE;YACR,UAAU,EAAE;gBACV,wDAAwD;gBACxD,iBAAiB,EAAE,KAAK,EAAE,OAAmC,EAAE,EAAE;oBAC/D,GAAG,CAAC,IAAI,CAAC,iDAAiD,OAAO,CAAC,cAAc,GAAG,CAAC,CAAA;gBACtF,CAAC;gBAED,oCAAoC;gBACpC,UAAU,EAAE,KAAK,EAAE,OAA4B,EAAE,EAAE;oBACjD,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,CAAA;oBACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,YAAY,OAAO,CAAC,OAAO,GAAG,CAAA;oBACzE,GAAG,CAAC,IAAI,CAAC,0CAA0C,OAAO,CAAC,OAAO,KAAK,QAAQ,GAAG,CAAC,CAAA;gBACrF,CAAC;gBAED,2DAA2D;gBAC3D,IAAI,EAAE,KAAK,EAAE,OAAiE,EAAE,EAAE;oBAChF,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;oBACnD,GAAG,CAAC,IAAI,CAAC,8CAA8C,GAAG,UAAU,OAAO,CAAC,IAAI,eAAe,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;gBACrH,CAAC;aACF;SACF;KACF,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/devices/section-9-hvac/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Section 9: HVAC
+ *
+ * Matter Specification § 9 - Heating, ventilation, and air conditioning
+ */
+export { registerFan } from './fan.js';
+export { registerThermostat } from './thermostat.js';

package/dist/devices/section-9-hvac/index.js

@@ -0,0 +1,8 @@
+/**
+ * Section 9: HVAC
+ *
+ * Matter Specification § 9 - Heating, ventilation, and air conditioning
+ */
+export { registerFan } from './fan.js';
+export { registerThermostat } from './thermostat.js';
+//# sourceMappingURL=index.js.map

package/dist/devices/section-9-hvac/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/devices/section-9-hvac/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/devices/section-9-hvac/thermostat.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Thermostat Device (Matter Spec § 9.1)
+ *
+ * A device for controlling heating and cooling systems.
+ */
+import type { DeviceContext } from '../types.js';
+export declare function registerThermostat(context: DeviceContext): any[];

package/dist/devices/section-9-hvac/thermostat.js

@@ -0,0 +1,61 @@
+/**
+ * Thermostat Device (Matter Spec § 9.1)
+ *
+ * A device for controlling heating and cooling systems.
+ */
+export function registerThermostat(context) {
+    const { api, log, config } = context;
+    const accessories = [];
+    if (!config.enableThermostat) {
+        return accessories;
+    }
+    accessories.push({
+        uuid: api.matter.uuid.generate('matter-thermostat'),
+        displayName: 'Thermostat',
+        deviceType: api.matter.deviceTypes.Thermostat,
+        serialNumber: 'THERMO-001',
+        manufacturer: 'Matter Examples',
+        model: 'Thermostat v1',
+        clusters: {
+            thermostat: {
+                // Current temperature (in hundredths of degrees Celsius)
+                localTemperature: 2100, // 21.00°C
+                // Heating setpoint (target temperature in heat mode)
+                occupiedHeatingSetpoint: 2000, // 20.00°C
+                minHeatSetpointLimit: 700, // 7°C minimum
+                maxHeatSetpointLimit: 3000, // 30°C maximum
+                // Cooling setpoint (target temperature in cool mode)
+                occupiedCoolingSetpoint: 2400, // 24.00°C
+                minCoolSetpointLimit: 1600, // 16°C minimum
+                maxCoolSetpointLimit: 3200, // 32°C maximum
+                // System mode: 0=Off, 1=Auto, 3=Cool, 4=Heat
+                systemMode: 4, // Heat mode
+                // Control sequence: what modes are available (mandatory field)
+                // 4 = CoolingAndHeating (correct value when both Heating & Cooling features are present)
+                controlSequenceOfOperation: 4,
+            },
+        },
+        handlers: {
+            thermostat: {
+                // Called when user changes heating setpoint
+                setOccupiedHeatingSetpoint: async (request) => {
+                    const tempC = (request.targetSetpoint / 100).toFixed(1);
+                    log.info(`[Thermostat] ✓ Handler \`setOccupiedHeatingSetpoint\` called: ${request.targetSetpoint} (${tempC}°C)`);
+                },
+                // Called when user changes cooling setpoint
+                setOccupiedCoolingSetpoint: async (request) => {
+                    const tempC = (request.targetSetpoint / 100).toFixed(1);
+                    log.info(`[Thermostat] ✓ Handler \`setOccupiedCoolingSetpoint\` called: ${request.targetSetpoint} (${tempC}°C)`);
+                },
+                // Called when user changes mode (Off, Auto, Cool, Heat)
+                setSystemMode: async (request) => {
+                    const modes = ['Off', 'Auto', 'Reserved', 'Cool', 'Heat', 'Emergency Heating', 'Precooling', 'Fan Only'];
+                    const modeName = modes[request.systemMode] || `Unknown (${request.systemMode})`;
+                    log.info(`[Thermostat] ✓ Handler \`setSystemMode\` called: ${request.systemMode} (${modeName})`);
+                },
+            },
+        },
+    });
+    return accessories;
+}
+//# sourceMappingURL=thermostat.js.map

package/dist/devices/section-9-hvac/thermostat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thermostat.js","sourceRoot":"","sources":["../../../src/devices/section-9-hvac/thermostat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,kBAAkB,CAAC,OAAsB;IACvD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IACpC,MAAM,WAAW,GAAU,EAAE,CAAA;IAE7B,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC7B,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,WAAW,CAAC,IAAI,CAAC;QACf,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnD,WAAW,EAAE,YAAY;QACzB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU;QAC7C,YAAY,EAAE,YAAY;QAC1B,YAAY,EAAE,iBAAiB;QAC/B,KAAK,EAAE,eAAe;QAEtB,QAAQ,EAAE;YACR,UAAU,EAAE;gBACV,yDAAyD;gBACzD,gBAAgB,EAAE,IAAI,EAAE,UAAU;gBAElC,qDAAqD;gBACrD,uBAAuB,EAAE,IAAI,EAAE,UAAU;gBACzC,oBAAoB,EAAE,GAAG,EAAE,cAAc;gBACzC,oBAAoB,EAAE,IAAI,EAAE,eAAe;gBAE3C,qDAAqD;gBACrD,uBAAuB,EAAE,IAAI,EAAE,UAAU;gBACzC,oBAAoB,EAAE,IAAI,EAAE,eAAe;gBAC3C,oBAAoB,EAAE,IAAI,EAAE,eAAe;gBAE3C,6CAA6C;gBAC7C,UAAU,EAAE,CAAC,EAAE,YAAY;gBAE3B,+DAA+D;gBAC/D,yFAAyF;gBACzF,0BAA0B,EAAE,CAAC;aAC9B;SACF;QAED,QAAQ,EAAE;YACR,UAAU,EAAE;gBACV,4CAA4C;gBAC5C,0BAA0B,EAAE,KAAK,EAAE,OAAmC,EAAE,EAAE;oBACxE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;oBACvD,GAAG,CAAC,IAAI,CAAC,iEAAiE,OAAO,CAAC,cAAc,KAAK,KAAK,KAAK,CAAC,CAAA;gBAClH,CAAC;gBAED,4CAA4C;gBAC5C,0BAA0B,EAAE,KAAK,EAAE,OAAmC,EAAE,EAAE;oBACxE,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,cAAc,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;oBACvD,GAAG,CAAC,IAAI,CAAC,iEAAiE,OAAO,CAAC,cAAc,KAAK,KAAK,KAAK,CAAC,CAAA;gBAClH,CAAC;gBAED,wDAAwD;gBACxD,aAAa,EAAE,KAAK,EAAE,OAA+B,EAAE,EAAE;oBACvD,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;oBACxG,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,YAAY,OAAO,CAAC,UAAU,GAAG,CAAA;oBAC/E,GAAG,CAAC,IAAI,CAAC,oDAAoD,OAAO,CAAC,UAAU,KAAK,QAAQ,GAAG,CAAC,CAAA;gBAClG,CAAC;aACF;SACF;KACF,CAAC,CAAA;IAEF,OAAO,WAAW,CAAA;AACpB,CAAC"}

package/dist/devices/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Common types for Matter device implementations
+ */
+import type { API, Logging, PlatformConfig } from 'homebridge';
+/**
+ * Device registration function signature
+ */
+export type DeviceRegistrar = (api: API, log: Logging, config: PlatformConfig) => any[];
+/**
+ * Base context passed to all device registrars
+ */
+export interface DeviceContext {
+    api: API;
+    log: Logging;
+    config: PlatformConfig;
+}

package/dist/devices/types.js

@@ -0,0 +1,5 @@
+/**
+ * Common types for Matter device implementations
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/devices/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/devices/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}