added template helper to get mandatory attribute count (#1642)

Author: dhchandw

docs/api.md

@@ -9111,10 +9111,19 @@ This module contains the API for templating. For more detailed instructions, rea
 
 
 * [Templating API: Attribute helpers](#module_Templating API_ Attribute helpers)
+    * [~count_mandatory_matter_attributes()](#module_Templating API_ Attribute helpers..count_mandatory_matter_attributes)
     * [~featureBits(options)](#module_Templating API_ Attribute helpers..featureBits) ⇒
     * [~attributeDefault()](#module_Templating API_ Attribute helpers..attributeDefault) ⇒
     * [~as_underlying_atomic_identifier_for_attribute_id(attributeId)](#module_Templating API_ Attribute helpers..as_underlying_atomic_identifier_for_attribute_id)
 
+<a name="module_Templating API_ Attribute helpers..count_mandatory_matter_attributes"></a>
+
+### Templating API: Attribute helpers~count\_mandatory\_matter\_attributes()
+Counts the number of mandatory attributes (not optional, non-global) for the current cluster context.
+Usage: {{count_mandatory_matter_attributes side="server"}}
+If side is not provided or invalid, counts all attributes.
+
+**Kind**: inner method of [<code>Templating API: Attribute helpers</code>](#module_Templating API_ Attribute helpers)  
 <a name="module_Templating API_ Attribute helpers..featureBits"></a>
 
 ### Templating API: Attribute helpers~featureBits(options) ⇒

docs/helpers.md

@@ -138,10 +138,19 @@ This module contains the API for templating. For more detailed instructions, rea
 
 
 * [Templating API: Attribute helpers](#module_Templating API_ Attribute helpers)
+    * [~count_mandatory_matter_attributes()](#module_Templating API_ Attribute helpers..count_mandatory_matter_attributes)
     * [~featureBits(options)](#module_Templating API_ Attribute helpers..featureBits) ⇒
     * [~attributeDefault()](#module_Templating API_ Attribute helpers..attributeDefault) ⇒
     * [~as_underlying_atomic_identifier_for_attribute_id(attributeId)](#module_Templating API_ Attribute helpers..as_underlying_atomic_identifier_for_attribute_id)
 
+<a name="module_Templating API_ Attribute helpers..count_mandatory_matter_attributes"></a>
+
+### Templating API: Attribute helpers~count\_mandatory\_matter\_attributes()
+Counts the number of mandatory attributes (not optional, non-global) for the current cluster context.
+Usage: {{count_mandatory_matter_attributes side="server"}}
+If side is not provided or invalid, counts all attributes.
+
+**Kind**: inner method of [<code>Templating API: Attribute helpers</code>](#module_Templating API_ Attribute helpers)  
 <a name="module_Templating API_ Attribute helpers..featureBits"></a>
 
 ### Templating API: Attribute helpers~featureBits(options) ⇒

src-electron/generator/helper-attribute.js

@@ -27,6 +27,40 @@ const templateUtil = require('./template-util')
 const zclUtil = require('../util/zcl-util')
 const dbEnum = require('../../src-shared/db-enum')
 
+/**
+ * Counts the number of mandatory attributes (not optional, non-global) for the current cluster context.
+ * Usage: {{count_mandatory_matter_attributes side="server"}}
+ * If side is not provided or invalid, counts all attributes.
+ */
+async function count_mandatory_matter_attributes(options) {
+  if (!('id' in this))
+    throw new Error(
+      'count_mandatory_matter_attributes requires a cluster id inside the context.'
+    )
+  const packageIds = await templateUtil.ensureZclPackageIds(this)
+  let side = options?.hash?.side
+  if (typeof side === 'string') side = side.toLowerCase()
+  let attributes
+  if (side === dbEnum.side.server || side === dbEnum.side.client) {
+    attributes =
+      await queryZcl.selectAttributesByClusterIdAndSideIncludingGlobal(
+        this.global.db,
+        this.id,
+        packageIds,
+        side
+      )
+  } else {
+    // Get all attributes for this cluster (both sides)
+    attributes = await queryZcl.selectAttributesByClusterIdIncludingGlobal(
+      this.global.db,
+      this.id,
+      packageIds
+    )
+  }
+  // Count mandatory attributes (not optional, non-global)
+  return attributes.filter((a) => a.clusterRef && !a.isOptional).length
+}
+
 /**
  * Get feature bits from the given context.
  * @param {*} options
@@ -172,3 +206,4 @@ exports.global_attribute_default = attributeDefault
 exports.feature_bits = featureBits
 exports.as_underlying_atomic_identifier_for_attribute_id =
   as_underlying_atomic_identifier_for_attribute_id
+exports.count_mandatory_matter_attributes = count_mandatory_matter_attributes

test/gen-matter-1.test.js

@@ -275,6 +275,13 @@ test(
       )
     )
 
+    // Testing count_mandatory_matter_attributes helper
+    expect(
+      sdkExt.includes(
+        '// mandatory attribute count for cluster Network Commissioning: 6'
+      )
+    ).toBeTruthy()
+
     // Testing promisedHandlebars when we have {{#if (promise)}} in a template
     // Eg: {{#zcl_clusters}}
     // {{#zcl_commands_source_server}}

test/gen-template/matter/sdk-ext.zapt

@@ -4,6 +4,7 @@
 ------------------- Clusters -------------------
 {{#zcl_clusters}}
 // cluster: {{asHex code 4}} {{label}}, text extension: '{{cluster_extension property="testClusterExtension"}}'
+// mandatory attribute count for cluster {{label}}: {{count_mandatory_matter_attributes}}
 {{/zcl_clusters}}
 
 ------------------- By-role Clusters -------------------