@itwin/presentation-common 5.7.0-dev.1 → 5.7.0-dev.11

package/CHANGELOG.md

@@ -1,6 +1,14 @@
 # Change Log - @itwin/presentation-common
 
-This log was last generated on Thu, 22 Jan 2026 16:18:35 GMT and should not be manually modified.
+This log was last generated on Thu, 05 Feb 2026 16:14:10 GMT and should not be manually modified.
+
+## 5.6.0
+Thu, 05 Feb 2026 16:12:37 GMT
+
+### Updates
+
+- Ensure array & struct parent fields are accessible from their items & member fields. Also, ensure `IContentVisitor` receives parent array & struct names as the `parentFieldName` when traversing content.
+- Added `getFieldByName` method to `ArrayPropertiesField` and `StructPropertiesField`.
 
 ## 5.5.2
 Thu, 22 Jan 2026 16:16:54 GMT

package/Ruleset.schema.json

@@ -104,10 +104,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "ChildNodes",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "ChildNodes"
-          ],
           "type": "string"
         },
         "specifications": {
@@ -166,10 +164,8 @@
           "type": "boolean"
         },
         "specType": {
+          "const": "Class",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Class"
-          ],
           "type": "string"
         }
       },
@@ -262,10 +258,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "ContentInstancesOfSpecificClasses",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "ContentInstancesOfSpecificClasses"
-          ],
           "type": "string"
         }
       },
@@ -331,10 +325,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "ContentModifier",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "ContentModifier"
-          ],
           "type": "string"
         }
       },
@@ -402,10 +394,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "ContentRelatedInstances",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "ContentRelatedInstances"
-          ],
           "type": "string"
         }
       },
@@ -439,10 +429,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "Content",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Content"
-          ],
           "type": "string"
         },
         "specifications": {
@@ -535,10 +523,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "CustomNode",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "CustomNode"
-          ],
           "type": "string"
         },
         "suppressSimilarAncestorsCheck": {
@@ -621,10 +607,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "CustomQueryInstanceNodes",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "CustomQueryInstanceNodes"
-          ],
           "type": "string"
         },
         "suppressSimilarAncestorsCheck": {
@@ -694,10 +678,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "DefaultPropertyCategoryOverride",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "DefaultPropertyCategoryOverride"
-          ],
           "type": "string"
         },
         "specification": {
@@ -743,10 +725,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "DisabledSorting",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "DisabledSorting"
-          ],
           "type": "string"
         }
       },
@@ -769,10 +749,8 @@
           "type": "string"
         },
         "specType": {
+          "const": "ECPropertyValue",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "ECPropertyValue"
-          ],
           "type": "string"
         }
       },
@@ -814,10 +792,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "ExtendedData",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "ExtendedData"
-          ],
           "type": "string"
         }
       },
@@ -863,10 +839,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "Grouping",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Grouping"
-          ],
           "type": "string"
         }
       },
@@ -905,10 +879,8 @@
           "type": "boolean"
         },
         "type": {
+          "const": "Id",
           "description": "Type of the identifier",
-          "enum": [
-            "Id"
-          ],
           "type": "string"
         }
       },
@@ -942,10 +914,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "InstanceLabelOverride",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "InstanceLabelOverride"
-          ],
           "type": "string"
         },
         "values": {
@@ -968,10 +938,8 @@
       "description": "Specification returns ECInstance's briefcase ID in base36 format.",
       "properties": {
         "specType": {
+          "const": "BriefcaseId",
           "description": "Type of the specification",
-          "enum": [
-            "BriefcaseId"
-          ],
           "type": "string"
         }
       },
@@ -985,10 +953,8 @@
       "description": "Specification uses ECClass display label as the label content.",
       "properties": {
         "specType": {
+          "const": "ClassLabel",
           "description": "Type of the specification",
-          "enum": [
-            "ClassLabel"
-          ],
           "type": "string"
         }
       },
@@ -1006,10 +972,8 @@
           "type": "boolean"
         },
         "specType": {
+          "const": "ClassName",
           "description": "Type of the specification",
-          "enum": [
-            "ClassName"
-          ],
           "type": "string"
         }
       },
@@ -1046,10 +1010,8 @@
           "type": "string"
         },
         "specType": {
+          "const": "Composite",
           "description": "Type of the specification",
-          "enum": [
-            "Composite"
-          ],
           "type": "string"
         }
       },
@@ -1064,10 +1026,8 @@
       "description": "Specification returns ECInstance's local ID in base36 format.",
       "properties": {
         "specType": {
+          "const": "LocalId",
           "description": "Type of the specification",
-          "enum": [
-            "LocalId"
-          ],
           "type": "string"
         }
       },
@@ -1099,10 +1059,8 @@
           "description": "Specification of the relationship path from `InstanceLabelOverride.class`\nto class of the property. If omitted, `InstanceLabelOverride.class` is used as property class."
         },
         "specType": {
+          "const": "Property",
           "description": "Type of the specification",
-          "enum": [
-            "Property"
-          ],
           "type": "string"
         }
       },
@@ -1121,10 +1079,8 @@
           "description": "Specification of the relationship path from `InstanceLabelOverride.class`\nto class of the related instance."
         },
         "specType": {
+          "const": "RelatedInstanceLabel",
           "description": "Type of the specification",
-          "enum": [
-            "RelatedInstanceLabel"
-          ],
           "type": "string"
         }
       },
