@itwin/presentation-common 3.6.0-dev.52 → 3.6.0-dev.53

package/lib/esm/presentation-common/rules/customization/GroupingRule.d.ts

@@ -1,201 +1,201 @@
-/** @packageDocumentation
- * @module PresentationRules
- */
-import { SingleSchemaClassSpecification } from "../ClassSpecifications";
-import { RuleBase, RuleTypes } from "../Rule";
-/**
- * Grouping rules provide advanced ways to group instances when creating hierarchies.
- *
- * @see [Grouping rule reference documentation page]($docs/presentation/hierarchies/GroupingRule.md)
- * @public
- */
-export interface GroupingRule extends RuleBase {
-    /** Used for serializing to JSON. */
-    ruleType: RuleTypes.Grouping;
-    /**
-     * An [ECExpression]($docs/presentation/hierarchies/ECExpressions.md#rule-condition) that results in
-     * a boolean value. If specified,  the grouping rule applies only to instance nodes that cause the condition
-     * to evaluate to `true`.
-     */
-    condition?: string;
-    /** Specification of ECClass which should be grouped using this rule. */
-    class: SingleSchemaClassSpecification;
-    /**
-     * Specifies a list of [grouping specifications]($docs/presentation/hierarchies/GroupingRule.md#grouping-specifications)
-     * which describe the kind of grouping that should be applied.
-     */
-    groups: GroupingSpecification[];
-}
-/**
- * Grouping rule specifications.
- * @public
- */
-export declare type GroupingSpecification = ClassGroup | PropertyGroup | SameLabelInstanceGroup;
-/**
- * Available types of [[GroupingSpecification]].
- * @public
- */
-export declare enum GroupingSpecificationTypes {
-    Class = "Class",
-    Property = "Property",
-    SameLabelInstance = "SameLabelInstance"
-}
-/**
- * Base interface for all [[GroupingSpecification]] implementations. Not
- * meant to be used directly, see `GroupingSpecification`.
- *
- * @public
- */
-export interface GroupingSpecificationBase {
-    /** Type of the subclass */
-    specType: GroupingSpecificationTypes;
-}
-/**
- * Base class grouping allows grouping ECInstance nodes by their base class (as opposed to the hierarchy
- * specifications' `groupByClass` attribute, which always groups by direct class).
- *
- * @see [Base class grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#base-class-grouping)
- * @public
- */
-export interface ClassGroup extends GroupingSpecificationBase {
-    /** Used for serializing to JSON. */
-    specType: GroupingSpecificationTypes.Class;
-    /** Specifies whether a grouping node should be created if there is only one item in that group. */
-    createGroupForSingleItem?: boolean;
-    /**
-     * Specification of the base ECClass to group by. If specified, allows grouping by a subclass of the class
-     * specified by rule's `class` attribute.
-     */
-    baseClass?: SingleSchemaClassSpecification;
-}
-/**
- * Allows grouping multiple instances with the same label into one ECInstances type of node. Similar to display label grouping,
- * but instead of showing a grouping node with multiple grouped ECInstance nodes, it shows a single ECInstances node which represents
- * multiple ECInstances.
- *
- * @see [Same label instance grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#same-label-instance-grouping)
- * @public
- */
-export interface SameLabelInstanceGroup extends GroupingSpecificationBase {
-    /** Used for serializing to JSON. */
-    specType: GroupingSpecificationTypes.SameLabelInstance;
-    /**
-     * Grouping nodes by label is an expensive operation because it requires the whole hierarchy level to be created before even the first
-     * grouped node can be produced. To alleviate the performance impact when this specification is used, two `applicationStage` settings have been introduced:
-     *
-     * - `"Query"` groups instances during ECSql query, which can often make use of database indices and is generally fairly quick. It is chosen
-     *   as the default option, however, it fails to produce grouping nodes when certain ruleset specifications are involved.
-     *
-     * - `"PostProcess"` groups instances after the whole hierarchy level is built. It incurs a large performance penalty, but it will
-     *   produce the expected result in all cases.
-     */
-    applicationStage?: SameLabelInstanceGroupApplicationStage;
-}
-/**
- * Specifies hierarchy creation stages used to apply [[SameLabelInstanceGroup]] grouping.
- * @public
- */
-export declare enum SameLabelInstanceGroupApplicationStage {
-    /** Apply grouping at query stage. */
-    Query = "Query",
-    /**
-     * Apply grouping at post-processing stage.
-     *
-     * This allows grouping nodes created by different hierarchy specifications at
-     * a higher performance cost as it requires loading the whole hierarchy level before
-     * returning even the first node - avoid using with large numbers of nodes.
-     */
-    PostProcess = "PostProcess"
-}
-/**
- * Property grouping allows grouping by a property of the instance by value or by given ranges of values.
- *
- * @see [Property grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#property-grouping)
- * @public
- */
-export interface PropertyGroup extends GroupingSpecificationBase {
-    /** Used for serializing to JSON. */
-    specType: GroupingSpecificationTypes.Property;
-    /**
-     * Name of the ECProperty which is used for grouping. The property must exist on the ECClass specified by the
-     * rule's `class` attribute and it must be of either a primitive or a navigation type.
-     *
-     * @minLength 1
-     */
-    propertyName: string;
-    /**
-     * Specifies grouping node's image ID. If set, the ID is assigned to [[Node.imageId]] and
-     * it's up to the UI component to decide what to do with it.
-     *
-     * @minLength 1
-     */
-    imageId?: string;
-    /** Specifies whether a grouping node should be created if there is only one item in that group. */
-    createGroupForSingleItem?: boolean;
-    /**
-     * Should a separate grouping node be created for nodes whose grouping value is not set or is set to an empty string.
-     */
-    createGroupForUnspecifiedValues?: boolean;
-    /**
-     * Specifies whether instances should be grouped using property's display or raw value.
-     *
-     * @deprecated Display value should always be used for grouping.
-     */
-    groupingValue?: PropertyGroupingValue;
-    /**
-     * Specifies whether nodes should be sorted by their display label or the grouping property's value. In most cases the result
-     * is the same, unless a [label override rule]($docs/presentation/customization/LabelOverride.md) is used to change node's display label.
-     *
-     * @deprecated Property grouping nodes should always be sorted by display label.
-     */
-    sortingValue?: PropertyGroupingValue;
-    /** Ranges into which the grouping values are divided. Instances are grouped by value if no ranges are specified. */
-    ranges?: PropertyRangeGroupSpecification[];
-}
-/**
- * Used in [[PropertyGroup]] to specify the type of value to use
- * for grouping and sorting
- *
- * @public
- * @deprecated The attributes using this enum are deprecated.
- */
-export declare enum PropertyGroupingValue {
-    /** By property value */
-    PropertyValue = "PropertyValue",
-    /** By display label */
-    DisplayLabel = "DisplayLabel"
-}
-/**
- * Describes a grouping range.
- *
- * @see [Property range group specification documentation section]($docs/presentation/hierarchies/GroupingRule.md#attribute-ranges)
- * @public
- */
-export interface PropertyRangeGroupSpecification {
-    /**
-     * ID of an image to use for the grouping node. Defaults to [[PropertyGroup.imageId]] specified in [[PropertyGroup]].
-     *
-     * @minLength 1
-     */
-    imageId?: string;
-    /**
-     * Grouping node label. May be [localized]($docs/presentation/advanced/Localization.md).
-     * Defaults to `{from value} - {to value}`.
-     *
-     * @minLength 1
-     */
-    label?: string;
-    /**
-     * Value that defines the range start (inclusive).
-     *
-     * @minLength 1
-     */
-    fromValue: string;
-    /**
-     * Value that defines the range end (inclusive).
-     *
-     * @minLength 1
-     */
-    toValue: string;
-}
+/** @packageDocumentation
+ * @module PresentationRules
+ */
+import { SingleSchemaClassSpecification } from "../ClassSpecifications";
+import { RuleBase, RuleTypes } from "../Rule";
+/**
+ * Grouping rules provide advanced ways to group instances when creating hierarchies.
+ *
+ * @see [Grouping rule reference documentation page]($docs/presentation/hierarchies/GroupingRule.md)
+ * @public
+ */
+export interface GroupingRule extends RuleBase {
+    /** Used for serializing to JSON. */
+    ruleType: RuleTypes.Grouping;
+    /**
+     * An [ECExpression]($docs/presentation/hierarchies/ECExpressions.md#rule-condition) that results in
+     * a boolean value. If specified,  the grouping rule applies only to instance nodes that cause the condition
+     * to evaluate to `true`.
+     */
+    condition?: string;
+    /** Specification of ECClass which should be grouped using this rule. */
+    class: SingleSchemaClassSpecification;
+    /**
+     * Specifies a list of [grouping specifications]($docs/presentation/hierarchies/GroupingRule.md#grouping-specifications)
+     * which describe the kind of grouping that should be applied.
+     */
+    groups: GroupingSpecification[];
+}
+/**
+ * Grouping rule specifications.
+ * @public
+ */
+export declare type GroupingSpecification = ClassGroup | PropertyGroup | SameLabelInstanceGroup;
+/**
+ * Available types of [[GroupingSpecification]].
+ * @public
+ */
+export declare enum GroupingSpecificationTypes {
+    Class = "Class",
+    Property = "Property",
+    SameLabelInstance = "SameLabelInstance"
+}
+/**
+ * Base interface for all [[GroupingSpecification]] implementations. Not
+ * meant to be used directly, see `GroupingSpecification`.
+ *
+ * @public
+ */
+export interface GroupingSpecificationBase {
+    /** Type of the subclass */
+    specType: GroupingSpecificationTypes;
+}
+/**
+ * Base class grouping allows grouping ECInstance nodes by their base class (as opposed to the hierarchy
+ * specifications' `groupByClass` attribute, which always groups by direct class).
+ *
+ * @see [Base class grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#base-class-grouping)
+ * @public
+ */
+export interface ClassGroup extends GroupingSpecificationBase {
+    /** Used for serializing to JSON. */
+    specType: GroupingSpecificationTypes.Class;
+    /** Specifies whether a grouping node should be created if there is only one item in that group. */
+    createGroupForSingleItem?: boolean;
+    /**
+     * Specification of the base ECClass to group by. If specified, allows grouping by a subclass of the class
+     * specified by rule's `class` attribute.
+     */
+    baseClass?: SingleSchemaClassSpecification;
+}
+/**
+ * Allows grouping multiple instances with the same label into one ECInstances type of node. Similar to display label grouping,
+ * but instead of showing a grouping node with multiple grouped ECInstance nodes, it shows a single ECInstances node which represents
+ * multiple ECInstances.
+ *
+ * @see [Same label instance grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#same-label-instance-grouping)
+ * @public
+ */
+export interface SameLabelInstanceGroup extends GroupingSpecificationBase {
+    /** Used for serializing to JSON. */
+    specType: GroupingSpecificationTypes.SameLabelInstance;
+    /**
+     * Grouping nodes by label is an expensive operation because it requires the whole hierarchy level to be created before even the first
+     * grouped node can be produced. To alleviate the performance impact when this specification is used, two `applicationStage` settings have been introduced:
+     *
+     * - `"Query"` groups instances during ECSql query, which can often make use of database indices and is generally fairly quick. It is chosen
+     *   as the default option, however, it fails to produce grouping nodes when certain ruleset specifications are involved.
+     *
+     * - `"PostProcess"` groups instances after the whole hierarchy level is built. It incurs a large performance penalty, but it will
+     *   produce the expected result in all cases.
+     */
+    applicationStage?: SameLabelInstanceGroupApplicationStage;
+}
+/**
+ * Specifies hierarchy creation stages used to apply [[SameLabelInstanceGroup]] grouping.
+ * @public
+ */
+export declare enum SameLabelInstanceGroupApplicationStage {
+    /** Apply grouping at query stage. */
+    Query = "Query",
+    /**
+     * Apply grouping at post-processing stage.
+     *
+     * This allows grouping nodes created by different hierarchy specifications at
+     * a higher performance cost as it requires loading the whole hierarchy level before
+     * returning even the first node - avoid using with large numbers of nodes.
+     */
+    PostProcess = "PostProcess"
+}
+/**
+ * Property grouping allows grouping by a property of the instance by value or by given ranges of values.
+ *
+ * @see [Property grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#property-grouping)
+ * @public
+ */
+export interface PropertyGroup extends GroupingSpecificationBase {
+    /** Used for serializing to JSON. */
+    specType: GroupingSpecificationTypes.Property;
+    /**
+     * Name of the ECProperty which is used for grouping. The property must exist on the ECClass specified by the
+     * rule's `class` attribute and it must be of either a primitive or a navigation type.
+     *
+     * @minLength 1
+     */
+    propertyName: string;
+    /**
+     * Specifies grouping node's image ID. If set, the ID is assigned to [[Node.imageId]] and
+     * it's up to the UI component to decide what to do with it.
+     *
+     * @minLength 1
+     */
+    imageId?: string;
+    /** Specifies whether a grouping node should be created if there is only one item in that group. */
+    createGroupForSingleItem?: boolean;
+    /**
+     * Should a separate grouping node be created for nodes whose grouping value is not set or is set to an empty string.
+     */
+    createGroupForUnspecifiedValues?: boolean;
+    /**
+     * Specifies whether instances should be grouped using property's display or raw value.
+     *
+     * @deprecated in 3.x. Display value should always be used for grouping.
+     */
+    groupingValue?: PropertyGroupingValue;
+    /**
+     * Specifies whether nodes should be sorted by their display label or the grouping property's value. In most cases the result
+     * is the same, unless a [label override rule]($docs/presentation/customization/LabelOverride.md) is used to change node's display label.
+     *
+     * @deprecated in 3.x. Property grouping nodes should always be sorted by display label.
+     */
+    sortingValue?: PropertyGroupingValue;
+    /** Ranges into which the grouping values are divided. Instances are grouped by value if no ranges are specified. */
+    ranges?: PropertyRangeGroupSpecification[];
+}
+/**
+ * Used in [[PropertyGroup]] to specify the type of value to use
+ * for grouping and sorting
+ *
+ * @public
+ * @deprecated in 3.x. The attributes using this enum are deprecated.
+ */
+export declare enum PropertyGroupingValue {
+    /** By property value */
+    PropertyValue = "PropertyValue",
+    /** By display label */
+    DisplayLabel = "DisplayLabel"
+}
+/**
+ * Describes a grouping range.
+ *
+ * @see [Property range group specification documentation section]($docs/presentation/hierarchies/GroupingRule.md#attribute-ranges)
+ * @public
+ */
+export interface PropertyRangeGroupSpecification {
+    /**
+     * ID of an image to use for the grouping node. Defaults to [[PropertyGroup.imageId]] specified in [[PropertyGroup]].
+     *
+     * @minLength 1
+     */
+    imageId?: string;
+    /**
+     * Grouping node label. May be [localized]($docs/presentation/advanced/Localization.md).
+     * Defaults to `{from value} - {to value}`.
+     *
+     * @minLength 1
+     */
+    label?: string;
+    /**
+     * Value that defines the range start (inclusive).
+     *
+     * @minLength 1
+     */
+    fromValue: string;
+    /**
+     * Value that defines the range end (inclusive).
+     *
+     * @minLength 1
+     */
+    toValue: string;
+}
 //# sourceMappingURL=GroupingRule.d.ts.map

