@itwin/components-react 4.17.0 → 5.0.0-dev.2

package/lib/components-react/propertygrid/internal/PropertyGridModelChangeEvent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyGridModelChangeEvent.d.ts","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/internal/PropertyGridModelChangeEvent.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,IAAI,CAAC;AAEzD;;;GAGG;AACH,qBAAa,4BAA6B,SAAQ,OAAO,CAAC,+BAA+B,CAAC;CAAG"}

package/lib/components-react/propertygrid/internal/PropertyGridModelChangeEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyGridModelChangeEvent.js","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/internal/PropertyGridModelChangeEvent.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG;;GAEG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAQ9C;;;GAGG;AACH,MAAM,OAAO,4BAA6B,SAAQ,OAAwC;CAAG","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module PropertyGrid\n */\nimport { BeEvent } from \"@itwin/core-bentley\";\n\n/**\n * A signature for property grid model change listeners\n * @public\n */\nexport type PropertyGridModelChangeListener = () => void;\n\n/**\n * An event broadcasted on property grid model changes\n * @public\n */\nexport class PropertyGridModelChangeEvent extends BeEvent<PropertyGridModelChangeListener> {}\n"]}

package/lib/components-react/propertygrid/internal/PropertyGridModelSource.d.ts

@@ -0,0 +1,37 @@
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import type { PropertyData } from "../PropertyDataProvider.js";
+import type { IMutableGridItemFactory } from "./flat-items/MutableGridItemFactory.js";
+import type { IMutablePropertyGridModel, IPropertyGridModel } from "./PropertyGridModel.js";
+import { PropertyGridModelChangeEvent } from "./PropertyGridModelChangeEvent.js";
+/** @public */
+export interface IPropertyGridModelSource {
+    onModelChanged: PropertyGridModelChangeEvent;
+    setPropertyData: (data: PropertyData) => void;
+    modifyModel(callback: (model: IMutablePropertyGridModel) => void): void;
+    getModel(): IPropertyGridModel | undefined;
+}
+/**
+ * Controls property grid model.
+ * It is used to modify property grid model model and inform when the model changes.
+ * @public
+ */
+export declare class PropertyGridModelSource implements IPropertyGridModelSource {
+    private _gridFactory;
+    private _model?;
+    /** Event that is emitted every time property model is changed. */
+    onModelChanged: PropertyGridModelChangeEvent;
+    constructor(_gridFactory: IMutableGridItemFactory);
+    private getFullModelMap;
+    private moveOldModelState;
+    setPropertyData(data: PropertyData): void;
+    /**
+     * Modifies property grid model using provided callback.
+     * If changes to model are detected, onModelChanged emits an event to all subscribers.
+     */
+    modifyModel(callback: (model: IMutablePropertyGridModel) => void): void;
+    /** Returns property grid model. */
+    getModel(): IPropertyGridModel | undefined;
+}
+//# sourceMappingURL=PropertyGridModelSource.d.ts.map

package/lib/components-react/propertygrid/internal/PropertyGridModelSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyGridModelSource.d.ts","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/internal/PropertyGridModelSource.ts"],"names":[],"mappings":"AAIA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACtF,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAEjF,cAAc;AACd,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,4BAA4B,CAAC;IAC7C,eAAe,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC9C,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GAAG,IAAI,CAAC;IACxE,QAAQ,IAAI,kBAAkB,GAAG,SAAS,CAAC;CAC5C;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,YAAW,wBAAwB;IAKnD,OAAO,CAAC,YAAY;IAJvC,OAAO,CAAC,MAAM,CAAC,CAA4B;IAC3C,kEAAkE;IAC3D,cAAc,+BAAsC;gBAEhC,YAAY,EAAE,uBAAuB;IAEhE,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,iBAAiB;IAalB,eAAe,CAAC,IAAI,EAAE,YAAY;IASzC;;;OAGG;IACI,WAAW,CAChB,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,GACnD,IAAI;IAOP,mCAAmC;IAC5B,QAAQ,IAAI,kBAAkB,GAAG,SAAS;CAGlD"}

package/lib/components-react/propertygrid/internal/PropertyGridModelSource.js

@@ -0,0 +1,61 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import { produce } from "immer";
+import { MutablePropertyGridModel } from "./PropertyGridModel.js";
+import { PropertyGridModelChangeEvent } from "./PropertyGridModelChangeEvent.js";
+/**
+ * Controls property grid model.
+ * It is used to modify property grid model model and inform when the model changes.
+ * @public
+ */
+export class PropertyGridModelSource {
+    constructor(_gridFactory) {
+        this._gridFactory = _gridFactory;
+        /** Event that is emitted every time property model is changed. */
+        this.onModelChanged = new PropertyGridModelChangeEvent();
+    }
+    getFullModelMap(fullModel) {
+        const fullModelMap = new Map();
+        for (const item of fullModel) {
+            const key = item.selectionKey;
+            fullModelMap.set(key, item);
+        }
+        return fullModelMap;
+    }
+    moveOldModelState(oldModel, newModel) {
+        const oldModelMap = this.getFullModelMap(oldModel.getFlatGrid());
+        const flatGrid = newModel.getFlatGrid();
+        flatGrid.forEach((gridItem) => {
+            const oldGridItem = oldModelMap.get(gridItem.selectionKey);
+            if (oldGridItem)
+                gridItem.isExpanded = oldGridItem.isExpanded;
+        });
+    }
+    setPropertyData(data) {
+        const newModel = new MutablePropertyGridModel(data, this._gridFactory);
+        if (this._model !== undefined && data.reusePropertyDataState)
+            this.moveOldModelState(this._model, newModel);
+        this._model = newModel;
+        this.onModelChanged.raiseEvent();
+    }
+    /**
+     * Modifies property grid model using provided callback.
+     * If changes to model are detected, onModelChanged emits an event to all subscribers.
+     */
+    modifyModel(callback) {
+        if (!this._model)
+            return;
+        this._model = produce(this._model, callback);
+        this.onModelChanged.raiseEvent();
+    }
+    /** Returns property grid model. */
+    getModel() {
+        return this._model;
+    }
+}
+//# sourceMappingURL=PropertyGridModelSource.js.map

