@itwin/components-react 4.0.0-dev.2 → 4.0.0-dev.3

package/lib/cjs/components-react/filter-builder/FilterBuilderState.js

@@ -1,4 +1,11 @@
 "use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
@@ -19,17 +26,17 @@ var __importStar = (this && this.__importStar) || function (mod) {
     return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.usePropertyFilterBuilderState = exports.isPropertyFilterBuilderRuleGroup = exports.PropertyFilterBuilderActions = void 0;
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
+exports.buildPropertyFilter = exports.usePropertyFilterBuilderState = exports.isPropertyFilterBuilderRuleGroup = exports.PropertyFilterBuilderActions = void 0;
 const immer_1 = require("immer");
 const React = __importStar(require("react"));
+const appui_abstract_1 = require("@itwin/appui-abstract");
 const core_bentley_1 = require("@itwin/core-bentley");
 const Operators_1 = require("./Operators");
 const Types_1 = require("./Types");
-/** @alpha */
+/**
+ * Actions for controlling [[PropertyFilterBuilder]] component state.
+ * @internal
+ */
 class PropertyFilterBuilderActions {
     constructor(setState) {
         this.setState = setState;
@@ -37,6 +44,7 @@ class PropertyFilterBuilderActions {
     updateState(updater) {
         this.setState((0, immer_1.produce)(updater));
     }
+    /** Adds new rule or group of rules to the group specified by path. */
     addItem(path, itemType) {
         this.updateState((state) => {
             const parentGroup = findRuleGroup(state.rootGroup, path);
@@ -46,6 +54,7 @@ class PropertyFilterBuilderActions {
             parentGroup.items.push(item);
         });
     }
+    /** Removes item specified by path. */
     removeItem(path) {
         function removeItemFromGroup(state, pathToItem) {
             const pathToParent = pathToItem.slice(0, -1);
@@ -64,6 +73,7 @@ class PropertyFilterBuilderActions {
             removeItemFromGroup(state, path);
         });
     }
+    /** Sets operator of rule group specified by the path. */
     setRuleGroupOperator(path, operator) {
         this.updateState((state) => {
             const group = findRuleGroup(state.rootGroup, path);
@@ -72,6 +82,7 @@ class PropertyFilterBuilderActions {
             group.operator = operator;
         });
     }
+    /** Sets property of rule specified by the path. */
     setRuleProperty(path, property) {
         this.updateState((state) => {
             const rule = findRule(state.rootGroup, path);
@@ -81,6 +92,7 @@ class PropertyFilterBuilderActions {
             rule.value = undefined;
         });
     }
+    /** Sets operator of rule specified by the path. */
     setRuleOperator(path, operator) {
         this.updateState((state) => {
             const rule = findRule(state.rootGroup, path);
@@ -91,6 +103,7 @@ class PropertyFilterBuilderActions {
             rule.operator = operator;
         });
     }
+    /** Sets value of rule specified by the path. */
     setRuleValue(path, value) {
         this.updateState((state) => {
             const rule = findRule(state.rootGroup, path);
@@ -101,18 +114,57 @@ class PropertyFilterBuilderActions {
     }
 }
 exports.PropertyFilterBuilderActions = PropertyFilterBuilderActions;
-/** @alpha */
+/**
+ * Function to check if supplied [[PropertyFilterBuilderRuleGroupItem]] is [[PropertyFilterBuilderRuleGroup]].
+ * @internal
+ */
 function isPropertyFilterBuilderRuleGroup(item) {
     return item.items !== undefined;
 }
 exports.isPropertyFilterBuilderRuleGroup = isPropertyFilterBuilderRuleGroup;
-/** @alpha */
+/**
+ * Custom hook that creates state for [[PropertyFilterBuilder]] component. It creates empty state or initializes
+ * state from supplied initial filter.
+ * @internal
+ */
 function usePropertyFilterBuilderState(initialFilter) {
     const [state, setState] = React.useState(() => initialFilter ? convertFilterToState(initialFilter) : { rootGroup: createEmptyRuleGroup() });
     const [actions] = React.useState(() => new PropertyFilterBuilderActions(setState));
     return { state, actions };
 }
 exports.usePropertyFilterBuilderState = usePropertyFilterBuilderState;
+/** @internal */
+function buildPropertyFilter(groupItem) {
+    if (isPropertyFilterBuilderRuleGroup(groupItem))
+        return buildPropertyFilterFromRuleGroup(groupItem);
+    return buildPropertyFilterFromRule(groupItem);
+}
+exports.buildPropertyFilter = buildPropertyFilter;
+function buildPropertyFilterFromRuleGroup(rootGroup) {
+    if (rootGroup.items.length === 0)
+        return undefined;
+    const rules = new Array();
+    for (const item of rootGroup.items) {
+        const rule = buildPropertyFilter(item);
+        if (!rule)
+            return undefined;
+        rules.push(rule);
+    }
+    if (rules.length === 1)
+        return rules[0];
+    return {
+        operator: rootGroup.operator,
+        rules,
+    };
+}
+function buildPropertyFilterFromRule(rule) {
+    const { property, operator, value } = rule;
+    if (!property || operator === undefined)
+        return undefined;
+    if (!(0, Operators_1.isUnaryPropertyFilterOperator)(operator) && (value === undefined || value.valueFormat !== appui_abstract_1.PropertyValueFormat.Primitive || value.value === undefined))
+        return undefined;
+    return { property, operator, value };
+}
 function createEmptyRule(groupId) {
     return {
         id: core_bentley_1.Guid.createValue(),

package/lib/cjs/components-react/filter-builder/FilterBuilderState.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilderState.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderState.ts"],"names":[],"mappings":"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","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 { Draft, produce } from \"immer\";\nimport * as React from \"react\";\nimport { PropertyDescription, PropertyValue } from \"@itwin/appui-abstract\";\nimport { Guid } from \"@itwin/core-bentley\";\nimport { isUnaryPropertyFilterOperator, PropertyFilterRuleGroupOperator, PropertyFilterRuleOperator } from \"./Operators\";\nimport { isPropertyFilterRuleGroup, PropertyFilter, PropertyFilterRule } from \"./Types\";\n\n/** @alpha */\nexport interface PropertyFilterBuilderState {\n  rootGroup: PropertyFilterBuilderRuleGroup;\n}\n\n/** @alpha */\nexport type PropertyFilterBuilderRuleGroupItem = PropertyFilterBuilderRuleGroup | PropertyFilterBuilderRule;\n\n/** @alpha */\nexport interface PropertyFilterBuilderRuleGroup {\n  id: string;\n  groupId?: string;\n  operator: PropertyFilterRuleGroupOperator;\n  items: PropertyFilterBuilderRuleGroupItem[];\n}\n\n/** @alpha */\nexport interface PropertyFilterBuilderRule {\n  id: string;\n  groupId: string;\n  property?: PropertyDescription;\n  operator?: PropertyFilterRuleOperator;\n  value?: PropertyValue;\n}\n\n/** @alpha */\nexport class PropertyFilterBuilderActions {\n  constructor(private setState: (setter: (prevState: PropertyFilterBuilderState) => PropertyFilterBuilderState) => void) { }\n\n  private updateState(updater: (state: Draft<PropertyFilterBuilderState>) => void) {\n    this.setState(produce(updater));\n  }\n\n  public addItem(path: string[], itemType: \"RULE_GROUP\" | \"RULE\") {\n    this.updateState((state) => {\n      const parentGroup = findRuleGroup(state.rootGroup, path);\n      if (!parentGroup)\n        return;\n      const item = itemType === \"RULE_GROUP\" ? createEmptyRuleGroup(parentGroup.id) : createEmptyRule(parentGroup.id);\n      parentGroup.items.push(item);\n    });\n  }\n\n  public removeItem(path: string[]) {\n    function removeItemFromGroup(state: Draft<PropertyFilterBuilderState>, pathToItem: string[]) {\n      const pathToParent = pathToItem.slice(0, -1);\n      const parentGroup = findRuleGroup(state.rootGroup, pathToParent);\n      if (!parentGroup)\n        return;\n      const itemId = pathToItem[pathToItem.length - 1];\n      const itemIndex = parentGroup.items.findIndex((item) => item.id === itemId);\n      if (itemIndex === -1)\n        return;\n      parentGroup.items.splice(itemIndex, 1);\n      if (parentGroup.items.length === 0)\n        removeItemFromGroup(state, pathToParent);\n    }\n\n    this.updateState((state) => {\n      removeItemFromGroup(state, path);\n    });\n  }\n\n  public setRuleGroupOperator(path: string[], operator: PropertyFilterRuleGroupOperator) {\n    this.updateState((state) => {\n      const group = findRuleGroup(state.rootGroup, path);\n      if (!group)\n        return;\n      group.operator = operator;\n    });\n  }\n\n  public setRuleProperty(path: string[], property?: PropertyDescription) {\n    this.updateState((state) => {\n      const rule = findRule(state.rootGroup, path);\n      if (!rule)\n        return;\n      rule.property = property;\n      rule.value = undefined;\n    });\n  }\n\n  public setRuleOperator(path: string[], operator: PropertyFilterRuleOperator) {\n    this.updateState((state) => {\n      const rule = findRule(state.rootGroup, path);\n      if (!rule)\n        return;\n      if (isUnaryPropertyFilterOperator(operator))\n        rule.value = undefined;\n      rule.operator = operator;\n    });\n  }\n\n  public setRuleValue(path: string[], value: PropertyValue) {\n    this.updateState((state) => {\n      const rule = findRule(state.rootGroup, path);\n      if (!rule)\n        return;\n      rule.value = value;\n    });\n  }\n}\n\n/** @alpha */\nexport function isPropertyFilterBuilderRuleGroup(item: PropertyFilterBuilderRuleGroupItem): item is PropertyFilterBuilderRuleGroup {\n  return (item as any).items !== undefined;\n}\n\n/** @alpha */\nexport function usePropertyFilterBuilderState(initialFilter?: PropertyFilter) {\n  const [state, setState] = React.useState<PropertyFilterBuilderState>(\n    () => initialFilter ? convertFilterToState(initialFilter) : { rootGroup: createEmptyRuleGroup() }\n  );\n  const [actions] = React.useState(() => new PropertyFilterBuilderActions(setState));\n\n  return { state, actions };\n}\n\nfunction createEmptyRule(groupId: string): PropertyFilterBuilderRule {\n  return {\n    id: Guid.createValue(),\n    groupId,\n  };\n}\n\nfunction createEmptyRuleGroup(groupId?: string): PropertyFilterBuilderRuleGroup {\n  const id = Guid.createValue();\n  return {\n    id,\n    groupId,\n    operator: PropertyFilterRuleGroupOperator.And,\n    items: [createEmptyRule(id)],\n  };\n}\n\nfunction findRuleGroup(rootGroup: PropertyFilterBuilderRuleGroup, path: string[]): PropertyFilterBuilderRuleGroup | undefined {\n  if (path.length === 0)\n    return rootGroup;\n\n  const [currentItemId, ...rest] = path;\n  const currentItem = rootGroup.items.find((item) => item.id === currentItemId);\n  if (!currentItem || !isPropertyFilterBuilderRuleGroup(currentItem))\n    return undefined;\n\n  return findRuleGroup(currentItem, rest);\n}\n\nfunction findRule(rootGroup: PropertyFilterBuilderRuleGroup, path: string[]): PropertyFilterBuilderRule | undefined {\n  if (path.length === 0)\n    return undefined;\n\n  const [currentItemId, ...rest] = path;\n  const currentItem = rootGroup.items.find((item) => item.id === currentItemId);\n  if (!currentItem)\n    return undefined;\n\n  if (isPropertyFilterBuilderRuleGroup(currentItem))\n    return findRule(currentItem, rest);\n\n  return currentItem;\n}\n\nfunction getRuleGroupItem(filter: PropertyFilter, parentId: string): PropertyFilterBuilderRuleGroupItem {\n  const id = Guid.createValue();\n  if (isPropertyFilterRuleGroup(filter))\n    return {\n      id,\n      groupId: parentId,\n      operator: filter.operator,\n      items: filter.rules.map((rule) => getRuleGroupItem(rule, id)),\n    };\n  return getRuleItem(filter, id);\n}\n\nfunction getRuleItem(filter: PropertyFilterRule, parentId: string) {\n  return {\n    id: Guid.createValue(),\n    groupId: parentId,\n    property: filter.property,\n    operator: filter.operator,\n    value: filter.value,\n  };\n}\n\nfunction convertFilterToState(filter: PropertyFilter): PropertyFilterBuilderState {\n  const id = Guid.createValue();\n  if (isPropertyFilterRuleGroup(filter)) {\n    return {\n      rootGroup: {\n        id,\n        operator: filter.operator,\n        items: filter.rules.map((rule) => getRuleGroupItem(rule, id)),\n      },\n    };\n  }\n  return {\n    rootGroup: {\n      id,\n      operator: PropertyFilterRuleGroupOperator.And,\n      items: [getRuleItem(filter, id)],\n    },\n  };\n}\n"]}
+{"version":3,"file":"FilterBuilderState.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderState.ts"],"names":[],"mappings":"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","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 PropertyFilterBuilder\n */\n\nimport { Draft, produce } from \"immer\";\nimport * as React from \"react\";\nimport { PropertyDescription, PropertyValue, PropertyValueFormat } from \"@itwin/appui-abstract\";\nimport { Guid } from \"@itwin/core-bentley\";\nimport { isUnaryPropertyFilterOperator, PropertyFilterRuleGroupOperator, PropertyFilterRuleOperator } from \"./Operators\";\nimport { isPropertyFilterRuleGroup, PropertyFilter, PropertyFilterRule } from \"./Types\";\n\n/**\n * Data structure that describes [[PropertyFilterBuilder]] component state.\n * @internal\n */\nexport interface PropertyFilterBuilderState {\n  /** Root group of rules in [[PropertyFilterBuilder]] component. */\n  rootGroup: PropertyFilterBuilderRuleGroup;\n}\n\n/**\n * Type that describes [[PropertyFilterBuilder]] component group item.\n * @internal\n */\nexport type PropertyFilterBuilderRuleGroupItem = PropertyFilterBuilderRuleGroup | PropertyFilterBuilderRule;\n\n/**\n * Data structure that describes [[PropertyFilterBuilder]] component rule group.\n * @internal\n */\nexport interface PropertyFilterBuilderRuleGroup {\n  /** Id of this rule group. */\n  id: string;\n  /** Id of rule group that this group is nested in. */\n  groupId?: string;\n  /** Operator that should join items in this group. */\n  operator: PropertyFilterRuleGroupOperator;\n  /** Items in this group. */\n  items: PropertyFilterBuilderRuleGroupItem[];\n}\n\n/**\n * Data structure that describes [[PropertyFilterBuilder]] component single rule.\n * @internal\n */\nexport interface PropertyFilterBuilderRule {\n  /** Id of this rule. */\n  id: string;\n  /** Id of rule group that this rule is nested in. */\n  groupId: string;\n  /** Property used in this rule. */\n  property?: PropertyDescription;\n  /** Operator that should be used to compare property value. */\n  operator?: PropertyFilterRuleOperator;\n  /** Value that property should be compared to. */\n  value?: PropertyValue;\n}\n\n/**\n * Actions for controlling [[PropertyFilterBuilder]] component state.\n * @internal\n */\nexport class PropertyFilterBuilderActions {\n  constructor(private setState: (setter: (prevState: PropertyFilterBuilderState) => PropertyFilterBuilderState) => void) { }\n\n  private updateState(updater: (state: Draft<PropertyFilterBuilderState>) => void) {\n    this.setState(produce(updater));\n  }\n\n  /** Adds new rule or group of rules to the group specified by path. */\n  public addItem(path: string[], itemType: \"RULE_GROUP\" | \"RULE\") {\n    this.updateState((state) => {\n      const parentGroup = findRuleGroup(state.rootGroup, path);\n      if (!parentGroup)\n        return;\n      const item = itemType === \"RULE_GROUP\" ? createEmptyRuleGroup(parentGroup.id) : createEmptyRule(parentGroup.id);\n      parentGroup.items.push(item);\n    });\n  }\n\n  /** Removes item specified by path. */\n  public removeItem(path: string[]) {\n    function removeItemFromGroup(state: Draft<PropertyFilterBuilderState>, pathToItem: string[]) {\n      const pathToParent = pathToItem.slice(0, -1);\n      const parentGroup = findRuleGroup(state.rootGroup, pathToParent);\n      if (!parentGroup)\n        return;\n      const itemId = pathToItem[pathToItem.length - 1];\n      const itemIndex = parentGroup.items.findIndex((item) => item.id === itemId);\n      if (itemIndex === -1)\n        return;\n      parentGroup.items.splice(itemIndex, 1);\n      if (parentGroup.items.length === 0)\n        removeItemFromGroup(state, pathToParent);\n    }\n\n    this.updateState((state) => {\n      removeItemFromGroup(state, path);\n    });\n  }\n\n  /** Sets operator of rule group specified by the path. */\n  public setRuleGroupOperator(path: string[], operator: PropertyFilterRuleGroupOperator) {\n    this.updateState((state) => {\n      const group = findRuleGroup(state.rootGroup, path);\n      if (!group)\n        return;\n      group.operator = operator;\n    });\n  }\n\n  /** Sets property of rule specified by the path. */\n  public setRuleProperty(path: string[], property?: PropertyDescription) {\n    this.updateState((state) => {\n      const rule = findRule(state.rootGroup, path);\n      if (!rule)\n        return;\n      rule.property = property;\n      rule.value = undefined;\n    });\n  }\n\n  /** Sets operator of rule specified by the path. */\n  public setRuleOperator(path: string[], operator: PropertyFilterRuleOperator) {\n    this.updateState((state) => {\n      const rule = findRule(state.rootGroup, path);\n      if (!rule)\n        return;\n      if (isUnaryPropertyFilterOperator(operator))\n        rule.value = undefined;\n      rule.operator = operator;\n    });\n  }\n\n  /** Sets value of rule specified by the path. */\n  public setRuleValue(path: string[], value: PropertyValue) {\n    this.updateState((state) => {\n      const rule = findRule(state.rootGroup, path);\n      if (!rule)\n        return;\n      rule.value = value;\n    });\n  }\n}\n\n/**\n * Function to check if supplied [[PropertyFilterBuilderRuleGroupItem]] is [[PropertyFilterBuilderRuleGroup]].\n * @internal\n */\nexport function isPropertyFilterBuilderRuleGroup(item: PropertyFilterBuilderRuleGroupItem): item is PropertyFilterBuilderRuleGroup {\n  return (item as any).items !== undefined;\n}\n\n/**\n * Custom hook that creates state for [[PropertyFilterBuilder]] component. It creates empty state or initializes\n * state from supplied initial filter.\n * @internal\n */\nexport function usePropertyFilterBuilderState(initialFilter?: PropertyFilter) {\n  const [state, setState] = React.useState<PropertyFilterBuilderState>(\n    () => initialFilter ? convertFilterToState(initialFilter) : { rootGroup: createEmptyRuleGroup() }\n  );\n  const [actions] = React.useState(() => new PropertyFilterBuilderActions(setState));\n\n  return { state, actions };\n}\n\n/** @internal */\nexport function buildPropertyFilter(groupItem: PropertyFilterBuilderRuleGroupItem): PropertyFilter | undefined {\n  if (isPropertyFilterBuilderRuleGroup(groupItem))\n    return buildPropertyFilterFromRuleGroup(groupItem);\n  return buildPropertyFilterFromRule(groupItem);\n}\n\nfunction buildPropertyFilterFromRuleGroup(rootGroup: PropertyFilterBuilderRuleGroup): PropertyFilter | undefined {\n  if (rootGroup.items.length === 0)\n    return undefined;\n\n  const rules = new Array<PropertyFilter>();\n  for (const item of rootGroup.items) {\n    const rule = buildPropertyFilter(item);\n    if (!rule)\n      return undefined;\n    rules.push(rule);\n  }\n\n  if (rules.length === 1)\n    return rules[0];\n\n  return {\n    operator: rootGroup.operator,\n    rules,\n  };\n}\n\nfunction buildPropertyFilterFromRule(rule: PropertyFilterBuilderRule): PropertyFilter | undefined {\n  const { property, operator, value } = rule;\n  if (!property || operator === undefined)\n    return undefined;\n\n  if (!isUnaryPropertyFilterOperator(operator) && (value === undefined || value.valueFormat !== PropertyValueFormat.Primitive || value.value === undefined))\n    return undefined;\n\n  return { property, operator, value };\n}\n\nfunction createEmptyRule(groupId: string): PropertyFilterBuilderRule {\n  return {\n    id: Guid.createValue(),\n    groupId,\n  };\n}\n\nfunction createEmptyRuleGroup(groupId?: string): PropertyFilterBuilderRuleGroup {\n  const id = Guid.createValue();\n  return {\n    id,\n    groupId,\n    operator: PropertyFilterRuleGroupOperator.And,\n    items: [createEmptyRule(id)],\n  };\n}\n\nfunction findRuleGroup(rootGroup: PropertyFilterBuilderRuleGroup, path: string[]): PropertyFilterBuilderRuleGroup | undefined {\n  if (path.length === 0)\n    return rootGroup;\n\n  const [currentItemId, ...rest] = path;\n  const currentItem = rootGroup.items.find((item) => item.id === currentItemId);\n  if (!currentItem || !isPropertyFilterBuilderRuleGroup(currentItem))\n    return undefined;\n\n  return findRuleGroup(currentItem, rest);\n}\n\nfunction findRule(rootGroup: PropertyFilterBuilderRuleGroup, path: string[]): PropertyFilterBuilderRule | undefined {\n  if (path.length === 0)\n    return undefined;\n\n  const [currentItemId, ...rest] = path;\n  const currentItem = rootGroup.items.find((item) => item.id === currentItemId);\n  if (!currentItem)\n    return undefined;\n\n  if (isPropertyFilterBuilderRuleGroup(currentItem))\n    return findRule(currentItem, rest);\n\n  return currentItem;\n}\n\nfunction getRuleGroupItem(filter: PropertyFilter, parentId: string): PropertyFilterBuilderRuleGroupItem {\n  const id = Guid.createValue();\n  if (isPropertyFilterRuleGroup(filter))\n    return {\n      id,\n      groupId: parentId,\n      operator: filter.operator,\n      items: filter.rules.map((rule) => getRuleGroupItem(rule, id)),\n    };\n  return getRuleItem(filter, id);\n}\n\nfunction getRuleItem(filter: PropertyFilterRule, parentId: string) {\n  return {\n    id: Guid.createValue(),\n    groupId: parentId,\n    property: filter.property,\n    operator: filter.operator,\n    value: filter.value,\n  };\n}\n\nfunction convertFilterToState(filter: PropertyFilter): PropertyFilterBuilderState {\n  const id = Guid.createValue();\n  if (isPropertyFilterRuleGroup(filter)) {\n    return {\n      rootGroup: {\n        id,\n        operator: filter.operator,\n        items: filter.rules.map((rule) => getRuleGroupItem(rule, id)),\n      },\n    };\n  }\n  return {\n    rootGroup: {\n      id,\n      operator: PropertyFilterRuleGroupOperator.And,\n      items: [getRuleItem(filter, id)],\n    },\n  };\n}\n"]}

package/lib/cjs/components-react/filter-builder/Operators.d.ts

@@ -1,10 +1,19 @@
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
 import { PropertyDescription } from "@itwin/appui-abstract";
-/** @alpha */
+/**
+ * Logical operator for joining rules.
+ * @beta
+ */
 export declare enum PropertyFilterRuleGroupOperator {
     And = 0,
     Or = 1
 }
-/** @alpha */
+/**
+ * Operators for comparing property value in rule.
+ * @beta
+ */
 export declare enum PropertyFilterRuleOperator {
     IsTrue = 0,
     IsFalse = 1,
@@ -18,10 +27,19 @@ export declare enum PropertyFilterRuleOperator {
     IsNull = 9,
     IsNotNull = 10
 }
-/** @alpha */
+/**
+ * Function that returns set of available operator based on property type.
+ * @beta
+ */
 export declare function getPropertyFilterOperators(property: PropertyDescription): PropertyFilterRuleOperator[];
-/** @alpha */
+/**
+ * Function that returns display label for rule operator.
+ * @beta
+ */
 export declare function getPropertyFilterOperatorLabel(operator: PropertyFilterRuleOperator): string;
-/** @alpha */
+/**
+ * Function that checks if supplied operator is unary.
+ * @beta
+ */
 export declare function isUnaryPropertyFilterOperator(operator: PropertyFilterRuleOperator): boolean;
 //# sourceMappingURL=Operators.d.ts.map

package/lib/cjs/components-react/filter-builder/Operators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Operators.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Operators.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,uBAAuB,CAAC;AAG/E,aAAa;AACb,oBAAY,+BAA+B;IACzC,GAAG,IAAA;IACH,EAAE,IAAA;CACH;AAED,aAAa;AACb,oBAAY,0BAA0B;IACpC,MAAM,IAAA;IACN,OAAO,IAAA;IAEP,OAAO,IAAA;IACP,UAAU,IAAA;IAEV,OAAO,IAAA;IACP,cAAc,IAAA;IACd,IAAI,IAAA;IACJ,WAAW,IAAA;IAEX,IAAI,IAAA;IAEJ,MAAM,IAAA;IACN,SAAS,KAAA;CACV;AAED,aAAa;AACb,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,mBAAmB,gCA2CvE;AAGD,aAAa;AACb,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,0BAA0B,UAyBlF;AAED,aAAa;AACb,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,0BAA0B,WASjF"}
+{"version":3,"file":"Operators.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Operators.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAqB,MAAM,uBAAuB,CAAC;AAG/E;;;GAGG;AACH,oBAAY,+BAA+B;IACzC,GAAG,IAAA;IACH,EAAE,IAAA;CACH;AAED;;;GAGG;AACH,oBAAY,0BAA0B;IACpC,MAAM,IAAA;IACN,OAAO,IAAA;IAEP,OAAO,IAAA;IACP,UAAU,IAAA;IAEV,OAAO,IAAA;IACP,cAAc,IAAA;IACd,IAAI,IAAA;IACJ,WAAW,IAAA;IAEX,IAAI,IAAA;IAEJ,MAAM,IAAA;IACN,SAAS,KAAA;CACV;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,mBAAmB,gCA2CvE;AAGD;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,0BAA0B,UAyBlF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,0BAA0B,WASjF"}

package/lib/cjs/components-react/filter-builder/Operators.js

@@ -1,19 +1,28 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isUnaryPropertyFilterOperator = exports.getPropertyFilterOperatorLabel = exports.getPropertyFilterOperators = exports.PropertyFilterRuleOperator = exports.PropertyFilterRuleGroupOperator = void 0;
 /*---------------------------------------------------------------------------------------------
 * Copyright (c) Bentley Systems, Incorporated. All rights reserved.
 * See LICENSE.md in the project root for license terms and full copyright notice.
 *--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUnaryPropertyFilterOperator = exports.getPropertyFilterOperatorLabel = exports.getPropertyFilterOperators = exports.PropertyFilterRuleOperator = exports.PropertyFilterRuleGroupOperator = void 0;
 const appui_abstract_1 = require("@itwin/appui-abstract");
 const UiComponents_1 = require("../UiComponents");
-/** @alpha */
+/**
+ * Logical operator for joining rules.
+ * @beta
+ */
 var PropertyFilterRuleGroupOperator;
 (function (PropertyFilterRuleGroupOperator) {
     PropertyFilterRuleGroupOperator[PropertyFilterRuleGroupOperator["And"] = 0] = "And";
     PropertyFilterRuleGroupOperator[PropertyFilterRuleGroupOperator["Or"] = 1] = "Or";
 })(PropertyFilterRuleGroupOperator = exports.PropertyFilterRuleGroupOperator || (exports.PropertyFilterRuleGroupOperator = {}));
-/** @alpha */
+/**
+ * Operators for comparing property value in rule.
+ * @beta
+ */
 var PropertyFilterRuleOperator;
 (function (PropertyFilterRuleOperator) {
     PropertyFilterRuleOperator[PropertyFilterRuleOperator["IsTrue"] = 0] = "IsTrue";
@@ -28,7 +37,10 @@ var PropertyFilterRuleOperator;
     PropertyFilterRuleOperator[PropertyFilterRuleOperator["IsNull"] = 9] = "IsNull";
     PropertyFilterRuleOperator[PropertyFilterRuleOperator["IsNotNull"] = 10] = "IsNotNull";
 })(PropertyFilterRuleOperator = exports.PropertyFilterRuleOperator || (exports.PropertyFilterRuleOperator = {}));
-/** @alpha */
+/**
+ * Function that returns set of available operator based on property type.
+ * @beta
+ */
 function getPropertyFilterOperators(property) {
     const typename = property.typename;
     if (typename === appui_abstract_1.StandardTypeNames.Bool || typename === appui_abstract_1.StandardTypeNames.Boolean) {
@@ -70,7 +82,10 @@ function getPropertyFilterOperators(property) {
 }
 exports.getPropertyFilterOperators = getPropertyFilterOperators;
 /* istanbul ignore next */
-/** @alpha */
+/**
+ * Function that returns display label for rule operator.
+ * @beta
+ */
 function getPropertyFilterOperatorLabel(operator) {
     switch (operator) {
         case PropertyFilterRuleOperator.IsTrue:
@@ -98,7 +113,10 @@ function getPropertyFilterOperatorLabel(operator) {
     }
 }
 exports.getPropertyFilterOperatorLabel = getPropertyFilterOperatorLabel;
-/** @alpha */
+/**
+ * Function that checks if supplied operator is unary.
+ * @beta
+ */
 function isUnaryPropertyFilterOperator(operator) {
     switch (operator) {
         case PropertyFilterRuleOperator.IsTrue:

package/lib/cjs/components-react/filter-builder/Operators.js.map

@@ -1 +1 @@
-{"version":3,"file":"Operators.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Operators.ts"],"names":[],"mappings":"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","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 { PropertyDescription, StandardTypeNames } from \"@itwin/appui-abstract\";\nimport { UiComponents } from \"../UiComponents\";\n\n/** @alpha */\nexport enum PropertyFilterRuleGroupOperator {\n  And,\n  Or,\n}\n\n/** @alpha */\nexport enum PropertyFilterRuleOperator {\n  IsTrue,\n  IsFalse,\n\n  IsEqual,\n  IsNotEqual,\n\n  Greater,\n  GreaterOrEqual,\n  Less,\n  LessOrEqual,\n\n  Like,\n\n  IsNull,\n  IsNotNull,\n}\n\n/** @alpha */\nexport function getPropertyFilterOperators(property: PropertyDescription) {\n  const typename = property.typename;\n\n  if (typename === StandardTypeNames.Bool || typename === StandardTypeNames.Boolean) {\n    return [\n      PropertyFilterRuleOperator.IsTrue,\n      PropertyFilterRuleOperator.IsFalse,\n    ];\n  }\n\n  const operators = [\n    PropertyFilterRuleOperator.IsEqual,\n    PropertyFilterRuleOperator.IsNotEqual,\n    PropertyFilterRuleOperator.IsNull,\n    PropertyFilterRuleOperator.IsNotNull,\n  ];\n\n  if (typename === StandardTypeNames.Number\n    || typename === StandardTypeNames.Int\n    || typename === StandardTypeNames.Integer\n    || typename === StandardTypeNames.Double\n    || typename === StandardTypeNames.Float\n    || typename === StandardTypeNames.Hex\n    || typename === StandardTypeNames.Hexadecimal\n    || typename === StandardTypeNames.ShortDate\n    || typename === StandardTypeNames.DateTime) {\n    return [\n      ...operators,\n      PropertyFilterRuleOperator.Greater,\n      PropertyFilterRuleOperator.GreaterOrEqual,\n      PropertyFilterRuleOperator.Less,\n      PropertyFilterRuleOperator.LessOrEqual,\n    ];\n  }\n\n  if (typename === StandardTypeNames.String || typename === StandardTypeNames.Text) {\n    return [\n      ...operators,\n      PropertyFilterRuleOperator.Like,\n    ];\n  }\n\n  return operators;\n}\n\n/* istanbul ignore next */\n/** @alpha */\nexport function getPropertyFilterOperatorLabel(operator: PropertyFilterRuleOperator) {\n  switch(operator) {\n    case PropertyFilterRuleOperator.IsTrue:\n      return UiComponents.translate(\"filterBuilder.operators.isTrue\");\n    case PropertyFilterRuleOperator.IsFalse:\n      return UiComponents.translate(\"filterBuilder.operators.isFalse\");\n    case PropertyFilterRuleOperator.IsEqual:\n      return UiComponents.translate(\"filterBuilder.operators.equal\");\n    case PropertyFilterRuleOperator.IsNotEqual:\n      return UiComponents.translate(\"filterBuilder.operators.notEqual\");\n    case PropertyFilterRuleOperator.Greater:\n      return \">\";\n    case PropertyFilterRuleOperator.GreaterOrEqual:\n      return \">=\";\n    case PropertyFilterRuleOperator.Less:\n      return \"<\";\n    case PropertyFilterRuleOperator.LessOrEqual:\n      return \"<=\";\n    case PropertyFilterRuleOperator.Like:\n      return UiComponents.translate(\"filterBuilder.operators.contains\");\n    case PropertyFilterRuleOperator.IsNull:\n      return UiComponents.translate(\"filterBuilder.operators.isNull\");\n    case PropertyFilterRuleOperator.IsNotNull:\n      return UiComponents.translate(\"filterBuilder.operators.isNotNull\");\n  }\n}\n\n/** @alpha */\nexport function isUnaryPropertyFilterOperator(operator: PropertyFilterRuleOperator) {\n  switch (operator) {\n    case PropertyFilterRuleOperator.IsTrue:\n    case PropertyFilterRuleOperator.IsFalse:\n    case PropertyFilterRuleOperator.IsNull:\n    case PropertyFilterRuleOperator.IsNotNull:\n      return true;\n  }\n  return false;\n}\n"]}
+{"version":3,"file":"Operators.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Operators.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,0DAA+E;AAC/E,kDAA+C;AAE/C;;;GAGG;AACH,IAAY,+BAGX;AAHD,WAAY,+BAA+B;IACzC,mFAAG,CAAA;IACH,iFAAE,CAAA;AACJ,CAAC,EAHW,+BAA+B,GAA/B,uCAA+B,KAA/B,uCAA+B,QAG1C;AAED;;;GAGG;AACH,IAAY,0BAgBX;AAhBD,WAAY,0BAA0B;IACpC,+EAAM,CAAA;IACN,iFAAO,CAAA;IAEP,iFAAO,CAAA;IACP,uFAAU,CAAA;IAEV,iFAAO,CAAA;IACP,+FAAc,CAAA;IACd,2EAAI,CAAA;IACJ,yFAAW,CAAA;IAEX,2EAAI,CAAA;IAEJ,+EAAM,CAAA;IACN,sFAAS,CAAA;AACX,CAAC,EAhBW,0BAA0B,GAA1B,kCAA0B,KAA1B,kCAA0B,QAgBrC;AAED;;;GAGG;AACH,SAAgB,0BAA0B,CAAC,QAA6B;IACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAEnC,IAAI,QAAQ,KAAK,kCAAiB,CAAC,IAAI,IAAI,QAAQ,KAAK,kCAAiB,CAAC,OAAO,EAAE;QACjF,OAAO;YACL,0BAA0B,CAAC,MAAM;YACjC,0BAA0B,CAAC,OAAO;SACnC,CAAC;KACH;IAED,MAAM,SAAS,GAAG;QAChB,0BAA0B,CAAC,OAAO;QAClC,0BAA0B,CAAC,UAAU;QACrC,0BAA0B,CAAC,MAAM;QACjC,0BAA0B,CAAC,SAAS;KACrC,CAAC;IAEF,IAAI,QAAQ,KAAK,kCAAiB,CAAC,MAAM;WACpC,QAAQ,KAAK,kCAAiB,CAAC,GAAG;WAClC,QAAQ,KAAK,kCAAiB,CAAC,OAAO;WACtC,QAAQ,KAAK,kCAAiB,CAAC,MAAM;WACrC,QAAQ,KAAK,kCAAiB,CAAC,KAAK;WACpC,QAAQ,KAAK,kCAAiB,CAAC,GAAG;WAClC,QAAQ,KAAK,kCAAiB,CAAC,WAAW;WAC1C,QAAQ,KAAK,kCAAiB,CAAC,SAAS;WACxC,QAAQ,KAAK,kCAAiB,CAAC,QAAQ,EAAE;QAC5C,OAAO;YACL,GAAG,SAAS;YACZ,0BAA0B,CAAC,OAAO;YAClC,0BAA0B,CAAC,cAAc;YACzC,0BAA0B,CAAC,IAAI;YAC/B,0BAA0B,CAAC,WAAW;SACvC,CAAC;KACH;IAED,IAAI,QAAQ,KAAK,kCAAiB,CAAC,MAAM,IAAI,QAAQ,KAAK,kCAAiB,CAAC,IAAI,EAAE;QAChF,OAAO;YACL,GAAG,SAAS;YACZ,0BAA0B,CAAC,IAAI;SAChC,CAAC;KACH;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AA3CD,gEA2CC;AAED,0BAA0B;AAC1B;;;GAGG;AACH,SAAgB,8BAA8B,CAAC,QAAoC;IACjF,QAAQ,QAAQ,EAAE;QAChB,KAAK,0BAA0B,CAAC,MAAM;YACpC,OAAO,2BAAY,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAClE,KAAK,0BAA0B,CAAC,OAAO;YACrC,OAAO,2BAAY,CAAC,SAAS,CAAC,iCAAiC,CAAC,CAAC;QACnE,KAAK,0BAA0B,CAAC,OAAO;YACrC,OAAO,2BAAY,CAAC,SAAS,CAAC,+BAA+B,CAAC,CAAC;QACjE,KAAK,0BAA0B,CAAC,UAAU;YACxC,OAAO,2BAAY,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACpE,KAAK,0BAA0B,CAAC,OAAO;YACrC,OAAO,GAAG,CAAC;QACb,KAAK,0BAA0B,CAAC,cAAc;YAC5C,OAAO,IAAI,CAAC;QACd,KAAK,0BAA0B,CAAC,IAAI;YAClC,OAAO,GAAG,CAAC;QACb,KAAK,0BAA0B,CAAC,WAAW;YACzC,OAAO,IAAI,CAAC;QACd,KAAK,0BAA0B,CAAC,IAAI;YAClC,OAAO,2BAAY,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACpE,KAAK,0BAA0B,CAAC,MAAM;YACpC,OAAO,2BAAY,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QAClE,KAAK,0BAA0B,CAAC,SAAS;YACvC,OAAO,2BAAY,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;KACtE;AACH,CAAC;AAzBD,wEAyBC;AAED;;;GAGG;AACH,SAAgB,6BAA6B,CAAC,QAAoC;IAChF,QAAQ,QAAQ,EAAE;QAChB,KAAK,0BAA0B,CAAC,MAAM,CAAC;QACvC,KAAK,0BAA0B,CAAC,OAAO,CAAC;QACxC,KAAK,0BAA0B,CAAC,MAAM,CAAC;QACvC,KAAK,0BAA0B,CAAC,SAAS;YACvC,OAAO,IAAI,CAAC;KACf;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AATD,sEASC","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 PropertyFilterBuilder\n */\n\nimport { PropertyDescription, StandardTypeNames } from \"@itwin/appui-abstract\";\nimport { UiComponents } from \"../UiComponents\";\n\n/**\n * Logical operator for joining rules.\n * @beta\n */\nexport enum PropertyFilterRuleGroupOperator {\n  And,\n  Or,\n}\n\n/**\n * Operators for comparing property value in rule.\n * @beta\n */\nexport enum PropertyFilterRuleOperator {\n  IsTrue,\n  IsFalse,\n\n  IsEqual,\n  IsNotEqual,\n\n  Greater,\n  GreaterOrEqual,\n  Less,\n  LessOrEqual,\n\n  Like,\n\n  IsNull,\n  IsNotNull,\n}\n\n/**\n * Function that returns set of available operator based on property type.\n * @beta\n */\nexport function getPropertyFilterOperators(property: PropertyDescription) {\n  const typename = property.typename;\n\n  if (typename === StandardTypeNames.Bool || typename === StandardTypeNames.Boolean) {\n    return [\n      PropertyFilterRuleOperator.IsTrue,\n      PropertyFilterRuleOperator.IsFalse,\n    ];\n  }\n\n  const operators = [\n    PropertyFilterRuleOperator.IsEqual,\n    PropertyFilterRuleOperator.IsNotEqual,\n    PropertyFilterRuleOperator.IsNull,\n    PropertyFilterRuleOperator.IsNotNull,\n  ];\n\n  if (typename === StandardTypeNames.Number\n    || typename === StandardTypeNames.Int\n    || typename === StandardTypeNames.Integer\n    || typename === StandardTypeNames.Double\n    || typename === StandardTypeNames.Float\n    || typename === StandardTypeNames.Hex\n    || typename === StandardTypeNames.Hexadecimal\n    || typename === StandardTypeNames.ShortDate\n    || typename === StandardTypeNames.DateTime) {\n    return [\n      ...operators,\n      PropertyFilterRuleOperator.Greater,\n      PropertyFilterRuleOperator.GreaterOrEqual,\n      PropertyFilterRuleOperator.Less,\n      PropertyFilterRuleOperator.LessOrEqual,\n    ];\n  }\n\n  if (typename === StandardTypeNames.String || typename === StandardTypeNames.Text) {\n    return [\n      ...operators,\n      PropertyFilterRuleOperator.Like,\n    ];\n  }\n\n  return operators;\n}\n\n/* istanbul ignore next */\n/**\n * Function that returns display label for rule operator.\n * @beta\n */\nexport function getPropertyFilterOperatorLabel(operator: PropertyFilterRuleOperator) {\n  switch (operator) {\n    case PropertyFilterRuleOperator.IsTrue:\n      return UiComponents.translate(\"filterBuilder.operators.isTrue\");\n    case PropertyFilterRuleOperator.IsFalse:\n      return UiComponents.translate(\"filterBuilder.operators.isFalse\");\n    case PropertyFilterRuleOperator.IsEqual:\n      return UiComponents.translate(\"filterBuilder.operators.equal\");\n    case PropertyFilterRuleOperator.IsNotEqual:\n      return UiComponents.translate(\"filterBuilder.operators.notEqual\");\n    case PropertyFilterRuleOperator.Greater:\n      return \">\";\n    case PropertyFilterRuleOperator.GreaterOrEqual:\n      return \">=\";\n    case PropertyFilterRuleOperator.Less:\n      return \"<\";\n    case PropertyFilterRuleOperator.LessOrEqual:\n      return \"<=\";\n    case PropertyFilterRuleOperator.Like:\n      return UiComponents.translate(\"filterBuilder.operators.contains\");\n    case PropertyFilterRuleOperator.IsNull:\n      return UiComponents.translate(\"filterBuilder.operators.isNull\");\n    case PropertyFilterRuleOperator.IsNotNull:\n      return UiComponents.translate(\"filterBuilder.operators.isNotNull\");\n  }\n}\n\n/**\n * Function that checks if supplied operator is unary.\n * @beta\n */\nexport function isUnaryPropertyFilterOperator(operator: PropertyFilterRuleOperator) {\n  switch (operator) {\n    case PropertyFilterRuleOperator.IsTrue:\n    case PropertyFilterRuleOperator.IsFalse:\n    case PropertyFilterRuleOperator.IsNull:\n    case PropertyFilterRuleOperator.IsNotNull:\n      return true;\n  }\n  return false;\n}\n"]}

package/lib/cjs/components-react/filter-builder/Types.d.ts

@@ -1,18 +1,38 @@
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
 import { PropertyDescription, PropertyValue } from "@itwin/appui-abstract";
 import { PropertyFilterRuleGroupOperator, PropertyFilterRuleOperator } from "./Operators";
-/** @alpha */
+/**
+ * Type that describes property filter.
+ * @beta
+ */
 export declare type PropertyFilter = PropertyFilterRule | PropertyFilterRuleGroup;
-/** @alpha */
+/**
+ * Data structure that describes group of filter rules.
+ * @beta
+ */
 export interface PropertyFilterRuleGroup {
+    /** Operator that should join rules in this group. */
     operator: PropertyFilterRuleGroupOperator;
+    /** Rules in this group. */
     rules: Array<PropertyFilter>;
 }
-/** @alpha */
+/**
+ * Data structure that describes single filter rule.
+ * @beta
+ */
 export interface PropertyFilterRule {
+    /** Property used in this rule. */
     property: PropertyDescription;
+    /** Operator that should be used to compare property value. */
     operator: PropertyFilterRuleOperator;
+    /** Value that property should be compared to. */
     value?: PropertyValue;
 }
-/** @alpha */
+/**
+ * Function that checks if supplied filter is rule group.
+ * @beta
+ */
 export declare function isPropertyFilterRuleGroup(filter: PropertyFilter): filter is PropertyFilterRuleGroup;
 //# sourceMappingURL=Types.d.ts.map

package/lib/cjs/components-react/filter-builder/Types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE1F,aAAa;AACb,oBAAY,cAAc,GAAG,kBAAkB,GAAG,uBAAuB,CAAC;AAE1E,aAAa;AACb,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CAC9B;AAED,aAAa;AACb,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,QAAQ,EAAE,0BAA0B,CAAC;IACrC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,aAAa;AACb,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,uBAAuB,CAEnG"}
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Types.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE1F;;;GAGG;AACH,oBAAY,cAAc,GAAG,kBAAkB,GAAG,uBAAuB,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,2BAA2B;IAC3B,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,8DAA8D;IAC9D,QAAQ,EAAE,0BAA0B,CAAC;IACrC,iDAAiD;IACjD,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,IAAI,uBAAuB,CAEnG"}

package/lib/cjs/components-react/filter-builder/Types.js

@@ -1,7 +1,17 @@
 "use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPropertyFilterRuleGroup = void 0;
-/** @alpha */
+/**
+ * Function that checks if supplied filter is rule group.
+ * @beta
+ */
 function isPropertyFilterRuleGroup(filter) {
     return filter.rules !== undefined;
 }

package/lib/cjs/components-react/filter-builder/Types.js.map

@@ -1 +1 @@
-{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Types.ts"],"names":[],"mappings":";;;AAuBA,aAAa;AACb,SAAgB,yBAAyB,CAAC,MAAsB;IAC9D,OAAQ,MAAc,CAAC,KAAK,KAAK,SAAS,CAAC;AAC7C,CAAC;AAFD,8DAEC","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 { PropertyDescription, PropertyValue } from \"@itwin/appui-abstract\";\nimport { PropertyFilterRuleGroupOperator, PropertyFilterRuleOperator } from \"./Operators\";\n\n/** @alpha */\nexport type PropertyFilter = PropertyFilterRule | PropertyFilterRuleGroup;\n\n/** @alpha */\nexport interface PropertyFilterRuleGroup {\n  operator: PropertyFilterRuleGroupOperator;\n  rules: Array<PropertyFilter>;\n}\n\n/** @alpha */\nexport interface PropertyFilterRule {\n  property: PropertyDescription;\n  operator: PropertyFilterRuleOperator;\n  value?: PropertyValue;\n}\n\n/** @alpha */\nexport function isPropertyFilterRuleGroup(filter: PropertyFilter): filter is PropertyFilterRuleGroup {\n  return (filter as any).rules !== undefined;\n}\n"]}
+{"version":3,"file":"Types.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/Types.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAmCH;;;GAGG;AACH,SAAgB,yBAAyB,CAAC,MAAsB;IAC9D,OAAQ,MAAc,CAAC,KAAK,KAAK,SAAS,CAAC;AAC7C,CAAC;AAFD,8DAEC","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 PropertyFilterBuilder\n */\n\nimport { PropertyDescription, PropertyValue } from \"@itwin/appui-abstract\";\nimport { PropertyFilterRuleGroupOperator, PropertyFilterRuleOperator } from \"./Operators\";\n\n/**\n * Type that describes property filter.\n * @beta\n */\nexport type PropertyFilter = PropertyFilterRule | PropertyFilterRuleGroup;\n\n/**\n * Data structure that describes group of filter rules.\n * @beta\n */\nexport interface PropertyFilterRuleGroup {\n  /** Operator that should join rules in this group. */\n  operator: PropertyFilterRuleGroupOperator;\n  /** Rules in this group. */\n  rules: Array<PropertyFilter>;\n}\n\n/**\n * Data structure that describes single filter rule.\n * @beta\n */\nexport interface PropertyFilterRule {\n  /** Property used in this rule. */\n  property: PropertyDescription;\n  /** Operator that should be used to compare property value. */\n  operator: PropertyFilterRuleOperator;\n  /** Value that property should be compared to. */\n  value?: PropertyValue;\n}\n\n/**\n * Function that checks if supplied filter is rule group.\n * @beta\n */\nexport function isPropertyFilterRuleGroup(filter: PropertyFilter): filter is PropertyFilterRuleGroup {\n  return (filter as any).rules !== undefined;\n}\n"]}

package/lib/cjs/components-react/properties/LinkHandler.d.ts

@@ -14,7 +14,7 @@ export declare const renderLinks: (text: string, links: LinkElementsInfo, highli
 export declare const withLinks: (stringValue: string, links?: LinkElementsInfo | undefined, highlight?: ((text: string) => React.ReactNode) | undefined) => React.ReactNode;
 /**
  * Properties for [[LinksRenderer]] component.
- * @alpha
+ * @public
  */
 export interface LinksRendererProps {
     value: string;
@@ -23,7 +23,7 @@ export interface LinksRendererProps {
 }
 /**
  * React component for rendering string with links.
- * @alpha
+ * @public
  */
 export declare function LinksRenderer(props: LinksRendererProps): JSX.Element;
 //# sourceMappingURL=LinkHandler.d.ts.map

package/lib/cjs/components-react/properties/LinkHandler.js

@@ -96,7 +96,7 @@ const withLinks = (stringValue, links, highlight) => {
 exports.withLinks = withLinks;
 /**
  * React component for rendering string with links.
- * @alpha
+ * @public
  */
 function LinksRenderer(props) {
     return React.createElement(React.Fragment, null, (0, exports.withLinks)(props.value, props.links, props.highlighter));

package/lib/cjs/components-react/properties/LinkHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"LinkHandler.js","sourceRoot":"","sources":["../../../../src/components-react/properties/LinkHandler.tsx"],"names":[],"mappings":"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","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 Properties\n */\n\nimport * as React from \"react\";\nimport { BentleyError, BentleyStatus } from \"@itwin/core-bentley\";\nimport { LinkElementsInfo } from \"@itwin/appui-abstract\";\nimport { UnderlinedButton } from \"@itwin/core-react\";\n\n/** Render a single anchor tag */\nfunction renderTag(text: string, links: LinkElementsInfo, highlight?: (text: string) => React.ReactNode) {\n  return (\n    <UnderlinedButton\n      onClick={(e) => {\n        e.preventDefault();\n        e.stopPropagation();\n        links.onClick(text);\n      }}\n    >\n      {highlight ? highlight(text) : text}\n    </UnderlinedButton>\n  );\n}\n\ninterface Match { start: number, end: number }\n\nfunction matchComparison(matchA: Match, matchB: Match) {\n  if (matchA.start > matchB.start)\n    return 1;\n  if (matchB.start > matchA.start)\n    return -1;\n  return 0;\n}\n\nfunction renderTextPart(text: string, highlight?: (text: string) => React.ReactNode): React.ReactNode {\n  return highlight ? highlight(text) : text;\n}\n\nfunction renderText(text: string, links: LinkElementsInfo, highlight?: (text: string) => React.ReactNode): React.ReactNode {\n  const { matcher } = links;\n\n  if (!matcher)\n    return renderTag(text, links, highlight);\n\n  const matches = matcher(text);\n\n  // Sort just to be sure\n  matches.sort(matchComparison);\n\n  const parts: React.ReactNode[] = [];\n  let lastIndex = 0;\n  for (const match of matches) {\n    // If matches overlap there must be something wrong with the matcher\n    if (lastIndex > match.start)\n      throw new BentleyError(BentleyStatus.ERROR, \"renderText: matcher returned overlapping matches\");\n\n    if (lastIndex < match.start)\n      parts.push(renderTextPart(text.substring(lastIndex, match.start), highlight));\n\n    const anchorText = text.substring(match.start, match.end);\n    parts.push(renderTag(anchorText, links, highlight));\n\n    lastIndex = match.end;\n  }\n  if (text.length > lastIndex)\n    parts.push(renderTextPart(text.substring(lastIndex), highlight));\n\n  // Need to map, because React complains about the lack of keys\n  return parts.map((part, index) => <React.Fragment key={index}>{part}</React.Fragment>);\n}\n\nfunction renderHighlighted(text: string, highlight: (text: string) => React.ReactNode) {\n  return highlight(text);\n}\n\n/** Renders anchor tag by wrapping or splitting provided text\n * @public\n */\nexport const renderLinks = (text: string, links: LinkElementsInfo, highlight?: (text: string) => React.ReactNode): React.ReactNode => {\n  return renderText(text, links, highlight);\n};\n\n/** If record has links, wraps stringValue in them, otherwise returns unchanged stringValue\n * Optionally it can highlight text\n * @public\n */\nexport const withLinks = (stringValue: string, links?: LinkElementsInfo, highlight?: (text: string) => React.ReactNode): React.ReactNode => {\n  if (links)\n    return renderLinks(stringValue, links, highlight);\n  if (highlight)\n    return renderHighlighted(stringValue, highlight);\n  return stringValue;\n};\n\n/**\n * Properties for [[LinksRenderer]] component.\n * @alpha\n */\nexport interface LinksRendererProps {\n  value: string;\n  links?: LinkElementsInfo;\n  highlighter?: (text: string) => React.ReactNode;\n}\n\n/**\n * React component for rendering string with links.\n * @alpha\n */\nexport function LinksRenderer(props: LinksRendererProps) {\n  return <>{withLinks(props.value, props.links, props.highlighter)}</>;\n}\n"]}
+{"version":3,"file":"LinkHandler.js","sourceRoot":"","sources":["../../../../src/components-react/properties/LinkHandler.tsx"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;;;;;;;;;;;;;;;;;;;;AAEH,6CAA+B;AAC/B,sDAAkE;AAElE,kDAAqD;AAErD,iCAAiC;AACjC,SAAS,SAAS,CAAC,IAAY,EAAE,KAAuB,EAAE,SAA6C;IACrG,OAAO,CACL,oBAAC,6BAAgB,IACf,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;YACb,CAAC,CAAC,cAAc,EAAE,CAAC;YACnB,CAAC,CAAC,eAAe,EAAE,CAAC;YACpB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC,IAEA,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAClB,CACpB,CAAC;AACJ,CAAC;AAID,SAAS,eAAe,CAAC,MAAa,EAAE,MAAa;IACnD,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK;QAC7B,OAAO,CAAC,CAAC;IACX,IAAI,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK;QAC7B,OAAO,CAAC,CAAC,CAAC;IACZ,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,SAA6C;IACjF,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAuB,EAAE,SAA6C;IACtG,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAE1B,IAAI,CAAC,OAAO;QACV,OAAO,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,uBAAuB;IACvB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE9B,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;QAC3B,oEAAoE;QACpE,IAAI,SAAS,GAAG,KAAK,CAAC,KAAK;YACzB,MAAM,IAAI,2BAAY,CAAC,4BAAa,CAAC,KAAK,EAAE,kDAAkD,CAAC,CAAC;QAElG,IAAI,SAAS,GAAG,KAAK,CAAC,KAAK;YACzB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;QAEhF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;QAEpD,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC;KACvB;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS;QACzB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAEnE,8DAA8D;IAC9D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,oBAAC,KAAK,CAAC,QAAQ,IAAC,GAAG,EAAE,KAAK,IAAG,IAAI,CAAkB,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,SAA4C;IACnF,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACI,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,KAAuB,EAAE,SAA6C,EAAmB,EAAE;IACnI,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC,CAAC;AAFW,QAAA,WAAW,eAEtB;AAEF;;;GAGG;AACI,MAAM,SAAS,GAAG,CAAC,WAAmB,EAAE,KAAwB,EAAE,SAA6C,EAAmB,EAAE;IACzI,IAAI,KAAK;QACP,OAAO,IAAA,mBAAW,EAAC,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IACpD,IAAI,SAAS;QACX,OAAO,iBAAiB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IACnD,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC;AANW,QAAA,SAAS,aAMpB;AAYF;;;GAGG;AACH,SAAgB,aAAa,CAAC,KAAyB;IACrD,OAAO,0CAAG,IAAA,iBAAS,EAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAI,CAAC;AACvE,CAAC;AAFD,sCAEC","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 Properties\n */\n\nimport * as React from \"react\";\nimport { BentleyError, BentleyStatus } from \"@itwin/core-bentley\";\nimport { LinkElementsInfo } from \"@itwin/appui-abstract\";\nimport { UnderlinedButton } from \"@itwin/core-react\";\n\n/** Render a single anchor tag */\nfunction renderTag(text: string, links: LinkElementsInfo, highlight?: (text: string) => React.ReactNode) {\n  return (\n    <UnderlinedButton\n      onClick={(e) => {\n        e.preventDefault();\n        e.stopPropagation();\n        links.onClick(text);\n      }}\n    >\n      {highlight ? highlight(text) : text}\n    </UnderlinedButton>\n  );\n}\n\ninterface Match { start: number, end: number }\n\nfunction matchComparison(matchA: Match, matchB: Match) {\n  if (matchA.start > matchB.start)\n    return 1;\n  if (matchB.start > matchA.start)\n    return -1;\n  return 0;\n}\n\nfunction renderTextPart(text: string, highlight?: (text: string) => React.ReactNode): React.ReactNode {\n  return highlight ? highlight(text) : text;\n}\n\nfunction renderText(text: string, links: LinkElementsInfo, highlight?: (text: string) => React.ReactNode): React.ReactNode {\n  const { matcher } = links;\n\n  if (!matcher)\n    return renderTag(text, links, highlight);\n\n  const matches = matcher(text);\n\n  // Sort just to be sure\n  matches.sort(matchComparison);\n\n  const parts: React.ReactNode[] = [];\n  let lastIndex = 0;\n  for (const match of matches) {\n    // If matches overlap there must be something wrong with the matcher\n    if (lastIndex > match.start)\n      throw new BentleyError(BentleyStatus.ERROR, \"renderText: matcher returned overlapping matches\");\n\n    if (lastIndex < match.start)\n      parts.push(renderTextPart(text.substring(lastIndex, match.start), highlight));\n\n    const anchorText = text.substring(match.start, match.end);\n    parts.push(renderTag(anchorText, links, highlight));\n\n    lastIndex = match.end;\n  }\n  if (text.length > lastIndex)\n    parts.push(renderTextPart(text.substring(lastIndex), highlight));\n\n  // Need to map, because React complains about the lack of keys\n  return parts.map((part, index) => <React.Fragment key={index}>{part}</React.Fragment>);\n}\n\nfunction renderHighlighted(text: string, highlight: (text: string) => React.ReactNode) {\n  return highlight(text);\n}\n\n/** Renders anchor tag by wrapping or splitting provided text\n * @public\n */\nexport const renderLinks = (text: string, links: LinkElementsInfo, highlight?: (text: string) => React.ReactNode): React.ReactNode => {\n  return renderText(text, links, highlight);\n};\n\n/** If record has links, wraps stringValue in them, otherwise returns unchanged stringValue\n * Optionally it can highlight text\n * @public\n */\nexport const withLinks = (stringValue: string, links?: LinkElementsInfo, highlight?: (text: string) => React.ReactNode): React.ReactNode => {\n  if (links)\n    return renderLinks(stringValue, links, highlight);\n  if (highlight)\n    return renderHighlighted(stringValue, highlight);\n  return stringValue;\n};\n\n/**\n * Properties for [[LinksRenderer]] component.\n * @public\n */\nexport interface LinksRendererProps {\n  value: string;\n  links?: LinkElementsInfo;\n  highlighter?: (text: string) => React.ReactNode;\n}\n\n/**\n * React component for rendering string with links.\n * @public\n */\nexport function LinksRenderer(props: LinksRendererProps) {\n  return <>{withLinks(props.value, props.links, props.highlighter)}</>;\n}\n"]}

package/lib/cjs/components-react/propertygrid/PropertyCategoryRendererManager.d.ts

@@ -6,7 +6,7 @@ import { VirtualizedPropertyGridContext } from "./component/VirtualizedPropertyG
 import { GridCategoryItem } from "./internal/flat-items/FlatGridItem";
 /**
  * Props that property category renderer receives.
- * @beta
+ * @public
  */
 export interface PropertyCategoryRendererProps {
     /** The category being rendered. */
@@ -18,13 +18,13 @@ export interface PropertyCategoryRendererProps {
 }
 /**
  * Factory function that produces custom property category components.
- * @beta
+ * @public
  */
 export declare type PropertyCategoryRenderer = (categoryItem: GridCategoryItem) => React.ComponentType<PropertyCategoryRendererProps> | undefined;
 /**
  * Keeps a record of currently registered property category renderers and determines which renderers get invoked for
  * each category.
- * @beta
+ * @public
  */
 export declare class PropertyCategoryRendererManager {
     private _categoryRenderers;

package/lib/cjs/components-react/propertygrid/PropertyCategoryRendererManager.js

@@ -11,7 +11,7 @@ exports.PropertyCategoryRendererManager = void 0;
 /**
  * Keeps a record of currently registered property category renderers and determines which renderers get invoked for
  * each category.
- * @beta
+ * @public
  */
 class PropertyCategoryRendererManager {
     constructor() {

package/lib/cjs/components-react/propertygrid/PropertyCategoryRendererManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyCategoryRendererManager.js","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/PropertyCategoryRendererManager.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAyBH;;;;GAIG;AACH,MAAa,+BAA+B;IAA5C;QACU,uBAAkB,GAAG,IAAI,GAAG,EAAoC,CAAC;IA4B3E,CAAC;IAxBC,mFAAmF;IAC5E,oBAAoB,CAAC,YAA8B;;QACxD,IAAI,YAAY,CAAC,eAAe,CAAC,QAAQ,KAAK,SAAS,EAAE;YACvD,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,MAAA,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,0CAAG,YAAY,CAAC,CAAC;IACjG,CAAC;IAED,qGAAqG;IAC9F,WAAW,CAAC,YAAoB,EAAE,gBAA0C,EAAE,QAAQ,GAAG,KAAK;QACnG,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1D,MAAM,SAAS,GAAG,+BAA+B,CAAC,IAAI,CAAC;YACvD,MAAM,UAAU,GAAG,+BAA+B,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,IAAI,UAAU,qBAAqB,YAAY,wDAAwD,CAAC,CAAC;SACtI;QAED,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC9D,CAAC;IAED,sDAAsD;IAC/C,cAAc,CAAC,YAAoB;QACxC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;;AA5BH,0EA6BC;AA1Be,8CAAc,GAAG,IAAI,+BAA+B,EAAE,CAAC","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 * as React from \"react\";\nimport { VirtualizedPropertyGridContext } from \"./component/VirtualizedPropertyGrid\";\nimport { GridCategoryItem } from \"./internal/flat-items/FlatGridItem\";\n\n/**\n * Props that property category renderer receives.\n * @beta\n */\nexport interface PropertyCategoryRendererProps {\n  /** The category being rendered. */\n  categoryItem: GridCategoryItem;\n  /** Context of the surrounding property grid. */\n  gridContext: VirtualizedPropertyGridContext;\n  /** Sets the allocated height for category contents. */\n  onHeightChanged: (newHeight: number) => void;\n}\n\n/**\n * Factory function that produces custom property category components.\n * @beta\n */\nexport type PropertyCategoryRenderer = (categoryItem: GridCategoryItem) => React.ComponentType<PropertyCategoryRendererProps> | undefined;\n\n/**\n * Keeps a record of currently registered property category renderers and determines which renderers get invoked for\n * each category.\n * @beta\n */\nexport class PropertyCategoryRendererManager {\n  private _categoryRenderers = new Map<string, PropertyCategoryRenderer>();\n\n  public static defaultManager = new PropertyCategoryRendererManager();\n\n  /** Retrieves a category rendering component based for the passed category item. */\n  public getCategoryComponent(categoryItem: GridCategoryItem): React.ComponentType<PropertyCategoryRendererProps> | undefined {\n    if (categoryItem.derivedCategory.renderer === undefined) {\n      return undefined;\n    }\n\n    return this._categoryRenderers.get(categoryItem.derivedCategory.renderer.name)?.(categoryItem);\n  }\n\n  /** Registers a renderer factory function to be invoked on categories with specific renderer name. */\n  public addRenderer(rendererName: string, categoryRenderer: PropertyCategoryRenderer, override = false): void {\n    if (this._categoryRenderers.has(rendererName) && !override) {\n      const className = PropertyCategoryRendererManager.name;\n      const methodName = PropertyCategoryRendererManager.prototype.addRenderer.name;\n      throw new Error(`${className}.${methodName} error: renderer '${rendererName}' has already been added. Did you mean to override it?`);\n    }\n\n    this._categoryRenderers.set(rendererName, categoryRenderer);\n  }\n\n  /** Removes previous renderer factory registration. */\n  public removeRenderer(rendererName: string): void {\n    this._categoryRenderers.delete(rendererName);\n  }\n}\n"]}
+{"version":3,"file":"PropertyCategoryRendererManager.js","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/PropertyCategoryRendererManager.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAyBH;;;;GAIG;AACH,MAAa,+BAA+B;IAA5C;QACU,uBAAkB,GAAG,IAAI,GAAG,EAAoC,CAAC;IA4B3E,CAAC;IAxBC,mFAAmF;IAC5E,oBAAoB,CAAC,YAA8B;;QACxD,IAAI,YAAY,CAAC,eAAe,CAAC,QAAQ,KAAK,SAAS,EAAE;YACvD,OAAO,SAAS,CAAC;SAClB;QAED,OAAO,MAAA,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,0CAAG,YAAY,CAAC,CAAC;IACjG,CAAC;IAED,qGAAqG;IAC9F,WAAW,CAAC,YAAoB,EAAE,gBAA0C,EAAE,QAAQ,GAAG,KAAK;QACnG,IAAI,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1D,MAAM,SAAS,GAAG,+BAA+B,CAAC,IAAI,CAAC;YACvD,MAAM,UAAU,GAAG,+BAA+B,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS,IAAI,UAAU,qBAAqB,YAAY,wDAAwD,CAAC,CAAC;SACtI;QAED,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAC9D,CAAC;IAED,sDAAsD;IAC/C,cAAc,CAAC,YAAoB;QACxC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;;AA5BH,0EA6BC;AA1Be,8CAAc,GAAG,IAAI,+BAA+B,EAAE,CAAC","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 * as React from \"react\";\nimport { VirtualizedPropertyGridContext } from \"./component/VirtualizedPropertyGrid\";\nimport { GridCategoryItem } from \"./internal/flat-items/FlatGridItem\";\n\n/**\n * Props that property category renderer receives.\n * @public\n */\nexport interface PropertyCategoryRendererProps {\n  /** The category being rendered. */\n  categoryItem: GridCategoryItem;\n  /** Context of the surrounding property grid. */\n  gridContext: VirtualizedPropertyGridContext;\n  /** Sets the allocated height for category contents. */\n  onHeightChanged: (newHeight: number) => void;\n}\n\n/**\n * Factory function that produces custom property category components.\n * @public\n */\nexport type PropertyCategoryRenderer = (categoryItem: GridCategoryItem) => React.ComponentType<PropertyCategoryRendererProps> | undefined;\n\n/**\n * Keeps a record of currently registered property category renderers and determines which renderers get invoked for\n * each category.\n * @public\n */\nexport class PropertyCategoryRendererManager {\n  private _categoryRenderers = new Map<string, PropertyCategoryRenderer>();\n\n  public static defaultManager = new PropertyCategoryRendererManager();\n\n  /** Retrieves a category rendering component based for the passed category item. */\n  public getCategoryComponent(categoryItem: GridCategoryItem): React.ComponentType<PropertyCategoryRendererProps> | undefined {\n    if (categoryItem.derivedCategory.renderer === undefined) {\n      return undefined;\n    }\n\n    return this._categoryRenderers.get(categoryItem.derivedCategory.renderer.name)?.(categoryItem);\n  }\n\n  /** Registers a renderer factory function to be invoked on categories with specific renderer name. */\n  public addRenderer(rendererName: string, categoryRenderer: PropertyCategoryRenderer, override = false): void {\n    if (this._categoryRenderers.has(rendererName) && !override) {\n      const className = PropertyCategoryRendererManager.name;\n      const methodName = PropertyCategoryRendererManager.prototype.addRenderer.name;\n      throw new Error(`${className}.${methodName} error: renderer '${rendererName}' has already been added. Did you mean to override it?`);\n    }\n\n    this._categoryRenderers.set(rendererName, categoryRenderer);\n  }\n\n  /** Removes previous renderer factory registration. */\n  public removeRenderer(rendererName: string): void {\n    this._categoryRenderers.delete(rendererName);\n  }\n}\n"]}

package/lib/cjs/components-react/propertygrid/PropertyDataProvider.d.ts

@@ -28,8 +28,8 @@ export interface PropertyData {
         [categoryName: string]: PropertyRecord[];
     };
     /**
-     * Should state of existing property data in the component be  re-used for this property data
-     * @alpha
+     * Should state of existing property data in the component be re-used for this property data
+     * @beta
      */
     reusePropertyDataState?: boolean;
 }

package/lib/cjs/components-react/propertygrid/PropertyDataProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyDataProvider.js","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/PropertyDataProvider.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAA8C;AAsC9C;;GAEG;AACH,MAAa,uBAAwB,SAAQ,sBAAoC;CAAI;AAArF,0DAAqF","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 { PropertyRecord } from \"@itwin/appui-abstract\";\nimport { BeEvent } from \"@itwin/core-bentley\";\n\n/**\n * Contains metadata about a group of Properties.\n * @public\n */\nexport interface PropertyCategory {\n  name: string;\n  label: string;\n  expand: boolean;\n  childCategories?: PropertyCategory[];\n  renderer?: {\n    name: string;\n  };\n}\n\n/**\n * Interface for property data provided to the PropertyGrid React component.\n * @public\n */\nexport interface PropertyData {\n  label: PropertyRecord;\n  description?: string;\n  categories: PropertyCategory[];\n  records: { [categoryName: string]: PropertyRecord[] };\n\n  /**\n   * Should state of existing property data in the component be  re-used for this property data\n   * @alpha\n   */\n  reusePropertyDataState?: boolean;\n}\n\n/** A signature for property data change listeners\n * @public\n */\nexport declare type PropertyDataChangesListener = () => void;\n\n/** An event broadcasted on property data changes\n * @public\n */\nexport class PropertyDataChangeEvent extends BeEvent<PropertyDataChangesListener> { }\n\n/**\n * An interface for property data provider which returns\n * property data and broadcasts an event when the data changes\n * @public\n */\nexport interface IPropertyDataProvider {\n  /** Returns property data. */\n  getData: (() => Promise<PropertyData>);\n  /** Property data change event. */\n  onDataChanged: PropertyDataChangeEvent;\n}\n"]}
+{"version":3,"file":"PropertyDataProvider.js","sourceRoot":"","sources":["../../../../src/components-react/propertygrid/PropertyDataProvider.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAGH,sDAA8C;AAsC9C;;GAEG;AACH,MAAa,uBAAwB,SAAQ,sBAAoC;CAAI;AAArF,0DAAqF","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 { PropertyRecord } from \"@itwin/appui-abstract\";\nimport { BeEvent } from \"@itwin/core-bentley\";\n\n/**\n * Contains metadata about a group of Properties.\n * @public\n */\nexport interface PropertyCategory {\n  name: string;\n  label: string;\n  expand: boolean;\n  childCategories?: PropertyCategory[];\n  renderer?: {\n    name: string;\n  };\n}\n\n/**\n * Interface for property data provided to the PropertyGrid React component.\n * @public\n */\nexport interface PropertyData {\n  label: PropertyRecord;\n  description?: string;\n  categories: PropertyCategory[];\n  records: { [categoryName: string]: PropertyRecord[] };\n\n  /**\n   * Should state of existing property data in the component be re-used for this property data\n   * @beta\n   */\n  reusePropertyDataState?: boolean;\n}\n\n/** A signature for property data change listeners\n * @public\n */\nexport declare type PropertyDataChangesListener = () => void;\n\n/** An event broadcasted on property data changes\n * @public\n */\nexport class PropertyDataChangeEvent extends BeEvent<PropertyDataChangesListener> { }\n\n/**\n * An interface for property data provider which returns\n * property data and broadcasts an event when the data changes\n * @public\n */\nexport interface IPropertyDataProvider {\n  /** Returns property data. */\n  getData: (() => Promise<PropertyData>);\n  /** Property data change event. */\n  onDataChanged: PropertyDataChangeEvent;\n}\n"]}

package/lib/cjs/components-react/propertygrid/component/PropertyGrid.d.ts

@@ -9,6 +9,7 @@ import { IPropertyDataProvider, PropertyCategory } from "../PropertyDataProvider
 import { CommonPropertyGridProps } from "./PropertyGridCommons";
 /** Properties for [[PropertyGrid]] React component
  * @public
+ * @deprecated in 3.x. Use [[VirtualizedPropertyGrid]] instead.
  */
 export interface PropertyGridProps extends CommonPropertyGridProps {
     /** Property data provider */
@@ -34,6 +35,7 @@ interface PropertyGridState {
 }
 /** PropertyGrid React component.
  * @public
+ * @deprecated in 3.x. Use [[VirtualizedPropertyGrid]] instead.
  */
 export declare class PropertyGrid extends React.Component<PropertyGridProps, PropertyGridState> {
     private _dataChangesListenerDisposeFunc?;

package/lib/cjs/components-react/propertygrid/component/PropertyGrid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyGrid.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/component/PropertyGrid.tsx"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,qBAAqB,CAAC;AAG7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAgB,MAAM,yBAAyB,CAAC;AAGhG,OAAO,EAAE,uBAAuB,EAAuB,MAAM,uBAAuB,CAAC;AAIrF;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,uBAAuB;IAChE,6BAA6B;IAC7B,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,UAAU,8BAA8B;IACtC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,8BAA8B,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,sCAAsC;IACtC,UAAU,EAAE,8BAA8B,EAAE,CAAC;IAC7C,mDAAmD;IACnD,WAAW,EAAE,WAAW,CAAC;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IACrF,OAAO,CAAC,+BAA+B,CAAC,CAAc;IACtD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,sBAAsB,CAAS;IAEvC,gBAAgB;gBACJ,KAAK,EAAE,iBAAiB;IASpC,gBAAgB;IACA,iBAAiB;IAQjC,gBAAgB;IACA,oBAAoB;IASpB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;IAiB/D,OAAO,CAAC,sBAAsB,CAG5B;YAEY,UAAU;IAyCxB,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,SAAS,CAEf;IAEF,OAAO,CAAC,2BAA2B,CAWjC;IAEF,OAAO,CAAC,iBAAiB;IAQzB,gBAAgB;IACA,MAAM;CA4CvB"}
+{"version":3,"file":"PropertyGrid.d.ts","sourceRoot":"","sources":["../../../../../src/components-react/propertygrid/component/PropertyGrid.tsx"],"names":[],"mappings":"AAKA;;GAEG;AACH,OAAO,qBAAqB,CAAC;AAG7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAA8B,MAAM,mBAAmB,CAAC;AAE5E,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAgB,MAAM,yBAAyB,CAAC;AAGhG,OAAO,EAAE,uBAAuB,EAAuB,MAAM,uBAAuB,CAAC;AAIrF;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,uBAAuB;IAChE,6BAA6B;IAC7B,YAAY,EAAE,qBAAqB,CAAC;CACrC;AAED,UAAU,8BAA8B;IACtC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,8BAA8B,EAAE,CAAC;CAC5C;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,sCAAsC;IACtC,UAAU,EAAE,8BAA8B,EAAE,CAAC;IAC7C,mDAAmD;IACnD,WAAW,EAAE,WAAW,CAAC;IACzB,uEAAuE;IACvE,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IACrF,OAAO,CAAC,+BAA+B,CAAC,CAAc;IACtD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,sBAAsB,CAAS;IAEvC,gBAAgB;gBACJ,KAAK,EAAE,iBAAiB;IASpC,gBAAgB;IACA,iBAAiB;IAQjC,gBAAgB;IACA,oBAAoB;IASpB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB;IAiB/D,OAAO,CAAC,sBAAsB,CAG5B;YAEY,UAAU;IAyCxB,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,SAAS,CAEf;IAEF,OAAO,CAAC,2BAA2B,CAWjC;IAEF,OAAO,CAAC,iBAAiB;IAQzB,gBAAgB;IACA,MAAM;CA4CvB"}