@genesislcap/expression-builder 14.483.3-alpha-92cb1f2a8.0 → 14.484.1

package/dist/custom-elements.json

@@ -644,30 +644,30 @@
               "type": {
                 "text": "CustomEvent"
               },
-              "description": "Fired when the expression model changes"
+              "description": "Fired when the expression model changes. detail: `ChangeEventDetail`"
             },
             {
-              "description": "Bubbled when a nested group add is requested",
+              "description": "Bubbled when a nested group add is requested. detail: `AddGroupEventDetail`",
               "name": "add-group"
             },
             {
-              "description": "Bubbled when a group delete is requested",
+              "description": "Bubbled when a group delete is requested. detail: `DelGroupEventDetail`",
               "name": "del-group"
             },
             {
-              "description": "Bubbled when a rule add is requested",
+              "description": "Bubbled when a rule add is requested. detail: `AddRuleEventDetail`",
               "name": "add-rule"
             },
             {
-              "description": "Bubbled when a rule delete is requested",
+              "description": "Bubbled when a rule delete is requested. detail: `DelRuleEventDetail`",
               "name": "del-rule"
             },
             {
-              "description": "Bubbled when group data changes",
+              "description": "Bubbled when group data changes. detail: `UpdateGroupEventDetail`",
               "name": "update-group"
             },
             {
-              "description": "Bubbled when rule data changes",
+              "description": "Bubbled when rule data changes. detail: `UpdateRuleEventDetail`",
               "name": "update-rule"
             }
           ],
@@ -703,6 +703,14 @@
       "path": "src/main/index.ts",
       "declarations": [],
       "exports": [
+        {
+          "kind": "js",
+          "name": "*",
+          "declaration": {
+            "name": "*",
+            "package": "./events"
+          }
+        },
         {
           "kind": "js",
           "name": "*",
@@ -1241,19 +1249,19 @@
               }
             },
             {
-              "description": "Bubbled when adding a child rule",
+              "description": "Bubbled when adding a child rule. detail: `AddRuleEventDetail`",
               "name": "add-rule"
             },
             {
-              "description": "Bubbled when adding a child group",
+              "description": "Bubbled when adding a child group. detail: `AddGroupEventDetail`",
               "name": "add-group"
             },
             {
-              "description": "Bubbled when deleting this group",
+              "description": "Bubbled when deleting this group. detail: `DelGroupEventDetail`",
               "name": "del-group"
             },
             {
-              "description": "Bubbled when combinator changes",
+              "description": "Bubbled when combinator changes. detail: `UpdateGroupEventDetail`",
               "name": "update-group"
             }
           ],
@@ -1684,11 +1692,11 @@
               }
             },
             {
-              "description": "Bubbled when deleting this rule",
+              "description": "Bubbled when deleting this rule. detail: `DelRuleEventDetail`",
               "name": "del-rule"
             },
             {
-              "description": "Bubbled when field/operator/value changes",
+              "description": "Bubbled when field/operator/value changes. detail: `UpdateRuleEventDetail`",
               "name": "update-rule"
             }
           ],
@@ -1815,7 +1823,7 @@
               }
             },
             {
-              "description": "Bubbled when the selected field changes",
+              "description": "Bubbled when the selected field changes. detail: `FieldSelectedEventDetail`",
               "name": "field-selected"
             }
           ],
@@ -1949,7 +1957,7 @@
               }
             },
             {
-              "description": "Bubbled when the selected operator changes",
+              "description": "Bubbled when the selected operator changes. detail: `OperatorSelectedEventDetail`",
               "name": "operator-selected"
             }
           ],
@@ -2238,11 +2246,11 @@
               }
             },
             {
-              "description": "Bubbled when operand value changes",
+              "description": "Bubbled when operand value changes. detail: `ValueUpdatedEventDetail`",
               "name": "value-updated"
             },
             {
-              "description": "Bubbled when a variadic operand is removed",
+              "description": "Bubbled when a variadic operand is removed. detail: `RemoveVarArgEventDetail`",
               "name": "remove-variadic-operand"
             }
           ],