package/lib/components-react/propertygrid/internal/PropertyGridModelSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyGridModelSource.js","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/internal/PropertyGridModelSource.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAChG;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAQhC,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC;AAUjF;;;;GAIG;AACH,MAAM,OAAO,uBAAuB;IAKlC,YAA2B,YAAqC;QAArC,iBAAY,GAAZ,YAAY,CAAyB;QAHhE,kEAAkE;QAC3D,mBAAc,GAAG,IAAI,4BAA4B,EAAE,CAAC;IAEQ,CAAC;IAE5D,eAAe,CACrB,SAAiC;QAEjC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAgC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC;YAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,iBAAiB,CACvB,QAAmC,EACnC,QAAmC;QAEnC,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAExC,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC5B,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YAC3D,IAAI,WAAW;gBAAE,QAAQ,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,eAAe,CAAC,IAAkB;QACvC,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,sBAAsB;YAC1D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;QACvB,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED;;;OAGG;IACI,WAAW,CAChB,QAAoD;QAEpD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEzB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;IACnC,CAAC;IAED,mCAAmC;IAC5B,QAAQ;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module PropertyGrid\n */\n\nimport { produce } from \"immer\";\nimport type { PropertyData } from \"../PropertyDataProvider.js\";\nimport type { IMutableFlatGridItem } from \"./flat-items/MutableFlatGridItem.js\";\nimport type { IMutableGridItemFactory } from \"./flat-items/MutableGridItemFactory.js\";\nimport type {\n  IMutablePropertyGridModel,\n  IPropertyGridModel,\n} from \"./PropertyGridModel.js\";\nimport { MutablePropertyGridModel } from \"./PropertyGridModel.js\";\nimport { PropertyGridModelChangeEvent } from \"./PropertyGridModelChangeEvent.js\";\n\n/** @public */\nexport interface IPropertyGridModelSource {\n  onModelChanged: PropertyGridModelChangeEvent;\n  setPropertyData: (data: PropertyData) => void;\n  modifyModel(callback: (model: IMutablePropertyGridModel) => void): void;\n  getModel(): IPropertyGridModel | undefined;\n}\n\n/**\n * Controls property grid model.\n * It is used to modify property grid model model and inform when the model changes.\n * @public\n */\nexport class PropertyGridModelSource implements IPropertyGridModelSource {\n  private _model?: IMutablePropertyGridModel;\n  /** Event that is emitted every time property model is changed. */\n  public onModelChanged = new PropertyGridModelChangeEvent();\n\n  public constructor(private _gridFactory: IMutableGridItemFactory) {}\n\n  private getFullModelMap(\n    fullModel: IMutableFlatGridItem[]\n  ): Map<string, IMutableFlatGridItem> {\n    const fullModelMap = new Map<string, IMutableFlatGridItem>();\n    for (const item of fullModel) {\n      const key = item.selectionKey;\n      fullModelMap.set(key, item);\n    }\n\n    return fullModelMap;\n  }\n\n  private moveOldModelState(\n    oldModel: IMutablePropertyGridModel,\n    newModel: IMutablePropertyGridModel\n  ) {\n    const oldModelMap = this.getFullModelMap(oldModel.getFlatGrid());\n    const flatGrid = newModel.getFlatGrid();\n\n    flatGrid.forEach((gridItem) => {\n      const oldGridItem = oldModelMap.get(gridItem.selectionKey);\n      if (oldGridItem) gridItem.isExpanded = oldGridItem.isExpanded;\n    });\n  }\n\n  public setPropertyData(data: PropertyData) {\n    const newModel = new MutablePropertyGridModel(data, this._gridFactory);\n    if (this._model !== undefined && data.reusePropertyDataState)\n      this.moveOldModelState(this._model, newModel);\n\n    this._model = newModel;\n    this.onModelChanged.raiseEvent();\n  }\n\n  /**\n   * Modifies property grid model using provided callback.\n   * If changes to model are detected, onModelChanged emits an event to all subscribers.\n   */\n  public modifyModel(\n    callback: (model: IMutablePropertyGridModel) => void\n  ): void {\n    if (!this._model) return;\n\n    this._model = produce(this._model, callback);\n    this.onModelChanged.raiseEvent();\n  }\n\n  /** Returns property grid model. */\n  public getModel(): IPropertyGridModel | undefined {\n    return this._model;\n  }\n}\n"]}

package/lib/components-react/propertygrid/internal/flat-items/FlatGridItem.d.ts

@@ -0,0 +1,52 @@
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import type { CategorizedPropertyTypes, FlatGridItemType } from "./MutableFlatGridItem.js";
+import type { PropertyRecord } from "@itwin/appui-abstract";
+import type { PropertyCategory } from "../../PropertyDataProvider.js";
+/**
+ * Base immutable data structure defining common methods and properties for categories and categorized properties
+ * @public
+ */
+export interface FlatGridItemBase {
+    readonly isExpanded: boolean;
+    readonly key: string;
+    readonly selectionKey: string;
+    readonly parentSelectionKey: string | undefined;
+    readonly parentCategorySelectionKey: string | undefined;
+    readonly depth: number;
+    readonly label: string;
+    readonly type: FlatGridItemType;
+    readonly lastInNumberOfCategories: number;
+    readonly isLastInRootCategory: boolean;
+    getDescendantsAndSelf(): FlatGridItem[];
+    getVisibleDescendantsAndSelf(): FlatGridItem[];
+    getChildren(): FlatGridItem[];
+    getLastVisibleDescendantOrSelf(): FlatGridItem;
+}
+/**
+ * Data structure which describes methods and properties present on immutable [[GridCategoryItem]]
+ * @public
+ */
+export interface GridCategoryItem extends FlatGridItemBase {
+    readonly type: FlatGridItemType.Category;
+    readonly name: string;
+    readonly derivedCategory: PropertyCategory;
+}
+/**
+ * Data structure which describes methods and properties present on immutable [[CategorizedPropertyItem]] objects
+ * @public
+ */
+export interface CategorizedPropertyItem extends FlatGridItemBase {
+    readonly type: CategorizedPropertyTypes;
+    readonly derivedRecord: PropertyRecord;
+    readonly parentCategorySelectionKey: string;
+    readonly parentSelectionKey: string;
+    getChildren(): CategorizedPropertyItem[];
+}
+/**
+ * Type which describes immutable [[GridCategoryItem]] or [[CategorizedPropertyItem]]
+ * @public
+ */
+export type FlatGridItem = CategorizedPropertyItem | GridCategoryItem;
+//# sourceMappingURL=FlatGridItem.d.ts.map

