@meshmakers/octo-ui 3.3.860 → 3.3.880

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshmakers/octo-ui",
-  "version": "3.3.860",
+  "version": "3.3.880",
   "peerDependencies": {
     "@ngx-translate/core": "^17.0.0",
     "@angular/animations": "^21.0.6",

package/types/meshmakers-octo-ui.d.ts

@@ -964,13 +964,15 @@ declare class PropertyGridComponent implements OnInit, OnChanges {
 /**
  * Component for displaying property values with appropriate formatting
  */
-declare class PropertyValueDisplayComponent implements OnInit {
+declare class PropertyValueDisplayComponent implements OnInit, OnChanges {
     value: unknown;
     type: AttributeValueTypeDto;
     displayMode: PropertyDisplayMode;
+    attributeName: string;
     /** Emitted when a binary download is requested */
     binaryDownload: EventEmitter<BinaryDownloadEvent>;
     isExpanded: boolean;
+    private readonly windowService;
     expandableRecord: boolean;
     complexType: boolean;
     binaryLinkedWithDownload: boolean;
@@ -982,15 +984,31 @@ declare class PropertyValueDisplayComponent implements OnInit {
     binarySize: number | null;
     binaryContentType: string | null;
     formattedBinarySize: string;
+    useRecordArrayTable: boolean;
+    recordArrayColumns: string[];
+    recordArrayRows: Record<string, unknown>[];
+    /** Hard cap so we don't render a horizontally-unmanageable table. */
+    private static readonly MAX_TABLE_COLUMNS;
     readonly PropertyDisplayMode: typeof PropertyDisplayMode;
     readonly AttributeValueTypeDto: typeof AttributeValueTypeDto;
     readonly Array: ArrayConstructor;
     readonly chevronRightIcon: _progress_kendo_svg_icons.SVGIcon;
     readonly chevronDownIcon: _progress_kendo_svg_icons.SVGIcon;
     readonly downloadIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly windowIcon: _progress_kendo_svg_icons.SVGIcon;
     ngOnInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    private recomputeDerivedValues;
     private computeFormattedValue;
     private computeIsExpandableRecord;
+    /**
+     * For RecordArray values, attempt to render as a compact table when the
+     * records share enough structure: ≥ 2 items, every item is object-like, and
+     * the union of keys stays within MAX_TABLE_COLUMNS. Columns are ordered by
+     * first appearance. Rows are stored as plain objects keyed by column name
+     * so the template can do `row[col]` lookups cheaply.
+     */
+    private computeRecordArrayTable;
     private computeIsComplexType;
     private computeTypeIndicator;
     private computeTypeDescription;
@@ -1022,6 +1040,15 @@ declare class PropertyValueDisplayComponent implements OnInit {
      * Toggle expansion state
      */
     toggleExpansion(): void;
+    /**
+     * Open the record-detail viewer in a Kendo Window. Using `WindowService.open`
+     * (instead of an inline `<kendo-window>`) is what makes the window mount at
+     * the application root with proper viewport positioning. An inline window
+     * inherits its tile's `position: relative` ancestor and ends up anchored
+     * inside that tile's box rather than on the meshboard surface.
+     */
+    openDetailDialog(event: Event): void;
+    private computeDialogTitle;
     /**
      * Compute summary text for record header
      */
@@ -1048,9 +1075,114 @@ declare class PropertyValueDisplayComponent implements OnInit {
      */
     onDownload(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PropertyValueDisplayComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyValueDisplayComponent, "mm-property-value-display", never, { "value": { "alias": "value"; "required": false; }; "type": { "alias": "type"; "required": false; }; "displayMode": { "alias": "displayMode"; "required": false; }; }, { "binaryDownload": "binaryDownload"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyValueDisplayComponent, "mm-property-value-display", never, { "value": { "alias": "value"; "required": false; }; "type": { "alias": "type"; "required": false; }; "displayMode": { "alias": "displayMode"; "required": false; }; "attributeName": { "alias": "attributeName"; "required": false; }; }, { "binaryDownload": "binaryDownload"; }, never, never, true, never>;
+}
+
+interface RecordProperty {
+    key: string;
+    value: unknown;
+    formattedValue: string;
+    type: AttributeValueTypeDto;
+}
+interface RecordArrayItem {
+    /** Stable position in the original array — preserved when filtering shrinks the visible list. */
+    originalIndex: number;
+    label: string | null;
+    properties: RecordProperty[];
+    expanded: boolean;
+}
+/**
+ * Content component for displaying Record and RecordArray attribute values.
+ * Designed to be hosted inside a Kendo Window opened via `WindowService.open()`
+ * — this guarantees the window is mounted at the application root (escaping
+ * any tile/widget stacking context) and is fully resizable, draggable,
+ * minimizable and maximizable like the other dialogs in the studio.
+ *
+ * Inputs are set on the component instance after the window is created:
+ *   const ref = windowService.open({ content: RecordDetailDialogComponent, ... });
+ *   const c = ref.content.instance as RecordDetailDialogComponent;
+ *   c.attributeName = ...; c.value = ...; c.type = ...;
+ */
+declare class RecordDetailDialogComponent implements OnInit {
+    attributeName: string;
+    value: unknown;
+    type: AttributeValueTypeDto;
+    /**
+     * Emitted when the user-visible state changes in a way the host might want
+     * to react to. Currently unused for closing — the host listens to
+     * `WindowRef.result` for that.
+     */
+    closed: EventEmitter<void>;
+    singleRecordProperties: RecordProperty[];
+    recordItems: RecordArrayItem[];
+    searchTerm: string;
+    readonly fileIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly folderIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly calendarIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly checkboxCheckedIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly listUnorderedIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly chevronRightIcon: _progress_kendo_svg_icons.SVGIcon;
+    readonly chevronDownIcon: _progress_kendo_svg_icons.SVGIcon;
+    get isRecordArray(): boolean;
+    /**
+     * Compute the title text for the host window. The host reads this via
+     * the component instance after construction.
+     */
+    get dialogTitle(): string;
+    ngOnInit(): void;
+    /**
+     * Recompute derived state. Public so the host can call it after late
+     * input assignment (WindowService.open() instantiates the component
+     * before inputs can be set on its instance).
+     */
+    recompute(): void;
+    /**
+     * Records visible after applying the search filter. With no search term
+     * this is just the full list. The matcher checks the record's label and
+     * every property's key + formatted value (case-insensitive substring).
+     */
+    get visibleRecords(): RecordArrayItem[];
+    /**
+     * When search is active, force matching records open so their content is
+     * visible without an extra click. Outside search mode the user's manual
+     * expanded state wins.
+     */
+    isRecordExpanded(record: RecordArrayItem): boolean;
+    onSearchInput(event: Event): void;
+    clearSearch(): void;
+    private recordMatches;
+    toggleRecord(index: number): void;
+    expandAll(): void;
+    collapseAll(): void;
+    getTypeIcon(type: AttributeValueTypeDto): _progress_kendo_svg_icons.SVGIcon;
+    formatTypeName(type: AttributeValueTypeDto): string;
+    private toRecordProperties;
+    private formatValue;
+    private getRecordLabel;
+    private getObjectProperties;
+    private inferType;
+    private formatAttributeName;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RecordDetailDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RecordDetailDialogComponent, "mm-record-detail-dialog", never, { "attributeName": { "alias": "attributeName"; "required": false; }; "value": { "alias": "value"; "required": false; }; "type": { "alias": "type"; "required": false; }; }, { "closed": "closed"; }, never, never, true, never>;
 }
 
+/**
+ * Result of validating a mapping expression.
+ */
+interface ExpressionValidationResult {
+    /** Whether the expression is syntactically valid and evaluates successfully. */
+    valid: boolean;
+    /** Error message if the expression is invalid. */
+    error?: string;
+    /** Formatted evaluation result for display (e.g., "42" or "0.42"). */
+    preview?: string;
+}
+/**
+ * Function that validates a mapping expression.
+ * Receives the expression string and returns a validation result.
+ * The implementation can use any expression engine (e.g., expr-eval, mXparser via API).
+ */
+type ExpressionValidatorFn = (expression: string) => ExpressionValidationResult;
 interface DataPointMappingItem {
     rtId?: string;
     name?: string;
@@ -1063,6 +1195,12 @@ interface DataPointMappingItem {
     enabled?: boolean;
     /** Tracks the original target rtId at load time to detect changes on save. */
     _originalTargetRtId?: string;
+    /** Client-side validation status (not persisted, set by component). */
+    _expressionValid?: boolean;
+    /** Client-side validation error message (not persisted). */
+    _expressionError?: string;
+    /** Client-side evaluation preview (not persisted, e.g., "value=42 → 0.42"). */
+    _expressionPreview?: string;
 }
 
 interface RtEntityId {
@@ -1581,6 +1719,10 @@ declare class RuntimeBrowserDetailsComponent implements OnChanges, AfterViewInit
     private readonly attributeSelectorDialog;
     dataMappings: DataPointMappingItem[];
     sourceDataPoints: string[];
+    /**
+     * Optional expression validator function passed through to EntityDetailViewComponent → DataMappingListComponent.
+     */
+    expressionValidator?: ExpressionValidatorFn;
     protected readonly detailsIcon: _progress_kendo_svg_icons.SVGIcon;
     protected fullEntity: RtEntityDto | null;
     private loadRequestToken;
@@ -1701,7 +1843,7 @@ declare class RuntimeBrowserDetailsComponent implements OnChanges, AfterViewInit
      */
     onSaveAllMappings(): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<RuntimeBrowserDetailsComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RuntimeBrowserDetailsComponent, "mm-runtime-browser-details", never, { "selectedItem": { "alias": "selectedItem"; "required": false; }; "showDataMapping": { "alias": "showDataMapping"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; }, { "entitySaved": "entitySaved"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RuntimeBrowserDetailsComponent, "mm-runtime-browser-details", never, { "selectedItem": { "alias": "selectedItem"; "required": false; }; "showDataMapping": { "alias": "showDataMapping"; "required": false; }; "messages": { "alias": "messages"; "required": false; }; "expressionValidator": { "alias": "expressionValidator"; "required": false; }; }, { "entitySaved": "entitySaved"; }, never, never, true, never>;
 }
 
 type BrowserItem$1 = RtEntityDto | CkModelDto | CkTypeDto | {
@@ -1724,6 +1866,11 @@ declare class RuntimeBrowserComponent implements AfterViewInit {
     private isEditing;
     messages: i0.InputSignal<Partial<RuntimeBrowserMessages>>;
     showDataMapping: i0.InputSignal<boolean>;
+    /**
+     * Optional expression validator function for DataPointMapping expressions.
+     * Passed through to RuntimeBrowserDetailsComponent → EntityDetailViewComponent → DataMappingListComponent.
+     */
+    expressionValidator: i0.InputSignal<ExpressionValidatorFn | undefined>;
     protected readonly resolvedMessages: i0.Signal<RuntimeBrowserMessages>;
     treeDetail: BaseTreeDetailComponent<BrowserItem$1>;
     detailsPanel: RuntimeBrowserDetailsComponent;
@@ -1812,7 +1959,7 @@ declare class RuntimeBrowserComponent implements AfterViewInit {
         parentRtId?: string;
     }): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<RuntimeBrowserComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RuntimeBrowserComponent, "mm-runtime-browser", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "showDataMapping": { "alias": "showDataMapping"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RuntimeBrowserComponent, "mm-runtime-browser", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "showDataMapping": { "alias": "showDataMapping"; "required": false; "isSignal": true; }; "expressionValidator": { "alias": "expressionValidator"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**
@@ -1973,6 +2120,94 @@ declare class RuntimeBrowserStateService {
     static ɵprov: i0.ɵɵInjectableDeclaration<RuntimeBrowserStateService>;
 }
 
+/**
+ * View model for a DataPointMapping entity with resolved source/target information.
+ * Used by the DataMappingOverviewComponent for display in the grid.
+ */
+interface DataPointMappingOverviewItem {
+    /** DataPointMapping entity rtId */
+    rtId: string;
+    /** Display name of the mapping */
+    name: string;
+    /** Whether the mapping is enabled */
+    enabled: boolean;
+    /** Source attribute path (e.g., "CurrentValue") */
+    sourceAttributePath: string;
+    /** mXparser expression for value transformation */
+    mappingExpression: string;
+    /** Target attribute path (e.g., "Temperature") */
+    targetAttributePath: string;
+    /** Source entity rtId (from MapsFrom association) */
+    sourceRtId: string;
+    /** Source entity CK type (e.g., "Loxone/Control") */
+    sourceCkTypeId: string;
+    /** Resolved source entity name (loaded separately) */
+    sourceName: string;
+    /** Target entity rtId (from MapsTo association) */
+    targetRtId: string;
+    /** Target entity CK type (e.g., "EnergyIQ/Space") */
+    targetCkTypeId: string;
+    /** Resolved target entity name (loaded separately) */
+    targetName: string;
+    /** Validation status computed client-side */
+    validationStatus: 'valid' | 'warning' | 'error';
+    /** Validation messages */
+    validationMessages: ValidationMessage[];
+}
+interface ValidationMessage {
+    level: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+}
+interface MappingOverviewSummary {
+    total: number;
+    valid: number;
+    warnings: number;
+    errors: number;
+    disabled: number;
+}
+
+declare class DataMappingOverviewComponent implements OnInit {
+    private readonly getMappingsGQL;
+    private readonly getEntityByIdGQL;
+    private readonly updateEntitiesGQL;
+    private readonly deleteEntitiesGQL;
+    navigateToEntity: EventEmitter<{
+        rtId: string;
+        ckTypeId: string;
+    }>;
+    readonly mappings: i0.WritableSignal<DataPointMappingOverviewItem[]>;
+    readonly loading: i0.WritableSignal<boolean>;
+    readonly selectedMapping: i0.WritableSignal<DataPointMappingOverviewItem | null>;
+    pageSize: number;
+    skip: number;
+    readonly gridData: i0.Signal<{
+        data: DataPointMappingOverviewItem[];
+        total: number;
+    }>;
+    readonly summary: i0.Signal<MappingOverviewSummary>;
+    protected readonly refreshIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly checkIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly warnIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly errorIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly deleteIcon: _progress_kendo_svg_icons.SVGIcon;
+    ngOnInit(): void;
+    loadMappings(): Promise<void>;
+    onPageChange(event: PageChangeEvent): void;
+    onCellClick(event: CellClickEvent): void;
+    onToggleEnabled(item: DataPointMappingOverviewItem, enabled: boolean): Promise<void>;
+    onDeleteMapping(item: DataPointMappingOverviewItem): Promise<void>;
+    private mapEntityToOverviewItem;
+    private validateMapping;
+    /**
+     * Resolves entity names for all unique source/target rtIds.
+     * Updates items in-place and triggers signal update.
+     */
+    private resolveEntityNames;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataMappingOverviewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataMappingOverviewComponent, "mm-data-mapping-overview", never, {}, { "navigateToEntity": "navigateToEntity"; }, never, never, true, never>;
+}
+
 /**
  * Input data for the RuntimeEntityVariableDialog.
  */
@@ -2091,5 +2326,5 @@ declare class TenantSwitcherComponent {
  */
 declare function provideOctoUi(): EnvironmentProviders;
 
-export { AssociationValidationService, AttributeSelectorDialogComponent, AttributeSelectorDialogService, AttributeSortSelectorDialogComponent, AttributeSortSelectorDialogService, AttributeValueTypeDto, CkTypeSelectorDialogComponent, CkTypeSelectorDialogService, CkTypeSelectorInputComponent, DEFAULT_RUNTIME_BROWSER_MESSAGES, DefaultPropertyCategory, EntityDetailComponent, EntityIdInfoComponent, EntitySelectorDialogComponent, EntitySelectorDialogService, FieldFilterEditorComponent, OctoGraphQlDataSource, OctoGraphQlHierarchyDataSource, OctoLoaderComponent, PropertyConverterService, PropertyDisplayMode, PropertyGridComponent, PropertyValueDisplayComponent, RUNTIME_BROWSER_MESSAGES, RtEntityIdHelper, RuntimeBrowserComponent, RuntimeBrowserOutletComponent, RuntimeBrowserPageComponent, RuntimeBrowserStateService, RuntimeEntityVariableDialogComponent, RuntimeEntityVariableDialogService, TenantSwitcherComponent, account_tree, add, analytics, app_registration, article, botService, category, chat, checklist, code, component_exchange, computer, createRuntimeBrowserRoutes, customer, dashboard, event_list, graphic_eq, group, identityService, insert_link, manage_accounts, more_time, notifications, page_info, pages, person_search, playlist_add_check, pool, power, provideOctoUi, publicIcon, query_builder, schedule_send, settings, sort, storage, swagger, swagger_asset, swagger_bot, swagger_communication, swagger_identity, team_dashboard, tenancy, text_snippet, travel_explore, user_diagnostics, webhook, work };
-export type { AttributeSelectorDialogData, AttributeSelectorDialogResult, AttributeSelectorResult, AttributeSortItem, AttributeSortSelectorDialogData, AttributeSortSelectorDialogResult, AttributeSortSelectorResult, BinaryDownloadEvent, BrowserItem, BrowserState, CkAssociationRole, CkTypeSelectorDialogData, CkTypeSelectorDialogResult, CkTypeSelectorResult, EntitySelectorDialogData, EntitySelectorDialogResult, EntitySelectorResult, FieldFilterItem, FilterVariable, MoveValidationResult, PropertyChangeEvent, PropertyGridConfig, PropertyGridItem, RtEntityId, RuntimeBrowserMessages, RuntimeBrowserRouteOptions, RuntimeEntityVariableDialogData, RuntimeEntityVariableDialogResult, RuntimeEntityVariableMapping, RuntimeEntityVariableResult, SortOption };
+export { AssociationValidationService, AttributeSelectorDialogComponent, AttributeSelectorDialogService, AttributeSortSelectorDialogComponent, AttributeSortSelectorDialogService, AttributeValueTypeDto, CkTypeSelectorDialogComponent, CkTypeSelectorDialogService, CkTypeSelectorInputComponent, DEFAULT_RUNTIME_BROWSER_MESSAGES, DataMappingOverviewComponent, DefaultPropertyCategory, EntityDetailComponent, EntityIdInfoComponent, EntitySelectorDialogComponent, EntitySelectorDialogService, FieldFilterEditorComponent, OctoGraphQlDataSource, OctoGraphQlHierarchyDataSource, OctoLoaderComponent, PropertyConverterService, PropertyDisplayMode, PropertyGridComponent, PropertyValueDisplayComponent, RUNTIME_BROWSER_MESSAGES, RecordDetailDialogComponent, RtEntityIdHelper, RuntimeBrowserComponent, RuntimeBrowserOutletComponent, RuntimeBrowserPageComponent, RuntimeBrowserStateService, RuntimeEntityVariableDialogComponent, RuntimeEntityVariableDialogService, TenantSwitcherComponent, account_tree, add, analytics, app_registration, article, botService, category, chat, checklist, code, component_exchange, computer, createRuntimeBrowserRoutes, customer, dashboard, event_list, graphic_eq, group, identityService, insert_link, manage_accounts, more_time, notifications, page_info, pages, person_search, playlist_add_check, pool, power, provideOctoUi, publicIcon, query_builder, schedule_send, settings, sort, storage, swagger, swagger_asset, swagger_bot, swagger_communication, swagger_identity, team_dashboard, tenancy, text_snippet, travel_explore, user_diagnostics, webhook, work };
+export type { AttributeSelectorDialogData, AttributeSelectorDialogResult, AttributeSelectorResult, AttributeSortItem, AttributeSortSelectorDialogData, AttributeSortSelectorDialogResult, AttributeSortSelectorResult, BinaryDownloadEvent, BrowserItem, BrowserState, CkAssociationRole, CkTypeSelectorDialogData, CkTypeSelectorDialogResult, CkTypeSelectorResult, DataPointMappingItem, DataPointMappingOverviewItem, EntitySelectorDialogData, EntitySelectorDialogResult, EntitySelectorResult, ExpressionValidationResult, ExpressionValidatorFn, FieldFilterItem, FilterVariable, MappingOverviewSummary, MoveValidationResult, PropertyChangeEvent, PropertyGridConfig, PropertyGridItem, RtEntityId, RuntimeBrowserMessages, RuntimeBrowserRouteOptions, RuntimeEntityVariableDialogData, RuntimeEntityVariableDialogResult, RuntimeEntityVariableMapping, RuntimeEntityVariableResult, SortOption, ValidationMessage };