@limetech/lime-crm-building-blocks 1.98.0 → 1.100.0

package/dist/types/components.d.ts

@@ -5,7 +5,7 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
-import { AggregateOperator, LimeFileUrlType, LimeType, LimeWebComponentContext, LimeWebComponentPlatform } from "@limetech/lime-web-components";
+import { AggregateOperator, AndOrExpression, Expression, LimeFileUrlType, LimeType, LimeWebComponentContext, LimeWebComponentPlatform, NotExpression } from "@limetech/lime-web-components";
 import { BrowserItem } from "./components/browser/browser-item.types";
 import { ActionBarItem, CustomElementDefinition, DateType, EditorUiType, FormInfo, Icon, Image, Languages, ListItem, ListSeparator, OpenDirection } from "@limetech/lime-elements";
 import { ChatItem } from "./components/chat-list/chat-item/chat-item.types";
@@ -17,14 +17,14 @@ import { DateTimeFormat, NumberFormat, RelativeDateTimeFormat } from "./componen
 import { InfoTile } from "./components/info-tile/info-tile";
 import { KanbanGroup } from "./components/kanban/kanban-group/kanban-group.types";
 import { KanbanItem } from "./components/kanban/kanban-item/kanban-item.types";
-import { FilterOperator, LimeQuery, LimeQueryFilterAnd, LimeQueryFilterComparison, LimeQueryFilterExpression, LimeQueryFilterMissing, LimeQueryFilterNot, LimeQueryFilterOr, ResponseFormat } from "./components/lime-query-builder/lime-query.types";
+import { FilterOperator, LimeQuery, ResponseFormat } from "./components/lime-query-builder/lime-query.types";
 import { LanguagePickerType } from "./components/locale-picker/language-picker.types";
 import { NavigationButtonType } from "./components/navigation-button/navigation-button.types";
 import { NotificationItem } from "./components/notification-list/notification-item/notification-item.types";
 import { PropertySelectionItem } from "./components/lime-query-builder/property-selection-format";
 import { TriggerMap } from "./components/text-editor/text-editor.types";
 import { EnhancedEditorMetadata } from "./components/text-editor/uploader/building-blocks-upload-handler";
-export { AggregateOperator, LimeFileUrlType, LimeType, LimeWebComponentContext, LimeWebComponentPlatform } from "@limetech/lime-web-components";
+export { AggregateOperator, AndOrExpression, Expression, LimeFileUrlType, LimeType, LimeWebComponentContext, LimeWebComponentPlatform, NotExpression } from "@limetech/lime-web-components";
 export { BrowserItem } from "./components/browser/browser-item.types";
 export { ActionBarItem, CustomElementDefinition, DateType, EditorUiType, FormInfo, Icon, Image, Languages, ListItem, ListSeparator, OpenDirection } from "@limetech/lime-elements";
 export { ChatItem } from "./components/chat-list/chat-item/chat-item.types";
@@ -36,7 +36,7 @@ export { DateTimeFormat, NumberFormat, RelativeDateTimeFormat } from "./componen
 export { InfoTile } from "./components/info-tile/info-tile";
 export { KanbanGroup } from "./components/kanban/kanban-group/kanban-group.types";
 export { KanbanItem } from "./components/kanban/kanban-item/kanban-item.types";
-export { FilterOperator, LimeQuery, LimeQueryFilterAnd, LimeQueryFilterComparison, LimeQueryFilterExpression, LimeQueryFilterMissing, LimeQueryFilterNot, LimeQueryFilterOr, ResponseFormat } from "./components/lime-query-builder/lime-query.types";
+export { FilterOperator, LimeQuery, ResponseFormat } from "./components/lime-query-builder/lime-query.types";
 export { LanguagePickerType } from "./components/locale-picker/language-picker.types";
 export { NavigationButtonType } from "./components/navigation-button/navigation-button.types";
 export { NotificationItem } from "./components/notification-list/notification-item/notification-item.types";
