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

package/lib/esm/components-react/filter-builder/FilterBuilder.d.ts

@@ -1,41 +1,38 @@
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
 import * as React from "react";
 import { PropertyDescription } from "@itwin/appui-abstract";
 import { PropertyFilterBuilderRuleOperatorProps } from "./FilterBuilderRuleOperator";
 import { PropertyFilterBuilderRuleValueProps } from "./FilterBuilderRuleValue";
-import { PropertyFilterBuilderActions, PropertyFilterBuilderRuleGroupItem } from "./FilterBuilderState";
 import { PropertyFilter } from "./Types";
-/** @alpha */
+/**
+ * Props for [[PropertyFilterBuilder]] component.
+ * @beta
+ */
 export interface PropertyFilterBuilderProps {
+    /** List of properties available to be used in filter rules. */
     properties: PropertyDescription[];
+    /** Callback that is invoked when filter changes. */
     onFilterChanged: (filter?: PropertyFilter) => void;
+    /** Callback that is invoked when property is selected in any rule. */
     onRulePropertySelected?: (property: PropertyDescription) => void;
+    /** Custom renderer for rule operator selector. */
     ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;
+    /** Custom renderer for rule value input. */
     ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;
-    ruleGroupDepthLimit?: number;
+    /** Custom renderer for property selector in rule. */
     propertyRenderer?: (name: string) => React.ReactNode;
-    disablePropertySelection?: boolean;
-    initialFilter?: PropertyFilter;
-}
-/** @alpha */
-export interface PropertyFilterBuilderContextProps {
-    actions: PropertyFilterBuilderActions;
-    properties: PropertyDescription[];
-    onRulePropertySelected?: (property: PropertyDescription) => void;
+    /** Specifies how deep rule groups can be nested. */
     ruleGroupDepthLimit?: number;
+    /** Specifies whether component is disabled or not. */
+    isDisabled?: boolean;
+    /** Initial filter that should be shown when component is mounted. */
+    initialFilter?: PropertyFilter;
 }
-/** @alpha */
-export declare const PropertyFilterBuilderContext: React.Context<PropertyFilterBuilderContextProps>;
-/** @alpha */
-export interface PropertyFilterBuilderRuleRenderingContextProps {
-    ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;
-    ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;
-    propertyRenderer?: (name: string) => React.ReactNode;
-    disablePropertySelection?: boolean;
-}
-/** @alpha */
-export declare const PropertyFilterBuilderRuleRenderingContext: React.Context<PropertyFilterBuilderRuleRenderingContextProps>;
-/** @alpha */
+/**
+ * Component for building complex filters. It allows to create filter rules or rule groups based on provided list of properties.
+ * @beta
+ */
 export declare function PropertyFilterBuilder(props: PropertyFilterBuilderProps): JSX.Element;
-/** @internal */
-export declare function buildPropertyFilter(groupItem: PropertyFilterBuilderRuleGroupItem): PropertyFilter | undefined;
 //# sourceMappingURL=FilterBuilder.d.ts.map

package/lib/esm/components-react/filter-builder/FilterBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilder.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilder.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAuB,MAAM,uBAAuB,CAAC;AAEjF,OAAO,EAAE,sCAAsC,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAC6B,4BAA4B,EAC9D,kCAAkC,EACnC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC,aAAa;AACb,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,sCAAsC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,KAAK,CAAC,SAAS,CAAC;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACrD,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAED,aAAa;AACb,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,4BAA4B,CAAC;IACtC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,aAAa;AACb,eAAO,MAAM,4BAA4B,kDAAgE,CAAC;AAE1G,aAAa;AACb,MAAM,WAAW,8CAA8C;IAC7D,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,sCAAsC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,KAAK,CAAC,SAAS,CAAC;IACpF,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACrD,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,aAAa;AACb,eAAO,MAAM,yCAAyC,+DAA0E,CAAC;AAIjI,aAAa;AACb,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,eAgCtE;AAED,gBAAgB;AAChB,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,kCAAkC,GAAG,cAAc,GAAG,SAAS,CAI7G"}
+{"version":3,"file":"FilterBuilder.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilder.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAM5D,OAAO,EAAE,sCAAsC,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,+DAA+D;IAC/D,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,oDAAoD;IACpD,eAAe,EAAE,CAAC,MAAM,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,sEAAsE;IACtE,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjE,kDAAkD;IAClD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,sCAAsC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1F,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,KAAK,CAAC,SAAS,CAAC;IACpF,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACrD,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,aAAa,CAAC,EAAE,cAAc,CAAC;CAChC;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,eAgCtE"}

package/lib/esm/components-react/filter-builder/FilterBuilder.js

@@ -2,19 +2,20 @@
 * 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
+ */
 import * as React from "react";
-import { PropertyValueFormat } from "@itwin/appui-abstract";
-import { ActiveRuleGroupContext, PropertyFilterBuilderRuleGroupRenderer } from "./FilterBuilderRuleGroup";
-import { isPropertyFilterBuilderRuleGroup, usePropertyFilterBuilderState, } from "./FilterBuilderState";
-import { isUnaryPropertyFilterOperator } from "./Operators";
-/** @alpha */
-export const PropertyFilterBuilderContext = React.createContext(null);
-/** @alpha */
-export const PropertyFilterBuilderRuleRenderingContext = React.createContext({});
+import { ActiveRuleGroupContext, PropertyFilterBuilderContext, PropertyFilterBuilderRuleRenderingContext, useActiveRuleGroupContextProps, } from "./FilterBuilderContext";
+import { PropertyFilterBuilderRuleGroupRenderer } from "./FilterBuilderRuleGroup";
+import { buildPropertyFilter, usePropertyFilterBuilderState } from "./FilterBuilderState";
 const ROOT_GROUP_PATH = [];
-/** @alpha */
+/**
+ * Component for building complex filters. It allows to create filter rules or rule groups based on provided list of properties.
+ * @beta
+ */
 export function PropertyFilterBuilder(props) {
-    const { properties, onFilterChanged, onRulePropertySelected, ruleOperatorRenderer, ruleValueRenderer, ruleGroupDepthLimit, propertyRenderer, disablePropertySelection, initialFilter } = props;
+    const { properties, onFilterChanged, onRulePropertySelected, ruleOperatorRenderer, ruleValueRenderer, ruleGroupDepthLimit, propertyRenderer, isDisabled, initialFilter } = props;
     const { state, actions } = usePropertyFilterBuilderState(initialFilter);
     const rootRef = React.useRef(null);
     const firstRender = React.useRef(true);
@@ -25,73 +26,11 @@ export function PropertyFilterBuilder(props) {
         firstRender.current = false;
     }, [filter, onFilterChanged]);
     const contextValue = React.useMemo(() => ({ actions, properties, onRulePropertySelected, ruleGroupDepthLimit }), [actions, properties, onRulePropertySelected, ruleGroupDepthLimit]);