package/lib/esm/presentation-common/rules/customization/GroupingRule.js

@@ -1,49 +1,49 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module PresentationRules
- */
-/**
- * Available types of [[GroupingSpecification]].
- * @public
- */
-export var GroupingSpecificationTypes;
-(function (GroupingSpecificationTypes) {
-    GroupingSpecificationTypes["Class"] = "Class";
-    GroupingSpecificationTypes["Property"] = "Property";
-    GroupingSpecificationTypes["SameLabelInstance"] = "SameLabelInstance";
-})(GroupingSpecificationTypes || (GroupingSpecificationTypes = {}));
-/**
- * Specifies hierarchy creation stages used to apply [[SameLabelInstanceGroup]] grouping.
- * @public
- */
-export var SameLabelInstanceGroupApplicationStage;
-(function (SameLabelInstanceGroupApplicationStage) {
-    /** Apply grouping at query stage. */
-    SameLabelInstanceGroupApplicationStage["Query"] = "Query";
-    /**
-     * Apply grouping at post-processing stage.
-     *
-     * This allows grouping nodes created by different hierarchy specifications at
-     * a higher performance cost as it requires loading the whole hierarchy level before
-     * returning even the first node - avoid using with large numbers of nodes.
-     */
-    SameLabelInstanceGroupApplicationStage["PostProcess"] = "PostProcess";
-})(SameLabelInstanceGroupApplicationStage || (SameLabelInstanceGroupApplicationStage = {}));
-/**
- * Used in [[PropertyGroup]] to specify the type of value to use
- * for grouping and sorting
- *
- * @public
- * @deprecated The attributes using this enum are deprecated.
- */
-export var PropertyGroupingValue;
-(function (PropertyGroupingValue) {
-    /** By property value */
-    PropertyGroupingValue["PropertyValue"] = "PropertyValue";
-    /** By display label */
-    PropertyGroupingValue["DisplayLabel"] = "DisplayLabel";
-})(PropertyGroupingValue || (PropertyGroupingValue = {}));
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PresentationRules
+ */
+/**
+ * Available types of [[GroupingSpecification]].
+ * @public
+ */
+export var GroupingSpecificationTypes;
+(function (GroupingSpecificationTypes) {
+    GroupingSpecificationTypes["Class"] = "Class";
+    GroupingSpecificationTypes["Property"] = "Property";
+    GroupingSpecificationTypes["SameLabelInstance"] = "SameLabelInstance";
+})(GroupingSpecificationTypes || (GroupingSpecificationTypes = {}));
+/**
+ * Specifies hierarchy creation stages used to apply [[SameLabelInstanceGroup]] grouping.
+ * @public
+ */
+export var SameLabelInstanceGroupApplicationStage;
+(function (SameLabelInstanceGroupApplicationStage) {
+    /** Apply grouping at query stage. */
+    SameLabelInstanceGroupApplicationStage["Query"] = "Query";
+    /**
+     * Apply grouping at post-processing stage.
+     *
+     * This allows grouping nodes created by different hierarchy specifications at
+     * a higher performance cost as it requires loading the whole hierarchy level before
+     * returning even the first node - avoid using with large numbers of nodes.
+     */
+    SameLabelInstanceGroupApplicationStage["PostProcess"] = "PostProcess";
+})(SameLabelInstanceGroupApplicationStage || (SameLabelInstanceGroupApplicationStage = {}));
+/**
+ * Used in [[PropertyGroup]] to specify the type of value to use
+ * for grouping and sorting
+ *
+ * @public
+ * @deprecated in 3.x. The attributes using this enum are deprecated.
+ */
+export var PropertyGroupingValue;
+(function (PropertyGroupingValue) {
+    /** By property value */
+    PropertyGroupingValue["PropertyValue"] = "PropertyValue";
+    /** By display label */
+    PropertyGroupingValue["DisplayLabel"] = "DisplayLabel";
+})(PropertyGroupingValue || (PropertyGroupingValue = {}));
 //# sourceMappingURL=GroupingRule.js.map

