matterbridge-example-dynamic-platform 3.0.2-dev-20260802-681c9d9 → 3.0.2-dev-20260808-db970b3

package/CHANGELOG.md

@@ -35,15 +35,19 @@ If you like this project and find it useful, please consider giving it a star on
 
 ### Added
 
+- [chip]: Add chip-test toolchain agents instruction and chip-test runner.
+- [frontend]: Add plugin-frontend agents instructions.
 - [platform]: Add `closureGarageDoor` device.
+- [platform]: Add `closureVenetianBlind` device with Lift and Tilt panels.
 
 ### Changed
 
 - [package]: Upgrade package.
 - [package]: Update dependencies.
-- [package]: Bump `@types/node` to v.26.1.2.
-- [package]: Bump `oxfmt` to v.0.61.0.
-- [package]: Bump `oxlint` to v.1.76.0.
+- [package]: Bump `typescript` to v.7.0.2.
+- [package]: Bump `@types/node` to v.26.2.0.
+- [package]: Bump `oxfmt` to v.0.62.0.
+- [package]: Bump `oxlint` to v.1.77.0.
 - [package]: Bump `oxlint-tsgolint` to v.7.0.2001.
 - [package]: Update agents configs.
 

package/README.md

@@ -23,7 +23,7 @@
 
 Matterbridge dynamic platform example plugin is a template to develop your own plugin using the dynamic platform.
 
-It exposes 71 virtual devices:
+It exposes 72 virtual devices:
 
 - a door contact sensor
 - a motion sensor
@@ -96,6 +96,7 @@ It exposes 71 virtual devices:
 - an irrigation system (Matter 1.5.0)
 - an irrigation system with four zones (Matter 1.5.0)
 - a closure device (Matter 1.5.0, supported by SmartThings)
+- a closure device with Lift and Tilt panels (Matter 1.5.0, supported by SmartThings)
 
 All these devices continuously change their state and position. The plugin also shows how to use all the command handlers (so you can control all the devices), how to subscribe to attributes, and how to trigger events.
 