-    const renderingContextValue = React.useMemo(() => ({ ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, disablePropertySelection }), [ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, disablePropertySelection]);
+    const renderingContextValue = React.useMemo(() => ({ ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, isDisabled }), [ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, isDisabled]);
     return (React.createElement(PropertyFilterBuilderRuleRenderingContext.Provider, { value: renderingContextValue },
         React.createElement(PropertyFilterBuilderContext.Provider, { value: contextValue },
             React.createElement(ActiveRuleGroupContext.Provider, { value: useActiveRuleGroupContextProps(rootRef) },
                 React.createElement("div", { ref: rootRef, className: "filter-builder" },
                     React.createElement(PropertyFilterBuilderRuleGroupRenderer, { path: ROOT_GROUP_PATH, group: state.rootGroup }))))));
 }
-/** @internal */
-export function buildPropertyFilter(groupItem) {
-    if (isPropertyFilterBuilderRuleGroup(groupItem))
-        return buildPropertyFilterFromRuleGroup(groupItem);
-    return buildPropertyFilterFromRule(groupItem);
-}
-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 (!isUnaryPropertyFilterOperator(operator) && (value === undefined || value.valueFormat !== PropertyValueFormat.Primitive || value.value === undefined))
-        return undefined;
-    return { property, operator, value };
-}
-function useActiveRuleGroupContextProps(rootElementRef) {
-    const [activeElement, setActiveElement] = React.useState();
-    const onFocus = React.useCallback((e) => {
-        e.stopPropagation();
-        setActiveElement(e.currentTarget);
-    }, []);
-    const onBlur = React.useCallback((e) => {
-        e.stopPropagation();
-        if (activeElement !== e.currentTarget || (rootElementRef.current && rootElementRef.current.contains(e.relatedTarget)))
-            return;
-        setActiveElement(undefined);
-    }, [activeElement, rootElementRef]);
-    const onMouseOver = React.useCallback((e) => {
-        e.stopPropagation();
-        setActiveElement(e.currentTarget);
-    }, []);
-    const onMouseOut = React.useCallback((e) => {
-        e.stopPropagation();
-        // istanbul ignore if
-        if (activeElement !== e.currentTarget)
-            return;
-        setActiveElement(undefined);
-    }, [activeElement]);
-    return React.useMemo(() => ({
-        activeElement,
-        onFocus,
-        onBlur,
-        onMouseOver,
-        onMouseOut,
-    }), [activeElement, onFocus, onBlur, onMouseOver, onMouseOut]);
-}
 //# sourceMappingURL=FilterBuilder.js.map

