@limetech/lime-crm-building-blocks 1.97.0 → 1.99.0

package/dist/types/components/lime-query-builder/expressions/lime-query-filter-expression.d.ts

@@ -1,19 +1,13 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { LimeQueryFilterExpression } from '../lime-query.types';
-import { LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform } from '@limetech/lime-web-components';
+import { Expression, LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform } from '@limetech/lime-web-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
  */
@@ -43,11 +37,13 @@ export declare class LimeQueryFilterExpressionComponent implements LimeWebCompon
     /**
      * The filter expression to render
      */
-    expression: LimeQueryFilterExpression;
+    expression: Expression;
     /**
      * Emitted when the filter expression changes
+     * Emits undefined when expression should be removed
      */
-    expressionChange: EventEmitter<LimeQueryFilterExpression>;
+    expressionChange: EventEmitter<Expression | undefined>;
     render(): any;
+    private handleExpressionChange;
 }
 //# sourceMappingURL=lime-query-filter-expression.d.ts.map

package/dist/types/components/lime-query-builder/expressions/lime-query-filter-group.d.ts

@@ -0,0 +1,60 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+import { AndOrExpression, Expression, LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform } from '@limetech/lime-web-components';
+/**
+ * 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
+ */
+export declare class LimeQueryFilterGroupComponent implements LimeWebComponent {
+    /**
+     * Platform service provider
+     */
+    platform: LimeWebComponentPlatform;
+    /**
+     * Component context
+     */
+    context: LimeWebComponentContext;
+    /**
+     * The limetype being queried (e.g., "deal", "company")
+     */
+    limetype: string;
+    /**
+     * The limetype of the active object (for %activeObject% placeholders)
+     */
+    activeLimetype?: string;
+    /**
+     * The group expression (AND or OR)
+     */
+    expression: AndOrExpression;
+    /**
+     * Emitted when the group expression changes
+     * Emits undefined when expression should be removed
+     * Can emit any Expression type when unwrapping (single child)
+     */
+    expressionChange: EventEmitter<Expression | undefined>;
+    render(): any;
+    private getSubheading;
+    private renderChildExpression;
+    private renderAddButton;
+    private renderAddGroupButton;
+    private getAddButtonLabel;
+    private getAddGroupButtonLabel;
+    private handleToggleOperator;
+    private handleAddChildExpression;
+    private handleAddChildGroup;
+    private handleExpressionChange;
+}
+//# sourceMappingURL=lime-query-filter-group.d.ts.map

package/dist/types/components/lime-query-builder/expressions/lime-query-filter-not.d.ts

@@ -1,6 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform } from '@limetech/lime-web-components';
-import { LimeQueryFilterNot, LimeQueryFilterMissing } from '../lime-query.types';
+import { LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform, NotExpression } from '@limetech/lime-web-components';
 /**
  * Lime Query Filter NOT Component
  *
@@ -43,11 +42,12 @@ export declare class LimeQueryFilterNotComponent implements LimeWebComponent {
     /**
      * The NOT expression containing the child expression to negate
      */
-    expression: LimeQueryFilterNot;
+    expression: NotExpression;
     /**
      * Emitted when the NOT expression changes (child expression modified or removed)
+     * Emits undefined when the expression should be removed
      */
-    expressionChange: EventEmitter<LimeQueryFilterNot | LimeQueryFilterMissing>;
+    expressionChange: EventEmitter<NotExpression | undefined>;
     render(): any;
     private handleExpressionChange;
 }

package/dist/types/components/lime-query-builder/expressions/lime-query-filter-or.d.ts

@@ -1,6 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform } from '@limetech/lime-web-components';
-import { LimeQueryFilterOr, LimeQueryFilterMissing } from '../lime-query.types';
+import { AndOrExpression, Expression, LimeWebComponent, LimeWebComponentContext, LimeWebComponentPlatform } from '@limetech/lime-web-components';
 /**
  * Lime Query Filter OR Component
  *
@@ -41,11 +40,13 @@ export declare class LimeQueryFilterOrComponent implements LimeWebComponent {
     /**
      * The OR expression containing child expressions
      */
-    expression: LimeQueryFilterOr;
+    expression: AndOrExpression;
     /**
      * 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)
      */
-    expressionChange: EventEmitter<LimeQueryFilterOr | LimeQueryFilterMissing>;
+    expressionChange: EventEmitter<Expression | undefined>;
     render(): any;
     private renderChildExpression;
     private handleExpressionChange;

package/dist/types/components/lime-query-builder/lime-query-builder.d.ts

@@ -14,11 +14,18 @@ import { LimeQuery } from './lime-query.types';
  * - **Type-aware inputs**: Automatic input types based on property type
  * - **Response format**: Select which properties to return
  * - **Query options**: Configure limit and other query parameters
+ * - **Placeholder support**: Use `%activeObject%` placeholders in filter values
  * - **Real-time output**: See the Lime Query JSON as you build
  *
  * The component produces a complete `LimeQuery` object that can be sent
  * directly to the Lime CRM backend.
  *
+ * **Active Object Placeholders**:
+ * When the `activeLimetype` prop is provided, the component enables validation
+ * and UI support for `%activeObject%` placeholders in filter expressions.
+ * 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
  * @private
  */
@@ -50,7 +57,12 @@ export declare class LimeQueryBuilder implements LimeWebComponent {
     private filter;
     private internalResponseFormat?;
     private limit?;
-    private activeLimetype?;
+    /**
+     * The limetype of the active object (for %activeObject% placeholder validation).
+     * When provided, enables placeholder validation and the placeholder input mode.
+     * When omitted, placeholders are accepted without validation.
+     */
+    activeLimetype?: string;
     private get guiModeEnabled();
     componentWillLoad(): void;
     render(): any;
@@ -58,7 +70,12 @@ export declare class LimeQueryBuilder implements LimeWebComponent {
     private handleFilterChange;
     private handleResponseFormatChange;
     private handleLimitChange;
-    private handleActiveLimetypeChange;
+    /**
+     * Normalize filter to ensure top-level is an AND group.
+     * This ensures Add buttons are available in the UI.
+     * @param filter
+     */
+    private normalizeFilter;
     private emitChange;
     private updateCodeValue;
     private checkGuiSupport;

package/dist/types/components/lime-query-builder/lime-query.types.d.ts

@@ -5,10 +5,11 @@
  * - lime-core/lime_query/schema.py
  * - lime-core/lime_filter/schema.py
  */
+import { Expression } from '@limetech/lime-web-components';
 export interface LimeQuery {
     limetype: string;
     responseFormat: ResponseFormat;
-    filter?: FilterExpression | FilterGroup;
+    filter?: Expression;
     orderBy?: OrderByItem[];
     limit?: number;
     offset?: number;