@@ -1139,10 +1095,8 @@
       "description": "Specification uses the specified value as the label content.",
       "properties": {
         "specType": {
+          "const": "String",
           "description": "Type of the specification",
-          "enum": [
-            "String"
-          ],
           "type": "string"
         },
         "value": {
@@ -1274,10 +1228,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "InstanceNodesOfSpecificClasses",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "InstanceNodesOfSpecificClasses"
-          ],
           "type": "string"
         },
         "suppressSimilarAncestorsCheck": {
@@ -1323,10 +1275,8 @@
       "description": "Identifier for no category. Used to make category displayed at root level by using\nthis identifier for `PropertyCategorySpecification.parentId`.",
       "properties": {
         "type": {
+          "const": "None",
           "description": "Type of the identifier",
-          "enum": [
-            "None"
-          ],
           "type": "string"
         }
       },
@@ -1367,10 +1317,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "NodeArtifacts",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "NodeArtifacts"
-          ],
           "type": "string"
         }
       },
@@ -1385,10 +1333,8 @@
       "description": "Identifier of the default parent category.\n\nFor direct properties it's the default category. See `DefaultPropertyCategoryOverride` for overriding the default category.\n\nFor related properties it's the category made up from the related ECClass defined by the last\n`RelatedPropertiesSpecification` with `RelationshipMeaning.RelatedInstance`. If there's no such specification,\nthe default category is used.",
       "properties": {
         "type": {
+          "const": "DefaultParent",
           "description": "Type of the identifier",
-          "enum": [
-            "DefaultParent"
-          ],
           "type": "string"
         }
       },
@@ -1463,10 +1409,8 @@
           "description": "Arbitrary JSON that can be handled by a property editor"
         },
         "paramsType": {
+          "const": "Json",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Json"
-          ],
           "type": "string"
         }
       },
@@ -1486,10 +1430,8 @@
           "type": "integer"
         },
         "paramsType": {
+          "const": "Multiline",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Multiline"
-          ],
           "type": "string"
         }
       },
@@ -1528,10 +1470,8 @@
           "type": "number"
         },
         "paramsType": {
+          "const": "Range",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Range"
-          ],
           "type": "string"
         }
       },
@@ -1562,10 +1502,8 @@
           "type": "number"
         },
         "paramsType": {
+          "const": "Slider",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Slider"
-          ],
           "type": "string"
         }
       },
@@ -1629,10 +1567,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "Property",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "Property"
-          ],
           "type": "string"
         }
       },
@@ -1712,10 +1648,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "PropertySorting",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "PropertySorting"
-          ],
           "type": "string"
         },
         "sortAscending": {
@@ -1944,10 +1878,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "RelatedInstanceNodes",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "RelatedInstanceNodes"
-          ],
           "type": "string"
         },
         "suppressSimilarAncestorsCheck": {
@@ -2133,9 +2065,7 @@
         "count": {
           "anyOf": [
             {
-              "enum": [
-                "*"
-              ],
+              "const": "*",
               "type": "string"
             },
             {
@@ -2196,10 +2126,8 @@
       "description": "Identifier of the root category.\n\nFor direct properties it's the default category. See `DefaultPropertyCategoryOverride` for overriding the default category.\n\nFor related properties it's the category made up from the related ECClass defined by the first\n`RelatedPropertiesSpecification` with `RelationshipMeaning.RelatedInstance`. If there's no such specification,\nthe default category is used.",
       "properties": {
         "type": {
+          "const": "Root",
           "description": "Type of the identifier",
-          "enum": [
-            "Root"
-          ],
           "type": "string"
         }
       },
@@ -2244,10 +2172,8 @@
           "type": "array"
         },
         "ruleType": {
+          "const": "RootNodes",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "RootNodes"
-          ],
           "type": "string"
         },
         "specifications": {
@@ -2326,10 +2252,8 @@
           "type": "string"
         },
         "specType": {
+          "const": "SameLabelInstance",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "SameLabelInstance"
-          ],
           "type": "string"
         }
       },
@@ -2347,10 +2271,8 @@
           "type": "string"
         },
         "type": {
+          "const": "SchemaCategory",
           "description": "Type of the identifier",
-          "enum": [
-            "SchemaCategory"
-          ],
           "type": "string"
         }
       },
@@ -2424,10 +2346,8 @@
           "type": "array"
         },
         "specType": {
+          "const": "SelectedNodeInstances",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "SelectedNodeInstances"
-          ],
           "type": "string"
         }
       },
@@ -2471,10 +2391,8 @@
           "type": "string"
         },
         "specType": {
+          "const": "String",
           "description": "Used for serializing to JSON.",
-          "enum": [
-            "String"
-          ],
           "type": "string"
         }
       },