package/lib/components-react/propertygrid/internal/flat-items/FlatGridItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatGridItem.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/FlatGridItem.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,0BAA0B,EAAE,MAAM,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,qBAAqB,IAAI,YAAY,EAAE,CAAC;IACxC,4BAA4B,IAAI,YAAY,EAAE,CAAC;IAC/C,WAAW,IAAI,YAAY,EAAE,CAAC;IAC9B,8BAA8B,IAAI,YAAY,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,EAAE,gBAAgB,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAEpC,WAAW,IAAI,uBAAuB,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,uBAAuB,GAAG,gBAAgB,CAAC"}

package/lib/components-react/propertygrid/internal/flat-items/FlatGridItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlatGridItem.js","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/FlatGridItem.ts"],"names":[],"mappings":"AAAA;;;gGAGgG","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module PropertyGrid\n */\nimport type {\n  CategorizedPropertyTypes,\n  FlatGridItemType,\n} from \"./MutableFlatGridItem.js\";\nimport type { PropertyRecord } from \"@itwin/appui-abstract\";\nimport type { PropertyCategory } from \"../../PropertyDataProvider.js\";\n\n/**\n * Base immutable data structure defining common methods and properties for categories and categorized properties\n * @public\n */\nexport interface FlatGridItemBase {\n  readonly isExpanded: boolean;\n  readonly key: string;\n  readonly selectionKey: string;\n  readonly parentSelectionKey: string | undefined;\n  readonly parentCategorySelectionKey: string | undefined;\n  readonly depth: number;\n  readonly label: string;\n  readonly type: FlatGridItemType;\n  readonly lastInNumberOfCategories: number;\n  readonly isLastInRootCategory: boolean;\n  getDescendantsAndSelf(): FlatGridItem[];\n  getVisibleDescendantsAndSelf(): FlatGridItem[];\n  getChildren(): FlatGridItem[];\n  getLastVisibleDescendantOrSelf(): FlatGridItem;\n}\n\n/**\n * Data structure which describes methods and properties present on immutable [[GridCategoryItem]]\n * @public\n */\nexport interface GridCategoryItem extends FlatGridItemBase {\n  readonly type: FlatGridItemType.Category;\n  readonly name: string;\n  readonly derivedCategory: PropertyCategory;\n}\n\n/**\n * Data structure which describes methods and properties present on immutable [[CategorizedPropertyItem]] objects\n * @public\n */\nexport interface CategorizedPropertyItem extends FlatGridItemBase {\n  readonly type: CategorizedPropertyTypes;\n  readonly derivedRecord: PropertyRecord;\n  readonly parentCategorySelectionKey: string;\n  readonly parentSelectionKey: string;\n\n  getChildren(): CategorizedPropertyItem[];\n}\n\n/**\n * Type which describes immutable [[GridCategoryItem]] or [[CategorizedPropertyItem]]\n * @public\n */\nexport type FlatGridItem = CategorizedPropertyItem | GridCategoryItem;\n"]}

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedArrayProperty.d.ts

@@ -0,0 +1,22 @@
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import { type PropertyRecord } from "@itwin/appui-abstract";
+import type { IMutableCategorizedPropertyItem, IMutableFlatGridItem } from "./MutableFlatGridItem.js";
+import { FlatGridItemType, MutableCategorizedProperty } from "./MutableFlatGridItem.js";
+import type { IMutableGridItemFactory } from "./MutableGridItemFactory.js";
+/**
+ * Mutable wrapper object for PropertyRecord with array valueFormat which provides methods for working with and managing record children hierarchies.
+ * @public
+ */
+export declare class MutableCategorizedArrayProperty extends MutableCategorizedProperty implements IMutableCategorizedPropertyItem {
+    private _renderLabel;
+    private _children;
+    constructor(record: PropertyRecord, parentSelectionKey: string, parentCategorySelectionKey: string, depth: number, gridItemFactory: IMutableGridItemFactory, overrideName?: string, overrideDisplayLabel?: string);
+    get type(): FlatGridItemType.Array;
+    getChildren(): IMutableCategorizedPropertyItem[];
+    getDescendantsAndSelf(): IMutableFlatGridItem[];
+    getVisibleDescendants(): IMutableFlatGridItem[];
+    getVisibleDescendantsAndSelf(): IMutableFlatGridItem[];
+}
+//# sourceMappingURL=MutableCategorizedArrayProperty.d.ts.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedArrayProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCategorizedArrayProperty.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCategorizedArrayProperty.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,+BAA+B,EAC/B,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,+BACX,SAAQ,0BACR,YAAW,+BAA+B;IAE1C,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,SAAS,CAAoC;gBAGnD,MAAM,EAAE,cAAc,EACtB,kBAAkB,EAAE,MAAM,EAC1B,0BAA0B,EAAE,MAAM,EAClC,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,uBAAuB,EACxC,YAAY,CAAC,EAAE,MAAM,EACrB,oBAAoB,CAAC,EAAE,MAAM;IAkC/B,IAAW,IAAI,IAAI,gBAAgB,CAAC,KAAK,CAExC;IAEM,WAAW,IAAI,+BAA+B,EAAE;IAIvC,qBAAqB;IAMrB,qBAAqB,IAAI,oBAAoB,EAAE;IAY/C,4BAA4B;CAK7C"}

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedArrayProperty.js