package/lib/esm/presentation-common/rules/customization/GroupingRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"GroupingRule.js","sourceRoot":"","sources":["../../../../../src/presentation-common/rules/customization/GroupingRule.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAsCH;;;GAGG;AACH,MAAM,CAAN,IAAY,0BAIX;AAJD,WAAY,0BAA0B;IACpC,6CAAe,CAAA;IACf,mDAAqB,CAAA;IACrB,qEAAuC,CAAA;AACzC,CAAC,EAJW,0BAA0B,KAA1B,0BAA0B,QAIrC;AA2DD;;;GAGG;AACH,MAAM,CAAN,IAAY,sCAYX;AAZD,WAAY,sCAAsC;IAChD,qCAAqC;IACrC,yDAAe,CAAA;IAEf;;;;;;OAMG;IACH,qEAA2B,CAAA;AAC7B,CAAC,EAZW,sCAAsC,KAAtC,sCAAsC,QAYjD;AAuDD;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC/B,wBAAwB;IACxB,wDAA+B,CAAA;IAE/B,uBAAuB;IACvB,sDAA6B,CAAA;AAC/B,CAAC,EANW,qBAAqB,KAArB,qBAAqB,QAMhC","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 PresentationRules\r\n */\r\n\r\nimport { SingleSchemaClassSpecification } from \"../ClassSpecifications\";\r\nimport { RuleBase, RuleTypes } from \"../Rule\";\r\n\r\n/**\r\n * Grouping rules provide advanced ways to group instances when creating hierarchies.\r\n *\r\n * @see [Grouping rule reference documentation page]($docs/presentation/hierarchies/GroupingRule.md)\r\n * @public\r\n */\r\nexport interface GroupingRule extends RuleBase {\r\n  /** Used for serializing to JSON. */\r\n  ruleType: RuleTypes.Grouping;\r\n\r\n  /**\r\n   * An [ECExpression]($docs/presentation/hierarchies/ECExpressions.md#rule-condition) that results in\r\n   * a boolean value. If specified,  the grouping rule applies only to instance nodes that cause the condition\r\n   * to evaluate to `true`.\r\n   */\r\n  condition?: string;\r\n\r\n  /** Specification of ECClass which should be grouped using this rule. */\r\n  class: SingleSchemaClassSpecification;\r\n\r\n  /**\r\n   * Specifies a list of [grouping specifications]($docs/presentation/hierarchies/GroupingRule.md#grouping-specifications)\r\n   * which describe the kind of grouping that should be applied.\r\n   */\r\n  groups: GroupingSpecification[];\r\n}\r\n\r\n/**\r\n * Grouping rule specifications.\r\n * @public\r\n */\r\nexport declare type GroupingSpecification = ClassGroup | PropertyGroup | SameLabelInstanceGroup;\r\n\r\n/**\r\n * Available types of [[GroupingSpecification]].\r\n * @public\r\n */\r\nexport enum GroupingSpecificationTypes {\r\n  Class = \"Class\",\r\n  Property = \"Property\",\r\n  SameLabelInstance = \"SameLabelInstance\",\r\n}\r\n\r\n/**\r\n * Base interface for all [[GroupingSpecification]] implementations. Not\r\n * meant to be used directly, see `GroupingSpecification`.\r\n *\r\n * @public\r\n */\r\nexport interface GroupingSpecificationBase {\r\n  /** Type of the subclass */\r\n  specType: GroupingSpecificationTypes;\r\n}\r\n\r\n/**\r\n * Base class grouping allows grouping ECInstance nodes by their base class (as opposed to the hierarchy\r\n * specifications' `groupByClass` attribute, which always groups by direct class).\r\n *\r\n * @see [Base class grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#base-class-grouping)\r\n * @public\r\n */\r\nexport interface ClassGroup extends GroupingSpecificationBase {\r\n  /** Used for serializing to JSON. */\r\n  specType: GroupingSpecificationTypes.Class;\r\n\r\n  /** Specifies whether a grouping node should be created if there is only one item in that group. */\r\n  createGroupForSingleItem?: boolean;\r\n\r\n  /**\r\n   * Specification of the base ECClass to group by. If specified, allows grouping by a subclass of the class\r\n   * specified by rule's `class` attribute.\r\n   */\r\n  baseClass?: SingleSchemaClassSpecification;\r\n}\r\n\r\n/**\r\n * Allows grouping multiple instances with the same label into one ECInstances type of node. Similar to display label grouping,\r\n * but instead of showing a grouping node with multiple grouped ECInstance nodes, it shows a single ECInstances node which represents\r\n * multiple ECInstances.\r\n *\r\n * @see [Same label instance grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#same-label-instance-grouping)\r\n * @public\r\n */\r\nexport interface SameLabelInstanceGroup extends GroupingSpecificationBase {\r\n  /** Used for serializing to JSON. */\r\n  specType: GroupingSpecificationTypes.SameLabelInstance;\r\n\r\n  /**\r\n   * Grouping nodes by label is an expensive operation because it requires the whole hierarchy level to be created before even the first\r\n   * grouped node can be produced. To alleviate the performance impact when this specification is used, two `applicationStage` settings have been introduced:\r\n   *\r\n   * - `\"Query\"` groups instances during ECSql query, which can often make use of database indices and is generally fairly quick. It is chosen\r\n   *   as the default option, however, it fails to produce grouping nodes when certain ruleset specifications are involved.\r\n   *\r\n   * - `\"PostProcess\"` groups instances after the whole hierarchy level is built. It incurs a large performance penalty, but it will\r\n   *   produce the expected result in all cases.\r\n   */\r\n  applicationStage?: SameLabelInstanceGroupApplicationStage;\r\n}\r\n\r\n/**\r\n * Specifies hierarchy creation stages used to apply [[SameLabelInstanceGroup]] grouping.\r\n * @public\r\n */\r\nexport enum SameLabelInstanceGroupApplicationStage {\r\n  /** Apply grouping at query stage. */\r\n  Query = \"Query\",\r\n\r\n  /**\r\n   * Apply grouping at post-processing stage.\r\n   *\r\n   * This allows grouping nodes created by different hierarchy specifications at\r\n   * a higher performance cost as it requires loading the whole hierarchy level before\r\n   * returning even the first node - avoid using with large numbers of nodes.\r\n   */\r\n  PostProcess = \"PostProcess\",\r\n}\r\n\r\n/**\r\n * Property grouping allows grouping by a property of the instance by value or by given ranges of values.\r\n *\r\n * @see [Property grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#property-grouping)\r\n * @public\r\n */\r\nexport interface PropertyGroup extends GroupingSpecificationBase {\r\n  /** Used for serializing to JSON. */\r\n  specType: GroupingSpecificationTypes.Property;\r\n\r\n  /**\r\n   * Name of the ECProperty which is used for grouping. The property must exist on the ECClass specified by the\r\n   * rule's `class` attribute and it must be of either a primitive or a navigation type.\r\n   *\r\n   * @minLength 1\r\n   */\r\n  propertyName: string;\r\n\r\n  /**\r\n   * Specifies grouping node's image ID. If set, the ID is assigned to [[Node.imageId]] and\r\n   * it's up to the UI component to decide what to do with it.\r\n   *\r\n   * @minLength 1\r\n   */\r\n  imageId?: string;\r\n\r\n  /** Specifies whether a grouping node should be created if there is only one item in that group. */\r\n  createGroupForSingleItem?: boolean;\r\n\r\n  /**\r\n   * Should a separate grouping node be created for nodes whose grouping value is not set or is set to an empty string.\r\n   */\r\n  createGroupForUnspecifiedValues?: boolean;\r\n\r\n  /**\r\n   * Specifies whether instances should be grouped using property's display or raw value.\r\n   *\r\n   * @deprecated Display value should always be used for grouping.\r\n   */\r\n  groupingValue?: PropertyGroupingValue; // eslint-disable-line deprecation/deprecation\r\n\r\n  /**\r\n   * Specifies whether nodes should be sorted by their display label or the grouping property's value. In most cases the result\r\n   * is the same, unless a [label override rule]($docs/presentation/customization/LabelOverride.md) is used to change node's display label.\r\n   *\r\n   * @deprecated Property grouping nodes should always be sorted by display label.\r\n   */\r\n  sortingValue?: PropertyGroupingValue; // eslint-disable-line deprecation/deprecation\r\n\r\n  /** Ranges into which the grouping values are divided. Instances are grouped by value if no ranges are specified. */\r\n  ranges?: PropertyRangeGroupSpecification[];\r\n}\r\n\r\n/**\r\n * Used in [[PropertyGroup]] to specify the type of value to use\r\n * for grouping and sorting\r\n *\r\n * @public\r\n * @deprecated The attributes using this enum are deprecated.\r\n */\r\nexport enum PropertyGroupingValue {\r\n  /** By property value */\r\n  PropertyValue = \"PropertyValue\",\r\n\r\n  /** By display label */\r\n  DisplayLabel = \"DisplayLabel\",\r\n}\r\n\r\n/**\r\n * Describes a grouping range.\r\n *\r\n * @see [Property range group specification documentation section]($docs/presentation/hierarchies/GroupingRule.md#attribute-ranges)\r\n * @public\r\n */\r\nexport interface PropertyRangeGroupSpecification {\r\n  /**\r\n   * ID of an image to use for the grouping node. Defaults to [[PropertyGroup.imageId]] specified in [[PropertyGroup]].\r\n   *\r\n   * @minLength 1\r\n   */\r\n  imageId?: string;\r\n\r\n  /**\r\n   * Grouping node label. May be [localized]($docs/presentation/advanced/Localization.md).\r\n   * Defaults to `{from value} - {to value}`.\r\n   *\r\n   * @minLength 1\r\n   */\r\n  label?: string;\r\n\r\n  /**\r\n   * Value that defines the range start (inclusive).\r\n   *\r\n   * @minLength 1\r\n   */\r\n  fromValue: string;\r\n\r\n  /**\r\n   * Value that defines the range end (inclusive).\r\n   *\r\n   * @minLength 1\r\n   */\r\n  toValue: string;\r\n}\r\n"]}
+{"version":3,"file":"GroupingRule.js","sourceRoot":"","sources":["../../../../../src/presentation-common/rules/customization/GroupingRule.ts"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAsCH;;;GAGG;AACH,MAAM,CAAN,IAAY,0BAIX;AAJD,WAAY,0BAA0B;IACpC,6CAAe,CAAA;IACf,mDAAqB,CAAA;IACrB,qEAAuC,CAAA;AACzC,CAAC,EAJW,0BAA0B,KAA1B,0BAA0B,QAIrC;AA2DD;;;GAGG;AACH,MAAM,CAAN,IAAY,sCAYX;AAZD,WAAY,sCAAsC;IAChD,qCAAqC;IACrC,yDAAe,CAAA;IAEf;;;;;;OAMG;IACH,qEAA2B,CAAA;AAC7B,CAAC,EAZW,sCAAsC,KAAtC,sCAAsC,QAYjD;AAuDD;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,qBAMX;AAND,WAAY,qBAAqB;IAC/B,wBAAwB;IACxB,wDAA+B,CAAA;IAE/B,uBAAuB;IACvB,sDAA6B,CAAA;AAC/B,CAAC,EANW,qBAAqB,KAArB,qBAAqB,QAMhC","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 PresentationRules\n */\n\nimport { SingleSchemaClassSpecification } from \"../ClassSpecifications\";\nimport { RuleBase, RuleTypes } from \"../Rule\";\n\n/**\n * Grouping rules provide advanced ways to group instances when creating hierarchies.\n *\n * @see [Grouping rule reference documentation page]($docs/presentation/hierarchies/GroupingRule.md)\n * @public\n */\nexport interface GroupingRule extends RuleBase {\n  /** Used for serializing to JSON. */\n  ruleType: RuleTypes.Grouping;\n\n  /**\n   * An [ECExpression]($docs/presentation/hierarchies/ECExpressions.md#rule-condition) that results in\n   * a boolean value. If specified,  the grouping rule applies only to instance nodes that cause the condition\n   * to evaluate to `true`.\n   */\n  condition?: string;\n\n  /** Specification of ECClass which should be grouped using this rule. */\n  class: SingleSchemaClassSpecification;\n\n  /**\n   * Specifies a list of [grouping specifications]($docs/presentation/hierarchies/GroupingRule.md#grouping-specifications)\n   * which describe the kind of grouping that should be applied.\n   */\n  groups: GroupingSpecification[];\n}\n\n/**\n * Grouping rule specifications.\n * @public\n */\nexport declare type GroupingSpecification = ClassGroup | PropertyGroup | SameLabelInstanceGroup;\n\n/**\n * Available types of [[GroupingSpecification]].\n * @public\n */\nexport enum GroupingSpecificationTypes {\n  Class = \"Class\",\n  Property = \"Property\",\n  SameLabelInstance = \"SameLabelInstance\",\n}\n\n/**\n * Base interface for all [[GroupingSpecification]] implementations. Not\n * meant to be used directly, see `GroupingSpecification`.\n *\n * @public\n */\nexport interface GroupingSpecificationBase {\n  /** Type of the subclass */\n  specType: GroupingSpecificationTypes;\n}\n\n/**\n * Base class grouping allows grouping ECInstance nodes by their base class (as opposed to the hierarchy\n * specifications' `groupByClass` attribute, which always groups by direct class).\n *\n * @see [Base class grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#base-class-grouping)\n * @public\n */\nexport interface ClassGroup extends GroupingSpecificationBase {\n  /** Used for serializing to JSON. */\n  specType: GroupingSpecificationTypes.Class;\n\n  /** Specifies whether a grouping node should be created if there is only one item in that group. */\n  createGroupForSingleItem?: boolean;\n\n  /**\n   * Specification of the base ECClass to group by. If specified, allows grouping by a subclass of the class\n   * specified by rule's `class` attribute.\n   */\n  baseClass?: SingleSchemaClassSpecification;\n}\n\n/**\n * Allows grouping multiple instances with the same label into one ECInstances type of node. Similar to display label grouping,\n * but instead of showing a grouping node with multiple grouped ECInstance nodes, it shows a single ECInstances node which represents\n * multiple ECInstances.\n *\n * @see [Same label instance grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#same-label-instance-grouping)\n * @public\n */\nexport interface SameLabelInstanceGroup extends GroupingSpecificationBase {\n  /** Used for serializing to JSON. */\n  specType: GroupingSpecificationTypes.SameLabelInstance;\n\n  /**\n   * Grouping nodes by label is an expensive operation because it requires the whole hierarchy level to be created before even the first\n   * grouped node can be produced. To alleviate the performance impact when this specification is used, two `applicationStage` settings have been introduced:\n   *\n   * - `\"Query\"` groups instances during ECSql query, which can often make use of database indices and is generally fairly quick. It is chosen\n   *   as the default option, however, it fails to produce grouping nodes when certain ruleset specifications are involved.\n   *\n   * - `\"PostProcess\"` groups instances after the whole hierarchy level is built. It incurs a large performance penalty, but it will\n   *   produce the expected result in all cases.\n   */\n  applicationStage?: SameLabelInstanceGroupApplicationStage;\n}\n\n/**\n * Specifies hierarchy creation stages used to apply [[SameLabelInstanceGroup]] grouping.\n * @public\n */\nexport enum SameLabelInstanceGroupApplicationStage {\n  /** Apply grouping at query stage. */\n  Query = \"Query\",\n\n  /**\n   * Apply grouping at post-processing stage.\n   *\n   * This allows grouping nodes created by different hierarchy specifications at\n   * a higher performance cost as it requires loading the whole hierarchy level before\n   * returning even the first node - avoid using with large numbers of nodes.\n   */\n  PostProcess = \"PostProcess\",\n}\n\n/**\n * Property grouping allows grouping by a property of the instance by value or by given ranges of values.\n *\n * @see [Property grouping documentation section]($docs/presentation/hierarchies/GroupingRule.md#property-grouping)\n * @public\n */\nexport interface PropertyGroup extends GroupingSpecificationBase {\n  /** Used for serializing to JSON. */\n  specType: GroupingSpecificationTypes.Property;\n\n  /**\n   * Name of the ECProperty which is used for grouping. The property must exist on the ECClass specified by the\n   * rule's `class` attribute and it must be of either a primitive or a navigation type.\n   *\n   * @minLength 1\n   */\n  propertyName: string;\n\n  /**\n   * Specifies grouping node's image ID. If set, the ID is assigned to [[Node.imageId]] and\n   * it's up to the UI component to decide what to do with it.\n   *\n   * @minLength 1\n   */\n  imageId?: string;\n\n  /** Specifies whether a grouping node should be created if there is only one item in that group. */\n  createGroupForSingleItem?: boolean;\n\n  /**\n   * Should a separate grouping node be created for nodes whose grouping value is not set or is set to an empty string.\n   */\n  createGroupForUnspecifiedValues?: boolean;\n\n  /**\n   * Specifies whether instances should be grouped using property's display or raw value.\n   *\n   * @deprecated in 3.x. Display value should always be used for grouping.\n   */\n  groupingValue?: PropertyGroupingValue; // eslint-disable-line deprecation/deprecation\n\n  /**\n   * Specifies whether nodes should be sorted by their display label or the grouping property's value. In most cases the result\n   * is the same, unless a [label override rule]($docs/presentation/customization/LabelOverride.md) is used to change node's display label.\n   *\n   * @deprecated in 3.x. Property grouping nodes should always be sorted by display label.\n   */\n  sortingValue?: PropertyGroupingValue; // eslint-disable-line deprecation/deprecation\n\n  /** Ranges into which the grouping values are divided. Instances are grouped by value if no ranges are specified. */\n  ranges?: PropertyRangeGroupSpecification[];\n}\n\n/**\n * Used in [[PropertyGroup]] to specify the type of value to use\n * for grouping and sorting\n *\n * @public\n * @deprecated in 3.x. The attributes using this enum are deprecated.\n */\nexport enum PropertyGroupingValue {\n  /** By property value */\n  PropertyValue = \"PropertyValue\",\n\n  /** By display label */\n  DisplayLabel = \"DisplayLabel\",\n}\n\n/**\n * Describes a grouping range.\n *\n * @see [Property range group specification documentation section]($docs/presentation/hierarchies/GroupingRule.md#attribute-ranges)\n * @public\n */\nexport interface PropertyRangeGroupSpecification {\n  /**\n   * ID of an image to use for the grouping node. Defaults to [[PropertyGroup.imageId]] specified in [[PropertyGroup]].\n   *\n   * @minLength 1\n   */\n  imageId?: string;\n\n  /**\n   * Grouping node label. May be [localized]($docs/presentation/advanced/Localization.md).\n   * Defaults to `{from value} - {to value}`.\n   *\n   * @minLength 1\n   */\n  label?: string;\n\n  /**\n   * Value that defines the range start (inclusive).\n   *\n   * @minLength 1\n   */\n  fromValue: string;\n\n  /**\n   * Value that defines the range end (inclusive).\n   *\n   * @minLength 1\n   */\n  toValue: string;\n}\n"]}

