@matter/types

@matter/types - Matter operational types and data structures for Matter.js

This package implements operational types and data structures for Matter.

Due to type definition size, we do not export clusters as part of the root package. You may instead import then as:

import { OnOffCluster } from "@matter/types/clusters/OnOffCluster";

or:

import { OnOffCluster } from "@matter/types/clusters";

Changelog

0.11.9 (2024-12-11)

• @matter/node

  • Enhancement: Enhances the number assertations to only allow finite numbers
  • Enhancement: WindowCovering: Adds an internal property to disable the operational state and value management by the default implementation to allow device to handle this themselves
  • BREAKING: WindowCovering: supportsCalibration is moved from state property to an internal property
  • Fix: ColorControl: Do not try to convert color mode details if they are not defined
  • Fix: ColorControl: colorMode attribute needs to be defined if HS feature is not used because the default value 0 is else invalid

• @matter/protocol

  • Fix: Also retry next discovered address when a Channel establishment error for PASE occurs
  • Fix: Optimizes MDNS cache handling to prevent too early cache invalidation

• @matter/types

  • Enhancement: Deprecated fields are now also usable and just flagged as deprecated on generated code
  • Enhancement: Removes default value from attribute ColorMode of ColorControl cluster because feature specific enum value was used

• @project-chip/matter.js

  • Feature: Introduces PairedNode#triggerReconnect() method to trigger a reconnection
  • Enhancement: Considers a node in reconnection state that should be decommissioned as already factory reset
  • Enhancement: Optimizes reconnection handling in Controller API
  • Fix: Do not try to convert color mode details if they are not defined
  • Fix: Clusters generated for extensions of base clusters such as Alarm Base and Mode Base now include full details of extended types; in particular extended enums such as Mode Tag were previously insufficiently defined
  • BREAKING: In ContentLauncher cluster ParameterEnum is renamed to Parameter and Parameter is renamed to ParameterStruct

• @matter/model

  • Feature: New Scope component analyzes scope of a model, caches analysis results, and implements algorithms that require analysis to perform efficiently
  • Enhancement: Models that define datatypes now inherit from common ScopeModel base class
  • Fix: Extended enums and other types now report the full set of members via Scope#membersOf
  • BREAKING: ClusterModel and ValueModel properties members, activeMembers and conformantMembers are removed; use Scope#membersOf instead