@@ -0,0 +1,55 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import { PropertyValueFormat, } from "@itwin/appui-abstract";
+import { FlatGridItemType, MutableCategorizedProperty, } from "./MutableFlatGridItem.js";
+/**
+ * Mutable wrapper object for PropertyRecord with array valueFormat which provides methods for working with and managing record children hierarchies.
+ * @public
+ */
+export class MutableCategorizedArrayProperty extends MutableCategorizedProperty {
+    constructor(record, parentSelectionKey, parentCategorySelectionKey, depth, gridItemFactory, overrideName, overrideDisplayLabel) {
+        super(FlatGridItemType.Array, record, parentSelectionKey, parentCategorySelectionKey, depth, overrideName, overrideDisplayLabel);
+        this._renderLabel = !record.property.hideCompositePropertyLabel;
+        const childrenDepth = depth + (this._renderLabel ? 1 : 0);
+        this._children = record.getChildrenRecords().map((child, index) => {
+            const newName = `${child.property.name}_${index}`;
+            let newDisplayLabel = `[${index + 1}]`;
+            if (child.description &&
+                child.value.valueFormat !== PropertyValueFormat.Primitive) {
+                newDisplayLabel += ` ${child.description}`;
+            }
+            return gridItemFactory.createCategorizedProperty(child, this.selectionKey, parentCategorySelectionKey, childrenDepth, newName, newDisplayLabel);
+        });
+    }
+    get type() {
+        return FlatGridItemType.Array;
+    }
+    getChildren() {
+        return this._children;
+    }
+    getDescendantsAndSelf() {
+        return this._renderLabel
+            ? super.getDescendantsAndSelf()
+            : this.getDescendants();
+    }
+    getVisibleDescendants() {
+        const descendants = [];
+        if (this.isExpanded || !this._renderLabel) {
+            // always render children if not rendering the label, otherwise there's no way to expand
+            // this item to make children visible
+            this.getChildren().forEach((child) => descendants.push(...child.getVisibleDescendantsAndSelf()));
+        }
+        return descendants;
+    }
+    getVisibleDescendantsAndSelf() {
+        return this._renderLabel
+            ? super.getVisibleDescendantsAndSelf()
+            : this.getVisibleDescendants();
+    }
+}
+//# sourceMappingURL=MutableCategorizedArrayProperty.js.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedArrayProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCategorizedArrayProperty.js","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCategorizedArrayProperty.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAEhG;;GAEG;AACH,OAAO,EAEL,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,MAAM,OAAO,+BACX,SAAQ,0BAA0B;IAMlC,YACE,MAAsB,EACtB,kBAA0B,EAC1B,0BAAkC,EAClC,KAAa,EACb,eAAwC,EACxC,YAAqB,EACrB,oBAA6B;QAE7B,KAAK,CACH,gBAAgB,CAAC,KAAK,EACtB,MAAM,EACN,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,EACL,YAAY,EACZ,oBAAoB,CACrB,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAChE,MAAM,aAAa,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;YAClD,IAAI,eAAe,GAAG,IAAI,KAAK,GAAG,CAAC,GAAG,CAAC;YACvC,IACE,KAAK,CAAC,WAAW;gBACjB,KAAK,CAAC,KAAK,CAAC,WAAW,KAAK,mBAAmB,CAAC,SAAS,EACzD,CAAC;gBACD,eAAe,IAAI,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAC7C,CAAC;YAED,OAAO,eAAe,CAAC,yBAAyB,CAC9C,KAAK,EACL,IAAI,CAAC,YAAY,EACjB,0BAA0B,EAC1B,aAAa,EACb,OAAO,EACP,eAAe,CAChB,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAW,IAAI;QACb,OAAO,gBAAgB,CAAC,KAAK,CAAC;IAChC,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEe,qBAAqB;QACnC,OAAO,IAAI,CAAC,YAAY;YACtB,CAAC,CAAC,KAAK,CAAC,qBAAqB,EAAE;YAC/B,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IAC5B,CAAC;IAEe,qBAAqB;QACnC,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,wFAAwF;YACxF,qCAAqC;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACnC,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,4BAA4B,EAAE,CAAC,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAEe,4BAA4B;QAC1C,OAAO,IAAI,CAAC,YAAY;YACtB,CAAC,CAAC,KAAK,CAAC,4BAA4B,EAAE;YACtC,CAAC,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACnC,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module PropertyGrid\n */\nimport {\n  type PropertyRecord,\n  PropertyValueFormat,\n} from \"@itwin/appui-abstract\";\nimport type {\n  IMutableCategorizedPropertyItem,\n  IMutableFlatGridItem,\n} from \"./MutableFlatGridItem.js\";\nimport {\n  FlatGridItemType,\n  MutableCategorizedProperty,\n} from \"./MutableFlatGridItem.js\";\nimport type { IMutableGridItemFactory } from \"./MutableGridItemFactory.js\";\n\n/**\n * Mutable wrapper object for PropertyRecord with array valueFormat which provides methods for working with and managing record children hierarchies.\n * @public\n */\nexport class MutableCategorizedArrayProperty\n  extends MutableCategorizedProperty\n  implements IMutableCategorizedPropertyItem\n{\n  private _renderLabel: boolean;\n  private _children: IMutableCategorizedPropertyItem[];\n\n  public constructor(\n    record: PropertyRecord,\n    parentSelectionKey: string,\n    parentCategorySelectionKey: string,\n    depth: number,\n    gridItemFactory: IMutableGridItemFactory,\n    overrideName?: string,\n    overrideDisplayLabel?: string\n  ) {\n    super(\n      FlatGridItemType.Array,\n      record,\n      parentSelectionKey,\n      parentCategorySelectionKey,\n      depth,\n      overrideName,\n      overrideDisplayLabel\n    );\n    this._renderLabel = !record.property.hideCompositePropertyLabel;\n    const childrenDepth = depth + (this._renderLabel ? 1 : 0);\n    this._children = record.getChildrenRecords().map((child, index) => {\n      const newName = `${child.property.name}_${index}`;\n      let newDisplayLabel = `[${index + 1}]`;\n      if (\n        child.description &&\n        child.value.valueFormat !== PropertyValueFormat.Primitive\n      ) {\n        newDisplayLabel += ` ${child.description}`;\n      }\n\n      return gridItemFactory.createCategorizedProperty(\n        child,\n        this.selectionKey,\n        parentCategorySelectionKey,\n        childrenDepth,\n        newName,\n        newDisplayLabel\n      );\n    });\n  }\n\n  public get type(): FlatGridItemType.Array {\n    return FlatGridItemType.Array;\n  }\n\n  public getChildren(): IMutableCategorizedPropertyItem[] {\n    return this._children;\n  }\n\n  public override getDescendantsAndSelf() {\n    return this._renderLabel\n      ? super.getDescendantsAndSelf()\n      : this.getDescendants();\n  }\n\n  public override getVisibleDescendants(): IMutableFlatGridItem[] {\n    const descendants: IMutableFlatGridItem[] = [];\n    if (this.isExpanded || !this._renderLabel) {\n      // always render children if not rendering the label, otherwise there's no way to expand\n      // this item to make children visible\n      this.getChildren().forEach((child) =>\n        descendants.push(...child.getVisibleDescendantsAndSelf())\n      );\n    }\n    return descendants;\n  }\n\n  public override getVisibleDescendantsAndSelf() {\n    return this._renderLabel\n      ? super.getVisibleDescendantsAndSelf()\n      : this.getVisibleDescendants();\n  }\n}\n"]}

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedPrimitiveProperty.d.ts