package/lib/cjs/presentation-common/ElementProperties.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ElementProperties.d.ts","sourceRoot":"","sources":["../../../src/presentation-common/ElementProperties.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAe/D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,EAAE,EAAE,UAAU,CAAC;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,IAAI,EAAE,UAAU,GAAG,kCAAkC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;IAC9E,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,mCAAmC;IACnC,IAAI,EAAE,kCAAkC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAuC,SAAQ,iCAAiC;IAC/F,mCAAmC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAuC,SAAQ,iCAAiC;IAC/F,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE,WAAW,GAAG,QAAQ,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,2CAA4C,SAAQ,sCAAsC;IACzG,8CAA8C;IAC9C,SAAS,EAAE,WAAW,CAAC;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,wCAAyC,SAAQ,sCAAsC;IACtG,8CAA8C;IAC9C,SAAS,EAAE,QAAQ,CAAC;IACpB,wBAAwB;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,WAAW,EAAE,MAAM,GAAG,6BAA6B,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,2CAA2C,GAAG,wCAAwC,CAAC;AAExI;;;GAGG;AACH,MAAM,WAAW,mCAAoC,SAAQ,iCAAiC;IAC5F,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE;QAAE,CAAC,WAAW,EAAE,MAAM,GAAG,6BAA6B,CAAA;KAAE,CAAC;CACnE;AAED;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,sCAAsC,GAAG,kCAAkC,GAAG,mCAAmC,CAAC;AAE9J;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,6BAA6B,GAAG,6BAA6B,CAAC;AAElG,gBAAgB;AAChB,eAAO,MAAM,8BAA8B,QAAO,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,KAAK,iBAAiB,CAO3G,CAAC"}
+{"version":3,"file":"ElementProperties.d.ts","sourceRoot":"","sources":["../../../src/presentation-common/ElementProperties.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAiC,UAAU,EAAe,MAAM,qBAAqB,CAAC;AAe7F,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAGzC;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,EAAE,EAAE,UAAU,CAAC;IACf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,mCAAmC;IACnC,IAAI,EAAE,UAAU,GAAG,kCAAkC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA8B,SAAQ,yBAAyB;IAC9E,mCAAmC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAAA;KAAE,CAAC;CACnD;AAED;;;GAGG;AACH,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,mCAAmC;IACnC,IAAI,EAAE,kCAAkC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAuC,SAAQ,iCAAiC;IAC/F,mCAAmC;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAuC,SAAQ,iCAAiC;IAC/F,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,8CAA8C;IAC9C,SAAS,EAAE,WAAW,GAAG,QAAQ,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,WAAW,2CAA4C,SAAQ,sCAAsC;IACzG,8CAA8C;IAC9C,SAAS,EAAE,WAAW,CAAC;IACvB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,wCAAyC,SAAQ,sCAAsC;IACtG,8CAA8C;IAC9C,SAAS,EAAE,QAAQ,CAAC;IACpB,wBAAwB;IACxB,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,WAAW,EAAE,MAAM,GAAG,6BAA6B,CAAA;KAAE,CAAC,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,2CAA2C,GAAG,wCAAwC,CAAC;AAExI;;;GAGG;AACH,MAAM,WAAW,mCAAoC,SAAQ,iCAAiC;IAC5F,mCAAmC;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,mCAAmC;IACnC,OAAO,EAAE;QAAE,CAAC,WAAW,EAAE,MAAM,GAAG,6BAA6B,CAAA;KAAE,CAAC;CACnE;AAED;;;GAGG;AACH,MAAM,MAAM,kCAAkC,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElF;;;GAGG;AACH,MAAM,MAAM,6BAA6B,GAAG,sCAAsC,GAAG,kCAAkC,GAAG,mCAAmC,CAAC;AAE9J;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,6BAA6B,GAAG,6BAA6B,CAAC;AAElG,gBAAgB;AAChB,eAAO,MAAM,8BAA8B,QAAO,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,KAAK,iBAAiB,CAO3G,CAAC"}

package/lib/cjs/presentation-common/ElementProperties.js

@@ -34,11 +34,14 @@ class ElementPropertiesAppender {
         this._propertyItems[label] = item;
     }
     finish() {
-        // eslint-disable-next-line guard-for-in
-        for (const categoryName in this._categoryItemAppenders) {
-            const appender = this._categoryItemAppenders[categoryName];
-            appender.finish();
-        }
+        // create an ordered list of category depths / appenders starting with categories that have the most ancestors and finishing with categories
+        // that have no ancestors, so that when we call `finish` on appenders, child categories are finished before parent categories, otherwise
+        // we may skip parent categories, thinking they have no items
+        const categoriesNestedToRoot = new core_bentley_1.SortedArray((lhs, rhs) => rhs.categoryDepth - lhs.categoryDepth, core_bentley_1.DuplicatePolicy.Allow);
+        Object.entries(this._categoryItemAppenders).forEach(([_, { category, appender }]) => {
+            categoriesNestedToRoot.insert({ categoryDepth: countAncestors(category), appender });
+        });
+        categoriesNestedToRoot.forEach(({ appender }) => appender.finish());
         this._onItemFinished({
             class: this._item.classInfo?.label ?? "",
             id: this._item.primaryKeys[0]?.id ?? core_bentley_1.Id64.invalid,
@@ -47,12 +50,12 @@ class ElementPropertiesAppender {
         });
     }
     getCategoryAppender(parentAppender, category) {
-        let appender = this._categoryItemAppenders[category.name];
-        if (!appender) {
-            appender = new CategoryItemAppender(parentAppender, category);
-            this._categoryItemAppenders[category.name] = appender;
+        let entry = this._categoryItemAppenders[category.name];
+        if (!entry) {
+            entry = { category, appender: new CategoryItemAppender(parentAppender, category) };
+            this._categoryItemAppenders[category.name] = entry;
         }
-        return appender;
+        return entry.appender;
     }
 }
 class CategoryItemAppender {
@@ -209,4 +212,7 @@ class ElementPropertiesBuilder {
         });
     }
 }
+function countAncestors(child) {
+    return child.parent ? 1 + countAncestors(child.parent) : 0;
+}
 //# sourceMappingURL=ElementProperties.js.map