package/lib/esm/components-react/filter-builder/FilterBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilder.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilder.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*--------------------------------------------------------------------------------------------*/\nimport * as React from \"react\";\nimport { PropertyDescription, PropertyValueFormat } from \"@itwin/appui-abstract\";\nimport { ActiveRuleGroupContext, PropertyFilterBuilderRuleGroupRenderer } from \"./FilterBuilderRuleGroup\";\nimport { PropertyFilterBuilderRuleOperatorProps } from \"./FilterBuilderRuleOperator\";\nimport { PropertyFilterBuilderRuleValueProps } from \"./FilterBuilderRuleValue\";\nimport {\n  isPropertyFilterBuilderRuleGroup, PropertyFilterBuilderActions, PropertyFilterBuilderRule, PropertyFilterBuilderRuleGroup,\n  PropertyFilterBuilderRuleGroupItem, usePropertyFilterBuilderState,\n} from \"./FilterBuilderState\";\nimport { isUnaryPropertyFilterOperator } from \"./Operators\";\nimport { PropertyFilter } from \"./Types\";\n\n/** @alpha */\nexport interface PropertyFilterBuilderProps {\n  properties: PropertyDescription[];\n  onFilterChanged: (filter?: PropertyFilter) => void;\n  onRulePropertySelected?: (property: PropertyDescription) => void;\n  ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;\n  ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;\n  ruleGroupDepthLimit?: number;\n  propertyRenderer?: (name: string) => React.ReactNode;\n  disablePropertySelection?: boolean;\n  initialFilter?: PropertyFilter;\n}\n\n/** @alpha */\nexport interface PropertyFilterBuilderContextProps {\n  actions: PropertyFilterBuilderActions;\n  properties: PropertyDescription[];\n  onRulePropertySelected?: (property: PropertyDescription) => void;\n  ruleGroupDepthLimit?: number;\n}\n\n/** @alpha */\nexport const PropertyFilterBuilderContext = React.createContext<PropertyFilterBuilderContextProps>(null!);\n\n/** @alpha */\nexport interface PropertyFilterBuilderRuleRenderingContextProps {\n  ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;\n  ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;\n  propertyRenderer?: (name: string) => React.ReactNode;\n  disablePropertySelection?: boolean;\n}\n\n/** @alpha */\nexport const PropertyFilterBuilderRuleRenderingContext = React.createContext<PropertyFilterBuilderRuleRenderingContextProps>({});\n\nconst ROOT_GROUP_PATH: string[] = [];\n\n/** @alpha */\nexport function PropertyFilterBuilder(props: PropertyFilterBuilderProps) {\n  const { properties, onFilterChanged, onRulePropertySelected, ruleOperatorRenderer, ruleValueRenderer, ruleGroupDepthLimit, propertyRenderer, disablePropertySelection, initialFilter } = props;\n  const { state, actions } = usePropertyFilterBuilderState(initialFilter);\n  const rootRef = React.useRef<HTMLDivElement>(null);\n\n  const firstRender = React.useRef(true);\n  const filter = React.useMemo(() => buildPropertyFilter(state.rootGroup), [state]);\n  React.useEffect(() => {\n    if (!firstRender.current)\n      onFilterChanged(filter);\n    firstRender.current = false;\n  }, [filter, onFilterChanged]);\n\n  const contextValue = React.useMemo<PropertyFilterBuilderContextProps>(\n    () => ({ actions, properties, onRulePropertySelected, ruleGroupDepthLimit }),\n    [actions, properties, onRulePropertySelected, ruleGroupDepthLimit]\n  );\n  const renderingContextValue = React.useMemo<PropertyFilterBuilderRuleRenderingContextProps>(\n    () => ({ ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, disablePropertySelection }),\n    [ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, disablePropertySelection]\n  );\n  return (\n    <PropertyFilterBuilderRuleRenderingContext.Provider value={renderingContextValue}>\n      <PropertyFilterBuilderContext.Provider value={contextValue}>\n        <ActiveRuleGroupContext.Provider value={useActiveRuleGroupContextProps(rootRef)}>\n          <div ref={rootRef} className=\"filter-builder\">\n            <PropertyFilterBuilderRuleGroupRenderer path={ROOT_GROUP_PATH} group={state.rootGroup} />\n          </div>\n        </ActiveRuleGroupContext.Provider>\n      </PropertyFilterBuilderContext.Provider>\n    </PropertyFilterBuilderRuleRenderingContext.Provider>\n  );\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 useActiveRuleGroupContextProps(rootElementRef: React.RefObject<HTMLElement>) {\n  const [activeElement, setActiveElement] = React.useState<HTMLElement | undefined>();\n\n  const onFocus: React.FocusEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    setActiveElement(e.currentTarget);\n  }, []);\n\n  const onBlur: React.FocusEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    if (activeElement !== e.currentTarget || (rootElementRef.current && rootElementRef.current.contains(e.relatedTarget)))\n      return;\n\n    setActiveElement(undefined);\n  }, [activeElement, rootElementRef]);\n\n  const onMouseOver: React.MouseEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    setActiveElement(e.currentTarget);\n  }, []);\n\n  const onMouseOut: React.MouseEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    // istanbul ignore if\n    if (activeElement !== e.currentTarget)\n      return;\n\n    setActiveElement(undefined);\n  }, [activeElement]);\n\n  return React.useMemo(() => ({\n    activeElement,\n    onFocus,\n    onBlur,\n    onMouseOver,\n    onMouseOut,\n  }), [activeElement, onFocus, onBlur, onMouseOver, onMouseOut]);\n}\n"]}
+{"version":3,"file":"FilterBuilder.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilder.tsx"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EACL,sBAAsB,EAAE,4BAA4B,EAAqC,yCAAyC,EAClF,8BAA8B,GAC/E,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sCAAsC,EAAE,MAAM,0BAA0B,CAAC;AAGlF,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AA4B1F,MAAM,eAAe,GAAa,EAAE,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAiC;IACrE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IACjL,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,6BAA6B,CAAC,aAAa,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAiB,IAAI,CAAC,CAAC;IAEnD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC,WAAW,CAAC,OAAO;YACtB,eAAe,CAAC,MAAM,CAAC,CAAC;QAC1B,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC;IAC9B,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IAE9B,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAChC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,CAAC,EAC5E,CAAC,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,mBAAmB,CAAC,CACnE,CAAC;IACF,MAAM,qBAAqB,GAAG,KAAK,CAAC,OAAO,CACzC,GAAG,EAAE,CAAC,CAAC,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,CAAC,EACjF,CAAC,oBAAoB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,CAAC,CACxE,CAAC;IACF,OAAO,CACL,oBAAC,yCAAyC,CAAC,QAAQ,IAAC,KAAK,EAAE,qBAAqB;QAC9E,oBAAC,4BAA4B,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY;YACxD,oBAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,8BAA8B,CAAC,OAAO,CAAC;gBAC7E,6BAAK,GAAG,EAAE,OAAO,EAAE,SAAS,EAAC,gBAAgB;oBAC3C,oBAAC,sCAAsC,IAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,GAAI,CACrF,CAC0B,CACI,CACW,CACtD,CAAC;AACJ,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 PropertyFilterBuilder\n */\n\nimport * as React from \"react\";\nimport { PropertyDescription } from \"@itwin/appui-abstract\";\nimport {\n  ActiveRuleGroupContext, PropertyFilterBuilderContext, PropertyFilterBuilderContextProps, PropertyFilterBuilderRuleRenderingContext,\n  PropertyFilterBuilderRuleRenderingContextProps, useActiveRuleGroupContextProps,\n} from \"./FilterBuilderContext\";\nimport { PropertyFilterBuilderRuleGroupRenderer } from \"./FilterBuilderRuleGroup\";\nimport { PropertyFilterBuilderRuleOperatorProps } from \"./FilterBuilderRuleOperator\";\nimport { PropertyFilterBuilderRuleValueProps } from \"./FilterBuilderRuleValue\";\nimport { buildPropertyFilter, usePropertyFilterBuilderState } from \"./FilterBuilderState\";\nimport { PropertyFilter } from \"./Types\";\n\n/**\n * Props for [[PropertyFilterBuilder]] component.\n * @beta\n */\nexport interface PropertyFilterBuilderProps {\n  /** List of properties available to be used in filter rules. */\n  properties: PropertyDescription[];\n  /** Callback that is invoked when filter changes. */\n  onFilterChanged: (filter?: PropertyFilter) => void;\n  /** Callback that is invoked when property is selected in any rule. */\n  onRulePropertySelected?: (property: PropertyDescription) => void;\n  /** Custom renderer for rule operator selector. */\n  ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;\n  /** Custom renderer for rule value input. */\n  ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;\n  /** Custom renderer for property selector in rule. */\n  propertyRenderer?: (name: string) => React.ReactNode;\n  /** Specifies how deep rule groups can be nested. */\n  ruleGroupDepthLimit?: number;\n  /** Specifies whether component is disabled or not. */\n  isDisabled?: boolean;\n  /** Initial filter that should be shown when component is mounted. */\n  initialFilter?: PropertyFilter;\n}\n\nconst ROOT_GROUP_PATH: string[] = [];\n\n/**\n * Component for building complex filters. It allows to create filter rules or rule groups based on provided list of properties.\n * @beta\n */\nexport function PropertyFilterBuilder(props: PropertyFilterBuilderProps) {\n  const { properties, onFilterChanged, onRulePropertySelected, ruleOperatorRenderer, ruleValueRenderer, ruleGroupDepthLimit, propertyRenderer, isDisabled, initialFilter } = props;\n  const { state, actions } = usePropertyFilterBuilderState(initialFilter);\n  const rootRef = React.useRef<HTMLDivElement>(null);\n\n  const firstRender = React.useRef(true);\n  const filter = React.useMemo(() => buildPropertyFilter(state.rootGroup), [state]);\n  React.useEffect(() => {\n    if (!firstRender.current)\n      onFilterChanged(filter);\n    firstRender.current = false;\n  }, [filter, onFilterChanged]);\n\n  const contextValue = React.useMemo<PropertyFilterBuilderContextProps>(\n    () => ({ actions, properties, onRulePropertySelected, ruleGroupDepthLimit }),\n    [actions, properties, onRulePropertySelected, ruleGroupDepthLimit]\n  );\n  const renderingContextValue = React.useMemo<PropertyFilterBuilderRuleRenderingContextProps>(\n    () => ({ ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, isDisabled }),\n    [ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, isDisabled]\n  );\n  return (\n    <PropertyFilterBuilderRuleRenderingContext.Provider value={renderingContextValue}>\n      <PropertyFilterBuilderContext.Provider value={contextValue}>\n        <ActiveRuleGroupContext.Provider value={useActiveRuleGroupContextProps(rootRef)}>\n          <div ref={rootRef} className=\"filter-builder\">\n            <PropertyFilterBuilderRuleGroupRenderer path={ROOT_GROUP_PATH} group={state.rootGroup} />\n          </div>\n        </ActiveRuleGroupContext.Provider>\n      </PropertyFilterBuilderContext.Provider>\n    </PropertyFilterBuilderRuleRenderingContext.Provider>\n  );\n}\n"]}