@@ -111,11 +112,11 @@ If you like this project and find it useful, please consider giving it a star on
 
 See the guidelines on [Matterbridge](https://github.com/Luligu/matterbridge/blob/main/README.md) for more information.
 
-## Repository setup
+## Repository toolchain
 
-> **Note:** This repository uses a new toolchain. It replaces the traditional TypeScript / ESLint / Prettier / Jest stack with a faster, lighter setup.
+> **Note:** This repository uses a new toolchain. It replaces the traditional TypeScript / ESLint / Prettier / Jest stack with a faster and lighter setup.
 
-- **No `typescript` package** — replaced by [TypeScript Native](https://github.com/microsoft/typescript-go). The `typescript` package is kept only as a publish-time dependency while tsgo is still in preview.
+- **No `typescript 6.x` package** — replaced by [TypeScript Native 7.x](https://github.com/microsoft/typescript-go).
 - **No ESLint, no Prettier** — replaced by the [oxc](https://oxc.rs) stack: [oxlint](https://oxc.rs/docs/guide/usage/linter.html) for linting and [oxfmt](https://oxc.rs/docs/guide/usage/formatter.html) for formatting.
 - **No Jest** — replaced by [Vitest](https://vitest.dev), which is much faster and natively supports ESM without extra configuration.
 - **Far fewer development dependencies** — the number of installed packages drops from **~600** to **~75**. A clean install is much faster.
@@ -129,25 +130,33 @@ See also the [Style Guide](./STYLEGUIDE.md) for JSDoc, naming, and logging conve
 
 ## Copilot instructions
 
-| File                                                             | Notes                                                            |
-| ---------------------------------------------------------------- | ---------------------------------------------------------------- |
-| `.github/copilot-instructions.md`                                | Main project instructions — always loaded                        |
-| `.github/instructions/matterbridge/matterbridge.instructions.md` | Matterbridge endpoint guide — dedicated Copilot instruction file |
-| `.github/instructions/testing/unit-tests.instructions.md`        | Testing standards — scoped to `**/*.test.ts`                     |
+| File                                                                   | Notes                                                                              |
+| ---------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `.github/copilot-instructions.md`                                      | Main project instructions — always loaded                                          |
+| `.github/instructions/chip-tests/chip-tests.instructions.md`           | CHIP conformance test harness — scoped to CHIP test files                          |
+| `.github/instructions/matterbridge/matterbridge.instructions.md`       | Matterbridge endpoint guide — dedicated Copilot instruction file                   |
+| `.github/instructions/plugin-frontend/plugin-frontend.instructions.md` | Plugin frontend SPA and custom REST API guide — scoped to frontend and plugin code |
+| `.github/instructions/testing/unit-tests.instructions.md`              | Testing standards — scoped to `**/*.test.ts`                                       |
 
 ## Claude instructions
 
-| File                                                      | Notes                                                 |
-| --------------------------------------------------------- | ----------------------------------------------------- |
-| `CLAUDE.md`                                               | Main project instructions — always loaded             |
-| `.claude/rules/matterbridge/matterbridge.instructions.md` | Matterbridge endpoint guide — loaded for all contexts |
-| `.claude/rules/testing/unit-tests.instructions.md`        | Testing standards — scoped to `**/*.test.ts`          |
+| File                                                            | Notes                                                                              |
+| --------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `CLAUDE.md`                                                     | Main project instructions — always loaded                                          |
+| `.claude/rules/chip-tests/chip-tests.instructions.md`           | CHIP conformance test harness — scoped to CHIP test files                          |
+| `.claude/rules/matterbridge/matterbridge.instructions.md`       | Matterbridge endpoint guide — loaded for all contexts                              |
+| `.claude/rules/plugin-frontend/plugin-frontend.instructions.md` | Plugin frontend SPA and custom REST API guide — scoped to frontend and plugin code |
+| `.claude/rules/testing/unit-tests.instructions.md`              | Testing standards — scoped to `**/*.test.ts`                                       |
 
 ## Codex/Agents instructions
 
 | File                         | Notes                                             |
 | ---------------------------- | ------------------------------------------------- |
 | `AGENTS.md`                  | Main project instructions                         |
+| `.agents/chip-tests.md`      | CHIP conformance test harness                     |
+| `.agents/matterbridge.md`    | Matterbridge endpoint guide                       |
+| `.agents/plugin-frontend.md` | Plugin frontend SPA and custom REST API guide     |
+| `.agents/testing.md`         | Testing and validation expectations               |
 | `.codex/config.toml`         | Codex project permissions, approvals, and profile |
 | `.codex/rules/default.rules` | Codex command allow, prompt, and deny rules       |
 

package/dist/module.js

@@ -1,8 +1,8 @@
 import { aggregator, airPurifier, airQualitySensor, bridgedNode, colorTemperatureLight, contactSensor, windowCovering, dimmableLight, mountedDimmableLoadControl, dimmablePlugInUnit, doorLock, electricalSensor, extendedColorLight, fan, flowSensor, genericSwitch, getSemtag, humiditySensor, lightSensor, MatterbridgeDynamicPlatform, MatterbridgeEndpoint, modeSelect, occupancySensor, onOffLight, mountedOnOffControl, onOffPlugInUnit, onOffLightSwitch, powerSource, pressureSensor, pump, rainSensor, smokeCoAlarm, temperatureSensor, thermostat, waterFreezeDetector, waterLeakDetector, waterValve, } from 'matterbridge';
 import { AirConditioner, BasicVideoPlayer, BatteryStorage, Closure, Cooktop, Dishwasher, Evse, ExtractorHood, HeatPump, IrrigationSystem, LaundryDryer, LaundryWasher, MicrowaveOven, Oven, Refrigerator, RoboticVacuumCleaner, SoilSensor, SolarPower, Speaker, WaterHeater, } from 'matterbridge/devices';
 import { debugStringify } from 'matterbridge/logger';
-import { ClosureTag, CommonAreaNamespaceTag, CommonLocationTag, CommonNumberTag, CommonPositionTag, RefrigeratorTag, SwitchesTag, UINT16_MAX, UINT32_MAX, } from 'matterbridge/matter';
-import { AirQuality, BooleanState, BridgedDeviceBasicInformation, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, ClosureControl, ColorControl, Descriptor, DeviceEnergyManagement, DoorLock, ElectricalEnergyMeasurement, ElectricalPowerMeasurement, EnergyEvse, EnergyEvseMode, FanControl, FlowMeasurement, FormaldehydeConcentrationMeasurement, Identify, IlluminanceMeasurement, LevelControl, NitrogenDioxideConcentrationMeasurement, OccupancySensing, OnOff, OperationalState, OvenMode, OzoneConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm25ConcentrationMeasurement, PowerSource, PressureMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RvcCleanMode, RvcOperationalState, RvcRunMode, SmokeCoAlarm, TemperatureMeasurement, Thermostat, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, } from 'matterbridge/matter/clusters';
+import { ClosureCoveringTag, ClosurePanelTag, ClosureTag, CommonAreaNamespaceTag, CommonLocationTag, CommonNumberTag, CommonPositionTag, RefrigeratorTag, SwitchesTag, UINT16_MAX, UINT32_MAX, } from 'matterbridge/matter';
+import { AirQuality, BooleanState, BridgedDeviceBasicInformation, CarbonDioxideConcentrationMeasurement, CarbonMonoxideConcentrationMeasurement, ClosureControl, ClosureDimension, ColorControl, Descriptor, DeviceEnergyManagement, DoorLock, ElectricalEnergyMeasurement, ElectricalPowerMeasurement, EnergyEvse, EnergyEvseMode, FanControl, FlowMeasurement, FormaldehydeConcentrationMeasurement, Identify, IlluminanceMeasurement, LevelControl, NitrogenDioxideConcentrationMeasurement, OccupancySensing, OnOff, OperationalState, OvenMode, OzoneConcentrationMeasurement, Pm1ConcentrationMeasurement, Pm10ConcentrationMeasurement, Pm25ConcentrationMeasurement, PowerSource, PressureMeasurement, RadonConcentrationMeasurement, RelativeHumidityMeasurement, RvcCleanMode, RvcOperationalState, RvcRunMode, SmokeCoAlarm, TemperatureMeasurement, Thermostat, TotalVolatileOrganicCompoundsConcentrationMeasurement, WindowCovering, } from 'matterbridge/matter/clusters';
 import { fireAndForget, getEnumDescription, isValidBoolean, isValidNumber, isValidObject, isValidString } from 'matterbridge/utils';
 function luxToMatter(lux) {
     if (!Number.isFinite(lux) || lux <= 0)
@@ -35,6 +35,7 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
     irrigation;
     irrigationSystem;
     closureGarageDoor;
+    closureVenetianBlind;
     select;
     climate;
     switch;
@@ -179,26 +180,127 @@ export class ExampleMatterbridgeDynamicPlatform extends MatterbridgeDynamicPlatf
             tagList: [getSemtag(ClosureTag.GarageDoor)],
         });
         this.closureGarageDoor = (await this.addDevice(this.closureGarageDoor));
-        this.closureGarageDoor?.addCommandHandler('ClosureControl.moveTo', ({ request: { position, latch, speed } }) => {
+        let closureGarageDoorMoveTimeout;
+        function closureTargetToCurrentPosition(position) {
+            if (position === ClosureControl.TargetPosition.MoveToFullyClosed)
+                return ClosureControl.CurrentPosition.FullyClosed;
+            if (position === ClosureControl.TargetPosition.MoveToFullyOpen)
+                return ClosureControl.CurrentPosition.FullyOpened;
+            if (position === ClosureControl.TargetPosition.MoveToPedestrianPosition)
+                return ClosureControl.CurrentPosition.OpenedForPedestrian;
+            if (position === ClosureControl.TargetPosition.MoveToVentilationPosition)
+                return ClosureControl.CurrentPosition.OpenedForVentilation;
+            return ClosureControl.CurrentPosition.OpenedAtSignature;
+        }
+        this.closureGarageDoor?.addCommandHandler('ClosureControl.moveTo', ({ request: { position, latch, speed }, attributes }) => {
             this.closureGarageDoor?.log.info(`Command moveTo called position:${position} latch:${latch} speed:${speed}`);
-            const currentStateTimeout = setTimeout(() => {
-                const targetState = this.closureGarageDoor?.getAttribute(ClosureControl.id, 'overallTargetState');
-                const currentState = this.closureGarageDoor?.getAttribute(ClosureControl.id, 'overallCurrentState');
-                if (targetState === undefined || targetState === null)
+            attributes.countdownTime = 1;
+            closureGarageDoorMoveTimeout = setTimeout(() => {
+                const targetState = this.closureGarageDoor?.getAttribute(ClosureControl, 'overallTargetState');
+                if (targetState === undefined || targetState === null || targetState.position === undefined || targetState.position === null)
                     return;
-                void this.closureGarageDoor?.setAttribute(ClosureControl.id, 'mainState', ClosureControl.MainState.Stopped, this.closureGarageDoor.log);
-                void this.closureGarageDoor?.setAttribute(ClosureControl.id, 'overallCurrentState', {
-                    position: targetState.position,
+                void this.closureGarageDoor?.setAttribute(ClosureControl, 'mainState', ClosureControl.MainState.Stopped, this.closureGarageDoor.log);
+                void this.closureGarageDoor?.setAttribute(ClosureControl, 'countdownTime', 0, this.closureGarageDoor.log);
+                void this.closureGarageDoor?.setAttribute(ClosureControl, 'overallCurrentState', {
+                    position: closureTargetToCurrentPosition(targetState.position),
                     latch: targetState.latch,
                     speed: targetState.speed,
-                    secureState: targetState.position === ClosureControl.TargetPosition.MoveToFullyClosed ? true : (currentState?.secureState ?? false),
+                    secureState: targetState.position === ClosureControl.TargetPosition.MoveToFullyClosed && targetState.latch === true,
                 }, this.closureGarageDoor.log);
-            }, 1000);
-            currentStateTimeout.unref();
+            }, 1000).unref();
         });
         this.closureGarageDoor?.addCommandHandler('ClosureControl.stop', () => {
             this.closureGarageDoor?.log.info('Command stop called');
-        });
+            clearTimeout(closureGarageDoorMoveTimeout);
+            closureGarageDoorMoveTimeout = undefined;
+        });
+        this.closureVenetianBlind = new Closure('Venetian Blind', 'VEN000072', {
+            tagList: [getSemtag(ClosureTag.Covering), getSemtag(ClosureCoveringTag.Venetian)],
+        });
+        const closureVenetianBlindLift = this.closureVenetianBlind.addPanel('Lift', [getSemtag(ClosurePanelTag.Lift)]);
+        const closureVenetianBlindTilt = this.closureVenetianBlind.addPanel('Tilt', [getSemtag(ClosurePanelTag.Tilt)]);
+        this.closureVenetianBlind = (await this.addDevice(this.closureVenetianBlind));
+        const closurePanelTargetPercent = (position) => {
+            if (position === ClosureControl.TargetPosition.MoveToFullyOpen)
+                return 0;
+            if (position === ClosureControl.TargetPosition.MoveToFullyClosed)
+                return 10000;
+            return 5000;
+        };
+        const closurePanelReachTimeouts = new Map();
+        let closureVenetianBlindMoveTimeout;
+        const clearClosureVenetianBlindTimeouts = () => {
+            clearTimeout(closureVenetianBlindMoveTimeout);
+            closureVenetianBlindMoveTimeout = undefined;
+            for (const pending of closurePanelReachTimeouts.values())
+                clearTimeout(pending);
+            closurePanelReachTimeouts.clear();
+        };
+        const syncClosureVenetianBlindFromPanels = () => {
+            const liftTarget = closureVenetianBlindLift.getAttribute(ClosureDimension, 'targetState');
+            const liftCurrent = closureVenetianBlindLift.getAttribute(ClosureDimension, 'currentState');
+            const tiltTarget = closureVenetianBlindTilt.getAttribute(ClosureDimension, 'targetState');
+            const tiltCurrent = closureVenetianBlindTilt.getAttribute(ClosureDimension, 'currentState');
+            if (!liftTarget || !liftCurrent || !tiltTarget || !tiltCurrent)
+                return;
+            if (liftCurrent.position !== liftTarget.position || tiltCurrent.position !== tiltTarget.position)
+                return;
+            const overallPosition = liftCurrent.position === 0
+                ? ClosureControl.CurrentPosition.FullyOpened
+                : liftCurrent.position === 10000
+                    ? ClosureControl.CurrentPosition.FullyClosed
+                    : ClosureControl.CurrentPosition.PartiallyOpened;
+            void this.closureVenetianBlind?.setAttribute(ClosureControl, 'mainState', ClosureControl.MainState.Stopped, this.closureVenetianBlind.log);
+            void this.closureVenetianBlind?.setAttribute(ClosureControl, 'overallCurrentState', { position: overallPosition, latch: liftCurrent.latch ?? true, speed: liftCurrent.speed, secureState: liftCurrent.position === 10000 && liftCurrent.latch === true }, this.closureVenetianBlind?.log);
+        };
+        const simulateClosurePanelReachingTarget = (panel) => {
+            const pending = closurePanelReachTimeouts.get(panel);
+            if (pending)
+                clearTimeout(pending);
+            const currentStateTimeout = setTimeout(() => {
+                void (async () => {
+                    closurePanelReachTimeouts.delete(panel);
+                    const targetState = panel.getAttribute(ClosureDimension, 'targetState');
+                    if (targetState === undefined || targetState === null)
+                        return;
+                    await panel.setAttribute(ClosureDimension, 'currentState', targetState, panel.log);
+                    syncClosureVenetianBlindFromPanels();
+                })();
+            }, 1000);
+            currentStateTimeout.unref();
+            closurePanelReachTimeouts.set(panel, currentStateTimeout);
+        };
+        const moveClosurePanelTo = (panel, position, latch, speed) => {
+            void panel.setAttribute(ClosureDimension, 'targetState', { position, latch: latch ?? true, speed }, panel.log);
+            simulateClosurePanelReachingTarget(panel);
+        };
+        this.closureVenetianBlind?.addCommandHandler('ClosureControl.moveTo', ({ request: { position, latch, speed }, attributes }) => {
+            this.closureVenetianBlind?.log.info(`Command moveTo called position:${position} latch:${latch} speed:${speed}`);
+            attributes.countdownTime = 1;
+            clearClosureVenetianBlindTimeouts();
+            closureVenetianBlindMoveTimeout = setTimeout(() => {
+                void this.closureVenetianBlind?.setAttribute(ClosureControl, 'countdownTime', 0, this.closureVenetianBlind.log);
+                closureVenetianBlindMoveTimeout = undefined;
+                const targetState = this.closureVenetianBlind?.getAttribute(ClosureControl, 'overallTargetState');
+                if (targetState === undefined || targetState === null || targetState.position === undefined || targetState.position === null)
+                    return;
+                const panelPercent = closurePanelTargetPercent(targetState.position);
+                moveClosurePanelTo(closureVenetianBlindLift, panelPercent, targetState.latch, targetState.speed);
+                moveClosurePanelTo(closureVenetianBlindTilt, panelPercent, targetState.latch, targetState.speed);
+            }, 1000).unref();
+        });
+        this.closureVenetianBlind?.addCommandHandler('ClosureControl.stop', () => {
+            this.closureVenetianBlind?.log.info('Command stop called');
+            clearClosureVenetianBlindTimeouts();
+        });
+        const addClosurePanelSetTargetSimulation = (panel) => {
+            panel.addCommandHandler('ClosureDimension.setTarget', ({ request: { position, latch, speed } }) => {
+                panel.log.info(`Command setTarget called position:${position} latch:${latch} speed:${speed}`);
+                simulateClosurePanelReachingTarget(panel);
+            });
+        };
+        addClosurePanelSetTargetSimulation(closureVenetianBlindLift);
+        addClosurePanelSetTargetSimulation(closureVenetianBlindTilt);
         this.climate = new MatterbridgeEndpoint([bridgedNode, powerSource], { id: 'Climate' }, this.config.debug)
             .createDefaultBridgedDeviceBasicInformationClusterServer('Climate', 'CLI00008', 0xfff1, 'Matterbridge', 'Matterbridge Climate')
             .createDefaultPowerSourceReplaceableBatteryClusterServer(90, PowerSource.BatChargeLevel.Ok, 2990, '2 x AA', 2, PowerSource.BatReplaceability.UserReplaceable)

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.2-dev-20260802-681c9d9",
+  "version": "3.0.2-dev-20260808-db970b3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "matterbridge-example-dynamic-platform",
-      "version": "3.0.2-dev-20260802-681c9d9",
+      "version": "3.0.2-dev-20260808-db970b3",
       "license": "Apache-2.0",
       "dependencies": {
         "node-ansi-logger": "3.3.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "matterbridge-example-dynamic-platform",
-  "version": "3.0.2-dev-20260802-681c9d9",
+  "version": "3.0.2-dev-20260808-db970b3",
   "description": "Matterbridge dynamic plugin",
   "author": "https://github.com/Luligu",
   "license": "Apache-2.0",