package/lib/cjs/presentation-common/ElementProperties.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementProperties.js","sourceRoot":"","sources":["../../../src/presentation-common/ElementProperties.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n * See LICENSE.md in the project root for license terms and full copyright notice.\r\n *--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RPC\r\n */\r\n\r\nimport { assert, Id64, Id64String } from \"@itwin/core-bentley\";\r\nimport { CategoryDescription } from \"./content/Category.js\";\r\nimport {\r\n  createContentTraverser,\r\n  IContentVisitor,\r\n  ProcessFieldHierarchiesProps,\r\n  ProcessMergedValueProps,\r\n  ProcessPrimitiveValueProps,\r\n  StartArrayProps,\r\n  StartCategoryProps,\r\n  StartContentProps,\r\n  StartFieldProps,\r\n  StartItemProps,\r\n  StartStructProps,\r\n} from \"./content/ContentTraverser.js\";\r\nimport { Descriptor } from \"./content/Descriptor.js\";\r\nimport { Item } from \"./content/Item.js\";\r\nimport { PropertyValueFormat } from \"./content/TypeDescription.js\";\r\n\r\n/**\r\n * Data structure for storing element properties information in a simplified format.\r\n * @see [[Content]] for a format that stores all available element property data.\r\n * @public\r\n */\r\nexport interface ElementProperties {\r\n  /** Label of element's ECClass. */\r\n  class: string;\r\n  /** Element's ID. */\r\n  id: Id64String;\r\n  /** Element's label. */\r\n  label: string;\r\n  /** Container of property values */\r\n  items: { [label: string]: ElementPropertiesItem };\r\n}\r\n\r\n/**\r\n * Base type for all [[ElementPropertiesItem]] types.\r\n * @public\r\n */\r\nexport interface ElementPropertiesItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"category\" | ElementPropertiesPropertyValueType;\r\n}\r\n\r\n/**\r\n * Definition for a category. A category can nest other property items, including categories.\r\n * @public\r\n */\r\nexport interface ElementPropertiesCategoryItem extends ElementPropertiesItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"category\";\r\n  /** Container of property values */\r\n  items: { [label: string]: ElementPropertiesItem };\r\n}\r\n\r\n/**\r\n * Base type for all [[ElementPropertiesPropertyItem]] types.\r\n * @public\r\n */\r\nexport interface ElementPropertiesPropertyItemBase extends ElementPropertiesItemBase {\r\n  /** Type of the properties item. */\r\n  type: ElementPropertiesPropertyValueType;\r\n}\r\n\r\n/**\r\n * Definition for a primitive property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesPrimitivePropertyItem extends ElementPropertiesPropertyItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"primitive\";\r\n  /** Display value of the property. */\r\n  value: string;\r\n}\r\n\r\n/**\r\n * Base type for all [[ElementPropertiesArrayPropertyItem]] types.\r\n * @public\r\n */\r\nexport interface ElementPropertiesArrayPropertyItemBase extends ElementPropertiesPropertyItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"array\";\r\n  /** Type of values contained in this array. */\r\n  valueType: \"primitive\" | \"struct\";\r\n}\r\n\r\n/**\r\n * Definition for a primitives' array property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesPrimitiveArrayPropertyItem extends ElementPropertiesArrayPropertyItemBase {\r\n  /** Type of values contained in this array. */\r\n  valueType: \"primitive\";\r\n  /** Array of display values. */\r\n  values: string[];\r\n}\r\n\r\n/**\r\n * Definition for a structs' array property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesStructArrayPropertyItem extends ElementPropertiesArrayPropertyItemBase {\r\n  /** Type of values contained in this array. */\r\n  valueType: \"struct\";\r\n  /** Array of structs. */\r\n  values: Array<{ [memberLabel: string]: ElementPropertiesPropertyItem }>;\r\n}\r\n\r\n/**\r\n * Definition for an array property value.\r\n * @public\r\n */\r\nexport type ElementPropertiesArrayPropertyItem = ElementPropertiesPrimitiveArrayPropertyItem | ElementPropertiesStructArrayPropertyItem;\r\n\r\n/**\r\n * Definition for an struct property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesStructPropertyItem extends ElementPropertiesPropertyItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"struct\";\r\n  /** Container of struct members. */\r\n  members: { [memberLabel: string]: ElementPropertiesPropertyItem };\r\n}\r\n\r\n/**\r\n * Available element property types.\r\n * @public\r\n */\r\nexport type ElementPropertiesPropertyValueType = \"primitive\" | \"array\" | \"struct\";\r\n\r\n/**\r\n * Definition of a property value.\r\n * @public\r\n */\r\nexport type ElementPropertiesPropertyItem = ElementPropertiesPrimitivePropertyItem | ElementPropertiesArrayPropertyItem | ElementPropertiesStructPropertyItem;\r\n\r\n/**\r\n * Definition of a property item, including a property category.\r\n * @public\r\n */\r\nexport type ElementPropertiesItem = ElementPropertiesCategoryItem | ElementPropertiesPropertyItem;\r\n\r\n/** @internal */\r\nexport const createElementPropertiesBuilder = (): ((descriptor: Descriptor, item: Item) => ElementProperties) => {\r\n  const builder = new ElementPropertiesBuilder();\r\n  const traverseContent = createContentTraverser(builder);\r\n  return (descriptor: Descriptor, item: Item) => {\r\n    traverseContent(descriptor, [item]);\r\n    return builder.items[0];\r\n  };\r\n};\r\n\r\ninterface IPropertiesAppender {\r\n  append(label: string, item: ElementPropertiesItem): void;\r\n  finish(): void;\r\n}\r\n\r\nclass ElementPropertiesAppender implements IPropertiesAppender {\r\n  private _propertyItems: { [label: string]: ElementPropertiesItem } = {};\r\n  private _categoryItemAppenders: { [categoryName: string]: IPropertiesAppender } = {};\r\n  constructor(\r\n    private _item: Item,\r\n    private _onItemFinished: (item: ElementProperties) => void,\r\n  ) {}\r\n\r\n  public append(label: string, item: ElementPropertiesItem): void {\r\n    this._propertyItems[label] = item;\r\n  }\r\n\r\n  public finish(): void {\r\n    // eslint-disable-next-line guard-for-in\r\n    for (const categoryName in this._categoryItemAppenders) {\r\n      const appender = this._categoryItemAppenders[categoryName];\r\n      appender.finish();\r\n    }\r\n\r\n    this._onItemFinished({\r\n      class: this._item.classInfo?.label ?? \"\",\r\n      id: this._item.primaryKeys[0]?.id ?? Id64.invalid,\r\n      label: this._item.label.displayValue,\r\n      items: this._propertyItems,\r\n    });\r\n  }\r\n\r\n  public getCategoryAppender(parentAppender: IPropertiesAppender, category: CategoryDescription): IPropertiesAppender {\r\n    let appender = this._categoryItemAppenders[category.name];\r\n    if (!appender) {\r\n      appender = new CategoryItemAppender(parentAppender, category);\r\n      this._categoryItemAppenders[category.name] = appender;\r\n    }\r\n    return appender;\r\n  }\r\n}\r\n\r\nclass CategoryItemAppender implements IPropertiesAppender {\r\n  private _items: { [label: string]: ElementPropertiesItem } = {};\r\n  constructor(\r\n    private _parentAppender: IPropertiesAppender,\r\n    private _category: CategoryDescription,\r\n  ) {}\r\n  public append(label: string, item: ElementPropertiesItem): void {\r\n    this._items[label] = item;\r\n  }\r\n  public finish(): void {\r\n    if (Object.keys(this._items).length === 0) {\r\n      return;\r\n    }\r\n\r\n    this._parentAppender.append(this._category.label, {\r\n      type: \"category\",\r\n      items: this._items,\r\n    });\r\n  }\r\n}\r\n\r\nclass ArrayItemAppender implements IPropertiesAppender {\r\n  private _items: ElementPropertiesPropertyItem[] = [];\r\n  constructor(\r\n    private _parentAppender: IPropertiesAppender,\r\n    private _props: StartArrayProps,\r\n  ) {}\r\n  public append(_label: string, item: ElementPropertiesItem): void {\r\n    assert(item.type !== \"category\");\r\n    this._items.push(item);\r\n  }\r\n  public finish(): void {\r\n    assert(this._props.valueType.valueFormat === PropertyValueFormat.Array);\r\n    if (this._props.valueType.memberType.valueFormat === PropertyValueFormat.Primitive) {\r\n      this._parentAppender.append(this._props.hierarchy.field.label, this.createPrimitivesArray());\r\n    } else {\r\n      this._parentAppender.append(this._props.hierarchy.field.label, this.createStructsArray());\r\n    }\r\n  }\r\n  private createPrimitivesArray(): ElementPropertiesPrimitiveArrayPropertyItem {\r\n    return {\r\n      type: \"array\",\r\n      valueType: \"primitive\",\r\n      values: this._items.map((item) => {\r\n        assert(item.type === \"primitive\");\r\n        return item.value;\r\n      }),\r\n    };\r\n  }\r\n  private createStructsArray(): ElementPropertiesStructArrayPropertyItem {\r\n    return {\r\n      type: \"array\",\r\n      valueType: \"struct\",\r\n      values: this._items.map((item) => {\r\n        assert(item.type === \"struct\");\r\n        return item.members;\r\n      }),\r\n    };\r\n  }\r\n}\r\n\r\nclass StructItemAppender implements IPropertiesAppender {\r\n  private _members: { [label: string]: ElementPropertiesPropertyItem } = {};\r\n  constructor(\r\n    private _parentAppender: IPropertiesAppender,\r\n    private _props: StartStructProps,\r\n  ) {}\r\n  public append(label: string, item: ElementPropertiesItem): void {\r\n    assert(item.type !== \"category\");\r\n    this._members[label] = item;\r\n  }\r\n  public finish(): void {\r\n    assert(this._props.valueType.valueFormat === PropertyValueFormat.Struct);\r\n    this._parentAppender.append(this._props.hierarchy.field.label, {\r\n      type: \"struct\",\r\n      members: this._members,\r\n    });\r\n  }\r\n}\r\n\r\nclass ElementPropertiesBuilder implements IContentVisitor {\r\n  private _appendersStack: IPropertiesAppender[] = [];\r\n  private _items: ElementProperties[] = [];\r\n  private _elementPropertiesAppender: ElementPropertiesAppender | undefined;\r\n\r\n  public get items(): ElementProperties[] {\r\n    return this._items;\r\n  }\r\n\r\n  private get _currentAppender(): IPropertiesAppender {\r\n    const appender = this._appendersStack[this._appendersStack.length - 1];\r\n    assert(appender !== undefined);\r\n    return appender;\r\n  }\r\n\r\n  public startContent(_props: StartContentProps): boolean {\r\n    this._appendersStack = [];\r\n    this._items = [];\r\n    this._elementPropertiesAppender = undefined;\r\n    return true;\r\n  }\r\n  public finishContent(): void {}\r\n\r\n  public processFieldHierarchies(_props: ProcessFieldHierarchiesProps): void {}\r\n\r\n  public startItem(props: StartItemProps): boolean {\r\n    this._elementPropertiesAppender = new ElementPropertiesAppender(props.item, (item) => this._items.push(item));\r\n    this._appendersStack.push(this._elementPropertiesAppender);\r\n    return true;\r\n  }\r\n  public finishItem(): void {\r\n    this._appendersStack.pop();\r\n    assert(this._elementPropertiesAppender !== undefined);\r\n    this._elementPropertiesAppender.finish();\r\n    this._elementPropertiesAppender = undefined;\r\n  }\r\n\r\n  public startCategory(props: StartCategoryProps): boolean {\r\n    assert(this._elementPropertiesAppender !== undefined);\r\n    this._appendersStack.push(this._elementPropertiesAppender.getCategoryAppender(this._currentAppender, props.category));\r\n    return true;\r\n  }\r\n  public finishCategory(): void {\r\n    this._appendersStack.pop();\r\n  }\r\n\r\n  public startField(_props: StartFieldProps): boolean {\r\n    return true;\r\n  }\r\n  public finishField(): void {}\r\n\r\n  public startStruct(props: StartStructProps): boolean {\r\n    this._appendersStack.push(new StructItemAppender(this._currentAppender, props));\r\n    return true;\r\n  }\r\n  public finishStruct(): void {\r\n    this._appendersStack.pop()!.finish();\r\n  }\r\n\r\n  public startArray(props: StartArrayProps): boolean {\r\n    this._appendersStack.push(new ArrayItemAppender(this._currentAppender, props));\r\n    return true;\r\n  }\r\n  public finishArray(): void {\r\n    this._appendersStack.pop()!.finish();\r\n  }\r\n\r\n  public processMergedValue(props: ProcessMergedValueProps): void {\r\n    this._currentAppender.append(props.mergedField.label, {\r\n      type: \"primitive\",\r\n      value: \"\",\r\n    });\r\n  }\r\n  public processPrimitiveValue(props: ProcessPrimitiveValueProps): void {\r\n    this._currentAppender.append(props.field.label, {\r\n      type: \"primitive\",\r\n      // eslint-disable-next-line @typescript-eslint/no-base-to-string\r\n      value: props.displayValue?.toString() ?? \"\",\r\n    });\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ElementProperties.js","sourceRoot":"","sources":["../../../src/presentation-common/ElementProperties.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n * See LICENSE.md in the project root for license terms and full copyright notice.\r\n *--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module RPC\r\n */\r\n\r\nimport { assert, DuplicatePolicy, Id64, Id64String, SortedArray } from \"@itwin/core-bentley\";\r\nimport { CategoryDescription } from \"./content/Category.js\";\r\nimport {\r\n  createContentTraverser,\r\n  IContentVisitor,\r\n  ProcessFieldHierarchiesProps,\r\n  ProcessMergedValueProps,\r\n  ProcessPrimitiveValueProps,\r\n  StartArrayProps,\r\n  StartCategoryProps,\r\n  StartContentProps,\r\n  StartFieldProps,\r\n  StartItemProps,\r\n  StartStructProps,\r\n} from \"./content/ContentTraverser.js\";\r\nimport { Descriptor } from \"./content/Descriptor.js\";\r\nimport { Item } from \"./content/Item.js\";\r\nimport { PropertyValueFormat } from \"./content/TypeDescription.js\";\r\n\r\n/**\r\n * Data structure for storing element properties information in a simplified format.\r\n * @see [[Content]] for a format that stores all available element property data.\r\n * @public\r\n */\r\nexport interface ElementProperties {\r\n  /** Label of element's ECClass. */\r\n  class: string;\r\n  /** Element's ID. */\r\n  id: Id64String;\r\n  /** Element's label. */\r\n  label: string;\r\n  /** Container of property values */\r\n  items: { [label: string]: ElementPropertiesItem };\r\n}\r\n\r\n/**\r\n * Base type for all [[ElementPropertiesItem]] types.\r\n * @public\r\n */\r\nexport interface ElementPropertiesItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"category\" | ElementPropertiesPropertyValueType;\r\n}\r\n\r\n/**\r\n * Definition for a category. A category can nest other property items, including categories.\r\n * @public\r\n */\r\nexport interface ElementPropertiesCategoryItem extends ElementPropertiesItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"category\";\r\n  /** Container of property values */\r\n  items: { [label: string]: ElementPropertiesItem };\r\n}\r\n\r\n/**\r\n * Base type for all [[ElementPropertiesPropertyItem]] types.\r\n * @public\r\n */\r\nexport interface ElementPropertiesPropertyItemBase extends ElementPropertiesItemBase {\r\n  /** Type of the properties item. */\r\n  type: ElementPropertiesPropertyValueType;\r\n}\r\n\r\n/**\r\n * Definition for a primitive property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesPrimitivePropertyItem extends ElementPropertiesPropertyItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"primitive\";\r\n  /** Display value of the property. */\r\n  value: string;\r\n}\r\n\r\n/**\r\n * Base type for all [[ElementPropertiesArrayPropertyItem]] types.\r\n * @public\r\n */\r\nexport interface ElementPropertiesArrayPropertyItemBase extends ElementPropertiesPropertyItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"array\";\r\n  /** Type of values contained in this array. */\r\n  valueType: \"primitive\" | \"struct\";\r\n}\r\n\r\n/**\r\n * Definition for a primitives' array property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesPrimitiveArrayPropertyItem extends ElementPropertiesArrayPropertyItemBase {\r\n  /** Type of values contained in this array. */\r\n  valueType: \"primitive\";\r\n  /** Array of display values. */\r\n  values: string[];\r\n}\r\n\r\n/**\r\n * Definition for a structs' array property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesStructArrayPropertyItem extends ElementPropertiesArrayPropertyItemBase {\r\n  /** Type of values contained in this array. */\r\n  valueType: \"struct\";\r\n  /** Array of structs. */\r\n  values: Array<{ [memberLabel: string]: ElementPropertiesPropertyItem }>;\r\n}\r\n\r\n/**\r\n * Definition for an array property value.\r\n * @public\r\n */\r\nexport type ElementPropertiesArrayPropertyItem = ElementPropertiesPrimitiveArrayPropertyItem | ElementPropertiesStructArrayPropertyItem;\r\n\r\n/**\r\n * Definition for an struct property value.\r\n * @public\r\n */\r\nexport interface ElementPropertiesStructPropertyItem extends ElementPropertiesPropertyItemBase {\r\n  /** Type of the properties item. */\r\n  type: \"struct\";\r\n  /** Container of struct members. */\r\n  members: { [memberLabel: string]: ElementPropertiesPropertyItem };\r\n}\r\n\r\n/**\r\n * Available element property types.\r\n * @public\r\n */\r\nexport type ElementPropertiesPropertyValueType = \"primitive\" | \"array\" | \"struct\";\r\n\r\n/**\r\n * Definition of a property value.\r\n * @public\r\n */\r\nexport type ElementPropertiesPropertyItem = ElementPropertiesPrimitivePropertyItem | ElementPropertiesArrayPropertyItem | ElementPropertiesStructPropertyItem;\r\n\r\n/**\r\n * Definition of a property item, including a property category.\r\n * @public\r\n */\r\nexport type ElementPropertiesItem = ElementPropertiesCategoryItem | ElementPropertiesPropertyItem;\r\n\r\n/** @internal */\r\nexport const createElementPropertiesBuilder = (): ((descriptor: Descriptor, item: Item) => ElementProperties) => {\r\n  const builder = new ElementPropertiesBuilder();\r\n  const traverseContent = createContentTraverser(builder);\r\n  return (descriptor: Descriptor, item: Item) => {\r\n    traverseContent(descriptor, [item]);\r\n    return builder.items[0];\r\n  };\r\n};\r\n\r\ninterface IPropertiesAppender {\r\n  append(label: string, item: ElementPropertiesItem): void;\r\n  finish(): void;\r\n}\r\n\r\nclass ElementPropertiesAppender implements IPropertiesAppender {\r\n  private _propertyItems: { [label: string]: ElementPropertiesItem } = {};\r\n  private _categoryItemAppenders: { [categoryName: string]: { category: CategoryDescription; appender: IPropertiesAppender } } = {};\r\n  constructor(\r\n    private _item: Item,\r\n    private _onItemFinished: (item: ElementProperties) => void,\r\n  ) {}\r\n\r\n  public append(label: string, item: ElementPropertiesItem): void {\r\n    this._propertyItems[label] = item;\r\n  }\r\n\r\n  public finish(): void {\r\n    // create an ordered list of category depths / appenders starting with categories that have the most ancestors and finishing with categories\r\n    // that have no ancestors, so that when we call `finish` on appenders, child categories are finished before parent categories, otherwise\r\n    // we may skip parent categories, thinking they have no items\r\n    const categoriesNestedToRoot = new SortedArray<{ categoryDepth: number; appender: IPropertiesAppender }>(\r\n      (lhs, rhs) => rhs.categoryDepth - lhs.categoryDepth,\r\n      DuplicatePolicy.Allow,\r\n    );\r\n    Object.entries(this._categoryItemAppenders).forEach(([_, { category, appender }]) => {\r\n      categoriesNestedToRoot.insert({ categoryDepth: countAncestors(category), appender });\r\n    });\r\n    categoriesNestedToRoot.forEach(({ appender }) => appender.finish());\r\n\r\n    this._onItemFinished({\r\n      class: this._item.classInfo?.label ?? \"\",\r\n      id: this._item.primaryKeys[0]?.id ?? Id64.invalid,\r\n      label: this._item.label.displayValue,\r\n      items: this._propertyItems,\r\n    });\r\n  }\r\n\r\n  public getCategoryAppender(parentAppender: IPropertiesAppender, category: CategoryDescription): IPropertiesAppender {\r\n    let entry = this._categoryItemAppenders[category.name];\r\n    if (!entry) {\r\n      entry = { category, appender: new CategoryItemAppender(parentAppender, category) };\r\n      this._categoryItemAppenders[category.name] = entry;\r\n    }\r\n    return entry.appender;\r\n  }\r\n}\r\n\r\nclass CategoryItemAppender implements IPropertiesAppender {\r\n  private _items: { [label: string]: ElementPropertiesItem } = {};\r\n  constructor(\r\n    private _parentAppender: IPropertiesAppender,\r\n    private _category: CategoryDescription,\r\n  ) {}\r\n  public append(label: string, item: ElementPropertiesItem): void {\r\n    this._items[label] = item;\r\n  }\r\n  public finish(): void {\r\n    if (Object.keys(this._items).length === 0) {\r\n      return;\r\n    }\r\n\r\n    this._parentAppender.append(this._category.label, {\r\n      type: \"category\",\r\n      items: this._items,\r\n    });\r\n  }\r\n}\r\n\r\nclass ArrayItemAppender implements IPropertiesAppender {\r\n  private _items: ElementPropertiesPropertyItem[] = [];\r\n  constructor(\r\n    private _parentAppender: IPropertiesAppender,\r\n    private _props: StartArrayProps,\r\n  ) {}\r\n  public append(_label: string, item: ElementPropertiesItem): void {\r\n    assert(item.type !== \"category\");\r\n    this._items.push(item);\r\n  }\r\n  public finish(): void {\r\n    assert(this._props.valueType.valueFormat === PropertyValueFormat.Array);\r\n    if (this._props.valueType.memberType.valueFormat === PropertyValueFormat.Primitive) {\r\n      this._parentAppender.append(this._props.hierarchy.field.label, this.createPrimitivesArray());\r\n    } else {\r\n      this._parentAppender.append(this._props.hierarchy.field.label, this.createStructsArray());\r\n    }\r\n  }\r\n  private createPrimitivesArray(): ElementPropertiesPrimitiveArrayPropertyItem {\r\n    return {\r\n      type: \"array\",\r\n      valueType: \"primitive\",\r\n      values: this._items.map((item) => {\r\n        assert(item.type === \"primitive\");\r\n        return item.value;\r\n      }),\r\n    };\r\n  }\r\n  private createStructsArray(): ElementPropertiesStructArrayPropertyItem {\r\n    return {\r\n      type: \"array\",\r\n      valueType: \"struct\",\r\n      values: this._items.map((item) => {\r\n        assert(item.type === \"struct\");\r\n        return item.members;\r\n      }),\r\n    };\r\n  }\r\n}\r\n\r\nclass StructItemAppender implements IPropertiesAppender {\r\n  private _members: { [label: string]: ElementPropertiesPropertyItem } = {};\r\n  constructor(\r\n    private _parentAppender: IPropertiesAppender,\r\n    private _props: StartStructProps,\r\n  ) {}\r\n  public append(label: string, item: ElementPropertiesItem): void {\r\n    assert(item.type !== \"category\");\r\n    this._members[label] = item;\r\n  }\r\n  public finish(): void {\r\n    assert(this._props.valueType.valueFormat === PropertyValueFormat.Struct);\r\n    this._parentAppender.append(this._props.hierarchy.field.label, {\r\n      type: \"struct\",\r\n      members: this._members,\r\n    });\r\n  }\r\n}\r\n\r\nclass ElementPropertiesBuilder implements IContentVisitor {\r\n  private _appendersStack: IPropertiesAppender[] = [];\r\n  private _items: ElementProperties[] = [];\r\n  private _elementPropertiesAppender: ElementPropertiesAppender | undefined;\r\n\r\n  public get items(): ElementProperties[] {\r\n    return this._items;\r\n  }\r\n\r\n  private get _currentAppender(): IPropertiesAppender {\r\n    const appender = this._appendersStack[this._appendersStack.length - 1];\r\n    assert(appender !== undefined);\r\n    return appender;\r\n  }\r\n\r\n  public startContent(_props: StartContentProps): boolean {\r\n    this._appendersStack = [];\r\n    this._items = [];\r\n    this._elementPropertiesAppender = undefined;\r\n    return true;\r\n  }\r\n  public finishContent(): void {}\r\n\r\n  public processFieldHierarchies(_props: ProcessFieldHierarchiesProps): void {}\r\n\r\n  public startItem(props: StartItemProps): boolean {\r\n    this._elementPropertiesAppender = new ElementPropertiesAppender(props.item, (item) => this._items.push(item));\r\n    this._appendersStack.push(this._elementPropertiesAppender);\r\n    return true;\r\n  }\r\n  public finishItem(): void {\r\n    this._appendersStack.pop();\r\n    assert(this._elementPropertiesAppender !== undefined);\r\n    this._elementPropertiesAppender.finish();\r\n    this._elementPropertiesAppender = undefined;\r\n  }\r\n\r\n  public startCategory(props: StartCategoryProps): boolean {\r\n    assert(this._elementPropertiesAppender !== undefined);\r\n    this._appendersStack.push(this._elementPropertiesAppender.getCategoryAppender(this._currentAppender, props.category));\r\n    return true;\r\n  }\r\n  public finishCategory(): void {\r\n    this._appendersStack.pop();\r\n  }\r\n\r\n  public startField(_props: StartFieldProps): boolean {\r\n    return true;\r\n  }\r\n  public finishField(): void {}\r\n\r\n  public startStruct(props: StartStructProps): boolean {\r\n    this._appendersStack.push(new StructItemAppender(this._currentAppender, props));\r\n    return true;\r\n  }\r\n  public finishStruct(): void {\r\n    this._appendersStack.pop()!.finish();\r\n  }\r\n\r\n  public startArray(props: StartArrayProps): boolean {\r\n    this._appendersStack.push(new ArrayItemAppender(this._currentAppender, props));\r\n    return true;\r\n  }\r\n  public finishArray(): void {\r\n    this._appendersStack.pop()!.finish();\r\n  }\r\n\r\n  public processMergedValue(props: ProcessMergedValueProps): void {\r\n    this._currentAppender.append(props.mergedField.label, {\r\n      type: \"primitive\",\r\n      value: \"\",\r\n    });\r\n  }\r\n  public processPrimitiveValue(props: ProcessPrimitiveValueProps): void {\r\n    this._currentAppender.append(props.field.label, {\r\n      type: \"primitive\",\r\n      // eslint-disable-next-line @typescript-eslint/no-base-to-string\r\n      value: props.displayValue?.toString() ?? \"\",\r\n    });\r\n  }\r\n}\r\n\r\nfunction countAncestors<T extends { parent?: T }>(child: T): number {\r\n  return child.parent ? 1 + countAncestors(child.parent) : 0;\r\n}\r\n"]}