@@ -0,0 +1,16 @@
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import type { PropertyRecord } from "@itwin/appui-abstract";
+import type { IMutableCategorizedPropertyItem } from "./MutableFlatGridItem.js";
+import { FlatGridItemType, MutableCategorizedProperty } from "./MutableFlatGridItem.js";
+/**
+ * Mutable wrapper object for PropertyRecord with primitive valueFormat.
+ * @public
+ */
+export declare class MutableCategorizedPrimitiveProperty extends MutableCategorizedProperty implements IMutableCategorizedPropertyItem {
+    constructor(record: PropertyRecord, parentSelectionKey: string, parentCategorySelectionKey: string, depth: number, overrideName?: string, overrideDisplayLabel?: string);
+    get type(): FlatGridItemType.Primitive;
+    getChildren(): IMutableCategorizedPropertyItem[];
+}
+//# sourceMappingURL=MutableCategorizedPrimitiveProperty.d.ts.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedPrimitiveProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCategorizedPrimitiveProperty.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCategorizedPrimitiveProperty.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,qBAAa,mCACX,SAAQ,0BACR,YAAW,+BAA+B;gBAGxC,MAAM,EAAE,cAAc,EACtB,kBAAkB,EAAE,MAAM,EAC1B,0BAA0B,EAAE,MAAM,EAClC,KAAK,EAAE,MAAM,EACb,YAAY,CAAC,EAAE,MAAM,EACrB,oBAAoB,CAAC,EAAE,MAAM;IAa/B,IAAW,IAAI,IAAI,gBAAgB,CAAC,SAAS,CAE5C;IAEM,WAAW,IAAI,+BAA+B,EAAE;CAGxD"}

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedPrimitiveProperty.js

@@ -0,0 +1,21 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { FlatGridItemType, MutableCategorizedProperty, } from "./MutableFlatGridItem.js";
+/**
+ * Mutable wrapper object for PropertyRecord with primitive valueFormat.
+ * @public
+ */
+export class MutableCategorizedPrimitiveProperty extends MutableCategorizedProperty {
+    constructor(record, parentSelectionKey, parentCategorySelectionKey, depth, overrideName, overrideDisplayLabel) {
+        super(FlatGridItemType.Primitive, record, parentSelectionKey, parentCategorySelectionKey, depth, overrideName, overrideDisplayLabel);
+    }
+    get type() {
+        return FlatGridItemType.Primitive;
+    }
+    getChildren() {
+        return [];
+    }
+}
+//# sourceMappingURL=MutableCategorizedPrimitiveProperty.js.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedPrimitiveProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCategorizedPrimitiveProperty.js","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCategorizedPrimitiveProperty.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAOhG,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,mCACX,SAAQ,0BAA0B;IAGlC,YACE,MAAsB,EACtB,kBAA0B,EAC1B,0BAAkC,EAClC,KAAa,EACb,YAAqB,EACrB,oBAA6B;QAE7B,KAAK,CACH,gBAAgB,CAAC,SAAS,EAC1B,MAAM,EACN,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,EACL,YAAY,EACZ,oBAAoB,CACrB,CAAC;IACJ,CAAC;IAED,IAAW,IAAI;QACb,OAAO,gBAAgB,CAAC,SAAS,CAAC;IACpC,CAAC;IAEM,WAAW;QAChB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module PropertyGrid\n */\nimport type { PropertyRecord } from \"@itwin/appui-abstract\";\nimport type { IMutableCategorizedPropertyItem } from \"./MutableFlatGridItem.js\";\nimport {\n  FlatGridItemType,\n  MutableCategorizedProperty,\n} from \"./MutableFlatGridItem.js\";\n\n/**\n * Mutable wrapper object for PropertyRecord with primitive valueFormat.\n * @public\n */\nexport class MutableCategorizedPrimitiveProperty\n  extends MutableCategorizedProperty\n  implements IMutableCategorizedPropertyItem\n{\n  public constructor(\n    record: PropertyRecord,\n    parentSelectionKey: string,\n    parentCategorySelectionKey: string,\n    depth: number,\n    overrideName?: string,\n    overrideDisplayLabel?: string\n  ) {\n    super(\n      FlatGridItemType.Primitive,\n      record,\n      parentSelectionKey,\n      parentCategorySelectionKey,\n      depth,\n      overrideName,\n      overrideDisplayLabel\n    );\n  }\n\n  public get type(): FlatGridItemType.Primitive {\n    return FlatGridItemType.Primitive;\n  }\n\n  public getChildren(): IMutableCategorizedPropertyItem[] {\n    return [];\n  }\n}\n"]}

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedStructProperty.d.ts