package/lib/esm/components-react/filter-builder/FilterBuilderContext.d.ts

@@ -0,0 +1,80 @@
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
+import * as React from "react";
+import { PropertyDescription } from "@itwin/appui-abstract";
+import { PropertyFilterBuilderActions } from "./FilterBuilderState";
+import { PropertyFilterBuilderRuleOperatorProps } from "./FilterBuilderRuleOperator";
+import { PropertyFilterBuilderRuleValueProps } from "./FilterBuilderRuleValue";
+/**
+ * Data structure that describes [[PropertyFilterBuilderContext]] value.
+ * @internal
+ */
+export interface PropertyFilterBuilderContextProps {
+    /** Actions for modifying [[PropertyFilterBuilder]] state. */
+    actions: PropertyFilterBuilderActions;
+    /** List of available properties. */
+    properties: PropertyDescription[];
+    /** Callback to invoke when property is selected in any rule. */
+    onRulePropertySelected?: (property: PropertyDescription) => void;
+    /** Specifies how deep rule groups can be nested. */
+    ruleGroupDepthLimit?: number;
+}
+/**
+ * Context used to store data for rules and rule groups rendered inside [[PropertyFilterBuilder]] component.
+ * @internal
+ */
+export declare const PropertyFilterBuilderContext: React.Context<PropertyFilterBuilderContextProps>;
+/**
+ * Data structure that describes [[PropertyFilterBuilderRuleRenderingContext]] value.
+ * @internal
+ */
+export interface PropertyFilterBuilderRuleRenderingContextProps {
+    /** Custom renderer for operator selector in rule. */
+    ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;
+    /** Custom renderer for value input in rule. */
+    ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;
+    /** Custom renderer for property selector in rule. */
+    propertyRenderer?: (name: string) => React.ReactNode;
+    /** Specifies that properties selection is disabled. */
+    isDisabled?: boolean;
+}
+/**
+ * Context for rendering rules and rule groups inside [[PropertyFilterBuilder]] component.
+ * @internal
+ */
+export declare const PropertyFilterBuilderRuleRenderingContext: React.Context<PropertyFilterBuilderRuleRenderingContextProps>;
+/**
+ * Data structure that describes value of [[ActiveRuleGroupContext]].
+ * @internal
+ */
+export interface ActiveRuleGroupContextProps {
+    /** Element of currently active rule group. */
+    activeElement: HTMLElement | undefined;
+    /** Even handler for rule group element 'onFocus' event */
+    onFocus: React.FocusEventHandler<HTMLElement>;
+    /** Even handler for rule group element 'onBlur' event */
+    onBlur: React.FocusEventHandler<HTMLElement>;
+    /** Even handler for rule group element 'onMouseOver' event */
+    onMouseOver: React.MouseEventHandler<HTMLElement>;
+    /** Even handler for rule group element 'onMouseOut' event */
+    onMouseOut: React.MouseEventHandler<HTMLElement>;
+}
+/**
+ * Context for tracking and storing active rule group in [[PropertyFilterBuilder]].
+ * Group is considered active if it is focused or hovered.
+ * @internal
+ */
+export declare const ActiveRuleGroupContext: React.Context<ActiveRuleGroupContextProps>;
+/**
+ * Custom hook that created value for [[ActiveRuleGroupContext]].
+ * @internal
+ */
+export declare function useActiveRuleGroupContextProps(rootElementRef: React.RefObject<HTMLElement>): {
+    activeElement: HTMLElement | undefined;
+    onFocus: React.FocusEventHandler<HTMLElement>;
+    onBlur: React.FocusEventHandler<HTMLElement>;
+    onMouseOver: React.MouseEventHandler<HTMLElement>;
+    onMouseOut: React.MouseEventHandler<HTMLElement>;
+};
+//# sourceMappingURL=FilterBuilderContext.d.ts.map

package/lib/esm/components-react/filter-builder/FilterBuilderContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterBuilderContext.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderContext.tsx"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,sCAAsC,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,EAAE,mCAAmC,EAAE,MAAM,0BAA0B,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,iCAAiC;IAChD,6DAA6D;IAC7D,OAAO,EAAE,4BAA4B,CAAC;IACtC,oCAAoC;IACpC,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,IAAI,CAAC;IACjE,oDAAoD;IACpD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,kDAAgE,CAAC;AAE1G;;;GAGG;AACH,MAAM,WAAW,8CAA8C;IAC7D,qDAAqD;IACrD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,sCAAsC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC1F,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,mCAAmC,KAAK,KAAK,CAAC,SAAS,CAAC;IACpF,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACrD,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,yCAAyC,+DAA0E,CAAC;AAEjI;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,8CAA8C;IAC9C,aAAa,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,0DAA0D;IAC1D,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,yDAAyD;IACzD,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC7C,8DAA8D;IAC9D,WAAW,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAClD,6DAA6D;IAC7D,UAAU,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAClD;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,4CAA0D,CAAC;AAE9F;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC;;;;;;EAqC1F"}

package/lib/esm/components-react/filter-builder/FilterBuilderContext.js