package/lib/esm/presentation-common/rules/customization/ImageIdOverride.d.ts

@@ -1,30 +1,30 @@
-/** @packageDocumentation
- * @module PresentationRules
- */
-import { RuleBase, RuleTypes } from "../Rule";
-/**
- * ImageId override rules allow setting an image ID to specific types of ECInstances.
- *
- * @see [Image ID override reference documentation page]($docs/presentation/customization/ImageIdOverride.md)
- * @public
- * @deprecated Use [[ExtendedDataRule]] instead. See [extended data usage page]($docs/presentation/customization/ExtendedDataUsage.md) for more details.
- */
-export interface ImageIdOverride extends RuleBase {
-    /** Used for serializing to JSON. */
-    ruleType: RuleTypes.ImageIdOverride;
-    /**
-     * Defines a condition for the rule, which needs to be met in order to execute it. Condition
-     * is an [ECExpression]($docs/presentation/advanced/ECExpressions.md), which can use
-     * a [limited set of symbols]($docs/presentation/customization/ECExpressions.md#rule-condition).
-     */
-    condition?: string;
-    /**
-     * An expression whose result becomes the image ID. This is
-     * an [ECExpression]($docs/presentation/customization/ECExpressions.md), so ID can be
-     * defined/formatted dynamically based on the context - for example ECInstance property value.
-     *
-     * @minLength 1
-     */
-    imageIdExpression: string;
-}
+/** @packageDocumentation
+ * @module PresentationRules
+ */
+import { RuleBase, RuleTypes } from "../Rule";
+/**
+ * ImageId override rules allow setting an image ID to specific types of ECInstances.
+ *
+ * @see [Image ID override reference documentation page]($docs/presentation/customization/ImageIdOverride.md)
+ * @public
+ * @deprecated in 3.x. Use [[ExtendedDataRule]] instead. See [extended data usage page]($docs/presentation/customization/ExtendedDataUsage.md) for more details.
+ */
+export interface ImageIdOverride extends RuleBase {
+    /** Used for serializing to JSON. */
+    ruleType: RuleTypes.ImageIdOverride;
+    /**
+     * Defines a condition for the rule, which needs to be met in order to execute it. Condition
+     * is an [ECExpression]($docs/presentation/advanced/ECExpressions.md), which can use
+     * a [limited set of symbols]($docs/presentation/customization/ECExpressions.md#rule-condition).
+     */
+    condition?: string;
+    /**
+     * An expression whose result becomes the image ID. This is
+     * an [ECExpression]($docs/presentation/customization/ECExpressions.md), so ID can be
+     * defined/formatted dynamically based on the context - for example ECInstance property value.
+     *
+     * @minLength 1
+     */
+    imageIdExpression: string;
+}
 //# sourceMappingURL=ImageIdOverride.d.ts.map

package/lib/esm/presentation-common/rules/customization/ImageIdOverride.js

@@ -1,9 +1,9 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module PresentationRules
- */
-export {};
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PresentationRules
+ */
+export {};
 //# sourceMappingURL=ImageIdOverride.js.map