@carbon/ibm-products 2.98.0 → 2.99.0

package/es/node_modules/@carbon/icons-react/es/generated/bucket-3.js

@@ -18,6 +18,30 @@ import { jsx } from "react/jsx-runtime";
 *
 * Code generated by @carbon/icon-build-helpers. DO NOT EDIT.
 */
+const ChartDualYAxis = /* @__PURE__ */ React.forwardRef(function ChartDualYAxis({ children, size = 16, ...rest }, ref) {
+	return React.createElement(Icon, {
+		width: size,
+		height: size,
+		ref,
+		xmlns: "http://www.w3.org/2000/svg",
+		viewBox: "0 0 32 32",
+		fill: "currentColor",
+		...rest
+	}, /* @__PURE__ */ jsx("path", { d: "m28,2v5.7222l-7.5317,6.9521L12.3818,6.5879c-.3918-.3911-.9111-.5918-1.4302-.5879-.4644.0034-.9285.1714-1.301.4976l-5.6506,4.9443V2h-2v26c0,1.1025.8972,2,2,2h24c1.1028,0,2-.8975,2-2V2h-2Zm0,8.4438v11.7622l-6.1165-6.1162,6.1165-5.646Zm-17.0322-2.4414l8.0298,8.0298-3.2141,2.9668-3.4148-3.415c-.3711-.3706-.8564-.5674-1.3479-.584s-.9885.1475-1.3833.4932l-5.6375,4.9326v-6.3262l6.9678-6.0972Zm-6.9678,19.9976v-4.9165l6.9546-6.085,3.4146,3.4146c.3809.3809.8755.5771,1.374.5869s1.0007-.166,1.3967-.5312l3.2729-3.0215,7.5872,7.5869v2.9658H4Z" }), children);
+});
+ChartDualYAxis.propTypes = iconPropTypes;
+const ChartErrorBar = /* @__PURE__ */ React.forwardRef(function ChartErrorBar({ children, size = 16, ...rest }, ref) {
+	return React.createElement(Icon, {
+		width: size,
+		height: size,
+		ref,
+		xmlns: "http://www.w3.org/2000/svg",
+		viewBox: "0 0 32 32",
+		fill: "currentColor",
+		...rest
+	}, /* @__PURE__ */ jsx("path", { d: "M22,28V12H18V8h2V6H14V8h2v4H12V28H4V2H2V28a2,2,0,0,0,2,2H30V28ZM14,14h2v4H14Zm6,14H14V20h6Zm0-10H18V14h2Z" }), children);
+});
+ChartErrorBar.propTypes = iconPropTypes;
 const ChartErrorBarAlt = /* @__PURE__ */ React.forwardRef(function ChartErrorBarAlt({ children, size = 16, ...rest }, ref) {
 	return React.createElement(Icon, {
 		width: size,
@@ -800,6 +824,18 @@ const Checkmark = /* @__PURE__ */ React.forwardRef(function Checkmark({ children
 	}, /* @__PURE__ */ jsx("path", { d: "M13 24 4 15 5.414 13.586 13 21.171 26.586 7.586 28 9 13 24z" }), children);
 });
 Checkmark.propTypes = iconPropTypes;
+const CheckmarkDouble = /* @__PURE__ */ React.forwardRef(function CheckmarkDouble({ children, size = 16, ...rest }, ref) {
+	return React.createElement(Icon, {
+		width: size,
+		height: size,
+		ref,
+		xmlns: "http://www.w3.org/2000/svg",
+		viewBox: "0 0 32 32",
+		fill: "currentColor",
+		...rest
+	}, /* @__PURE__ */ jsx("path", { d: "M18,21.4141l-3.5356-3.5352,1.4141-1.4141,2.1216,2.1211,9.8994-9.8994,1.4141,1.4141-11.3135,11.3135ZM10,20.4141l-6.3638-6.3638,1.4141-1.4141,4.9497,4.9497,9.8994-9.8994,1.4141,1.4141-11.3135,11.3135Z" }), children);
+});
+CheckmarkDouble.propTypes = iconPropTypes;
 const CheckmarkFilled = /* @__PURE__ */ React.forwardRef(function CheckmarkFilled({ children, size = 16, ...rest }, ref) {
 	if (size === 16 || size === "16" || size === "16px") return React.createElement(Icon, {
 		width: size,
@@ -1594,6 +1630,18 @@ const Classification = /* @__PURE__ */ React.forwardRef(function Classification(
 	}), /* @__PURE__ */ jsx("path", { d: "M27.7,9.3l-7-7A.9087.9087,0,0,0,20,2H10A2.0058,2.0058,0,0,0,8,4V14H6a2.0023,2.0023,0,0,0-2,2v6a2.0023,2.0023,0,0,0,2,2H8v4a2.0058,2.0058,0,0,0,2,2H26a2.0058,2.0058,0,0,0,2-2V10A.9092.9092,0,0,0,27.7,9.3ZM20,4.4,25.6,10H20ZM6,16h9.5972L19,19l-3.3926,3H6ZM26,28H10V24h5.6089a2.0076,2.0076,0,0,0,1.3135-.4927l3.3833-2.9917a2.0015,2.0015,0,0,0,.01-3.0229l-3.4033-3.0083A1.9961,1.9961,0,0,0,15.6089,14H10V4h8v6a2.0058,2.0058,0,0,0,2,2h6Z" }), children);
 });
 Classification.propTypes = iconPropTypes;
+const ClassificationGroups = /* @__PURE__ */ React.forwardRef(function ClassificationGroups({ children, size = 16, ...rest }, ref) {
+	return React.createElement(Icon, {
+		width: size,
+		height: size,
+		ref,
+		xmlns: "http://www.w3.org/2000/svg",
+		viewBox: "0 0 32 32",
+		fill: "currentColor",
+		...rest
+	}, /* @__PURE__ */ jsx("path", { d: "M8,17h5l2,2-2,2h-5v-4ZM30,28V4c0-1.103-.8975-2-2-2h-4v2h4v24h-4v2h4c1.1025,0,2-.8975,2-2ZM8,28h-4V4h4v-2h-4c-1.103,0-2,.897-2,2v24c0,1.1025.897,2,2,2h4v-2ZM24,23v-10c0-.2651-.1055-.5195-.293-.707l-5-5c-.1875-.1875-.4414-.293-.707-.293h-6c-1.103,0-2,.897-2,2v6h2v-6h4v4c0,1.103.897,2,2,2h4v8h-12c0,1.1025.897,2,2,2h10c1.1025,0,2-.8975,2-2ZM21.5859,13h-3.5859v-3.5859l3.5859,3.5859Z" }), children);
+});
+ClassificationGroups.propTypes = iconPropTypes;
 const ClassifierLanguage = /* @__PURE__ */ React.forwardRef(function ClassifierLanguage({ children, size = 16, ...rest }, ref) {
 	return React.createElement(Icon, {
 		width: size,
@@ -1880,61 +1928,5 @@ const CloudCeiling = /* @__PURE__ */ React.forwardRef(function CloudCeiling({ ch
 	}, /* @__PURE__ */ jsx("path", { d: "M2 28H11V30H2z" }), /* @__PURE__ */ jsx("path", { d: "M21 28H30V30H21z" }), /* @__PURE__ */ jsx("path", { d: "M17 26.167 17 17.832 19.586 20.414 21 19 16 14 11 19 12.413 20.415 15 17.832 15 26.167 12.413 23.584 11 25 16 30 21 25 19.586 23.586 17 26.167z" }), /* @__PURE__ */ jsx("path", { d: "M23,16H21V14h2a3,3,0,0,0,0-6c-.0938.0144-.1538.0219-.2153.0263l-.8037.0572L21.7544,7.31a5.9927,5.9927,0,0,0-11.1758-.8655l-.2832.5994-.8423-.0455A3.5008,3.5008,0,0,0,9.5,14H11v2H9.5A5.5,5.5,0,0,1,9.07,5.0166,7.9909,7.9909,0,0,1,23.42,6.0175,5,5,0,0,1,23,16Z" }), children);
 });
 CloudCeiling.propTypes = iconPropTypes;
-const CloudFoundry_1 = /* @__PURE__ */ React.forwardRef(function CloudFoundry_1({ children, size = 16, ...rest }, ref) {
-	return React.createElement(Icon, {
-		width: size,
-		height: size,
-		ref,
-		xmlns: "http://www.w3.org/2000/svg",
-		viewBox: "0 0 32 32",
-		fill: "currentColor",
-		...rest
-	}, /* @__PURE__ */ jsx("path", { d: "M16,7h0a7.66,7.66,0,0,1,1.51.15,8,8,0,0,1,6.35,6.34l.26,1.35,1.35.24a5.5,5.5,0,0,1-1,10.92H7.5a5.5,5.5,0,0,1-1-10.92l1.34-.24.26-1.35A8,8,0,0,1,16,7m0-2a10,10,0,0,0-9.83,8.12A7.5,7.5,0,0,0,7.49,28h17a7.5,7.5,0,0,0,1.32-14.88,10,10,0,0,0-7.94-7.94A10.27,10.27,0,0,0,16,5Z" }), /* @__PURE__ */ jsx("path", { d: "M14,24H11a2,2,0,0,1-2-2V19a2,2,0,0,1,2-2h3v2H11v3h3Z" }), /* @__PURE__ */ jsx("path", { d: "M21,15V13H19a2,2,0,0,0-2,2v2H16v2h1v5h2V19h2V17H19V15Z" }), children);
-});
-CloudFoundry_1.propTypes = iconPropTypes;
-const CloudFoundry_2 = /* @__PURE__ */ React.forwardRef(function CloudFoundry_2({ children, size = 16, ...rest }, ref) {
-	return React.createElement(Icon, {
-		width: size,
-		height: size,
-		ref,
-		xmlns: "http://www.w3.org/2000/svg",
-		viewBox: "0 0 32 32",
-		fill: "currentColor",
-		...rest
-	}, /* @__PURE__ */ jsx("path", { d: "M25 11 25 9 17 9 17 23 19 23 19 17 24 17 24 15 19 15 19 11 25 11z" }), /* @__PURE__ */ jsx("path", { d: "M15,23H9a2,2,0,0,1-2-2V11A2,2,0,0,1,9,9h6v2H9V21h6Z" }), children);
-});
-CloudFoundry_2.propTypes = iconPropTypes;
-const CloudRegistry = /* @__PURE__ */ React.forwardRef(function CloudRegistry({ children, size = 16, ...rest }, ref) {
-	return React.createElement(Icon, {
-		width: size,
-		height: size,
-		ref,
-		xmlns: "http://www.w3.org/2000/svg",
-		viewBox: "0 0 32 32",
-		fill: "currentColor",
-		...rest
-	}, /* @__PURE__ */ jsx("path", { d: "M28,30H23a2.0023,2.0023,0,0,1-2-2V23a2.0023,2.0023,0,0,1,2-2h5a2.0023,2.0023,0,0,1,2,2v5A2.0023,2.0023,0,0,1,28,30Zm-5-7h-.0012L23,28h5V23Z" }), /* @__PURE__ */ jsx("path", { d: "M16,23H11a2.0023,2.0023,0,0,1-2-2V11a2.0023,2.0023,0,0,1,2-2H21a2.0023,2.0023,0,0,1,2,2v5H21V11H11V21h5Z" }), /* @__PURE__ */ jsx("path", { d: "M16,30H4a2.0023,2.0023,0,0,1-2-2V4A2.0023,2.0023,0,0,1,4,2H28a2.0023,2.0023,0,0,1,2,2V16H28V4H4V28H16Z" }), children);
-});
-CloudRegistry.propTypes = iconPropTypes;
-const CloudSatellite = /* @__PURE__ */ React.forwardRef(function CloudSatellite({ children, size = 16, ...rest }, ref) {
-	return React.createElement(Icon, {
-		width: size,
-		height: size,
-		ref,
-		xmlns: "http://www.w3.org/2000/svg",
-		viewBox: "0 0 32 32",
-		fill: "currentColor",
-		...rest
-	}, /* @__PURE__ */ jsx("circle", {
-		cx: "9",
-		cy: "20",
-		r: "2"
-	}), /* @__PURE__ */ jsx("path", { d: "M16,20a4,4,0,1,1,4-4A4.0118,4.0118,0,0,1,16,20Zm0-6a2,2,0,1,0,2,2A2.0059,2.0059,0,0,0,16,14Z" }), /* @__PURE__ */ jsx("circle", {
-		cx: "23",
-		cy: "12",
-		r: "2"
-	}), /* @__PURE__ */ jsx("path", { d: "M16,31a.9988.9988,0,0,1-.5039-.1357l-12-7A1.0008,1.0008,0,0,1,3,23V9a.9994.9994,0,0,1,.4961-.8638l12-7a1,1,0,0,1,1.0078,0l12,7L27.4961,9.8638,16,3.1577,5,9.5742V22.4258l11,6.417,11-6.417V15h2v8a1.0008,1.0008,0,0,1-.4961.8643l-12,7A.9988.9988,0,0,1,16,31Z" }), children);
-});
-CloudSatellite.propTypes = iconPropTypes;
 //#endregion
 export { ChevronDown };

package/es/settings.d.ts

@@ -1,9 +1,9 @@
 export namespace carbon {
     const themes: {
-        white: typeof import("@carbon/themes/lib/white");
-        g10: typeof import("@carbon/themes/lib/g10");
-        g90: typeof import("@carbon/themes/lib/g90");
-        g100: typeof import("@carbon/themes/lib/g100");
+        white: typeof import("@carbon/themes/js/generated/themes/white");
+        g10: typeof import("@carbon/themes/js/generated/themes/g10");
+        g90: typeof import("@carbon/themes/js/generated/themes/g90");
+        g100: typeof import("@carbon/themes/js/generated/themes/g100");
     };
     let prefix: string;
 }

package/lib/components/ConditionBuilder/ConditionBuilder.d.ts

@@ -5,9 +5,30 @@
  * LICENSE file in the root directory of this source tree.
  */
 import React from 'react';
+export { getDeprecatedArgTypes } from '../../global/js/utils/props-helper';
 import { ConditionBuilderProps } from './ConditionBuilder.types';
 /**
  * TODO: A description of the component.
  */
 export declare const ConditionBuilder: React.ForwardRefExoticComponent<ConditionBuilderProps & React.RefAttributes<HTMLDivElement>>;
+export declare const deprecatedProps: {
+    /**
+     * @deprecated Use the `value` prop instead. `initialState` will be removed
+     * in a future major release.
+     *
+     * Optional prop to pass a saved condition state. `state` holds the
+     * condition structure; `enabledDefault: true` renders the builder
+     * immediately, `enabledDefault: false` (default) requires the user to
+     * click the start button first.
+     */
+    /**@ts-ignore */
+    initialState: (props: any, propName: any, comp: any, loc: any, propFullName: any, secret: any) => any;
+    /**
+     * @deprecated Use `onChange` instead. `getConditionState` will be removed
+     * in a future major release.
+     *
+     * Callback that receives the updated condition state on every change.
+     */
+    getConditionState: (props: any, propName: any, comp: any, loc: any, propFullName: any, secret: any) => any;
+};
 //# sourceMappingURL=ConditionBuilder.d.ts.map

package/lib/components/ConditionBuilder/ConditionBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConditionBuilder.d.ts","sourceRoot":"","sources":["../../../src/components/ConditionBuilder/ConditionBuilder.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAA+B,MAAM,OAAO,CAAC;AAepD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA0BjE;;GAEG;AAEH,eAAO,MAAM,gBAAgB,8FA2E5B,CAAC"}
+{"version":3,"file":"ConditionBuilder.d.ts","sourceRoot":"","sources":["../../../src/components/ConditionBuilder/ConditionBuilder.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAA+B,MAAM,OAAO,CAAC;AAWpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAM3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AA0BjE;;GAEG;AAEH,eAAO,MAAM,gBAAgB,8FAgF5B,CAAC;AAUF,eAAO,MAAM,eAAe;IAC1B;;;;;;;;OAQG;IACH,gBAAgB;;IAShB;;;;;OAKG;;CAKJ,CAAC"}

package/lib/components/ConditionBuilder/ConditionBuilder.js

@@ -8,6 +8,7 @@
 const require_runtime = require("../../_virtual/_rolldown/runtime.js");
 const require_index = require("../../node_modules/classnames/index.js");
 const require_devtools = require("../../global/js/utils/devtools.js");
+const require_props_helper = require("../../global/js/utils/props-helper.js");
 const require_util = require("./utils/util.js");
 const require_ConditionBuilderProvider = require("./ConditionBuilderContext/ConditionBuilderProvider.js");
 const require_handleKeyboardEvents = require("./utils/handleKeyboardEvents.js");
@@ -30,7 +31,7 @@ const componentName = "ConditionBuilder";
 /**
 * TODO: A description of the component.
 */
-const ConditionBuilder = react.default.forwardRef(({ className, inputConfig, startConditionLabel = "Add Condition", popOverSearchThreshold, getOptions, initialState, getConditionState, getActionsState, variant = require_util.NON_HIERARCHICAL_VARIANT, actions, translateWithId, statementConfigCustom, onAddItem, onRemoveItem, readOnly, ...rest }, ref) => {
+const ConditionBuilder = react.default.forwardRef(({ className, inputConfig, startConditionLabel = "Add Condition", popOverSearchThreshold = 4, getOptions, initialState, getConditionState, getActionsState, variant = require_util.NON_HIERARCHICAL_VARIANT, actions, translateWithId, statementConfigCustom, onAddItem, onRemoveItem, readOnly, startActive = true, value, onChange, ...rest }, ref) => {
 	const localRef = (0, react.useRef)(null);
 	const conditionBuilderRef = ref || localRef;
 	const handleKeyDownHandler = (evt) => {
@@ -46,7 +47,10 @@ const ConditionBuilder = react.default.forwardRef(({ className, inputConfig, sta
 		statementConfigCustom,
 		onAddItem,
 		onRemoveItem,
-		readOnly: !!readOnly
+		readOnly: !!readOnly,
+		startActive,
+		value,
+		onChange
 	}, /* @__PURE__ */ react.default.createElement("div", {
 		...rest,
 		className: (0, import_classnames.default)(require_util.blockClass, className, { [`${require_util.blockClass}__readonly`]: readOnly }, {}),
@@ -64,6 +68,29 @@ const ConditionBuilder = react.default.forwardRef(({ className, inputConfig, sta
 	}))));
 });
 ConditionBuilder.displayName = componentName;
+const deprecatedProps = {
+	/**
+	* @deprecated Use the `value` prop instead. `initialState` will be removed
+	* in a future major release.
+	*
+	* Optional prop to pass a saved condition state. `state` holds the
+	* condition structure; `enabledDefault: true` renders the builder
+	* immediately, `enabledDefault: false` (default) requires the user to
+	* click the start button first.
+	*/
+	/**@ts-ignore */
+	initialState: require_props_helper.deprecateProp(prop_types.default.shape({
+		state: prop_types.default.object,
+		enabledDefault: prop_types.default.bool
+	}), "Use the `value` prop instead (pair with `onChange` for controlled mode)."),
+	/**
+	* @deprecated Use `onChange` instead. `getConditionState` will be removed
+	* in a future major release.
+	*
+	* Callback that receives the updated condition state on every change.
+	*/
+	getConditionState: require_props_helper.deprecateProp(prop_types.default.func, "Use the `onChange` prop instead.")
+};
 ConditionBuilder.propTypes = {
 	/**
 	* optional array of actions
@@ -82,51 +109,13 @@ ConditionBuilder.propTypes = {
 	*/
 	getActionsState: prop_types.default.func,
 	/**
-	* This is a callback that gives back updated condition state
-	*/
-	getConditionState: prop_types.default.func.isRequired,
-	/**
 	* Callback triggered to dynamically fetch options for a property of type 'option'.
 	* This is invoked when no static options array is provided in the input config.
 	* The function should return a Promise that resolves with an array of options in the required format.
-	
 	*/
 	getOptions: prop_types.default.func,
 	/**
-	* Optional prop if you want to pass a saved condition state, pass as "initialState.state".
-	* "initialState.enabledDefault" will populate the builder with the provided initial state before clicking Add Condition button.
-	*
-	*  This state should respect the structure of condition state that is available in getConditionState callback
-	*/
-	/**@ts-ignore */
-	initialState: prop_types.default.shape({
-		state: prop_types.default.shape({
-			groups: prop_types.default.arrayOf(prop_types.default.shape({
-				groupOperator: prop_types.default.string,
-				statement: prop_types.default.string,
-				conditions: prop_types.default.arrayOf(prop_types.default.oneOfType([prop_types.default.shape({
-					property: prop_types.default.string,
-					operator: prop_types.default.string,
-					value: prop_types.default.oneOfType([
-						prop_types.default.string,
-						prop_types.default.arrayOf(prop_types.default.shape({
-							id: prop_types.default.string,
-							label: prop_types.default.string
-						})),
-						prop_types.default.shape({
-							id: prop_types.default.string,
-							label: prop_types.default.string
-						})
-					])
-				}), prop_types.default.object]))
-			})),
-			operator: prop_types.default.string
-		}),
-		enabledDefault: prop_types.default.bool
-	}),
-	/**
 	* This is a mandatory prop that defines the input to the condition builder.
-	
 	*/
 	/**@ts-ignore */
 	inputConfig: prop_types.default.shape({ properties: prop_types.default.arrayOf(prop_types.default.shape({
@@ -165,19 +154,30 @@ ConditionBuilder.propTypes = {
 	*/
 	onAddItem: prop_types.default.func,
 	/**
+	* Called with the full new state on every change. Use with `value` for
+	* controlled mode, or standalone instead of `getConditionState`.
+	*/
+	onChange: prop_types.default.func,
+	/**
 	* this is an optional callback triggered before removing any condition , subgroup, group or action.
 	* User can optionally perform any validation and can stop remove action if they return back {preventRemove:true}
 	*/
 	onRemoveItem: prop_types.default.func,
 	/**
-	* This will enable search in option popovers when option list length is more than this threshold
+	* This will enable search in option popovers when option list length is more than this threshold.
+	* Defaults to 4 when not provided.
 	*/
-	popOverSearchThreshold: prop_types.default.number.isRequired,
+	popOverSearchThreshold: prop_types.default.number,
 	/**
 	* Whether the conditionBuilder should be readOnly
 	*/
 	readOnly: prop_types.default.bool,
 	/**
+	* When false, the builder starts behind the "Add condition" button even
+	* if value contains groups. Defaults to true.
+	*/
+	startActive: prop_types.default.bool,
+	/**
 	* Provide a label to the button that starts condition builder
 	*/
 	startConditionLabel: prop_types.default.string,
@@ -194,14 +194,21 @@ ConditionBuilder.propTypes = {
 	/**
 	* Optional prop, if you need to pass translations to the texts on the component instead of the defined defaults.
 	* This callback function will receive the message id and you need to return the corresponding text for that id.
-	
 	*/
 	/**@ts-ignore */
 	translateWithId: prop_types.default.func,
 	/**
+	* Seed state or controlled state for the builder. When passed alongside
+	* `onChange`, updates to `value` from outside will sync the builder.
+	* Use without `onChange` for a one-time seed (uncontrolled).
+	*/
+	/**@ts-ignore */
+	value: prop_types.default.object,
+	/**
 	* Provide the condition builder variant: Non-Hierarchical/ Hierarchical
 	*/
-	variant: prop_types.default.oneOf(["Non-Hierarchical", "Hierarchical"])
+	variant: prop_types.default.oneOf(["Non-Hierarchical", "Hierarchical"]),
+	...deprecatedProps
 };
 //#endregion
 exports.ConditionBuilder = ConditionBuilder;

package/lib/components/ConditionBuilder/ConditionBuilder.types.d.ts

@@ -147,27 +147,62 @@ type RemoveItemConfig = {
     item?: Condition | ConditionGroup | Action;
     group?: ConditionGroup;
 };
-type ConditionBuilderTextKeys = 'ifText' | 'unlessText' | 'excl_if' | 'and' | 'or' | 'is' | 'ifAll' | 'ifAny' | 'unlessAll' | 'unlessAny' | 'greater' | 'greaterEqual' | 'lower' | 'lowerEqual' | 'startsWith' | 'endsWith' | 'contains' | 'oneOf' | 'before' | 'after' | 'between' | 'addConditionText' | 'addConditionGroupText' | 'addSubgroupText' | 'conditionText' | 'propertyText' | 'operatorText' | 'valueText' | 'connectorText' | 'conditionRowText' | 'conditionRowGroupText' | 'removeConditionText' | 'addConditionRowText' | 'startText' | 'endText' | 'clearSearchText' | 'actionsText' | 'then' | 'removeActionText' | 'addActionText' | 'invalidText' | 'invalidNumberWarnText' | 'conditionBuilderText' | 'actionSectionText' | 'conditionHeadingText' | 'addPropertyText' | 'addOperatorText' | 'addValueText' | 'conditionBuilderHierarchicalText';
+export type ConditionBuilderTextKeys = 'ifText' | 'unlessText' | 'excl_if' | 'and' | 'or' | 'is' | 'ifAll' | 'ifAny' | 'unlessAll' | 'unlessAny' | 'greater' | 'greaterEqual' | 'lower' | 'lowerEqual' | 'startsWith' | 'endsWith' | 'contains' | 'oneOf' | 'before' | 'after' | 'between' | 'addConditionText' | 'addConditionGroupText' | 'addSubgroupText' | 'conditionText' | 'propertyText' | 'operatorText' | 'valueText' | 'connectorText' | 'conditionRowText' | 'conditionRowGroupText' | 'removeConditionText' | 'addConditionRowText' | 'startText' | 'endText' | 'searchPropertiesText' | 'clearSearchText' | 'actionsText' | 'then' | 'removeActionText' | 'addActionText' | 'invalidText' | 'invalidNumberWarnText' | 'conditionBuilderText' | 'conditionBuilderGroupText' | 'actionSectionText' | 'conditionHeadingText' | 'addPropertyText' | 'addOperatorText' | 'addValueText' | 'conditionBuilderHierarchicalText' | 'conditionRemovedText';
 export type ConditionBuilderProps = {
     inputConfig: inputConfig;
+    /**
+     * @deprecated Use `value` (and `onChange` for controlled mode) instead.
+     * `initialState` will be removed in a future major release.
+     */
     initialState?: InitialState;
     getActionsState?: (state: Action[] | undefined) => void;
-    getConditionState: (state: ConditionBuilderState | undefined) => void;
+    /**
+     * @deprecated Use `onChange` instead. `getConditionState` will be removed
+     * in a future major release.
+     */
+    getConditionState?: (state: ConditionBuilderState | undefined) => void;
     getOptions?: (state: ConditionBuilderState, condition: Condition) => Promise<Option[]>;
     actions?: Action[];
     className?: string;
-    popOverSearchThreshold: number;
+    /** When omitted, defaults to 4. A search field appears in option popovers
+     *  when the option list length exceeds this threshold. */
+    popOverSearchThreshold?: number;
     startConditionLabel?: string;
     variant?: 'Non-Hierarchical' | 'Hierarchical';
     translateWithId?: (id: ConditionBuilderTextKeys) => string;
-    statementConfigCustom: statementConfig[];
+    /** Override the default four statements (if all / if any / unless all / unless any).
+     *  When omitted, the built-in defaults are used. */
+    statementConfigCustom?: statementConfig[];
     onAddItem?: (config: AddItemConfig) => {
         preventAdd: boolean;
-    };
+    } | void;
     onRemoveItem?: (config: RemoveItemConfig) => {
         preventRemove: boolean;
-    };
+    } | void;
     readOnly?: boolean;
+    /**
+     * When `false`, the builder starts behind the "Add condition" button even
+     * if `value` contains groups. The user must click the button to activate.
+     * Defaults to `true` (builder activates immediately when groups are present).
+     */
+    startActive?: boolean;
+    /**
+     * Pre-populate the builder with an existing condition state.
+     *
+     * - **Uncontrolled seed** (no `onChange`): the builder uses this as its
+     *   starting state and then manages state internally — equivalent to
+     *   `initialState.state` but without the `enabledDefault` flag.
+     * - **Controlled** (with `onChange`): the parent owns the state on every
+     *   render. Must be kept in sync via `onChange`.
+     */
+    value?: ConditionBuilderState;
+    /**
+     * Called with the full new state on every change.
+     * - Pair with `value` for fully controlled mode.
+     * - Omit to use `value` as a one-time uncontrolled seed.
+     * - Can also be used standalone instead of `getConditionState`.
+     */
+    onChange?: (state: ConditionBuilderState) => void;
 };
 export type InitialState = {
     state: ConditionBuilderState;
@@ -176,13 +211,16 @@ export type InitialState = {
 export interface ConditionBuilderContextInputProps extends PropsWithChildren {
     children?: ReactNode;
     inputConfig?: inputConfig;
-    popOverSearchThreshold: number;
+    popOverSearchThreshold?: number;
     getOptions?: (state: ConditionBuilderState, condition: Condition) => Promise<Option[]>;
     variant?: string;
     translateWithId?: (id: ConditionBuilderTextKeys) => string;
     statementConfigCustom?: statementConfig[];
     conditionBuilderRef?: ForwardedRef<HTMLDivElement>;
     readOnly?: boolean;
+    startActive?: boolean;
+    value?: ConditionBuilderState;
+    onChange?: (state: ConditionBuilderState) => void;
 }
 export type ConditionBuilderContextProps = {
     rootState?: ConditionBuilderState;
@@ -191,10 +229,10 @@ export type ConditionBuilderContextProps = {
     setActionState?: Dispatch<SetStateAction<Action[]>>;
     onAddItem?: (config: AddItemConfig) => {
         preventAdd: boolean;
-    };
+    } | void;
     onRemoveItem?: (config: RemoveItemConfig) => {
         preventRemove: boolean;
-    };
+    } | void;
 } & ConditionBuilderContextInputProps;
 export {};
 //# sourceMappingURL=ConditionBuilder.types.d.ts.map

package/lib/components/ConditionBuilder/ConditionBuilder.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConditionBuilder.types.d.ts","sourceRoot":"","sources":["../../../src/components/ConditionBuilder/ConditionBuilder.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,aAAa,EACb,cAAc,EACd,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,cAAc,EACf,MAAM,OAAO,CAAC;AAEf,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,IAAI,CAAC;AAC3C,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAE9E,KAAK,YAAY,GAAG,IAAI,CAAC;AACzB,KAAK,cAAc,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,YAAY,CAAC;AAC1E,KAAK,cAAc,GAAG,YAAY,GAAG,UAAU,CAAC;AAChD,KAAK,aAAa,GAAG,UAAU,CAAC;AAChC,KAAK,cAAc,GAAG,OAAO,CAAC;AAC9B,KAAK,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAChB,eAAe,GACf,iBAAiB,GACjB,YAAY,GACZ,cAAc,GACd,cAAc,GACd,aAAa,GACb,cAAc,GACd,YAAY,CAAC;AAEjB,MAAM,MAAM,cAAc,GACtB,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;CACpB,CAAC;AAEF,KAAK,IAAI,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG;IAAE,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,QAAQ,CAAC;IAEf,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,CAAC,EAAE,CAAC,IAAI,GAAG;YAAE,aAAa,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,EAAE,CAAC;KACpD,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,GAAG;QAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,aAAa,GAAG;QAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE;QACN,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;QACnB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,GAAG,gBAAgB,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,GAAG;QAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACrD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE;QACN,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;QACnB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;KAC5C,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB,oBAAoB,CAAC,QAAQ,CAAC,GAC9B,sBAAsB,CAAC,QAAQ,CAAC,GAChC,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,oBAAoB,CAAC,QAAQ,CAAC,GAC9B,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,oBAAoB,CAAC,QAAQ,CAAC,CAAC;AACnC,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG;IAC5B,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QACrB,cAAc,EAAE,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,cAAc,CAAC;KACxB,KAAK,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QACnB,cAAc,EAAE,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,cAAc,CAAC;KACxB,KAAK,OAAO,CAAC;CACf,GAAG,UAAU,CAAC;AAEf,MAAM,MAAM,WAAW,GAAG;IAAE,UAAU,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,MAAM,GAAG,IAAI,GAAG;IAAE,IAAI,CAAC,EAAE,cAAc,CAAA;CAAE,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,EAAE,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IACnC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,UAAU,CAAC,EAAE,CAAC,cAAc,GAAG,SAAS,CAAC,EAAE,CAAC;IAC5C,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAE/D,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG;IACnC,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AACF,KAAK,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AACtD,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,KAAK,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AACpE,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,IAAI,CAAC,EAAE,SAAS,GAAG,cAAc,GAAG,MAAM,CAAC;IAC3C,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,KAAK,wBAAwB,GACzB,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,KAAK,GACL,IAAI,GACJ,IAAI,GACJ,OAAO,GACP,OAAO,GACP,WAAW,GACX,WAAW,GACX,SAAS,GACT,cAAc,GACd,OAAO,GACP,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,UAAU,GACV,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,kBAAkB,GAClB,uBAAuB,GACvB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,cAAc,GACd,WAAW,GACX,eAAe,GACf,kBAAkB,GAClB,uBAAuB,GACvB,qBAAqB,GACrB,qBAAqB,GACrB,WAAW,GACX,SAAS,GACT,iBAAiB,GACjB,aAAa,GACb,MAAM,GACN,kBAAkB,GAClB,eAAe,GACf,aAAa,GACb,uBAAuB,GACvB,sBAAsB,GACtB,mBAAmB,GACnB,sBAAsB,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,kCAAkC,CAAC;AACvC,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,KAAK,IAAI,CAAC;IACxD,iBAAiB,EAAE,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,KAAK,IAAI,CAAC;IACtE,UAAU,CAAC,EAAE,CACX,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,kBAAkB,GAAG,cAAc,CAAC;IAC9C,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,wBAAwB,KAAK,MAAM,CAAC;IAC3D,qBAAqB,EAAE,eAAe,EAAE,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,qBAAqB,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,iCAAkC,SAAQ,iBAAiB;IAC1E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,CACX,KAAK,EAAE,qBAAqB,EAC5B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,wBAAwB,KAAK,MAAM,CAAC;IAC3D,qBAAqB,CAAC,EAAE,eAAe,EAAE,CAAC;IAC1C,mBAAmB,CAAC,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACpD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK;QAAE,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/D,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;CACzE,GAAG,iCAAiC,CAAC"}
+{"version":3,"file":"ConditionBuilder.types.d.ts","sourceRoot":"","sources":["../../../src/components/ConditionBuilder/ConditionBuilder.types.ts"],"names":[],"mappings":"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"}

package/lib/components/ConditionBuilder/ConditionBuilderContent/ConditionBuilderContent.d.ts

@@ -9,8 +9,10 @@ import PropTypes from 'prop-types';
 import { Action, ConditionBuilderState, InitialState } from '../ConditionBuilder.types';
 interface ConditionBuilderContentProps {
     startConditionLabel: string;
-    getConditionState: (state: ConditionBuilderState) => void;
+    /** @deprecated Use `onChange` (from context) instead. */
+    getConditionState?: (state: ConditionBuilderState) => void;
     getActionsState?: (state: Action[]) => void;
+    /** @deprecated Use `value` (and `onChange` for controlled mode) instead. */
     initialState?: InitialState;
     actions?: Action[];
 }
@@ -29,10 +31,15 @@ declare const ConditionBuilderContent: {
          */
         getActionsState: PropTypes.Requireable<(...args: any[]) => any>;
         /**
+         * @deprecated Use `onChange` instead. `getConditionState` will be removed
+         * in a future major release.
+         *
          * This is a callback function that returns the updated state
          */
-        getConditionState: PropTypes.Validator<(...args: any[]) => any>;
+        getConditionState: PropTypes.Requireable<(...args: any[]) => any>;
         /**
+         * @deprecated Use `value` (and `onChange` for controlled mode) instead.
+         *
          * Optional prop if the condition building need to start from a predefined initial state
          */
         initialState: PropTypes.Requireable<PropTypes.InferProps<{

package/lib/components/ConditionBuilder/ConditionBuilderContent/ConditionBuilderContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConditionBuilderContent.d.ts","sourceRoot":"","sources":["../../../../src/components/ConditionBuilder/ConditionBuilderContent/ConditionBuilderContent.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,SAAS,MAAM,YAAY,CAAC;AAiBnC,OAAO,EACL,MAAM,EAEN,qBAAqB,EAErB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,UAAU,4BAA4B;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC1D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,QAAA,MAAM,uBAAuB;0FAM1B,4BAA4B;;QAiR7B;;WAEG;;;;;QAOH;;WAEG;;QAEH;;WAEG;;QAEH;;WAEG;;;;;;;;;;;;;;CAxBJ,CAAC;AAEF,eAAe,uBAAuB,CAAC"}
+{"version":3,"file":"ConditionBuilderContent.d.ts","sourceRoot":"","sources":["../../../../src/components/ConditionBuilder/ConditionBuilderContent/ConditionBuilderContent.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,SAAS,MAAM,YAAY,CAAC;AAiBnC,OAAO,EACL,MAAM,EAEN,qBAAqB,EAErB,YAAY,EACb,MAAM,2BAA2B,CAAC;AAEnC,UAAU,4BAA4B;IACpC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC3D,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC5C,4EAA4E;IAC5E,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AACD,QAAA,MAAM,uBAAuB;0FAM1B,4BAA4B;;QAmT7B;;WAEG;;;;;QAOH;;WAEG;;QAEH;;;;;WAKG;;QAEH;;;;WAIG;;;;;;;;;;;;;;CA7BJ,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/lib/components/ConditionBuilder/ConditionBuilderContent/ConditionBuilderContent.js

@@ -30,8 +30,9 @@ let _carbon_react_icons = require("@carbon/react/icons");
 */
 /**@ts-ignore */
 const ConditionBuilderContent = ({ startConditionLabel, getConditionState, getActionsState, initialState, actions }) => {
-	const { rootState, setRootState, variant, actionState, onAddItem, onRemoveItem, readOnly, statementConfigCustom } = (0, react.useContext)(require_ConditionBuilderProvider.ConditionBuilderContext);
+	const { rootState, setRootState, variant, actionState, onAddItem, onRemoveItem, readOnly, statementConfigCustom, value: seedValue, onChange, startActive } = (0, react.useContext)(require_ConditionBuilderProvider.ConditionBuilderContext);
 	const initialConditionState = (0, react.useRef)(initialState?.state ? JSON.parse(JSON.stringify(initialState?.state)) : null);
+	const userActivated = (0, react.useRef)(false);
 	const [isConditionBuilderActive, setIsConditionBuilderActive] = (0, react.useState)(false);
 	const [showConditionGroupPreview, setShowConditionGroupPreview] = (0, react.useState)(false);
 	const [addConditionGroupText, conditionHeadingText, conditionBuilderHierarchicalText, conditionRemovedText] = require_useTranslations.useTranslations([
@@ -49,6 +50,10 @@ const ConditionBuilderContent = ({ startConditionLabel, getConditionState, getAc
 		setShowConditionGroupPreview(false);
 	};
 	(0, react.useEffect)(() => {
+		if (startActive === false && !userActivated.current) {
+			if (getConditionState) getConditionState(rootState ?? {});
+			return;
+		}
 		if (rootState?.groups?.length) setIsConditionBuilderActive(true);
 		else setIsConditionBuilderActive(false);
 		if (getConditionState) getConditionState(rootState ?? {});
@@ -57,10 +62,13 @@ const ConditionBuilderContent = ({ startConditionLabel, getConditionState, getAc
 		getActionsState?.(actionState ?? []);
 	}, [actionState]);
 	(0, react.useEffect)(() => {
-		if (initialState?.enabledDefault) setRootState?.(initialState.state);
+		if (initialState?.enabledDefault && seedValue === void 0) setRootState?.(initialState.state);
 	}, [initialState]);
 	const onStartConditionBuilder = () => {
+		userActivated.current = true;
 		setIsConditionBuilderActive(true);
+		if (seedValue !== void 0 && onChange !== void 0) return;
+		if (seedValue !== void 0 && rootState?.groups?.length) return;
 		if (initialConditionState?.current?.groups?.length) {
 			setRootState?.(initialConditionState.current);
 			initialConditionState.current = null;
@@ -208,10 +216,15 @@ ConditionBuilderContent.propTypes = {
 	*/
 	getActionsState: prop_types.default.func,
 	/**
+	* @deprecated Use `onChange` instead. `getConditionState` will be removed
+	* in a future major release.
+	*
 	* This is a callback function that returns the updated state
 	*/
-	getConditionState: prop_types.default.func.isRequired,
+	getConditionState: prop_types.default.func,
 	/**
+	* @deprecated Use `value` (and `onChange` for controlled mode) instead.
+	*
 	* Optional prop if the condition building need to start from a predefined initial state
 	*/
 	initialState: prop_types.default.shape({

package/lib/components/ConditionBuilder/ConditionBuilderContext/ConditionBuilderProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConditionBuilderProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/ConditionBuilder/ConditionBuilderContext/ConditionBuilderProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAkC,MAAM,OAAO,CAAC;AAGvD,OAAO,EAEL,4BAA4B,EAC5B,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,aAAa,GACxB,wBAAwB,4BAA4B,CAAC,uBAAuB,CAAC,KAC5E,qBAuBF,CAAC;AAEF,eAAO,MAAM,uBAAuB,6CAMhC,CAAC;AAEL,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAC7C,4BAA4B,CA6B7B,CAAC"}
+{"version":3,"file":"ConditionBuilderProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/ConditionBuilder/ConditionBuilderContext/ConditionBuilderProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAqD,MAAM,OAAO,CAAC;AAG1E,OAAO,EAEL,4BAA4B,EAC5B,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,aAAa,GACxB,wBAAwB,4BAA4B,CAAC,uBAAuB,CAAC,KAC5E,qBAuBF,CAAC;AAEF,eAAO,MAAM,uBAAuB,6CAMhC,CAAC;AAEL,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC,EAAE,CAC7C,4BAA4B,CAgE7B,CAAC"}