@@ -0,0 +1,60 @@
+/*---------------------------------------------------------------------------------------------
+* 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
+ */
+import * as React from "react";
+/**
+ * Context used to store data for rules and rule groups rendered inside [[PropertyFilterBuilder]] component.
+ * @internal
+ */
+export const PropertyFilterBuilderContext = React.createContext(null);
+/**
+ * Context for rendering rules and rule groups inside [[PropertyFilterBuilder]] component.
+ * @internal
+ */
+export const PropertyFilterBuilderRuleRenderingContext = React.createContext({});
+/**
+ * Context for tracking and storing active rule group in [[PropertyFilterBuilder]].
+ * Group is considered active if it is focused or hovered.
+ * @internal
+ */
+export const ActiveRuleGroupContext = React.createContext(null);
+/**
+ * Custom hook that created value for [[ActiveRuleGroupContext]].
+ * @internal
+ */
+export function useActiveRuleGroupContextProps(rootElementRef) {
+    const [activeElement, setActiveElement] = React.useState();
+    const onFocus = React.useCallback((e) => {
+        e.stopPropagation();
+        setActiveElement(e.currentTarget);
+    }, []);
+    const onBlur = React.useCallback((e) => {
+        e.stopPropagation();
+        if (activeElement !== e.currentTarget || (rootElementRef.current && rootElementRef.current.contains(e.relatedTarget)))
+            return;
+        setActiveElement(undefined);
+    }, [activeElement, rootElementRef]);
+    const onMouseOver = React.useCallback((e) => {
+        e.stopPropagation();
+        setActiveElement(e.currentTarget);
+    }, []);
+    const onMouseOut = React.useCallback((e) => {
+        e.stopPropagation();
+        // istanbul ignore if
+        if (activeElement !== e.currentTarget)
+            return;
+        setActiveElement(undefined);
+    }, [activeElement]);
+    return React.useMemo(() => ({
+        activeElement,
+        onFocus,
+        onBlur,
+        onMouseOver,
+        onMouseOut,
+    }), [activeElement, onFocus, onBlur, onMouseOver, onMouseOut]);
+}
+//# sourceMappingURL=FilterBuilderContext.js.map

package/lib/esm/components-react/filter-builder/FilterBuilderContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterBuilderContext.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderContext.tsx"],"names":[],"mappings":"AAAA;;;+FAG+F;AAC/F;;GAEG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAqB/B;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC,aAAa,CAAoC,IAAK,CAAC,CAAC;AAiB1G;;;GAGG;AACH,MAAM,CAAC,MAAM,yCAAyC,GAAG,KAAK,CAAC,aAAa,CAAiD,EAAE,CAAC,CAAC;AAmBjI;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC,aAAa,CAA8B,IAAK,CAAC,CAAC;AAE9F;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,cAA4C;IACzF,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,EAA2B,CAAC;IAEpF,MAAM,OAAO,GAAyC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5E,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,MAAM,GAAyC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3E,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,IAAI,aAAa,KAAK,CAAC,CAAC,aAAa,IAAI,CAAC,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;YACnH,OAAO;QAET,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC,EAAE,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC,CAAC;IAEpC,MAAM,WAAW,GAAyC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QAChF,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IACpC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,UAAU,GAAyC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE;QAC/E,CAAC,CAAC,eAAe,EAAE,CAAC;QACpB,qBAAqB;QACrB,IAAI,aAAa,KAAK,CAAC,CAAC,aAAa;YACnC,OAAO;QAET,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC;IAEpB,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,aAAa;QACb,OAAO;QACP,MAAM;QACN,WAAW;QACX,UAAU;KACX,CAAC,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;AACjE,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 PropertyFilterBuilder\n */\n\nimport * as React from \"react\";\nimport { PropertyDescription } from \"@itwin/appui-abstract\";\nimport { PropertyFilterBuilderActions } from \"./FilterBuilderState\";\nimport { PropertyFilterBuilderRuleOperatorProps } from \"./FilterBuilderRuleOperator\";\nimport { PropertyFilterBuilderRuleValueProps } from \"./FilterBuilderRuleValue\";\n\n/**\n * Data structure that describes [[PropertyFilterBuilderContext]] value.\n * @internal\n */\nexport interface PropertyFilterBuilderContextProps {\n  /** Actions for modifying [[PropertyFilterBuilder]] state. */\n  actions: PropertyFilterBuilderActions;\n  /** List of available properties. */\n  properties: PropertyDescription[];\n  /** Callback to invoke when property is selected in any rule. */\n  onRulePropertySelected?: (property: PropertyDescription) => void;\n  /** Specifies how deep rule groups can be nested. */\n  ruleGroupDepthLimit?: number;\n}\n\n/**\n * Context used to store data for rules and rule groups rendered inside [[PropertyFilterBuilder]] component.\n * @internal\n */\nexport const PropertyFilterBuilderContext = React.createContext<PropertyFilterBuilderContextProps>(null!);\n\n/**\n * Data structure that describes [[PropertyFilterBuilderRuleRenderingContext]] value.\n * @internal\n */\nexport interface PropertyFilterBuilderRuleRenderingContextProps {\n  /** Custom renderer for operator selector in rule. */\n  ruleOperatorRenderer?: (props: PropertyFilterBuilderRuleOperatorProps) => React.ReactNode;\n  /** Custom renderer for value input in rule. */\n  ruleValueRenderer?: (props: PropertyFilterBuilderRuleValueProps) => React.ReactNode;\n  /** Custom renderer for property selector in rule. */\n  propertyRenderer?: (name: string) => React.ReactNode;\n  /** Specifies that properties selection is disabled. */\n  isDisabled?: boolean;\n}\n\n/**\n * Context for rendering rules and rule groups inside [[PropertyFilterBuilder]] component.\n * @internal\n */\nexport const PropertyFilterBuilderRuleRenderingContext = React.createContext<PropertyFilterBuilderRuleRenderingContextProps>({});\n\n/**\n * Data structure that describes value of [[ActiveRuleGroupContext]].\n * @internal\n */\nexport interface ActiveRuleGroupContextProps {\n  /** Element of currently active rule group. */\n  activeElement: HTMLElement | undefined;\n  /** Even handler for rule group element 'onFocus' event */\n  onFocus: React.FocusEventHandler<HTMLElement>;\n  /** Even handler for rule group element 'onBlur' event */\n  onBlur: React.FocusEventHandler<HTMLElement>;\n  /** Even handler for rule group element 'onMouseOver' event */\n  onMouseOver: React.MouseEventHandler<HTMLElement>;\n  /** Even handler for rule group element 'onMouseOut' event */\n  onMouseOut: React.MouseEventHandler<HTMLElement>;\n}\n\n/**\n * Context for tracking and storing active rule group in [[PropertyFilterBuilder]].\n * Group is considered active if it is focused or hovered.\n * @internal\n */\nexport const ActiveRuleGroupContext = React.createContext<ActiveRuleGroupContextProps>(null!);\n\n/**\n * Custom hook that created value for [[ActiveRuleGroupContext]].\n * @internal\n */\nexport function useActiveRuleGroupContextProps(rootElementRef: React.RefObject<HTMLElement>) {\n  const [activeElement, setActiveElement] = React.useState<HTMLElement | undefined>();\n\n  const onFocus: React.FocusEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    setActiveElement(e.currentTarget);\n  }, []);\n\n  const onBlur: React.FocusEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    if (activeElement !== e.currentTarget || (rootElementRef.current && rootElementRef.current.contains(e.relatedTarget)))\n      return;\n\n    setActiveElement(undefined);\n  }, [activeElement, rootElementRef]);\n\n  const onMouseOver: React.MouseEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    setActiveElement(e.currentTarget);\n  }, []);\n\n  const onMouseOut: React.MouseEventHandler<HTMLElement> = React.useCallback((e) => {\n    e.stopPropagation();\n    // istanbul ignore if\n    if (activeElement !== e.currentTarget)\n      return;\n\n    setActiveElement(undefined);\n  }, [activeElement]);\n\n  return React.useMemo(() => ({\n    activeElement,\n    onFocus,\n    onBlur,\n    onMouseOver,\n    onMouseOut,\n  }), [activeElement, onFocus, onBlur, onMouseOver, onMouseOut]);\n}\n"]}