package/dist/dts/main/events.d.ts

@@ -1,4 +1,5 @@
 import { Group, GroupMetadata, Rule } from '../types';
+/** @beta Event names dispatched by the expression builder component family. */
 export declare enum Events {
     AddGroup = "add-group",
     DelGroup = "del-group",
@@ -11,6 +12,7 @@ export declare enum Events {
     ValueUpdated = "value-updated",
     RemoveVarArg = "remove-variadic-operand"
 }
+/** @beta Maps each event name to the `detail` payload carried by its CustomEvent. */
 export type EventsDetailMap = {
     [Events.AddGroup]: {
         parentGroupId: string;
@@ -47,4 +49,31 @@ export type EventsDetailMap = {
         index: number;
     };
 };
+/** @beta Detail payload for the `add-group` event. */
+export type AddGroupEventDetail = EventsDetailMap[Events.AddGroup];
+/** @beta Detail payload for the `del-group` event. */
+export type DelGroupEventDetail = EventsDetailMap[Events.DelGroup];
+/** @beta Detail payload for the `add-rule` event. */
+export type AddRuleEventDetail = EventsDetailMap[Events.AddRule];
+/** @beta Detail payload for the `del-rule` event. */
+export type DelRuleEventDetail = EventsDetailMap[Events.DelRule];
+/** @beta Detail payload for the `update-group` event. */
+export type UpdateGroupEventDetail = EventsDetailMap[Events.UpdateGroup];
+/** @beta Detail payload for the `update-rule` event. */
+export type UpdateRuleEventDetail = EventsDetailMap[Events.UpdateRule];
+/** @beta Detail payload for the `field-selected` event. */
+export type FieldSelectedEventDetail = EventsDetailMap[Events.FieldSelected];
+/** @beta Detail payload for the `operator-selected` event. */
+export type OperatorSelectedEventDetail = EventsDetailMap[Events.OperatorSelected];
+/** @beta Detail payload for the `value-updated` event. */
+export type ValueUpdatedEventDetail = EventsDetailMap[Events.ValueUpdated];
+/** @beta Detail payload for the `remove-variadic-operand` event. */
+export type RemoveVarArgEventDetail = EventsDetailMap[Events.RemoveVarArg];
+/**
+ * @beta Detail payload for the `change` event fired by the expression builder component.
+ * Alias of `Types.Group` exposed as a plain identifier: `Group` is otherwise only reachable
+ * through the `Types` namespace re-export, which the generated React wrapper's detail-type
+ * resolution can't follow.
+ */
+export type ChangeEventDetail = Group;
 //# sourceMappingURL=events.d.ts.map

package/dist/dts/main/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/main/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEtD,oBAAY,MAAM;IAChB,QAAQ,cAAc;IACtB,QAAQ,cAAc;IAEtB,OAAO,aAAa;IACpB,OAAO,aAAa;IAEpB,WAAW,iBAAiB;IAE5B,UAAU,gBAAgB;IAC1B,aAAa,mBAAmB;IAChC,gBAAgB,sBAAsB;IACtC,YAAY,kBAAkB;IAC9B,YAAY,4BAA4B;CACzC;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACrF,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAErC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;IAE5E,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;IACvD,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/main/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEtD,+EAA+E;AAC/E,oBAAY,MAAM;IAChB,QAAQ,cAAc;IACtB,QAAQ,cAAc;IAEtB,OAAO,aAAa;IACpB,OAAO,aAAa;IAEpB,WAAW,iBAAiB;IAE5B,UAAU,gBAAgB;IAC1B,aAAa,mBAAmB;IAChC,gBAAgB,sBAAsB;IACtC,YAAY,kBAAkB;IAC9B,YAAY,4BAA4B;CACzC;AAED,qFAAqF;AACrF,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACrF,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAErC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;KAAE,CAAC;IAE5E,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,CAAC;IACvD,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,CAAC,MAAM,CAAC,gBAAgB,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,CAAC;AAQF,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEnE,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAEnE,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEjE,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAEjE,yDAAyD;AACzD,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AAEzE,wDAAwD;AACxD,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AAEvE,2DAA2D;AAC3D,MAAM,MAAM,wBAAwB,GAAG,eAAe,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;AAE7E,8DAA8D;AAC9D,MAAM,MAAM,2BAA2B,GAAG,eAAe,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAEnF,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAE3E,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC"}

package/dist/dts/main/expression-builder.d.ts

@@ -13,13 +13,13 @@ import { MetadataProvider } from '../utils/data-model';
  * where you want to use a different (e.g. domain specific) model then it will likely override then emit event and instead emit
  * it's own model. To check the underlying `Types.Group` model check the {@link ExpressionBuilder.model} property.
  *
- * @fires change - Fired when the expression model changes
- * @fires add-group - Bubbled when a nested group add is requested
- * @fires del-group - Bubbled when a group delete is requested
- * @fires add-rule - Bubbled when a rule add is requested
- * @fires del-rule - Bubbled when a rule delete is requested
- * @fires update-group - Bubbled when group data changes
- * @fires update-rule - Bubbled when rule data changes
+ * @fires change - Fired when the expression model changes. detail: `ChangeEventDetail`
+ * @fires add-group - Bubbled when a nested group add is requested. detail: `AddGroupEventDetail`
+ * @fires del-group - Bubbled when a group delete is requested. detail: `DelGroupEventDetail`
+ * @fires add-rule - Bubbled when a rule add is requested. detail: `AddRuleEventDetail`
+ * @fires del-rule - Bubbled when a rule delete is requested. detail: `DelRuleEventDetail`
+ * @fires update-group - Bubbled when group data changes. detail: `UpdateGroupEventDetail`
+ * @fires update-rule - Bubbled when rule data changes. detail: `UpdateRuleEventDetail`
  *
  * @beta
  */

package/dist/dts/main/expression-group/expression-group.d.ts

@@ -4,10 +4,10 @@ import { Combinator, Config, ModelGroup, Styles } from '../../types';
  * Group node used inside expression-builder.
  * @beta
  *
- * @fires add-rule - Bubbled when adding a child rule
- * @fires add-group - Bubbled when adding a child group
- * @fires del-group - Bubbled when deleting this group
- * @fires update-group - Bubbled when combinator changes
+ * @fires add-rule - Bubbled when adding a child rule. detail: `AddRuleEventDetail`
+ * @fires add-group - Bubbled when adding a child group. detail: `AddGroupEventDetail`
+ * @fires del-group - Bubbled when deleting this group. detail: `DelGroupEventDetail`
+ * @fires update-group - Bubbled when combinator changes. detail: `UpdateGroupEventDetail`
  */
 export declare class ExpressionGroup extends GenesisElement {
     config: Config;

package/dist/dts/main/expression-rule/expression-rule.d.ts

@@ -5,8 +5,8 @@ import { Events, EventsDetailMap } from '../events';
  * Rule node used inside expression-builder.
  * @beta
  *
- * @fires del-rule - Bubbled when deleting this rule
- * @fires update-rule - Bubbled when field/operator/value changes
+ * @fires del-rule - Bubbled when deleting this rule. detail: `DelRuleEventDetail`
+ * @fires update-rule - Bubbled when field/operator/value changes. detail: `UpdateRuleEventDetail`
  */
 export declare class ExpressionRule extends GenesisElement {
     config: Config;

package/dist/dts/main/index.d.ts

@@ -1,3 +1,4 @@
+export * from './events';
 export * from './expression-builder';
 export * from './expression-builder.styles';
 export * from './expression-builder.template';

package/dist/dts/main/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/main/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/main/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC"}

package/dist/dts/main/rule-field/rule-field.d.ts

@@ -4,7 +4,7 @@ import { Config, Field, Styles } from '../../types';
  * Field selector for expression rules.
  * @beta
  *
- * @fires field-selected - Bubbled when the selected field changes
+ * @fires field-selected - Bubbled when the selected field changes. detail: `FieldSelectedEventDetail`
  */
 export declare class RuleField extends GenesisElement {
     fields: Field[];

package/dist/dts/main/rule-operator/rule-operator.d.ts

@@ -4,7 +4,7 @@ import { Config, Field, Operator, Styles } from '../../types';
  * Operator selector for expression rules.
  * @beta
  *
- * @fires operator-selected - Bubbled when the selected operator changes
+ * @fires operator-selected - Bubbled when the selected operator changes. detail: `OperatorSelectedEventDetail`
  */
 export declare class RuleOperator extends GenesisElement {
     operators: Operator[];

package/dist/dts/main/rule-value/rule-value.d.ts

@@ -4,8 +4,8 @@ import { Config, Field, Operator, Styles } from '../../types';
  * Value editor for expression rules.
  * @beta
  *
- * @fires value-updated - Bubbled when operand value changes
- * @fires remove-variadic-operand - Bubbled when a variadic operand is removed
+ * @fires value-updated - Bubbled when operand value changes. detail: `ValueUpdatedEventDetail`
+ * @fires remove-variadic-operand - Bubbled when a variadic operand is removed. detail: `RemoveVarArgEventDetail`
  */
 export declare class RuleValue extends GenesisElement {
     valueIndex: string;

package/dist/dts/react.d.ts

@@ -10,6 +10,7 @@ import type { ExpressionRule as ExpressionRuleWC } from './main/expression-rule/
 import type { RuleField as RuleFieldWC } from './main/rule-field/rule-field';
 import type { RuleOperator as RuleOperatorWC } from './main/rule-operator/rule-operator';
 import type { RuleValue as RuleValueWC } from './main/rule-value/rule-value';
+import type { AddGroupEventDetail, AddRuleEventDetail, DelGroupEventDetail, DelRuleEventDetail, FieldSelectedEventDetail, OperatorSelectedEventDetail, RemoveVarArgEventDetail, UpdateGroupEventDetail, UpdateRuleEventDetail, ValueUpdatedEventDetail } from '@genesislcap/expression-builder';
 
 /** @internal Maps a web component class to its public props only.
  * keyof T skips private/protected members, so this avoids the TS error
@@ -44,12 +45,12 @@ export declare const ExpressionBuilder: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<ExpressionBuilderWC>, 'children' | 'style'> &
     HTMLWCProps & {
-      onAddGroup?: (event: CustomEvent<unknown>) => void;
-      onDelGroup?: (event: CustomEvent<unknown>) => void;
-      onAddRule?: (event: CustomEvent<unknown>) => void;
-      onDelRule?: (event: CustomEvent<unknown>) => void;
-      onUpdateGroup?: (event: CustomEvent<unknown>) => void;
-      onUpdateRule?: (event: CustomEvent<unknown>) => void;
+      onAddGroup?: (event: CustomEvent<AddGroupEventDetail>) => void;
+      onDelGroup?: (event: CustomEvent<DelGroupEventDetail>) => void;
+      onAddRule?: (event: CustomEvent<AddRuleEventDetail>) => void;
+      onDelRule?: (event: CustomEvent<DelRuleEventDetail>) => void;
+      onUpdateGroup?: (event: CustomEvent<UpdateGroupEventDetail>) => void;
+      onUpdateRule?: (event: CustomEvent<UpdateRuleEventDetail>) => void;
     }
   > & React.RefAttributes<ExpressionBuilderWC>
 >;
@@ -59,10 +60,10 @@ export declare const ExpressionGroup: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<ExpressionGroupWC>, 'children' | 'style'> &
     HTMLWCProps & {
-      onAddRule?: (event: CustomEvent<unknown>) => void;
-      onAddGroup?: (event: CustomEvent<unknown>) => void;
-      onDelGroup?: (event: CustomEvent<unknown>) => void;
-      onUpdateGroup?: (event: CustomEvent<unknown>) => void;
+      onAddRule?: (event: CustomEvent<AddRuleEventDetail>) => void;
+      onAddGroup?: (event: CustomEvent<AddGroupEventDetail>) => void;
+      onDelGroup?: (event: CustomEvent<DelGroupEventDetail>) => void;
+      onUpdateGroup?: (event: CustomEvent<UpdateGroupEventDetail>) => void;
     }
   > & React.RefAttributes<ExpressionGroupWC>
 >;
@@ -72,8 +73,8 @@ export declare const ExpressionRule: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<ExpressionRuleWC>, 'children' | 'style'> &
     HTMLWCProps & {
-      onDelRule?: (event: CustomEvent<unknown>) => void;
-      onUpdateRule?: (event: CustomEvent<unknown>) => void;
+      onDelRule?: (event: CustomEvent<DelRuleEventDetail>) => void;
+      onUpdateRule?: (event: CustomEvent<UpdateRuleEventDetail>) => void;
     }
   > & React.RefAttributes<ExpressionRuleWC>
 >;
@@ -83,7 +84,7 @@ export declare const RuleField: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<RuleFieldWC>, 'children' | 'style'> &
     HTMLWCProps & {
-      onFieldSelected?: (event: CustomEvent<unknown>) => void;
+      onFieldSelected?: (event: CustomEvent<FieldSelectedEventDetail>) => void;
     }
   > & React.RefAttributes<RuleFieldWC>
 >;
@@ -93,7 +94,7 @@ export declare const RuleOperator: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<RuleOperatorWC>, 'children' | 'style'> &
     HTMLWCProps & {
-      onOperatorSelected?: (event: CustomEvent<unknown>) => void;
+      onOperatorSelected?: (event: CustomEvent<OperatorSelectedEventDetail>) => void;
     }
   > & React.RefAttributes<RuleOperatorWC>
 >;
@@ -103,8 +104,8 @@ export declare const RuleValue: React.ForwardRefExoticComponent<
   React.PropsWithChildren<
     Omit<PublicOf<RuleValueWC>, 'children' | 'style'> &
     HTMLWCProps & {
-      onValueUpdated?: (event: CustomEvent<unknown>) => void;
-      onRemoveVariadicOperand?: (event: CustomEvent<unknown>) => void;
+      onValueUpdated?: (event: CustomEvent<ValueUpdatedEventDetail>) => void;
+      onRemoveVariadicOperand?: (event: CustomEvent<RemoveVarArgEventDetail>) => void;
     }
   > & React.RefAttributes<RuleValueWC>
 >;

package/dist/esm/main/events.js

@@ -1,3 +1,4 @@
+/** @beta Event names dispatched by the expression builder component family. */
 export var Events;
 (function (Events) {
     Events["AddGroup"] = "add-group";

package/dist/esm/main/expression-builder.js

@@ -21,13 +21,13 @@ ExpressionRule;
  * where you want to use a different (e.g. domain specific) model then it will likely override then emit event and instead emit
  * it's own model. To check the underlying `Types.Group` model check the {@link ExpressionBuilder.model} property.
  *
- * @fires change - Fired when the expression model changes
- * @fires add-group - Bubbled when a nested group add is requested
- * @fires del-group - Bubbled when a group delete is requested
- * @fires add-rule - Bubbled when a rule add is requested
- * @fires del-rule - Bubbled when a rule delete is requested
- * @fires update-group - Bubbled when group data changes
- * @fires update-rule - Bubbled when rule data changes
+ * @fires change - Fired when the expression model changes. detail: `ChangeEventDetail`
+ * @fires add-group - Bubbled when a nested group add is requested. detail: `AddGroupEventDetail`
+ * @fires del-group - Bubbled when a group delete is requested. detail: `DelGroupEventDetail`
+ * @fires add-rule - Bubbled when a rule add is requested. detail: `AddRuleEventDetail`
+ * @fires del-rule - Bubbled when a rule delete is requested. detail: `DelRuleEventDetail`
+ * @fires update-group - Bubbled when group data changes. detail: `UpdateGroupEventDetail`
+ * @fires update-rule - Bubbled when rule data changes. detail: `UpdateRuleEventDetail`
  *
  * @beta
  */

package/dist/esm/main/expression-group/expression-group.js

@@ -8,10 +8,10 @@ import { template } from './expression-group.template';
  * Group node used inside expression-builder.
  * @beta
  *
- * @fires add-rule - Bubbled when adding a child rule
- * @fires add-group - Bubbled when adding a child group
- * @fires del-group - Bubbled when deleting this group
- * @fires update-group - Bubbled when combinator changes
+ * @fires add-rule - Bubbled when adding a child rule. detail: `AddRuleEventDetail`
+ * @fires add-group - Bubbled when adding a child group. detail: `AddGroupEventDetail`
+ * @fires del-group - Bubbled when deleting this group. detail: `DelGroupEventDetail`
+ * @fires update-group - Bubbled when combinator changes. detail: `UpdateGroupEventDetail`
  */
 let ExpressionGroup = class ExpressionGroup extends GenesisElement {
     connectedCallback() {

package/dist/esm/main/expression-rule/expression-rule.js

@@ -15,8 +15,8 @@ RuleValue;
  * Rule node used inside expression-builder.
  * @beta
  *
- * @fires del-rule - Bubbled when deleting this rule
- * @fires update-rule - Bubbled when field/operator/value changes
+ * @fires del-rule - Bubbled when deleting this rule. detail: `DelRuleEventDetail`
+ * @fires update-rule - Bubbled when field/operator/value changes. detail: `UpdateRuleEventDetail`
  */
 let ExpressionRule = class ExpressionRule extends GenesisElement {
     constructor() {

package/dist/esm/main/index.js

@@ -1,3 +1,4 @@
+export * from './events';
 export * from './expression-builder';
 export * from './expression-builder.styles';
 export * from './expression-builder.template';

package/dist/esm/main/rule-field/rule-field.js

@@ -7,7 +7,7 @@ import { template } from './rule-field.template';
  * Field selector for expression rules.
  * @beta
  *
- * @fires field-selected - Bubbled when the selected field changes
+ * @fires field-selected - Bubbled when the selected field changes. detail: `FieldSelectedEventDetail`
  */
 let RuleField = class RuleField extends GenesisElement {
     constructor() {

package/dist/esm/main/rule-operator/rule-operator.js

@@ -7,7 +7,7 @@ import { template } from './rule-operator.template';
  * Operator selector for expression rules.
  * @beta
  *
- * @fires operator-selected - Bubbled when the selected operator changes
+ * @fires operator-selected - Bubbled when the selected operator changes. detail: `OperatorSelectedEventDetail`
  */
 let RuleOperator = class RuleOperator extends GenesisElement {
     constructor() {

package/dist/esm/main/rule-value/rule-value.js

@@ -9,8 +9,8 @@ import { ruleValueTemplate } from './rule-value.template';
  * Value editor for expression rules.
  * @beta
  *
- * @fires value-updated - Bubbled when operand value changes
- * @fires remove-variadic-operand - Bubbled when a variadic operand is removed
+ * @fires value-updated - Bubbled when operand value changes. detail: `ValueUpdatedEventDetail`
+ * @fires remove-variadic-operand - Bubbled when a variadic operand is removed. detail: `RemoveVarArgEventDetail`
  */
 let RuleValue = class RuleValue extends GenesisElement {
     constructor() {