@@ -968,6 +968,7 @@ export namespace Components {
      * These placeholders reference properties of a contextual "active object"
      * (e.g., `%activeObject%.company` references the company of the active object).
      * @exampleComponent limebb-example-lime-query-builder-basic
+     * @exampleComponent limebb-example-lime-query-builder-with-active-limetype
      * @private 
      */
     interface LimebbLimeQueryBuilder {
@@ -1016,7 +1017,7 @@ export namespace Components {
         /**
           * The AND expression containing child expressions
          */
-        "expression": LimeQueryFilterAnd;
+        "expression": AndOrExpression;
         /**
           * Optional label for the AND group
          */
@@ -1030,6 +1031,38 @@ export namespace Components {
          */
         "platform": LimeWebComponentPlatform;
     }
+    /**
+     * Lime Query Filter Builder
+     * Entry component for building Lime Query filter expressions.
+     * This component wraps the expression router and adds promotion logic
+     * for handling Add buttons and expression structure.
+     * Unlike the expression router (which is pure routing), this component
+     * contains business logic for promoting expressions and managing the
+     * filter structure.
+     * @private 
+     */
+    interface LimebbLimeQueryFilterBuilder {
+        /**
+          * The limetype of the active object (for %activeObject% placeholders)
+         */
+        "activeLimetype"?: string;
+        /**
+          * Component context
+         */
+        "context": LimeWebComponentContext;
+        /**
+          * The filter expression to build
+         */
+        "expression": Expression | undefined;
+        /**
+          * The limetype being queried (e.g., "deal", "company")
+         */
+        "limetype": string;
+        /**
+          * Platform service provider
+         */
+        "platform": LimeWebComponentPlatform;
+    }
     /**
      * Lime Query Filter Comparison Component
      * Renders a single comparison expression with three parts:
@@ -1060,7 +1093,7 @@ export namespace Components {
         /**
           * The comparison expression to render
          */
-        "expression": LimeQueryFilterComparison;
+        "expression": ComparisonExpression;
         /**
           * Optional label for the comparison
          */
@@ -1076,15 +1109,11 @@ export namespace Components {
     }
     /**
      * Lime Query Filter Expression Router
-     * This is the main entry point for rendering Lime Query filters.
-     * It routes to the appropriate sub-component based on the filter type:
-     * - `'AND'` → limebb-lime-query-filter-and
-     * - `'OR'` → limebb-lime-query-filter-or
-     * - `'NOT'` → limebb-lime-query-filter-not
-     * - `'comparison'` → limebb-lime-query-filter-comparison
-     * - `''` (missing) → limebb-lime-query-filter-comparison (default)
-     * Use this component when you need to render a complete filter expression
-     * that may contain nested AND/OR/NOT logic.
+     * Router component for rendering Lime Query filter expressions.
+     * Routes to the appropriate sub-component based on expression structure:
+     * - Has `key` property → limebb-lime-query-filter-comparison
+     * - `op: Operator.AND | Operator.OR` → limebb-lime-query-filter-group
+     * - `op: Operator.NOT` → limebb-lime-query-filter-not
      * @private 
      */
     interface LimebbLimeQueryFilterExpression {
@@ -1099,7 +1128,7 @@ export namespace Components {
         /**
           * The filter expression to render
          */
-        "expression": LimeQueryFilterExpression;
+        "expression": Expression;
         /**
           * Optional label for the expression
          */
@@ -1113,6 +1142,42 @@ export namespace Components {
          */
         "platform": LimeWebComponentPlatform;
     }
+    /**
+     * Lime Query Filter Group Component
+     * Renders a group of filter expressions with AND/OR logic that can be toggled.
+     * Users can click the header to toggle between "All conditions" (AND) and
+     * "Any condition" (OR).
+     * This component displays:
+     * - A clickable header showing the current logic (AND/OR)
+     * - A list of child expressions (which can be comparisons or nested groups)
+     * - An "Add" button to add more expressions
+     * Clicking the header toggles between AND and OR logic.
+     * If a child component emits an ExpressionChange event with undefined, the
+     * child is removed from the group.
+     * @private 
+     */
+    interface LimebbLimeQueryFilterGroup {
+        /**
+          * The limetype of the active object (for %activeObject% placeholders)
+         */
+        "activeLimetype"?: string;
+        /**
+          * Component context
+         */
+        "context": LimeWebComponentContext;
+        /**
+          * The group expression (AND or OR)
+         */
+        "expression": AndOrExpression;
+        /**
+          * The limetype being queried (e.g., "deal", "company")
+         */
+        "limetype": string;
+        /**
+          * Platform service provider
+         */
+        "platform": LimeWebComponentPlatform;
+    }
     /**
      * Lime Query Filter NOT Component
      * Renders a negated filter expression. This inverts the logic of the child expression,
@@ -1138,7 +1203,7 @@ export namespace Components {
         /**
           * The NOT expression containing the child expression to negate
          */
-        "expression": LimeQueryFilterNot;
+        "expression": NotExpression;
         /**
           * Optional label for the NOT expression
          */
@@ -1176,7 +1241,7 @@ export namespace Components {
         /**
           * The OR expression containing child expressions
          */
-        "expression": LimeQueryFilterOr;
+        "expression": AndOrExpression;
         /**
           * Optional label for the OR group
          */
@@ -2091,6 +2156,10 @@ export interface LimebbLimeQueryFilterAndCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLLimebbLimeQueryFilterAndElement;
 }
+export interface LimebbLimeQueryFilterBuilderCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLLimebbLimeQueryFilterBuilderElement;
+}
 export interface LimebbLimeQueryFilterComparisonCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLLimebbLimeQueryFilterComparisonElement;
@@ -2099,6 +2168,10 @@ export interface LimebbLimeQueryFilterExpressionCustomEvent<T> extends CustomEve
     detail: T;
     target: HTMLLimebbLimeQueryFilterExpressionElement;
 }
+export interface LimebbLimeQueryFilterGroupCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLLimebbLimeQueryFilterGroupElement;
+}
 export interface LimebbLimeQueryFilterNotCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLLimebbLimeQueryFilterNotElement;
@@ -2792,6 +2865,7 @@ declare global {
      * These placeholders reference properties of a contextual "active object"
      * (e.g., `%activeObject%.company` references the company of the active object).
      * @exampleComponent limebb-example-lime-query-builder-basic
+     * @exampleComponent limebb-example-lime-query-builder-with-active-limetype
      * @private 
      */
     interface HTMLLimebbLimeQueryBuilderElement extends Components.LimebbLimeQueryBuilder, HTMLStencilElement {
@@ -2809,7 +2883,7 @@ declare global {
         new (): HTMLLimebbLimeQueryBuilderElement;
     };
     interface HTMLLimebbLimeQueryFilterAndElementEventMap {
-        "expressionChange": LimeQueryFilterAnd | LimeQueryFilterMissing;
+        "expressionChange": Expression | undefined;
     }
     /**
      * Lime Query Filter AND Component
@@ -2837,8 +2911,35 @@ declare global {
         prototype: HTMLLimebbLimeQueryFilterAndElement;
         new (): HTMLLimebbLimeQueryFilterAndElement;
     };
+    interface HTMLLimebbLimeQueryFilterBuilderElementEventMap {
+        "expressionChange": Expression | undefined;
+    }
+    /**
+     * Lime Query Filter Builder
+     * Entry component for building Lime Query filter expressions.
+     * This component wraps the expression router and adds promotion logic
+     * for handling Add buttons and expression structure.
+     * Unlike the expression router (which is pure routing), this component
+     * contains business logic for promoting expressions and managing the
+     * filter structure.
+     * @private 
+     */
+    interface HTMLLimebbLimeQueryFilterBuilderElement extends Components.LimebbLimeQueryFilterBuilder, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLLimebbLimeQueryFilterBuilderElementEventMap>(type: K, listener: (this: HTMLLimebbLimeQueryFilterBuilderElement, ev: LimebbLimeQueryFilterBuilderCustomEvent<HTMLLimebbLimeQueryFilterBuilderElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLLimebbLimeQueryFilterBuilderElementEventMap>(type: K, listener: (this: HTMLLimebbLimeQueryFilterBuilderElement, ev: LimebbLimeQueryFilterBuilderCustomEvent<HTMLLimebbLimeQueryFilterBuilderElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLLimebbLimeQueryFilterBuilderElement: {
+        prototype: HTMLLimebbLimeQueryFilterBuilderElement;
+        new (): HTMLLimebbLimeQueryFilterBuilderElement;
+    };
     interface HTMLLimebbLimeQueryFilterComparisonElementEventMap {
-        "expressionChange": LimeQueryFilterComparison | LimeQueryFilterMissing;
+        "expressionChange": ComparisonExpression | undefined;
     }
     /**
      * Lime Query Filter Comparison Component
@@ -2873,19 +2974,15 @@ declare global {
         new (): HTMLLimebbLimeQueryFilterComparisonElement;
     };
     interface HTMLLimebbLimeQueryFilterExpressionElementEventMap {
-        "expressionChange": LimeQueryFilterExpression;
+        "expressionChange": Expression | undefined;
     }
     /**
      * Lime Query Filter Expression Router
-     * This is the main entry point for rendering Lime Query filters.
-     * It routes to the appropriate sub-component based on the filter type:
-     * - `'AND'` → limebb-lime-query-filter-and
-     * - `'OR'` → limebb-lime-query-filter-or
-     * - `'NOT'` → limebb-lime-query-filter-not
-     * - `'comparison'` → limebb-lime-query-filter-comparison
-     * - `''` (missing) → limebb-lime-query-filter-comparison (default)
-     * Use this component when you need to render a complete filter expression
-     * that may contain nested AND/OR/NOT logic.
+     * Router component for rendering Lime Query filter expressions.
+     * Routes to the appropriate sub-component based on expression structure:
+     * - Has `key` property → limebb-lime-query-filter-comparison
+     * - `op: Operator.AND | Operator.OR` → limebb-lime-query-filter-group
+     * - `op: Operator.NOT` → limebb-lime-query-filter-not
      * @private 
      */
     interface HTMLLimebbLimeQueryFilterExpressionElement extends Components.LimebbLimeQueryFilterExpression, HTMLStencilElement {
@@ -2902,8 +2999,39 @@ declare global {
         prototype: HTMLLimebbLimeQueryFilterExpressionElement;
         new (): HTMLLimebbLimeQueryFilterExpressionElement;
     };
+    interface HTMLLimebbLimeQueryFilterGroupElementEventMap {
+        "expressionChange": Expression | undefined;
+    }
+    /**
+     * Lime Query Filter Group Component
+     * Renders a group of filter expressions with AND/OR logic that can be toggled.
+     * Users can click the header to toggle between "All conditions" (AND) and
+     * "Any condition" (OR).
+     * This component displays:
+     * - A clickable header showing the current logic (AND/OR)
+     * - A list of child expressions (which can be comparisons or nested groups)
+     * - An "Add" button to add more expressions
+     * Clicking the header toggles between AND and OR logic.
+     * If a child component emits an ExpressionChange event with undefined, the
+     * child is removed from the group.
+     * @private 
+     */
+    interface HTMLLimebbLimeQueryFilterGroupElement extends Components.LimebbLimeQueryFilterGroup, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLLimebbLimeQueryFilterGroupElementEventMap>(type: K, listener: (this: HTMLLimebbLimeQueryFilterGroupElement, ev: LimebbLimeQueryFilterGroupCustomEvent<HTMLLimebbLimeQueryFilterGroupElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLLimebbLimeQueryFilterGroupElementEventMap>(type: K, listener: (this: HTMLLimebbLimeQueryFilterGroupElement, ev: LimebbLimeQueryFilterGroupCustomEvent<HTMLLimebbLimeQueryFilterGroupElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLLimebbLimeQueryFilterGroupElement: {
+        prototype: HTMLLimebbLimeQueryFilterGroupElement;
+        new (): HTMLLimebbLimeQueryFilterGroupElement;
+    };
     interface HTMLLimebbLimeQueryFilterNotElementEventMap {
-        "expressionChange": LimeQueryFilterNot | LimeQueryFilterMissing;
+        "expressionChange": NotExpression | undefined;
     }
     /**
      * Lime Query Filter NOT Component
@@ -2933,7 +3061,7 @@ declare global {
         new (): HTMLLimebbLimeQueryFilterNotElement;
     };
     interface HTMLLimebbLimeQueryFilterOrElementEventMap {
-        "expressionChange": LimeQueryFilterOr | LimeQueryFilterMissing;
+        "expressionChange": Expression | undefined;
     }
     /**
      * Lime Query Filter OR Component
@@ -3501,8 +3629,10 @@ declare global {
         "limebb-kanban-item": HTMLLimebbKanbanItemElement;
         "limebb-lime-query-builder": HTMLLimebbLimeQueryBuilderElement;
         "limebb-lime-query-filter-and": HTMLLimebbLimeQueryFilterAndElement;
+        "limebb-lime-query-filter-builder": HTMLLimebbLimeQueryFilterBuilderElement;
         "limebb-lime-query-filter-comparison": HTMLLimebbLimeQueryFilterComparisonElement;
         "limebb-lime-query-filter-expression": HTMLLimebbLimeQueryFilterExpressionElement;
+        "limebb-lime-query-filter-group": HTMLLimebbLimeQueryFilterGroupElement;
         "limebb-lime-query-filter-not": HTMLLimebbLimeQueryFilterNotElement;
         "limebb-lime-query-filter-or": HTMLLimebbLimeQueryFilterOrElement;
         "limebb-lime-query-value-input": HTMLLimebbLimeQueryValueInputElement;
@@ -4544,6 +4674,7 @@ declare namespace LocalJSX {
      * These placeholders reference properties of a contextual "active object"
      * (e.g., `%activeObject%.company` references the company of the active object).
      * @exampleComponent limebb-example-lime-query-builder-basic
+     * @exampleComponent limebb-example-lime-query-builder-with-active-limetype
      * @private 
      */
     interface LimebbLimeQueryBuilder {
@@ -4596,7 +4727,7 @@ declare namespace LocalJSX {
         /**
           * The AND expression containing child expressions
          */
-        "expression"?: LimeQueryFilterAnd;
+        "expression"?: AndOrExpression;
         /**
           * Optional label for the AND group
          */
@@ -4606,9 +4737,45 @@ declare namespace LocalJSX {
          */
         "limetype"?: string;
         /**
-          * Emitted when the AND expression changes (expressions added/removed/modified)
+          * Emitted when the AND expression changes (expressions added/removed/modified) Emits undefined when expression should be removed Can emit any Expression type when unwrapping (single child)
+         */
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterAndCustomEvent<Expression | undefined>) => void;
+        /**
+          * Platform service provider
+         */
+        "platform"?: LimeWebComponentPlatform;
+    }
+    /**
+     * Lime Query Filter Builder
+     * Entry component for building Lime Query filter expressions.
+     * This component wraps the expression router and adds promotion logic
+     * for handling Add buttons and expression structure.
+     * Unlike the expression router (which is pure routing), this component
+     * contains business logic for promoting expressions and managing the
+     * filter structure.
+     * @private 
+     */
+    interface LimebbLimeQueryFilterBuilder {
+        /**
+          * The limetype of the active object (for %activeObject% placeholders)
+         */
+        "activeLimetype"?: string;
+        /**
+          * Component context
+         */
+        "context"?: LimeWebComponentContext;
+        /**
+          * The filter expression to build
+         */
+        "expression"?: Expression | undefined;
+        /**
+          * The limetype being queried (e.g., "deal", "company")
+         */
+        "limetype"?: string;
+        /**
+          * Emitted when the filter expression changes Emits undefined when expression should be removed
          */
-        "onExpressionChange"?: (event: LimebbLimeQueryFilterAndCustomEvent<LimeQueryFilterAnd | LimeQueryFilterMissing>) => void;
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterBuilderCustomEvent<Expression | undefined>) => void;
         /**
           * Platform service provider
          */
@@ -4644,7 +4811,7 @@ declare namespace LocalJSX {
         /**
           * The comparison expression to render
          */
-        "expression"?: LimeQueryFilterComparison;
+        "expression"?: ComparisonExpression;
         /**
           * Optional label for the comparison
          */
@@ -4654,9 +4821,9 @@ declare namespace LocalJSX {
          */
         "limetype"?: string;
         /**
-          * Emitted when the comparison expression changes (property/operator/value modified)
+          * Emitted when the comparison expression changes (property/operator/value modified) Emits undefined when the expression should be removed
          */
-        "onExpressionChange"?: (event: LimebbLimeQueryFilterComparisonCustomEvent<LimeQueryFilterComparison | LimeQueryFilterMissing>) => void;
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterComparisonCustomEvent<ComparisonExpression | undefined>) => void;
         /**
           * Platform service provider
          */
@@ -4664,15 +4831,11 @@ declare namespace LocalJSX {
     }
     /**
      * Lime Query Filter Expression Router
-     * This is the main entry point for rendering Lime Query filters.
-     * It routes to the appropriate sub-component based on the filter type:
-     * - `'AND'` → limebb-lime-query-filter-and
-     * - `'OR'` → limebb-lime-query-filter-or
-     * - `'NOT'` → limebb-lime-query-filter-not
-     * - `'comparison'` → limebb-lime-query-filter-comparison
-     * - `''` (missing) → limebb-lime-query-filter-comparison (default)
-     * Use this component when you need to render a complete filter expression
-     * that may contain nested AND/OR/NOT logic.
+     * Router component for rendering Lime Query filter expressions.
+     * Routes to the appropriate sub-component based on expression structure:
+     * - Has `key` property → limebb-lime-query-filter-comparison
+     * - `op: Operator.AND | Operator.OR` → limebb-lime-query-filter-group
+     * - `op: Operator.NOT` → limebb-lime-query-filter-not
      * @private 
      */
     interface LimebbLimeQueryFilterExpression {
@@ -4687,7 +4850,7 @@ declare namespace LocalJSX {
         /**
           * The filter expression to render
          */
-        "expression"?: LimeQueryFilterExpression;
+        "expression"?: Expression;
         /**
           * Optional label for the expression
          */
@@ -4697,9 +4860,49 @@ declare namespace LocalJSX {
          */
         "limetype"?: string;
         /**
-          * Emitted when the filter expression changes
+          * Emitted when the filter expression changes Emits undefined when expression should be removed
          */
-        "onExpressionChange"?: (event: LimebbLimeQueryFilterExpressionCustomEvent<LimeQueryFilterExpression>) => void;
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterExpressionCustomEvent<Expression | undefined>) => void;
+        /**
+          * Platform service provider
+         */
+        "platform"?: LimeWebComponentPlatform;
+    }
+    /**
+     * Lime Query Filter Group Component
+     * Renders a group of filter expressions with AND/OR logic that can be toggled.
+     * Users can click the header to toggle between "All conditions" (AND) and
+     * "Any condition" (OR).
+     * This component displays:
+     * - A clickable header showing the current logic (AND/OR)
+     * - A list of child expressions (which can be comparisons or nested groups)
+     * - An "Add" button to add more expressions
+     * Clicking the header toggles between AND and OR logic.
+     * If a child component emits an ExpressionChange event with undefined, the
+     * child is removed from the group.
+     * @private 
+     */
+    interface LimebbLimeQueryFilterGroup {
+        /**
+          * The limetype of the active object (for %activeObject% placeholders)
+         */
+        "activeLimetype"?: string;
+        /**
+          * Component context
+         */
+        "context"?: LimeWebComponentContext;
+        /**
+          * The group expression (AND or OR)
+         */
+        "expression"?: AndOrExpression;
+        /**
+          * The limetype being queried (e.g., "deal", "company")
+         */
+        "limetype"?: string;
+        /**
+          * Emitted when the group expression changes Emits undefined when expression should be removed Can emit any Expression type when unwrapping (single child)
+         */
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterGroupCustomEvent<Expression | undefined>) => void;
         /**
           * Platform service provider
          */
@@ -4730,7 +4933,7 @@ declare namespace LocalJSX {
         /**
           * The NOT expression containing the child expression to negate
          */
-        "expression"?: LimeQueryFilterNot;
+        "expression"?: NotExpression;
         /**
           * Optional label for the NOT expression
          */
@@ -4740,9 +4943,9 @@ declare namespace LocalJSX {
          */
         "limetype"?: string;
         /**
-          * Emitted when the NOT expression changes (child expression modified or removed)
+          * Emitted when the NOT expression changes (child expression modified or removed) Emits undefined when the expression should be removed
          */
-        "onExpressionChange"?: (event: LimebbLimeQueryFilterNotCustomEvent<LimeQueryFilterNot | LimeQueryFilterMissing>) => void;
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterNotCustomEvent<NotExpression | undefined>) => void;
         /**
           * Platform service provider
          */
@@ -4772,7 +4975,7 @@ declare namespace LocalJSX {
         /**
           * The OR expression containing child expressions
          */
-        "expression"?: LimeQueryFilterOr;
+        "expression"?: AndOrExpression;
         /**
           * Optional label for the OR group
          */
@@ -4782,9 +4985,9 @@ declare namespace LocalJSX {
          */
         "limetype"?: string;
         /**
-          * Emitted when the OR expression changes (expressions added/removed/modified)
+          * Emitted when the OR expression changes (expressions added/removed/modified) Emits undefined when expression should be removed Can emit any Expression type when unwrapping (single child)
          */
-        "onExpressionChange"?: (event: LimebbLimeQueryFilterOrCustomEvent<LimeQueryFilterOr | LimeQueryFilterMissing>) => void;
+        "onExpressionChange"?: (event: LimebbLimeQueryFilterOrCustomEvent<Expression | undefined>) => void;
         /**
           * Platform service provider
          */
@@ -5690,8 +5893,10 @@ declare namespace LocalJSX {
         "limebb-kanban-item": LimebbKanbanItem;
         "limebb-lime-query-builder": LimebbLimeQueryBuilder;
         "limebb-lime-query-filter-and": LimebbLimeQueryFilterAnd;
+        "limebb-lime-query-filter-builder": LimebbLimeQueryFilterBuilder;
         "limebb-lime-query-filter-comparison": LimebbLimeQueryFilterComparison;
         "limebb-lime-query-filter-expression": LimebbLimeQueryFilterExpression;
+        "limebb-lime-query-filter-group": LimebbLimeQueryFilterGroup;
         "limebb-lime-query-filter-not": LimebbLimeQueryFilterNot;
         "limebb-lime-query-filter-or": LimebbLimeQueryFilterOr;
         "limebb-lime-query-value-input": LimebbLimeQueryValueInput;
@@ -6010,6 +6215,7 @@ declare module "@stencil/core" {
              * These placeholders reference properties of a contextual "active object"
              * (e.g., `%activeObject%.company` references the company of the active object).
              * @exampleComponent limebb-example-lime-query-builder-basic
+             * @exampleComponent limebb-example-lime-query-builder-with-active-limetype
              * @private 
              */
             "limebb-lime-query-builder": LocalJSX.LimebbLimeQueryBuilder & JSXBase.HTMLAttributes<HTMLLimebbLimeQueryBuilderElement>;
@@ -6026,6 +6232,17 @@ declare module "@stencil/core" {
              * @private 
              */
             "limebb-lime-query-filter-and": LocalJSX.LimebbLimeQueryFilterAnd & JSXBase.HTMLAttributes<HTMLLimebbLimeQueryFilterAndElement>;
+            /**
+             * Lime Query Filter Builder
+             * Entry component for building Lime Query filter expressions.
+             * This component wraps the expression router and adds promotion logic
+             * for handling Add buttons and expression structure.
+             * Unlike the expression router (which is pure routing), this component
+             * contains business logic for promoting expressions and managing the
+             * filter structure.
+             * @private 
+             */
+            "limebb-lime-query-filter-builder": LocalJSX.LimebbLimeQueryFilterBuilder & JSXBase.HTMLAttributes<HTMLLimebbLimeQueryFilterBuilderElement>;
             /**
              * Lime Query Filter Comparison Component
              * Renders a single comparison expression with three parts:
@@ -6047,18 +6264,29 @@ declare module "@stencil/core" {
             "limebb-lime-query-filter-comparison": LocalJSX.LimebbLimeQueryFilterComparison & JSXBase.HTMLAttributes<HTMLLimebbLimeQueryFilterComparisonElement>;
             /**
              * Lime Query Filter Expression Router
-             * This is the main entry point for rendering Lime Query filters.
-             * It routes to the appropriate sub-component based on the filter type:
-             * - `'AND'` → limebb-lime-query-filter-and
-             * - `'OR'` → limebb-lime-query-filter-or
-             * - `'NOT'` → limebb-lime-query-filter-not
-             * - `'comparison'` → limebb-lime-query-filter-comparison
-             * - `''` (missing) → limebb-lime-query-filter-comparison (default)
-             * Use this component when you need to render a complete filter expression
-             * that may contain nested AND/OR/NOT logic.
+             * Router component for rendering Lime Query filter expressions.
+             * Routes to the appropriate sub-component based on expression structure:
+             * - Has `key` property → limebb-lime-query-filter-comparison
+             * - `op: Operator.AND | Operator.OR` → limebb-lime-query-filter-group
+             * - `op: Operator.NOT` → limebb-lime-query-filter-not
              * @private 
              */
             "limebb-lime-query-filter-expression": LocalJSX.LimebbLimeQueryFilterExpression & JSXBase.HTMLAttributes<HTMLLimebbLimeQueryFilterExpressionElement>;
+            /**
+             * Lime Query Filter Group Component
+             * Renders a group of filter expressions with AND/OR logic that can be toggled.
+             * Users can click the header to toggle between "All conditions" (AND) and
+             * "Any condition" (OR).
+             * This component displays:
+             * - A clickable header showing the current logic (AND/OR)
+             * - A list of child expressions (which can be comparisons or nested groups)
+             * - An "Add" button to add more expressions
+             * Clicking the header toggles between AND and OR logic.
+             * If a child component emits an ExpressionChange event with undefined, the
+             * child is removed from the group.
+             * @private 
+             */
+            "limebb-lime-query-filter-group": LocalJSX.LimebbLimeQueryFilterGroup & JSXBase.HTMLAttributes<HTMLLimebbLimeQueryFilterGroupElement>;
             /**
              * Lime Query Filter NOT Component
              * Renders a negated filter expression. This inverts the logic of the child expression,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@limetech/lime-crm-building-blocks",
-  "version": "1.98.0",
+  "version": "1.100.0",
   "description": "A home for shared components meant for use with Lime CRM",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",