package/lib/esm/components-react/filter-builder/FilterBuilderRule.d.ts

@@ -1,11 +1,22 @@
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
 /// <reference types="react" />
-import { PropertyFilterBuilderRule } from "./FilterBuilderState";
 import "./FilterBuilderRule.scss";
-/** @alpha */
+import { PropertyFilterBuilderRule } from "./FilterBuilderState";
+/**
+ * Props for [[PropertyFilterBuilderRuleRenderer]] component.
+ * @internal
+ */
 export interface PropertyFilterBuilderRuleRendererProps {
+    /** Path from [[PropertyFilterBuilder]] root to this rule. */
     path: string[];
+    /** Rule to render. */
     rule: PropertyFilterBuilderRule;
 }
-/** @alpha */
+/**
+ * Component that renders single rule in [[PropertyFilterBuilder]] component.
+ * @internal
+ */
 export declare function PropertyFilterBuilderRuleRenderer(props: PropertyFilterBuilderRuleRendererProps): JSX.Element;
 //# sourceMappingURL=FilterBuilderRule.d.ts.map

package/lib/esm/components-react/filter-builder/FilterBuilderRule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilderRule.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderRule.tsx"],"names":[],"mappings":";AAYA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,OAAO,0BAA0B,CAAC;AAElC,aAAa;AACb,MAAM,WAAW,sCAAsC;IACrD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,yBAAyB,CAAC;CACjC;AAED,aAAa;AACb,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,sCAAsC,eAsD9F"}
+{"version":3,"file":"FilterBuilderRule.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderRule.tsx"],"names":[],"mappings":"AAIA;;GAEG;;AAEH,OAAO,0BAA0B,CAAC;AASlC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAGjE;;;GAGG;AACH,MAAM,WAAW,sCAAsC;IACrD,6DAA6D;IAC7D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,yBAAyB,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,sCAAsC,eA8D9F"}

package/lib/esm/components-react/filter-builder/FilterBuilderRule.js

@@ -2,20 +2,26 @@
 * 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
+ */
+import "./FilterBuilderRule.scss";
 import * as React from "react";
 import { SvgDelete } from "@itwin/itwinui-icons-react";
 import { IconButton } from "@itwin/itwinui-react";
-import { PropertyFilterBuilderContext, PropertyFilterBuilderRuleRenderingContext } from "./FilterBuilder";
+import { PropertyFilterBuilderContext, PropertyFilterBuilderRuleRenderingContext } from "./FilterBuilderContext";
 import { PropertyFilterBuilderRuleOperator } from "./FilterBuilderRuleOperator";
 import { PropertyFilterBuilderRuleProperty } from "./FilterBuilderRuleProperty";
 import { PropertyFilterBuilderRuleValue } from "./FilterBuilderRuleValue";
 import { isUnaryPropertyFilterOperator } from "./Operators";
-import "./FilterBuilderRule.scss";
-/** @alpha */
+/**
+ * Component that renders single rule in [[PropertyFilterBuilder]] component.
+ * @internal
+ */
 export function PropertyFilterBuilderRuleRenderer(props) {
     const { path, rule } = props;
     const { properties, actions, onRulePropertySelected } = React.useContext(PropertyFilterBuilderContext);
-    const { ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, disablePropertySelection } = React.useContext(PropertyFilterBuilderRuleRenderingContext);
+    const { ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, isDisabled } = React.useContext(PropertyFilterBuilderRuleRenderingContext);
     const { property, operator, value } = rule;
     const onSelectedPropertyChanged = React.useCallback((newProperty) => {
         actions.setRuleProperty(path, newProperty);
@@ -46,8 +52,12 @@ export function PropertyFilterBuilderRuleRenderer(props) {
             React.createElement(IconButton, { onClick: removeRule, styleType: "borderless", size: "small" },
                 React.createElement(SvgDelete, null))),
         React.createElement("div", { className: "rule-condition" },
-            React.createElement(PropertyFilterBuilderRuleProperty, { properties: properties, selectedProperty: rule.property, onSelectedPropertyChanged: onSelectedPropertyChanged, propertyRenderer: propertyRenderer, isDisabled: disablePropertySelection }),
-            property && operatorRenderer(property),
-            property && operator && !isUnaryPropertyFilterOperator(operator) && valueRenderer(property)));
+            React.createElement(PropertyFilterBuilderRuleProperty, { properties: properties, selectedProperty: rule.property, onSelectedPropertyChanged: onSelectedPropertyChanged, propertyRenderer: propertyRenderer, isDisabled: isDisabled }),
+            property !== undefined
+                ? operatorRenderer(property)
+                : null,
+            property !== undefined && operator !== undefined && !isUnaryPropertyFilterOperator(operator)
+                ? valueRenderer(property)
+                : null));
 }
 //# sourceMappingURL=FilterBuilderRule.js.map