package/lib/cjs/presentation-common/PresentationManagerOptions.d.ts

@@ -3,7 +3,7 @@
  */
 import { BeEvent, Id64String } from "@itwin/core-bentley";
 import { UnitSystemKey } from "@itwin/core-quantity";
-import { Descriptor, SelectionInfo } from "./content/Descriptor.js";
+import { Descriptor, DescriptorFieldsSelector, SelectionInfo } from "./content/Descriptor.js";
 import { FieldDescriptor } from "./content/Fields.js";
 import { Item } from "./content/Item.js";
 import { InstanceKey } from "./EC.js";
@@ -186,9 +186,15 @@ export interface MultiElementPropertiesBaseRequestOptions<TIModel, TParsedConten
      * to a parser that creates [[ElementProperties]] objects.
      */
     contentParser?: (descriptor: Descriptor, item: Item) => TParsedContent;
+    /**
+     * A callback that allows specifying which fields should be included or excluded in the result based on the given content descriptor. This
+     * is useful when requesting properties of multiple elements, where the result set can be very large and it may be desirable to only get a
+     * subset of all available fields.
+     */
+    fieldsSelector?: (descriptor: Descriptor) => DescriptorFieldsSelector | undefined;
     /**
      * The properties of multiple elements are going to be retrieved and returned in batches. Depending on the batch
-     * size load on CPU vs MEMORY load may vary, so changing this attribute allows to fine tune the performance.
+     * size load on CPU vs MEMORY load may vary, so changing this attribute allows fine tuning the performance.
      * Defaults to `1000`.
      */
     batchSize?: number;