@limetech/lime-crm-building-blocks 1.105.0 → 1.105.2

package/dist/collection/components/component-command-picker/component-config/component-config.js

@@ -154,7 +154,7 @@ export class ComponentConfig {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -177,7 +177,7 @@ export class ComponentConfig {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/component-command-picker/component-picker/component-picker.js

@@ -174,7 +174,7 @@ export class ComponentPicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -197,7 +197,7 @@ export class ComponentPicker {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/date-picker/date-picker.js

@@ -118,7 +118,7 @@ export class DatePicker {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -144,7 +144,7 @@ export class DatePicker {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/date-range/date-range.js

@@ -89,7 +89,7 @@ export class DateRange {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -115,7 +115,7 @@ export class DateRange {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/document-picker/document-item/document-item.js

@@ -13,6 +13,11 @@ export class DocumentItemComponent {
          * - 'checkbox': renders a checkbox for multiple selection.
          */
         this.type = 'checkbox';
+        /**
+         * The preferred file URL types to use when displaying
+         * the document's image preview.
+         */
+        this.fileTypes = ['view', 'contents', 'download'];
         this.handleDocumentItemClick = (event) => {
             if (this.isUnavailable()) {
                 return;
@@ -72,21 +77,22 @@ export class DocumentItemComponent {
     }
     render() {
         const isUnavailable = this.isUnavailable();
-        return (h(Host, { key: '625f38ae7e31ae2b900366df8ad60ff2099a2ce6', id: this.item.id.toString(), class: {
-                'has-image': !!this.item.thumbnail,
+        const image = this.getImage();
+        return (h(Host, { key: '7fc37bbc0185cdb38c837f2487c88f4d275d1c2f', id: String(this.item.file.id), class: {
+                'has-image': !!image,
                 'has-error': !!this.item.hasError,
-            }, role: this.type === 'radio' ? 'radio' : 'checkbox', "aria-checked": this.item.selected ? 'true' : 'false', "aria-disabled": isUnavailable ? 'true' : 'false', tabIndex: isUnavailable ? -1 : 0 }, h("limel-card", { key: 'b88db5b44b9dfcd858f1e395d0837623dfe9b5a5', image: this.item.thumbnail, clickable: isUnavailable ? false : true, onClick: this.handleDocumentItemClick, onKeyDown: this.handleKeyDown }, h("div", { key: '558028048aba88caf524373cbeb7c14ebc371bdb', slot: "component" }, this.renderFileSize(), this.renderBooleanInput())), this.renderHelp()));
+            }, role: this.type === 'radio' ? 'radio' : 'checkbox', "aria-checked": this.item.selected ? 'true' : 'false', "aria-disabled": isUnavailable ? 'true' : 'false', tabIndex: isUnavailable ? -1 : 0 }, h("limel-card", { key: 'da1329af4f1eac4617da054b5b02715b512631ff', image: image, clickable: isUnavailable ? false : true, onClick: this.handleDocumentItemClick, onKeyDown: this.handleKeyDown }, h("div", { key: 'a30361cfb76512065fe3cf1b513f31257cf115ee', slot: "component" }, this.renderFileSize(), this.renderBooleanInput())), this.renderHelp()));
     }
     renderBooleanInput() {
         const id = this.getControlId();
         if (this.type === 'radio') {
-            return (h("limel-radio-button", { id: id, label: this.item.fileName, disabled: this.isUnavailable(), checked: this.item.selected, onClick: this.handleSelectionControlClick, onChange: this.handleSelectionControlChange }));
+            return (h("limel-radio-button", { id: id, label: this.item.file.filename, disabled: this.isUnavailable(), checked: this.item.selected, onClick: this.handleSelectionControlClick, onChange: this.handleSelectionControlChange }));
         }
-        return (h("limel-checkbox", { id: id, label: this.item.fileName, disabled: this.isUnavailable(), checked: this.item.selected, onClick: this.handleSelectionControlClick, onChange: this.handleSelectionControlChange }));
+        return (h("limel-checkbox", { id: id, label: this.item.file.filename, disabled: this.isUnavailable(), checked: this.item.selected, onClick: this.handleSelectionControlClick, onChange: this.handleSelectionControlChange }));
     }
     renderFileSize() {
-        var _a;
-        const formattedFileSize = formatBytes((_a = this.item) === null || _a === void 0 ? void 0 : _a.fileSize);
+        var _a, _b;
+        const formattedFileSize = formatBytes((_b = (_a = this.item) === null || _a === void 0 ? void 0 : _a.file) === null || _b === void 0 ? void 0 : _b.size);
         if (!formattedFileSize) {
             return;
         }
@@ -112,7 +118,7 @@ export class DocumentItemComponent {
         this.interact.emit(Object.assign(Object.assign({}, this.item), { selected }));
     }
     getControlId() {
-        return `boolean-input-${String(this.item.id)}`;
+        return `boolean-input-${String(this.item.file.id)}`;
     }
     isUnavailable() {
         var _a, _b;
@@ -126,6 +132,21 @@ export class DocumentItemComponent {
             input.checked = false;
         }
     }
+    getImage() {
+        const href = this.hrefForFile();
+        if (!href) {
+            return;
+        }
+        return {
+            src: href,
+            alt: this.item.file.filename,
+        };
+    }
+    hrefForFile() {
+        return ['preview', ...this.fileTypes]
+            .map((type) => this.item.file.getUrl(type))
+            .find(Boolean);
+    }
     static get is() { return "limebb-document-item"; }
     static get encapsulation() { return "shadow"; }
     static get delegatesFocus() { return true; }
@@ -162,7 +183,7 @@ export class DocumentItemComponent {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -188,7 +209,7 @@ export class DocumentItemComponent {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false
@@ -235,6 +256,30 @@ export class DocumentItemComponent {
                 "attribute": "type",
                 "reflect": true,
                 "defaultValue": "'checkbox'"
+            },
+            "fileTypes": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "LimeFileUrlType[]",
+                    "resolved": "LimeFileUrlType[]",
+                    "references": {
+                        "LimeFileUrlType": {
+                            "location": "import",
+                            "path": "@limetech/lime-web-components",
+                            "id": "node_modules::LimeFileUrlType"
+                        }
+                    }
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "The preferred file URL types to use when displaying\nthe document's image preview."
+                },
+                "getter": false,
+                "setter": false,
+                "defaultValue": "['view', 'contents', 'download']"
             }
         };
     }

package/dist/collection/components/document-picker/document-picker.js

@@ -47,7 +47,7 @@ export class DocumentPicker {
                 // or allow deselecting if clicking the already selected item
                 updatedItems = this.items
                     .map((item) => {
-                    if (item.id === interactedItem.id) {
+                    if (item.file.id === interactedItem.file.id) {
                         return Object.assign(Object.assign({}, item), { selected: interactedItem.selected });
                     }
                     return Object.assign(Object.assign({}, item), { selected: false });
@@ -57,7 +57,7 @@ export class DocumentPicker {
             else {
                 updatedItems = this.items
                     .map((item) => {
-                    if (item.id === interactedItem.id) {
+                    if (item.file.id === interactedItem.file.id) {
                         return Object.assign(Object.assign({}, item), { selected: interactedItem.selected });
                     }
                     return item;
@@ -79,7 +79,7 @@ export class DocumentPicker {
         return (h(Host, { key: '5e4a9004ed3b81b6c35be868c664e61cb88d490c' }, h("limel-notched-outline", { key: 'ada8928b3ed815896e1ef5fb61f539f0ab77c7af', labelId: this.labelId, label: this.label, required: this.required, invalid: this.invalid, hasFloatingLabel: true }, h("div", { key: '343aeef460a4ea4e0a4a247daf6988f749dc2b49', slot: "content", role: this.type === 'radio' ? 'radiogroup' : 'group', "aria-labelledby": this.label ? this.labelId : undefined, "aria-describedby": this.helperText ? this.helperTextId : undefined }, this.renderItems())), this.renderHelperLine()));
     }
     renderItems() {
-        return this.items.map((item) => (h("limebb-document-item", { platform: this.platform, context: this.context, item: item, key: item.id, type: this.type, onInteract: this.handleItemInteract })));
+        return this.items.map((item) => (h("limebb-document-item", { platform: this.platform, context: this.context, item: item, key: item.file.id, type: this.type, onInteract: this.handleItemInteract })));
     }
     static get is() { return "limebb-document-picker"; }
     static get encapsulation() { return "shadow"; }
@@ -116,7 +116,7 @@ export class DocumentPicker {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -142,7 +142,7 @@ export class DocumentPicker {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/feed/feed-item/feed-timeline-item.js

@@ -419,7 +419,7 @@ export class FeedTimelineItem {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -445,7 +445,7 @@ export class FeedTimelineItem {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/feed/feed.js

@@ -227,7 +227,7 @@ export class Feed {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -253,7 +253,7 @@ export class Feed {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/info-tile/info-tile.js

@@ -189,7 +189,7 @@ export class InfoTile {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -212,7 +212,7 @@ export class InfoTile {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/kanban/kanban-group/kanban-group.js

@@ -127,7 +127,7 @@ export class KanbanGroup {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -153,7 +153,7 @@ export class KanbanGroup {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/kanban/kanban-item/kanban-item.js

@@ -164,7 +164,7 @@ export class KanbanItemComponent {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -190,7 +190,7 @@ export class KanbanItemComponent {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/kanban/kanban.js

@@ -72,7 +72,7 @@ export class Kanban {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -98,7 +98,7 @@ export class Kanban {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/lime-query-builder/lime-query-validation.js

@@ -1,6 +1,5 @@
 import { Operator } from "@limetech/lime-web-components";
-import { getNormalizedProperties } from "./property-resolution";
-import { getPropertyFromPath } from "./property-resolution";
+import { getNormalizedProperties, getPropertyFromPath, validatePropertyPath, } from "./property-resolution";
 /**
  * Dynamic filter values and placeholders that are valid in Lime Query
  */
@@ -85,6 +84,46 @@ export function validatePlaceholder(value, activeLimetype, limetypes) {
         };
     }
 }
+/**
+ * Validates a filter expression key (property path).
+ * Supports both regular property paths and placeholders.
+ *
+ * @param key - Property path to validate (e.g., "name", "company.name", "%activeObject%.name")
+ * @param limetypes - All limetype definitions
+ * @param limetype - The limetype being filtered
+ * @param activeLimetype - Active limetype for placeholder resolution
+ * @returns Validation result with error message if invalid
+ */
+export function validateFilterKey(key, limetypes, limetype, activeLimetype) {
+    // 1. Handle empty/missing keys
+    if (!key) {
+        return { valid: false, error: 'Filter key cannot be empty' };
+    }
+    // 2. Check if key is a placeholder
+    if (key.startsWith('%activeObject%')) {
+        const placeholderResult = validatePlaceholder(key, activeLimetype, limetypes);
+        if (!placeholderResult.valid) {
+            return placeholderResult;
+        }
+        // Extract property path after the placeholder and validate for hasMany/hasAndBelongsToMany
+        const propertyPath = key.replace(/^%activeObject%\.?/, '');
+        if (propertyPath && activeLimetype) {
+            const { error } = validatePropertyPath(limetypes, activeLimetype, propertyPath);
+            if (error) {
+                return { valid: false, error };
+            }
+        }
+        return placeholderResult;
+    }
+    // 3. Validate regular property path (including intermediate properties)
+    const { error } = validatePropertyPath(limetypes, limetype, key);
+    if (error) {
+        return { valid: false, error };
+    }
+    // validatePropertyPath always returns an error if property is undefined,
+    // so if we reach here, the property exists and is valid
+    return { valid: true };
+}
 /**
  * Validate a response format against limetype schemas
  * Throws errors for invalid property references
@@ -253,13 +292,19 @@ export function validatePropertySelection(selection, limetypes, limetype, visual
  * @param filter
  * @param activeLimetype
  * @param limetypes
+ * @param limetype
  */
-function validateComparisonExpression(filter, activeLimetype, limetypes) {
+function validateComparisonExpression(filter, activeLimetype, limetypes, limetype) {
     // Validate operator
     const allValidOperators = Object.values(Operator);
     if (!allValidOperators.includes(filter.op)) {
         throw new Error(`Unsupported filter operator: ${filter.op}`);
     }
+    // Validate filter key
+    const keyResult = validateFilterKey(filter.key, limetypes, limetype, activeLimetype);
+    if (!keyResult.valid) {
+        throw new Error(`Invalid filter key '${filter.key}': ${keyResult.error}`);
+    }
     // Validate placeholder
     const result = validatePlaceholder(filter.exp, activeLimetype, limetypes);
     if (!result.valid) {
@@ -271,9 +316,10 @@ function validateComparisonExpression(filter, activeLimetype, limetypes) {
  * @param filter
  * @param activeLimetype
  * @param limetypes
+ * @param limetype
  * @param visualModeEnabled
  */
-function validateGroupExpression(filter, activeLimetype, limetypes, visualModeEnabled) {
+function validateGroupExpression(filter, activeLimetype, limetypes, limetype, visualModeEnabled) {
     // Validate operator
     if (filter.op !== Operator.AND &&
         filter.op !== Operator.OR &&
@@ -282,12 +328,12 @@ function validateGroupExpression(filter, activeLimetype, limetypes, visualModeEn
     }
     // Recursively validate children
     if (filter.op === Operator.NOT) {
-        validateFilterPlaceholders(filter.exp, activeLimetype, limetypes, visualModeEnabled);
+        validateFilterPlaceholders(filter.exp, activeLimetype, limetypes, limetype, visualModeEnabled);
     }
     else if (filter.op === Operator.AND || filter.op === Operator.OR) {
         const expressions = filter.exp;
         for (const expr of expressions) {
-            validateFilterPlaceholders(expr, activeLimetype, limetypes, visualModeEnabled);
+            validateFilterPlaceholders(expr, activeLimetype, limetypes, limetype, visualModeEnabled);
         }
     }
 }
@@ -296,37 +342,51 @@ function validateGroupExpression(filter, activeLimetype, limetypes, visualModeEn
  * @param filter Filter expression to validate
  * @param activeLimetype The limetype of the active object
  * @param limetypes Record of all available limetypes
+ * @param limetype The limetype being filtered
  * @param visualModeEnabled Whether visual mode is enabled (affects validation)
  */
-function validateFilterPlaceholders(filter, activeLimetype, limetypes, visualModeEnabled = true) {
+function validateFilterPlaceholders(filter, activeLimetype, limetypes, limetype, visualModeEnabled = true) {
     if (!filter) {
         return;
     }
     if ('key' in filter) {
-        validateComparisonExpression(filter, activeLimetype, limetypes);
+        validateComparisonExpression(filter, activeLimetype, limetypes, limetype);
         return;
     }
     if ('exp' in filter) {
-        validateGroupExpression(filter, activeLimetype, limetypes, visualModeEnabled);
+        validateGroupExpression(filter, activeLimetype, limetypes, limetype, visualModeEnabled);
     }
 }
 /**
- * Validate Lime Query filter and collect errors
+ * Validate Lime Query filter and collect errors and visual mode limitations
  * @param filter The filter expression or group to validate
  * @param activeLimetype Optional active object limetype for placeholder validation
  * @param limetypes Record of all available limetypes
+ * @param limetype The limetype being filtered
  * @param visualModeEnabled Whether visual mode is enabled
- * @returns Array of validation error messages
+ * @returns Object with validation errors and visual mode limitations
  */
-function validateLimeQueryFilterInternal(filter, activeLimetype, limetypes, visualModeEnabled) {
+function validateLimeQueryFilterInternal(filter, activeLimetype, limetypes, limetype, visualModeEnabled) {
     const errors = [];
+    const limitations = [];
     try {
-        validateFilterPlaceholders(filter, activeLimetype, limetypes, visualModeEnabled);
+        validateFilterPlaceholders(filter, activeLimetype, limetypes, limetype, visualModeEnabled);
     }
     catch (error) {
-        errors.push(`Invalid filter: ${error.message}`);
+        const errorMessage = error.message;
+        // Invalid keys are BOTH spec violations AND rendering limitations:
+        // - Backend will reject them (validation error)
+        // - Visual mode can't show them in property selector (visual limitation)
+        if (errorMessage.includes('Invalid filter key') ||
+            errorMessage.includes('Cannot filter on many-relation')) {
+            errors.push(`Invalid filter: ${errorMessage}`);
+            limitations.push(errorMessage);
+        }
+        else {
+            errors.push(`Invalid filter: ${errorMessage}`);
+        }
     }
-    return errors;
+    return { errors, limitations };
 }
 /**
  * Validate orderBy specification
@@ -495,8 +555,9 @@ export function isLimeQuerySupported(limeQuery, limetypes, activeLimetype, visua
     }
     // Validate filter
     if (limeQuery.filter) {
-        const filterErrors = validateLimeQueryFilterInternal(limeQuery.filter, activeLimetype, limetypes, visualModeEnabled);
-        validationErrors.push(...filterErrors);
+        const { errors, limitations } = validateLimeQueryFilterInternal(limeQuery.filter, activeLimetype, limetypes, limeQuery.limetype, visualModeEnabled);
+        validationErrors.push(...errors);
+        visualModeLimitations.push(...limitations);
     }
     // Validate responseFormat
     if (limeQuery.responseFormat) {

package/dist/collection/components/lime-query-builder/limetype-field/limetype-field.js

@@ -133,7 +133,7 @@ export class LimetypeField {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -159,7 +159,7 @@ export class LimetypeField {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/lime-query-builder/property-resolution.js

@@ -59,3 +59,49 @@ export function getPropertyFromPath(limetypes, limetype, path) {
     }
     return property;
 }
+/**
+ * Validates a property path to ensure no intermediate properties are hasMany or hasAndBelongsToMany relations.
+ * These relation types cannot be traversed in filter expressions.
+ * @param limetypes All limetype definitions
+ * @param limetype The starting limetype
+ * @param path The property path to validate (e.g., "company.name")
+ * @returns The property at the end of the path if valid, or undefined with error if invalid
+ */
+export function validatePropertyPath(limetypes, limetype, path) {
+    if (!path || !limetype || !limetypes) {
+        return { property: undefined };
+    }
+    const parts = path.split('.');
+    let currentType = limetypes[limetype];
+    let property;
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        if (!currentType) {
+            return { property: undefined };
+        }
+        const normalizedProperties = getNormalizedProperties(currentType);
+        property = normalizedProperties[part];
+        if (!property) {
+            return {
+                property: undefined,
+                error: `Property '${part}' does not exist on limetype '${currentType.name}'`,
+            };
+        }
+        // Check if this property is a hasMany/hasAndBelongsToMany relation
+        // These cannot be traversed in filter expressions
+        if (property.type === 'hasmany' ||
+            property.type === 'hasandbelongstomany') {
+            // Build the path up to this point for the error message
+            const invalidPath = parts.slice(0, i + 1).join('.');
+            return {
+                property: undefined,
+                error: `Cannot filter on many-relation '${invalidPath}'. Use a related limetype's filter instead.`,
+            };
+        }
+        // If this is a relation, get the related limetype for next iteration
+        if (property.relation) {
+            currentType = property.relation.getLimetype();
+        }
+    }
+    return { property };
+}

package/dist/collection/components/limeobject/file-viewer/file-viewer.js

@@ -161,7 +161,7 @@ export class FileViewer {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -184,7 +184,7 @@ export class FileViewer {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false

package/dist/collection/components/loader/loader.js

@@ -39,7 +39,7 @@ export class CrmComponentsLoader {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "Reference to the platform"
+                    "text": "Reference to the platform service container.\n\nUse this to access all platform services like repositories, HTTP client,\ncommand bus, navigator, and more. The platform instance is shared across\nall components in the same application context."
                 },
                 "getter": false,
                 "setter": false
@@ -65,7 +65,7 @@ export class CrmComponentsLoader {
                             "name": "inheritdoc",
                             "text": undefined
                         }],
-                    "text": "The context this component belongs to"
+                    "text": "The context describing where this component is running.\n\nThe context provides information about the current limetype and record ID\n(if viewing/editing a specific record). Components can use this to load\nrelevant data and understand their operating environment."
                 },
                 "getter": false,
                 "setter": false