package/lib/esm/components-react/filter-builder/FilterBuilderRule.js.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilderRule.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderRule.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*--------------------------------------------------------------------------------------------*/\nimport * as React from \"react\";\nimport { PropertyDescription, PropertyValue } from \"@itwin/appui-abstract\";\nimport { SvgDelete } from \"@itwin/itwinui-icons-react\";\nimport { IconButton } from \"@itwin/itwinui-react\";\nimport { PropertyFilterBuilderContext, PropertyFilterBuilderRuleRenderingContext } from \"./FilterBuilder\";\nimport { PropertyFilterBuilderRuleOperator } from \"./FilterBuilderRuleOperator\";\nimport { PropertyFilterBuilderRuleProperty } from \"./FilterBuilderRuleProperty\";\nimport { PropertyFilterBuilderRuleValue } from \"./FilterBuilderRuleValue\";\nimport { PropertyFilterBuilderRule } from \"./FilterBuilderState\";\nimport { isUnaryPropertyFilterOperator, PropertyFilterRuleOperator } from \"./Operators\";\nimport \"./FilterBuilderRule.scss\";\n\n/** @alpha */\nexport interface PropertyFilterBuilderRuleRendererProps {\n  path: string[];\n  rule: PropertyFilterBuilderRule;\n}\n\n/** @alpha */\nexport function PropertyFilterBuilderRuleRenderer(props: PropertyFilterBuilderRuleRendererProps) {\n  const { path, rule } = props;\n  const { properties, actions, onRulePropertySelected } = React.useContext(PropertyFilterBuilderContext);\n  const { ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, disablePropertySelection } = React.useContext(PropertyFilterBuilderRuleRenderingContext);\n  const { property, operator, value } = rule;\n\n  const onSelectedPropertyChanged = React.useCallback((newProperty?: PropertyDescription) => {\n    actions.setRuleProperty(path, newProperty);\n    // invoke 'onRulePropertySelected' when new property is selected. There is no way to deselect property\n    // so 'newProperty' will be 'undefined' only if selected property is no longer in 'properties' list.\n    if (onRulePropertySelected && newProperty)\n      onRulePropertySelected(newProperty);\n  }, [path, onRulePropertySelected, actions]);\n\n  const onRuleOperatorChange = React.useCallback((newOperator: PropertyFilterRuleOperator) => {\n    actions.setRuleOperator(path, newOperator);\n  }, [path, actions]);\n\n  const onRuleValueChange = React.useCallback((newValue: PropertyValue) => {\n    actions.setRuleValue(path, newValue);\n  }, [path, actions]);\n\n  const removeRule = () => actions.removeItem(path);\n\n  const operatorRenderer = React.useCallback((prop: PropertyDescription) => {\n    if (ruleOperatorRenderer)\n      return ruleOperatorRenderer({ property: prop, operator, onChange: onRuleOperatorChange });\n    return <PropertyFilterBuilderRuleOperator property={prop} onChange={onRuleOperatorChange} operator={operator} />;\n  }, [operator, ruleOperatorRenderer, onRuleOperatorChange]);\n\n  const valueRenderer = React.useCallback((prop: PropertyDescription) => {\n    if (ruleValueRenderer)\n      return ruleValueRenderer({ property: prop, value, onChange: onRuleValueChange });\n    return <PropertyFilterBuilderRuleValue property={prop} onChange={onRuleValueChange} value={value} />;\n  }, [value, ruleValueRenderer, onRuleValueChange]);\n\n  return <div className=\"rule\">\n    <div className=\"rule-remove-action\">\n      <IconButton onClick={removeRule} styleType=\"borderless\" size=\"small\">\n        <SvgDelete />\n      </IconButton>\n    </div>\n    <div className=\"rule-condition\">\n      <PropertyFilterBuilderRuleProperty\n        properties={properties}\n        selectedProperty={rule.property}\n        onSelectedPropertyChanged={onSelectedPropertyChanged}\n        propertyRenderer={propertyRenderer}\n        isDisabled={disablePropertySelection}\n      />\n      {property && operatorRenderer(property)}\n      {property && operator && !isUnaryPropertyFilterOperator(operator) && valueRenderer(property)}\n    </div>\n  </div>;\n}\n"]}
+{"version":3,"file":"FilterBuilderRule.js","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderRule.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 PropertyFilterBuilder\n */\n\nimport \"./FilterBuilderRule.scss\";\nimport * as React from \"react\";\nimport { PropertyDescription, PropertyValue } from \"@itwin/appui-abstract\";\nimport { SvgDelete } from \"@itwin/itwinui-icons-react\";\nimport { IconButton } from \"@itwin/itwinui-react\";\nimport { PropertyFilterBuilderContext, PropertyFilterBuilderRuleRenderingContext } from \"./FilterBuilderContext\";\nimport { PropertyFilterBuilderRuleOperator } from \"./FilterBuilderRuleOperator\";\nimport { PropertyFilterBuilderRuleProperty } from \"./FilterBuilderRuleProperty\";\nimport { PropertyFilterBuilderRuleValue } from \"./FilterBuilderRuleValue\";\nimport { PropertyFilterBuilderRule } from \"./FilterBuilderState\";\nimport { isUnaryPropertyFilterOperator, PropertyFilterRuleOperator } from \"./Operators\";\n\n/**\n * Props for [[PropertyFilterBuilderRuleRenderer]] component.\n * @internal\n */\nexport interface PropertyFilterBuilderRuleRendererProps {\n  /** Path from [[PropertyFilterBuilder]] root to this rule. */\n  path: string[];\n  /** Rule to render. */\n  rule: PropertyFilterBuilderRule;\n}\n\n/**\n * Component that renders single rule in [[PropertyFilterBuilder]] component.\n * @internal\n */\nexport function PropertyFilterBuilderRuleRenderer(props: PropertyFilterBuilderRuleRendererProps) {\n  const { path, rule } = props;\n  const { properties, actions, onRulePropertySelected } = React.useContext(PropertyFilterBuilderContext);\n  const { ruleOperatorRenderer, ruleValueRenderer, propertyRenderer, isDisabled } = React.useContext(PropertyFilterBuilderRuleRenderingContext);\n  const { property, operator, value } = rule;\n\n  const onSelectedPropertyChanged = React.useCallback((newProperty?: PropertyDescription) => {\n    actions.setRuleProperty(path, newProperty);\n    // invoke 'onRulePropertySelected' when new property is selected. There is no way to deselect property\n    // so 'newProperty' will be 'undefined' only if selected property is no longer in 'properties' list.\n    if (onRulePropertySelected && newProperty)\n      onRulePropertySelected(newProperty);\n  }, [path, onRulePropertySelected, actions]);\n\n  const onRuleOperatorChange = React.useCallback((newOperator: PropertyFilterRuleOperator) => {\n    actions.setRuleOperator(path, newOperator);\n  }, [path, actions]);\n\n  const onRuleValueChange = React.useCallback((newValue: PropertyValue) => {\n    actions.setRuleValue(path, newValue);\n  }, [path, actions]);\n\n  const removeRule = () => actions.removeItem(path);\n\n  const operatorRenderer = React.useCallback((prop: PropertyDescription) => {\n    if (ruleOperatorRenderer)\n      return ruleOperatorRenderer({ property: prop, operator, onChange: onRuleOperatorChange });\n    return <PropertyFilterBuilderRuleOperator property={prop} onChange={onRuleOperatorChange} operator={operator} />;\n  }, [operator, ruleOperatorRenderer, onRuleOperatorChange]);\n\n  const valueRenderer = React.useCallback((prop: PropertyDescription) => {\n    if (ruleValueRenderer)\n      return ruleValueRenderer({ property: prop, value, onChange: onRuleValueChange });\n    return <PropertyFilterBuilderRuleValue property={prop} onChange={onRuleValueChange} value={value} />;\n  }, [value, ruleValueRenderer, onRuleValueChange]);\n\n  return <div className=\"rule\">\n    <div className=\"rule-remove-action\">\n      <IconButton onClick={removeRule} styleType=\"borderless\" size=\"small\">\n        <SvgDelete />\n      </IconButton>\n    </div>\n    <div className=\"rule-condition\">\n      <PropertyFilterBuilderRuleProperty\n        properties={properties}\n        selectedProperty={rule.property}\n        onSelectedPropertyChanged={onSelectedPropertyChanged}\n        propertyRenderer={propertyRenderer}\n        isDisabled={isDisabled}\n      />\n      {\n        property !== undefined\n          ? operatorRenderer(property)\n          : null\n      }\n      {\n        property !== undefined && operator !== undefined && !isUnaryPropertyFilterOperator(operator)\n          ? valueRenderer(property)\n          : null\n      }\n    </div>\n  </div>;\n}\n"]}