@@ -0,0 +1,22 @@
+/** @packageDocumentation
+ * @module PropertyGrid
+ */
+import type { PropertyRecord } from "@itwin/appui-abstract";
+import type { IMutableCategorizedPropertyItem, IMutableFlatGridItem } from "./MutableFlatGridItem.js";
+import { FlatGridItemType, MutableCategorizedProperty } from "./MutableFlatGridItem.js";
+import type { IMutableGridItemFactory } from "./MutableGridItemFactory.js";
+/**
+ * Mutable wrapper object for PropertyRecord with struct valueFormat which provides methods for working with and managing record children hierarchies.
+ * @public
+ */
+export declare class MutableCategorizedStructProperty extends MutableCategorizedProperty implements IMutableCategorizedPropertyItem {
+    private _renderLabel;
+    private _children;
+    constructor(record: PropertyRecord, parentSelectionKey: string, parentCategorySelectionKey: string, depth: number, gridItemFactory: IMutableGridItemFactory, overrideName?: string, overrideDisplayLabel?: string);
+    get type(): FlatGridItemType.Struct;
+    getChildren(): IMutableCategorizedPropertyItem[];
+    getDescendantsAndSelf(): IMutableFlatGridItem[];
+    getVisibleDescendants(): IMutableFlatGridItem[];
+    getVisibleDescendantsAndSelf(): IMutableFlatGridItem[];
+}
+//# sourceMappingURL=MutableCategorizedStructProperty.d.ts.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedStructProperty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCategorizedStructProperty.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCategorizedStructProperty.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EACV,+BAA+B,EAC/B,oBAAoB,EACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E;;;GAGG;AACH,qBAAa,gCACX,SAAQ,0BACR,YAAW,+BAA+B;IAE1C,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,SAAS,CAAoC;gBAGnD,MAAM,EAAE,cAAc,EACtB,kBAAkB,EAAE,MAAM,EAC1B,0BAA0B,EAAE,MAAM,EAClC,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,uBAAuB,EACxC,YAAY,CAAC,EAAE,MAAM,EACrB,oBAAoB,CAAC,EAAE,MAAM;IAuB/B,IAAW,IAAI,IAAI,gBAAgB,CAAC,MAAM,CAEzC;IAEM,WAAW,IAAI,+BAA+B,EAAE;IAIvC,qBAAqB;IAMrB,qBAAqB,IAAI,oBAAoB,EAAE;IAY/C,4BAA4B;CAK7C"}

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedStructProperty.js

@@ -0,0 +1,45 @@
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+ * See LICENSE.md in the project root for license terms and full copyright notice.
+ *--------------------------------------------------------------------------------------------*/
+import { FlatGridItemType, MutableCategorizedProperty, } from "./MutableFlatGridItem.js";
+/**
+ * Mutable wrapper object for PropertyRecord with struct valueFormat which provides methods for working with and managing record children hierarchies.
+ * @public
+ */
+export class MutableCategorizedStructProperty extends MutableCategorizedProperty {
+    constructor(record, parentSelectionKey, parentCategorySelectionKey, depth, gridItemFactory, overrideName, overrideDisplayLabel) {
+        super(FlatGridItemType.Struct, record, parentSelectionKey, parentCategorySelectionKey, depth, overrideName, overrideDisplayLabel);
+        this._renderLabel = !record.property.hideCompositePropertyLabel;
+        const childrenDepth = depth + (this._renderLabel ? 1 : 0);
+        this._children = record.getChildrenRecords().map((value) => {
+            return gridItemFactory.createCategorizedProperty(value, this.selectionKey, this.parentCategorySelectionKey, childrenDepth);
+        });
+    }
+    get type() {
+        return FlatGridItemType.Struct;
+    }
+    getChildren() {
+        return this._children;
+    }
+    getDescendantsAndSelf() {
+        return this._renderLabel
+            ? super.getDescendantsAndSelf()
+            : this.getDescendants();
+    }
+    getVisibleDescendants() {
+        const descendants = [];
+        if (this.isExpanded || !this._renderLabel) {
+            // always render children if not rendering the label, otherwise there's no way to expand
+            // this item to make children visible
+            this.getChildren().forEach((child) => descendants.push(...child.getVisibleDescendantsAndSelf()));
+        }
+        return descendants;
+    }
+    getVisibleDescendantsAndSelf() {
+        return this._renderLabel
+            ? super.getVisibleDescendantsAndSelf()
+            : this.getVisibleDescendants();
+    }
+}
+//# sourceMappingURL=MutableCategorizedStructProperty.js.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCategorizedStructProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCategorizedStructProperty.js","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCategorizedStructProperty.ts"],"names":[],"mappings":"AAAA;;;gGAGgG;AAUhG,OAAO,EACL,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,MAAM,OAAO,gCACX,SAAQ,0BAA0B;IAMlC,YACE,MAAsB,EACtB,kBAA0B,EAC1B,0BAAkC,EAClC,KAAa,EACb,eAAwC,EACxC,YAAqB,EACrB,oBAA6B;QAE7B,KAAK,CACH,gBAAgB,CAAC,MAAM,EACvB,MAAM,EACN,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,EACL,YAAY,EACZ,oBAAoB,CACrB,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QAChE,MAAM,aAAa,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACzD,OAAO,eAAe,CAAC,yBAAyB,CAC9C,KAAK,EACL,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,0BAA0B,EAC/B,aAAa,CACd,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAW,IAAI;QACb,OAAO,gBAAgB,CAAC,MAAM,CAAC;IACjC,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEe,qBAAqB;QACnC,OAAO,IAAI,CAAC,YAAY;YACtB,CAAC,CAAC,KAAK,CAAC,qBAAqB,EAAE;YAC/B,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;IAC5B,CAAC;IAEe,qBAAqB;QACnC,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YAC1C,wFAAwF;YACxF,qCAAqC;YACrC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACnC,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,4BAA4B,EAAE,CAAC,CAC1D,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAEe,4BAA4B;QAC1C,OAAO,IAAI,CAAC,YAAY;YACtB,CAAC,CAAC,KAAK,CAAC,4BAA4B,EAAE;YACtC,CAAC,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACnC,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\n\n/** @packageDocumentation\n * @module PropertyGrid\n */\nimport type { PropertyRecord } from \"@itwin/appui-abstract\";\nimport type {\n  IMutableCategorizedPropertyItem,\n  IMutableFlatGridItem,\n} from \"./MutableFlatGridItem.js\";\nimport {\n  FlatGridItemType,\n  MutableCategorizedProperty,\n} from \"./MutableFlatGridItem.js\";\nimport type { IMutableGridItemFactory } from \"./MutableGridItemFactory.js\";\n\n/**\n * Mutable wrapper object for PropertyRecord with struct valueFormat which provides methods for working with and managing record children hierarchies.\n * @public\n */\nexport class MutableCategorizedStructProperty\n  extends MutableCategorizedProperty\n  implements IMutableCategorizedPropertyItem\n{\n  private _renderLabel: boolean;\n  private _children: IMutableCategorizedPropertyItem[];\n\n  public constructor(\n    record: PropertyRecord,\n    parentSelectionKey: string,\n    parentCategorySelectionKey: string,\n    depth: number,\n    gridItemFactory: IMutableGridItemFactory,\n    overrideName?: string,\n    overrideDisplayLabel?: string\n  ) {\n    super(\n      FlatGridItemType.Struct,\n      record,\n      parentSelectionKey,\n      parentCategorySelectionKey,\n      depth,\n      overrideName,\n      overrideDisplayLabel\n    );\n    this._renderLabel = !record.property.hideCompositePropertyLabel;\n    const childrenDepth = depth + (this._renderLabel ? 1 : 0);\n    this._children = record.getChildrenRecords().map((value) => {\n      return gridItemFactory.createCategorizedProperty(\n        value,\n        this.selectionKey,\n        this.parentCategorySelectionKey,\n        childrenDepth\n      );\n    });\n  }\n\n  public get type(): FlatGridItemType.Struct {\n    return FlatGridItemType.Struct;\n  }\n\n  public getChildren(): IMutableCategorizedPropertyItem[] {\n    return this._children;\n  }\n\n  public override getDescendantsAndSelf() {\n    return this._renderLabel\n      ? super.getDescendantsAndSelf()\n      : this.getDescendants();\n  }\n\n  public override getVisibleDescendants(): IMutableFlatGridItem[] {\n    const descendants: IMutableFlatGridItem[] = [];\n    if (this.isExpanded || !this._renderLabel) {\n      // always render children if not rendering the label, otherwise there's no way to expand\n      // this item to make children visible\n      this.getChildren().forEach((child) =>\n        descendants.push(...child.getVisibleDescendantsAndSelf())\n      );\n    }\n    return descendants;\n  }\n\n  public override getVisibleDescendantsAndSelf() {\n    return this._renderLabel\n      ? super.getVisibleDescendantsAndSelf()\n      : this.getVisibleDescendants();\n  }\n}\n"]}