package/lib/esm/components-react/filter-builder/FilterBuilderRule.scss

@@ -37,4 +37,8 @@
   &:first-child {
     padding-top: 14px;
   }
+
+  &:only-child {
+    padding-top: 3px;
+  }
 }

package/lib/esm/components-react/filter-builder/FilterBuilderRuleGroup.d.ts

@@ -1,29 +1,38 @@
-import * as React from "react";
+/** @packageDocumentation
+ * @module PropertyFilterBuilder
+ */
+/// <reference types="react" />
+import "./FilterBuilderRuleGroup.scss";
 import { PropertyFilterBuilderRuleGroup } from "./FilterBuilderState";
 import { PropertyFilterRuleGroupOperator } from "./Operators";
-import "./FilterBuilderRuleGroup.scss";
-/** @alpha */
-export interface ActiveRuleGroupContextProps {
-    activeElement: HTMLElement | undefined;
-    onFocus: React.FocusEventHandler<HTMLElement>;
-    onBlur: React.FocusEventHandler<HTMLElement>;
-    onMouseOver: React.MouseEventHandler<HTMLElement>;
-    onMouseOut: React.MouseEventHandler<HTMLElement>;
-}
-/** @alpha */
-export declare const ActiveRuleGroupContext: React.Context<ActiveRuleGroupContextProps>;
-/** @alpha */
+/**
+ * Props for [[PropertyFilterBuilderRuleGroupRenderer]] component.
+ * @internal
+ */
 export interface PropertyFilterBuilderRuleGroupRendererProps {
+    /** Path from [[PropertyFilterBuilder]] root to this rule group. */
     path: string[];
+    /** Rule group to render. */
     group: PropertyFilterBuilderRuleGroup;
 }
-/** @alpha */
+/**
+ * Component that renders group of rules in [[PropertyFilterBuilder]] component.
+ * @internal
+ */
 export declare function PropertyFilterBuilderRuleGroupRenderer(props: PropertyFilterBuilderRuleGroupRendererProps): JSX.Element;
-/** @alpha */
+/**
+ * Props for [[PropertyFilterBuilderRuleGroupOperator]] component.
+ * @internal
+ */
 export interface PropertyFilterBuilderRuleGroupOperatorProps {
+    /** Currently selected operator. */
     operator: PropertyFilterRuleGroupOperator;
+    /** Callback that is invoked when selected operator changes. */
     onChange: (operator: PropertyFilterRuleGroupOperator) => void;
 }
-/** @alpha */
+/**
+ * Component that renders [[PropertyFilterBuilderRuleGroup]] operator selector.
+ * @internal
+ */
 export declare function PropertyFilterBuilderRuleGroupOperator(props: PropertyFilterBuilderRuleGroupOperatorProps): JSX.Element;
 //# sourceMappingURL=FilterBuilderRuleGroup.d.ts.map

package/lib/esm/components-react/filter-builder/FilterBuilderRuleGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilterBuilderRuleGroup.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderRuleGroup.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAM/B,OAAO,EAAoC,8BAA8B,EAAsC,MAAM,sBAAsB,CAAC;AAC5I,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,+BAA+B,CAAC;AAEvC,aAAa;AACb,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,WAAW,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC7C,WAAW,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAClD,UAAU,EAAE,KAAK,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;CAClD;AAED,aAAa;AACb,eAAO,MAAM,sBAAsB,4CAA0D,CAAC;AAE9F,aAAa;AACb,MAAM,WAAW,2CAA2C;IAC1D,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,8BAA8B,CAAC;CACvC;AAED,aAAa;AACb,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,2CAA2C,eAwCxG;AAED,aAAa;AACb,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,+BAA+B,KAAK,IAAI,CAAC;CAC/D;AAED,aAAa;AACb,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,2CAA2C,eAWxG"}
+{"version":3,"file":"FilterBuilderRuleGroup.d.ts","sourceRoot":"","sources":["../../../../src/components-react/filter-builder/FilterBuilderRuleGroup.tsx"],"names":[],"mappings":"AAIA;;GAEG;;AAEH,OAAO,+BAA+B,CAAC;AAOvC,OAAO,EAAoC,8BAA8B,EAAsC,MAAM,sBAAsB,CAAC;AAC5I,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,2CAA2C;IAC1D,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4BAA4B;IAC5B,KAAK,EAAE,8BAA8B,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,2CAA2C,eA0CxG;AAED;;;GAGG;AACH,MAAM,WAAW,2CAA2C;IAC1D,mCAAmC;IACnC,QAAQ,EAAE,+BAA+B,CAAC;IAC1C,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,QAAQ,EAAE,+BAA+B,KAAK,IAAI,CAAC;CAC/D;AAED;;;GAGG;AACH,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,2CAA2C,eAWxG"}