package/lib/components-react/propertygrid/internal/flat-items/MutableCustomGridCategory.d.ts

@@ -0,0 +1,23 @@
+import type { PropertyCategory } from "../../PropertyDataProvider.js";
+import type { IMutableFlatGridItem, IMutableGridCategoryItem } from "./MutableFlatGridItem.js";
+import { FlatGridItemType, MutableFlatPropertyGridItem } from "./MutableFlatGridItem.js";
+import type { CategoryRecordsDict } from "./MutableGridCategory.js";
+import type { IMutableGridItemFactory } from "./MutableGridItemFactory.js";
+/** @internal */
+export declare class MutableCustomGridCategory extends MutableFlatPropertyGridItem implements IMutableGridCategoryItem {
+    private readonly _children;
+    private readonly _renderer;
+    readonly type: FlatGridItemType.Category;
+    readonly label: string;
+    readonly name: string;
+    readonly selectionKey: string;
+    constructor(category: PropertyCategory, recordsDict: CategoryRecordsDict, gridItemFactory: IMutableGridItemFactory, parentSelectionKey: string | undefined, depth: number);
+    get derivedCategory(): PropertyCategory;
+    get isRootCategory(): boolean;
+    get lastInNumberOfCategories(): number;
+    set lastInNumberOfCategories(value: number);
+    getSelf(): this;
+    getChildren(): IMutableFlatGridItem[];
+    getVisibleDescendantsAndSelf(): IMutableFlatGridItem[];
+}
+//# sourceMappingURL=MutableCustomGridCategory.d.ts.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCustomGridCategory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCustomGridCategory.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCustomGridCategory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAEV,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAE3E,gBAAgB;AAChB,qBAAa,yBACX,SAAQ,2BACR,YAAW,wBAAwB;IAEnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD,SAAgB,IAAI,4BAAsC;IAC1D,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAGnC,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAE,mBAAmB,EAChC,eAAe,EAAE,uBAAuB,EACxC,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,KAAK,EAAE,MAAM;IA4Bf,IAAW,eAAe,IAAI,gBAAgB,CAO7C;IAED,IAAW,cAAc,IAAI,OAAO,CAEnC;IAED,IAAoB,wBAAwB,IAAI,MAAM,CAErD;IAED,IAAoB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAEzD;IAEM,OAAO;IAIP,WAAW,IAAI,oBAAoB,EAAE;IAI5B,4BAA4B,IAAI,oBAAoB,EAAE;CAGvE"}

package/lib/components-react/propertygrid/internal/flat-items/MutableCustomGridCategory.js

@@ -0,0 +1,48 @@
+import { FlatGridItemType, MutableFlatPropertyGridItem, } from "./MutableFlatGridItem.js";
+/** @internal */
+export class MutableCustomGridCategory extends MutableFlatPropertyGridItem {
+    constructor(category, recordsDict, gridItemFactory, parentSelectionKey, depth) {
+        super(depth, parentSelectionKey, parentSelectionKey);
+        this.type = FlatGridItemType.Category;
+        this.name = category.name;
+        this.label = category.label;
+        this.isExpanded = category.expand;
+        this.selectionKey =
+            parentSelectionKey === undefined
+                ? this.name
+                : `${parentSelectionKey}_${this.name}`;
+        this._renderer = category.renderer;
+        // Even though categories are nested and have their own depth, categorized properties depth is counted starting with
+        // the parent category.
+        const categoryRecords = recordsDict[category.name] ?? [];
+        this._children = categoryRecords.map((value) => gridItemFactory.createCategorizedProperty(value, this.selectionKey, this.selectionKey, 0));
+        this.lastInNumberOfCategories = -1;
+    }
+    get derivedCategory() {
+        return {
+            name: this.name,
+            label: this.label,
+            expand: this.isExpanded,
+            renderer: this._renderer,
+        };
+    }
+    get isRootCategory() {
+        return this.depth === 0;
+    }
+    get lastInNumberOfCategories() {
+        return this._lastInNumberOfCategories;
+    }
+    set lastInNumberOfCategories(value) {
+        this._lastInNumberOfCategories = value + 1;
+    }
+    getSelf() {
+        return this;
+    }
+    getChildren() {
+        return this._children;
+    }
+    getVisibleDescendantsAndSelf() {
+        return [this];
+    }
+}
+//# sourceMappingURL=MutableCustomGridCategory.js.map

package/lib/components-react/propertygrid/internal/flat-items/MutableCustomGridCategory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MutableCustomGridCategory.js","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/internal/flat-items/MutableCustomGridCategory.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAIlC,gBAAgB;AAChB,MAAM,OAAO,yBACX,SAAQ,2BAA2B;IAWnC,YACE,QAA0B,EAC1B,WAAgC,EAChC,eAAwC,EACxC,kBAAsC,EACtC,KAAa;QAEb,KAAK,CAAC,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAZvC,SAAI,GAAG,gBAAgB,CAAC,QAAiB,CAAC;QAcxD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;QAClC,IAAI,CAAC,YAAY;YACf,kBAAkB,KAAK,SAAS;gBAC9B,CAAC,CAAC,IAAI,CAAC,IAAI;gBACX,CAAC,CAAC,GAAG,kBAAkB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAEnC,oHAAoH;QACpH,uBAAuB;QACvB,MAAM,eAAe,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC7C,eAAe,CAAC,yBAAyB,CACvC,KAAK,EACL,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,YAAY,EACjB,CAAC,CACF,CACF,CAAC;QAEF,IAAI,CAAC,wBAAwB,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,IAAW,eAAe;QACxB,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,UAAU;YACvB,QAAQ,EAAE,IAAI,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED,IAAW,cAAc;QACvB,OAAO,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,IAAoB,wBAAwB;QAC1C,OAAO,IAAI,CAAC,yBAAyB,CAAC;IACxC,CAAC;IAED,IAAoB,wBAAwB,CAAC,KAAa;QACxD,IAAI,CAAC,yBAAyB,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7C,CAAC;IAEM,OAAO;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEe,4BAA4B;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;CACF","sourcesContent":["/*---------------------------------------------------------------------------------------------\n * Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n * See LICENSE.md in the project root for license terms and full copyright notice.\n *--------------------------------------------------------------------------------------------*/\nimport type { PropertyCategory } from \"../../PropertyDataProvider.js\";\nimport type {\n  IMutableCategorizedPropertyItem,\n  IMutableFlatGridItem,\n  IMutableGridCategoryItem,\n} from \"./MutableFlatGridItem.js\";\nimport {\n  FlatGridItemType,\n  MutableFlatPropertyGridItem,\n} from \"./MutableFlatGridItem.js\";\nimport type { CategoryRecordsDict } from \"./MutableGridCategory.js\";\nimport type { IMutableGridItemFactory } from \"./MutableGridItemFactory.js\";\n\n/** @internal */\nexport class MutableCustomGridCategory\n  extends MutableFlatPropertyGridItem\n  implements IMutableGridCategoryItem\n{\n  private readonly _children: IMutableCategorizedPropertyItem[];\n  private readonly _renderer: PropertyCategory[\"renderer\"];\n\n  public readonly type = FlatGridItemType.Category as const;\n  public readonly label: string;\n  public readonly name: string;\n  public readonly selectionKey: string;\n\n  public constructor(\n    category: PropertyCategory,\n    recordsDict: CategoryRecordsDict,\n    gridItemFactory: IMutableGridItemFactory,\n    parentSelectionKey: string | undefined,\n    depth: number\n  ) {\n    super(depth, parentSelectionKey, parentSelectionKey);\n\n    this.name = category.name;\n    this.label = category.label;\n    this.isExpanded = category.expand;\n    this.selectionKey =\n      parentSelectionKey === undefined\n        ? this.name\n        : `${parentSelectionKey}_${this.name}`;\n    this._renderer = category.renderer;\n\n    // Even though categories are nested and have their own depth, categorized properties depth is counted starting with\n    // the parent category.\n    const categoryRecords = recordsDict[category.name] ?? [];\n    this._children = categoryRecords.map((value) =>\n      gridItemFactory.createCategorizedProperty(\n        value,\n        this.selectionKey,\n        this.selectionKey,\n        0\n      )\n    );\n\n    this.lastInNumberOfCategories = -1;\n  }\n\n  public get derivedCategory(): PropertyCategory {\n    return {\n      name: this.name,\n      label: this.label,\n      expand: this.isExpanded,\n      renderer: this._renderer,\n    };\n  }\n\n  public get isRootCategory(): boolean {\n    return this.depth === 0;\n  }\n\n  public override get lastInNumberOfCategories(): number {\n    return this._lastInNumberOfCategories;\n  }\n\n  public override set lastInNumberOfCategories(value: number) {\n    this._lastInNumberOfCategories = value + 1;\n  }\n\n  public getSelf() {\n    return this;\n  }\n\n  public getChildren(): IMutableFlatGridItem[] {\n    return this._children;\n  }\n\n  public override getVisibleDescendantsAndSelf(): IMutableFlatGridItem[] {\n    return [this];\n  }\n}\n"]}