@meshmakers/octo-ui 3.4.280 → 3.4.310

package/lib/runtime-browser/styles/_styles.scss

@@ -3818,29 +3818,11 @@
     }
   }
 
-  // Fix Kendo TileLayout drag offset caused by CSS zoom on kendo-drawer-content.
-  // When a tile is dragged, Kendo sets position:fixed on the item and calculates
-  // coordinates in viewport space. The parent zoom (from DensityService) scales
-  // those coordinates, causing the dragged tile to appear offset from the cursor.
-  // Counter-zooming the dragged item restores correct coordinate mapping.
-  kendo-tilelayout-item[style*="position: fixed"] {
-    zoom: calc(1 / var(--density-zoom, 1));
-  }
-
-  // Fix Kendo popup positioning when CSS zoom (density) is active on kendo-drawer-content.
-  // Popups with appendTo:'root' are rendered as direct children of <app-root>, outside
-  // the zoomed container. The dropdown component uses wrapper.offsetWidth (inflated by
-  // the zoom factor) for min-width, causing popups to be too wide and mispositioned.
-  // Using transform:scale() instead of CSS zoom because:
-  // - CSS zoom scales BOTH content AND the element's left/top position interpretation,
-  //   causing the popup to shift up-left from its intended anchor position.
-  // - transform:scale() only scales the visual rendering from transform-origin,
-  //   keeping left/top positioning intact (calculated correctly by Kendo from
-  //   getBoundingClientRect of the anchor element).
-  app-root > .k-animation-container {
-    transform: scale(var(--density-zoom, 1));
-    transform-origin: top left;
-  }
+  // NOTE (AB#4258): the former CSS-`zoom`-based UI density was replaced by root
+  // font-size (rem) scaling, so there is no ancestor `zoom` anymore. The Kendo
+  // TileLayout drag-offset and popup-position counter-zoom hacks that used to live
+  // here (keyed on `--density-zoom`) are therefore obsolete and were removed —
+  // coordinates now map 1:1 without compensation.
 
   // Widget Error State
   .widget-error {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshmakers/octo-ui",
-  "version": "3.4.280",
+  "version": "3.4.310",
   "peerDependencies": {
     "@ngx-translate/core": "^17.0.0",
     "@angular/animations": "^22.0.0",
@@ -50,6 +50,10 @@
     "./branding-settings": {
       "types": "./types/meshmakers-octo-ui-branding-settings.d.ts",
       "default": "./fesm2022/meshmakers-octo-ui-branding-settings.mjs"
+    },
+    "./tree-navigation-settings": {
+      "types": "./types/meshmakers-octo-ui-tree-navigation-settings.d.ts",
+      "default": "./fesm2022/meshmakers-octo-ui-tree-navigation-settings.mjs"
     }
   },
   "type": "module"

package/types/meshmakers-octo-ui-tree-navigation-settings.d.ts

@@ -0,0 +1,157 @@
+import * as _progress_kendo_svg_icons from '@progress/kendo-svg-icons';
+import * as _angular_forms from '@angular/forms';
+import { FormGroup } from '@angular/forms';
+import * as _angular_core from '@angular/core';
+import { OnInit } from '@angular/core';
+import { Routes } from '@angular/router';
+
+/** UI strings for the tree navigation settings editor. */
+interface TreeNavigationSettingsMessages {
+    title: string;
+    description: string;
+    /** Shown when System.UI < 2.2.0 (the CK type is not installed on the tenant). */
+    notInstalled: string;
+    columnSourceType: string;
+    columnRole: string;
+    columnDisplayName: string;
+    columnSortIndex: string;
+    columnVisible: string;
+    columnGrouped: string;
+    columnIcon: string;
+    columnActions: string;
+    visibleAuto: string;
+    visibleShow: string;
+    visibleHide: string;
+    groupedAuto: string;
+    groupedGroup: string;
+    groupedFlatten: string;
+    sourceTypeHint: string;
+    roleHint: string;
+    addRule: string;
+    removeRule: string;
+    save: string;
+    reload: string;
+    export: string;
+    import: string;
+    empty: string;
+    saveSuccess: string;
+    saveError: string;
+    loadError: string;
+    exportNothing: string;
+    exportError: string;
+    importSuccess: string;
+    importError: string;
+    perspectivesTitle: string;
+    perspectivesDescription: string;
+    columnKey: string;
+    columnPerspectiveName: string;
+    columnRootMode: string;
+    columnRootType: string;
+    columnPrimaryRole: string;
+    columnSecondaryRoles: string;
+    rootModeSpatial: string;
+    rootModeType: string;
+    secondaryRolesHint: string;
+    addPerspective: string;
+    perspectivesEmpty: string;
+}
+/** English defaults; hosts may override via the `messages` input. */
+declare const DEFAULT_TREE_NAVIGATION_SETTINGS_MESSAGES: TreeNavigationSettingsMessages;
+
+/**
+ * Admin editor for the per-tenant `System.UI/TreeNavigationConfiguration`.
+ * Each row is one override rule matched by (source type, role id); `*` as the
+ * source type matches every type. Empty dropdown value = auto (default
+ * behavior). Source type and role id offer autocomplete suggestions but also
+ * accept custom values (so orphan roles remain configurable).
+ */
+declare class TreeNavigationSettingsComponent implements OnInit {
+    readonly messages: _angular_core.InputSignal<TreeNavigationSettingsMessages>;
+    private readonly fb;
+    private readonly config;
+    private readonly ckTypeSelector;
+    private readonly assetRepo;
+    private readonly jobs;
+    private readonly importStrategyDialog;
+    private readonly route;
+    private readonly messageService;
+    protected readonly loading: _angular_core.WritableSignal<boolean>;
+    protected readonly saving: _angular_core.WritableSignal<boolean>;
+    protected readonly typePresent: _angular_core.WritableSignal<boolean>;
+    private rtId;
+    protected readonly rules: _angular_forms.FormArray<FormGroup<any>>;
+    protected readonly perspectiveRows: _angular_forms.FormArray<FormGroup<any>>;
+    protected readonly rootModeOptions: _angular_core.Signal<{
+        text: string;
+        value: string;
+    }[]>;
+    protected readonly ckTypeSuggestions: _angular_core.WritableSignal<string[]>;
+    protected readonly roleSuggestions: _angular_core.WritableSignal<{
+        roleId: string;
+        label: string;
+    }[]>;
+    protected readonly saveIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly plusIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly reloadIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly removeIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly exportIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly importIcon: _progress_kendo_svg_icons.SVGIcon;
+    protected readonly visibleOptions: _angular_core.Signal<{
+        text: string;
+        value: string;
+    }[]>;
+    protected readonly groupedOptions: _angular_core.Signal<{
+        text: string;
+        value: string;
+    }[]>;
+    ngOnInit(): Promise<void>;
+    protected reload(): Promise<void>;
+    protected addRule(): void;
+    protected removeRule(index: number): void;
+    protected addPerspective(): void;
+    protected removePerspective(index: number): void;
+    protected onSave(): Promise<void>;
+    /** Loads CK type suggestions for the source-type combobox (server filter). */
+    protected searchCkTypes(term: string): Promise<void>;
+    /** Loads role suggestions for the source type of the opened row's combobox. */
+    protected loadRoleSuggestions(row: FormGroup): Promise<void>;
+    /** Loads role suggestions for the root CK type of a perspective row. */
+    protected loadRoleSuggestionsForType(row: FormGroup): Promise<void>;
+    /**
+     * Exports the saved configuration singleton as a deep-graph runtime model ZIP,
+     * via the standard asset-repo export job (same mechanism as pools / adapters /
+     * data flows). Requires the config to have been saved first.
+     */
+    protected export(): Promise<void>;
+    /**
+     * Imports a configuration from a deep-graph runtime model ZIP via the standard
+     * import-strategy dialog + asset-repo import job, then reloads the editor.
+     */
+    protected onFileSelected(event: Event): Promise<void>;
+    /** Resolves the tenant id from the route hierarchy (route is /:tenantId/...). */
+    private getTenantId;
+    private collectRoles;
+    private collectPerspectives;
+    private createPerspectiveRow;
+    private toPerspectiveConfig;
+    private createRow;
+    private toRoleConfig;
+    private toVisibleValue;
+    private toGroupedValue;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeNavigationSettingsComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TreeNavigationSettingsComponent, "mm-tree-navigation-settings", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
+/**
+ * Routes for the tree navigation settings UI. Mount under any path, e.g.:
+ *
+ * ```ts
+ * { path: 'tree-navigation', canActivate: [adminGuard], children: TREE_NAVIGATION_SETTINGS_ROUTES }
+ * ```
+ *
+ * The component is lazy-loaded on first navigation (`loadComponent`).
+ */
+declare const TREE_NAVIGATION_SETTINGS_ROUTES: Routes;
+
+export { DEFAULT_TREE_NAVIGATION_SETTINGS_MESSAGES, TREE_NAVIGATION_SETTINGS_ROUTES, TreeNavigationSettingsComponent };
+export type { TreeNavigationSettingsMessages };

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

@@ -2,7 +2,7 @@ import * as _angular_core from '@angular/core';
 import { OnInit, OnDestroy, EventEmitter, OnChanges, SimpleChanges, AfterViewInit, Provider, InjectionToken, EnvironmentProviders } from '@angular/core';
 import * as _progress_kendo_svg_icons from '@progress/kendo-svg-icons';
 import { SVGIcon } from '@progress/kendo-svg-icons';
-import { AttributeItem, AttributeValueTypeDto as AttributeValueTypeDto$1, CkTypeSelectorItem as CkTypeSelectorItem$1, RtEntityDto, FieldFilterDto, SearchFilterDto, SortDto, CkModelDto, CkTypeDto, RtAssociationDto, FieldFilterOperatorsDto, GetCkTypesDtoGQL, RuntimeEntityItem, RuntimeEntitySelectDataSource, RuntimeEntityDialogDataSource } from '@meshmakers/octo-services';
+import { AttributeItem, AttributeValueTypeDto as AttributeValueTypeDto$1, CkTypeSelectorItem as CkTypeSelectorItem$1, RtEntityDto, FieldFilterDto, SearchFilterDto, SortDto, CkModelDto, CkTypeDto, GraphDirectionDto, RtAssociationDto, FieldFilterOperatorsDto, GetCkTypesDtoGQL, RuntimeEntityItem, RuntimeEntitySelectDataSource, RuntimeEntityDialogDataSource } from '@meshmakers/octo-services';
 import { GridDataResult, CellClickEvent, RowArgs, PageChangeEvent, SelectionEvent } from '@progress/kendo-angular-grid';
 import { TreeItemDataTyped, TreeItemData, CommandItemExecuteEventArgs, CommandItem } from '@meshmakers/shared-services';
 import { ControlValueAccessor, Validator, FormControl, AbstractControl, ValidationErrors } from '@angular/forms';
@@ -598,13 +598,183 @@ declare class EntityIdInfoComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EntityIdInfoComponent, "mm-entity-id-info", never, { "rtId": { "alias": "rtId"; "required": true; }; "rtCkTypeId": { "alias": "rtCkTypeId"; "required": true; }; "ckTypeId": { "alias": "ckTypeId"; "required": false; }; }, {}, never, never, true, never>;
 }
 
+/** One resolved per-role override (presentation only). */
+interface TreeNavigationRoleOverride {
+    visible?: boolean;
+    displayName?: string;
+    sortIndex?: number;
+    grouped?: boolean;
+    icon?: string;
+}
+/** One editable override rule (a row in the settings editor). */
+interface TreeNavigationRoleConfig {
+    /** Source CK type id this rule applies to, or `*` for every type. */
+    sourceCkTypeId: string;
+    /** Runtime association role id (e.g. `EnergyIQ/SpaceSensors`). */
+    roleId: string;
+    visible?: boolean;
+    displayName?: string;
+    sortIndex?: number;
+    grouped?: boolean;
+    icon?: string;
+}
+/** How a perspective determines its root nodes. */
+type PerspectiveRootMode = 'Spatial' | 'Type';
+/** Direction a perspective's primary role is navigated from the root node. */
+type PerspectiveDirection = 'Inbound' | 'Outbound';
+/**
+ * One switchable tree perspective (AB#4263). A perspective defines its own root
+ * (the spatial ParentChild tree, or all instances of a CK type) and an optional
+ * primary/secondary navigation whitelist applied at the root level. The built-in
+ * `Spatial` perspective is synthesized by the data source and is not stored.
+ */
+interface PerspectiveDefinition {
+    /** Stable key, unique within the tenant (e.g. `Spatial`, `Systems`). */
+    key: string;
+    /** Label shown in the perspective switcher. */
+    displayName: string;
+    /** Switcher ordering hint (ascending). */
+    sortIndex?: number;
+    /** Icon name for the switcher entry (resolved by the frontend). */
+    icon?: string;
+    /** `Spatial` = all Basic/Tree entities; `Type` = all instances of rootCkTypeId. */
+    rootMode: PerspectiveRootMode;
+    /** Runtime CK type id whose instances form the roots when rootMode = `Type`. */
+    rootCkTypeId?: string;
+    /** Association role flattened directly under each root node (like ParentChild). */
+    primaryRoleId?: string;
+    /** Direction the primary role is navigated (default: Inbound / containment side). */
+    primaryDirection?: PerspectiveDirection;
+    /** Additional roles shown as group nodes directly under each root node. */
+    secondaryRoleIds?: string[];
+}
+/** The full configuration as loaded for editing. */
+interface TreeNavigationConfig {
+    /** rtId of the singleton, or null when it does not exist yet. */
+    rtId: string | null;
+    /** True when the CK type is installed on the tenant (System.UI >= 2.2.0). */
+    typePresent: boolean;
+    roles: TreeNavigationRoleConfig[];
+    /** Configured extra perspectives (excludes the built-in spatial one). */
+    perspectives: PerspectiveDefinition[];
+}
+/**
+ * Loads the optional per-tenant `System.UI/TreeNavigationConfiguration` singleton
+ * and resolves per-association overrides for the entity trees.
+ *
+ * Design notes:
+ * - The config entity is OPTIONAL. When the CK type is not installed on the
+ *   tenant (System.UI < 2.2.0) or no instance exists, every lookup returns
+ *   undefined and the trees fall back to pure auto-discovery.
+ * - The singleton field (`systemUITreeNavigationConfiguration`) only exists in
+ *   the tenant schema when the CK type is installed, so querying it blindly
+ *   would raise a GraphQL validation error (and a user-facing toast). We first
+ *   probe the CK schema with the always-valid `constructionKit.types` query and
+ *   only run the singleton query when the type is present.
+ * - Uses inline `gql` (not codegen) so the feature is decoupled from a schema
+ *   re-introspection that includes the new CK type.
+ */
+declare class TreeNavigationConfigService {
+    private readonly apollo;
+    /** key `${sourceCkTypeId}::${roleId}` -> override; cached for the session. */
+    private overridesPromise?;
+    /** Configured extra perspectives; cached for the session. */
+    private perspectivesPromise?;
+    /**
+     * Resolves the override for one (source type, role) pair, preferring an exact
+     * source-type match over a wildcard (`*`) rule. Returns undefined when nothing
+     * is configured.
+     */
+    resolve(sourceCkTypeId: string, roleId: string): Promise<TreeNavigationRoleOverride | undefined>;
+    /** Forces a reload on next access (e.g. after a tenant switch). */
+    reset(): void;
+    /**
+     * Returns the configured extra tree perspectives (AB#4263), sorted by
+     * sortIndex then displayName. Returns [] when the CK type is absent
+     * (System.UI < 2.3.0) or none are configured. The built-in spatial
+     * perspective is synthesized by the data source and is NOT included here.
+     */
+    perspectives(): Promise<PerspectiveDefinition[]>;
+    private loadPerspectives;
+    /** Maps a raw perspective record to a definition, dropping invalid rows. */
+    private toPerspectiveDefinition;
+    /**
+     * Returns the inbound association roles declared on a CK type, for the role
+     * autocomplete in the settings editor. Returns `{ roleId, label }` where the
+     * label is the friendly inbound name plus the role id. Empty for `*` or an
+     * unknown type (orphan roles can still be typed as custom values).
+     */
+    getRoleSuggestions(ckTypeId: string): Promise<{
+        roleId: string;
+        label: string;
+    }[]>;
+    private getOverrides;
+    private load;
+    /**
+     * Loads the full configuration for editing (settings page). Returns whether
+     * the CK type is installed (so the page can show a clear "upgrade System.UI"
+     * hint), the singleton rtId (null when not created yet), and the role rules.
+     */
+    loadConfig(): Promise<TreeNavigationConfig>;
+    /**
+     * Creates or updates the singleton with the given rules and perspectives, then
+     * invalidates the resolve/perspective cache so the trees pick up the change on
+     * the next expand. Returns the singleton rtId.
+     */
+    saveConfig(rtId: string | null, roles: TreeNavigationRoleConfig[], perspectives?: PerspectiveDefinition[]): Promise<string>;
+    /** Drops undefined fields so the record-array input only carries set values. */
+    private toRoleInput;
+    /** Drops undefined/empty fields so the perspective input only carries set values. */
+    private toPerspectiveInput;
+    /**
+     * Probes whether the `System.UI/TreeNavigationConfiguration` CK type is
+     * installed on the tenant (System.UI >= 2.2.0). Uses the always-valid
+     * `constructionKit.types` query so it never raises a schema validation error.
+     */
+    private probeTypePresent;
+    /**
+     * Probes the CK schema and (when present) loads the singleton's raw roles.
+     * Perspectives are loaded separately (see fetchPerspectivesRaw) so a System.UI
+     * 2.2.0 tenant (type present but no `perspectives` field yet) keeps its roles.
+     */
+    private fetchSingleton;
+    /**
+     * Loads the singleton's raw perspectives, tolerating the System.UI 2.2.0 case
+     * where the `perspectives` field does not yet exist (GraphQL validation error).
+     * Any failure yields an empty list so roles loading is never affected.
+     */
+    private fetchPerspectivesRaw;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeNavigationConfigService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<TreeNavigationConfigService>;
+}
+declare const TREE_NAVIGATION_CONFIG_CONSTANTS: {
+    CONFIG_CK_TYPE_ID: string;
+    CONFIG_WELL_KNOWN_NAME: string;
+    WILDCARD: string;
+};
+
 type BrowserItem$3 = RtEntityDto | CkModelDto | CkTypeDto | {
     isCkModelsRoot?: boolean;
     ckModelId?: string;
-};
+} | AssociationGroupNode;
+/**
+ * Synthetic tree node that groups all entities reachable from a parent entity
+ * through a single association role (e.g. "ContainedSensors"). Its children are
+ * loaded lazily on expand. It is intentionally not a runtime entity, so the
+ * toolbar create/edit/delete actions and the entity picker stay disabled for it.
+ */
+interface AssociationGroupNode {
+    isAssociationGroup: true;
+    parentRtId: string;
+    parentCkTypeId: string;
+    roleId: string;
+    targetCkTypeId: string;
+    direction: GraphDirectionDto;
+}
 declare class RuntimeBrowserDataSource extends OctoGraphQlHierarchyDataSource<BrowserItem$3> {
     private readonly getTreesDtoGQL;
-    private readonly getTreeNodesDtoGQL;
+    private readonly getCkTypeAssociationRolesDtoGQL;
+    private readonly getTreeAssociationTargetsDtoGQL;
     private readonly getCkModelsGQL;
     private readonly getCkTypesGQL;
     private readonly getCkModelByIdDtoGQL;
@@ -613,13 +783,112 @@ declare class RuntimeBrowserDataSource extends OctoGraphQlHierarchyDataSource<Br
     private readonly updateRuntimeEntitiesDtoGQL;
     private readonly updateTreeNodesDtoGQL;
     private readonly typeHelperService;
+    private readonly treeNavConfig;
+    private readonly apollo;
+    /** Key of the currently active tree perspective (AB#4263). */
+    private activePerspectiveKey;
+    /**
+     * The perspective resolved during the last `fetchRootNodes()`. Used by
+     * `fetchChildren()` to apply the root-level whitelist for `Type` perspectives.
+     */
+    private activePerspective;
+    /**
+     * rtIds of the current perspective's root nodes. The primary/secondary role
+     * whitelist is applied ONLY to the direct children of these roots — deeper
+     * nodes keep full auto-discovery (whitelist-at-root-only).
+     */
+    private readonly perspectiveRootRtIds;
+    /**
+     * Selects the active perspective by key. The host is responsible for reloading
+     * the tree afterwards (e.g. `treeDetail.refreshTree()`), which re-runs
+     * `fetchRootNodes()` and re-resolves the perspective.
+     */
+    setActivePerspective(key: string): void;
+    /** The currently selected perspective key. */
+    getActivePerspectiveKey(): string;
+    /**
+     * Returns all selectable perspectives: the built-in spatial one first, then the
+     * per-tenant configured perspectives, de-duplicated by key (a configured
+     * `Spatial` overrides the built-in). With no configuration this is a single
+     * entry, so the host can hide the switcher.
+     */
+    getPerspectives(): Promise<PerspectiveDefinition[]>;
+    /**
+     * The role-id whitelist of the active perspective (primary + secondary), or
+     * null when the perspective is not a `Type` perspective or declares no roles.
+     */
+    private activePerspectiveWhitelist;
+    /**
+     * The set of role ids the given entity's direct children are restricted to,
+     * or null for full auto-discovery. Non-null only when the entity is a root of
+     * the active `Type` perspective (whitelist-at-root-only).
+     */
+    private rootWhitelistFor;
+    /**
+     * Resolves the active perspective from the configured list, falling back to a
+     * configured/built-in spatial one when the selected key is unknown.
+     */
+    private resolveActivePerspective;
     private isCkModelsRoot;
     private isCkModel;
     private isCkType;
-    private static readonly levelMetaData;
+    private isAssociationGroup;
+    /**
+     * Cache of inbound association roles per CK type id. Discovered lazily from
+     * the CK schema and reused across tree expansions (and to decide whether a
+     * child entity node is expandable). Lives on the instance because the tree is
+     * created fresh per browser/picker mount.
+     */
+    private readonly inboundRolesCache;
     private static readonly ckTypeMetaData;
     fetchChildren(item: TreeItemDataTyped<BrowserItem$3>): Promise<TreeItemDataTyped<BrowserItem$3>[]>;
+    /**
+     * Discovers the navigable inbound role groups of an entity from its ACTUAL
+     * inbound edges (associations.definitions), grouped by (roleId, origin CK
+     * type) with exact counts. Labels are enriched from the CK type schema
+     * (friendly inbound navigation property name) when the role is declared on the
+     * type, and otherwise derived from the role id (so orphan roles still get a
+     * readable label).
+     */
+    private discoverEntityInboundRoleGroups;
+    /** Readable fallback label for a role id without a schema navigation name. */
+    private deriveRoleLabel;
+    /**
+     * Orders group nodes by configured sortIndex (ascending, unconfigured last),
+     * then by navigation property name for a stable, readable order.
+     */
+    private compareGroupOrder;
+    /** Resolves a configured group icon name to an SVG icon (folder by default). */
+    private resolveGroupIcon;
+    /**
+     * Returns the inbound association roles of a CK type, discovered from the CK
+     * schema and cached per type id for the lifetime of this data source.
+     */
+    private getInboundRoles;
+    /** Loads the target entities reachable from an entity through one role. */
+    private fetchAssociationTargets;
+    /**
+     * Builds tree items for runtime entities, de-duplicating by rtId and marking
+     * an entity expandable when its CK type defines at least one inbound
+     * association role.
+     */
+    private buildEntityTreeItems;
+    /** Stable tree-node id for an association group node. */
+    private buildGroupNodeId;
+    /** Resolves the display label of an entity from its name/displayName attributes. */
+    private extractDisplayName;
+    /** Resolves the tooltip of an entity from its description attribute. */
+    private extractTooltip;
+    /** Resolves the icon for a CK type, falling back to a generic entity icon. */
+    private resolveIcon;
     fetchRootNodes(): Promise<TreeItemDataTyped<BrowserItem$3>[]>;
+    /**
+     * Loads all runtime instances of a CK type as the roots of a `Type`
+     * perspective (AB#4263), registering their rtIds so the whitelist applies to
+     * their direct children only. Expandability is schema-based (does the type
+     * declare an inbound role, restricted to the whitelist when set).
+     */
+    private fetchTypePerspectiveRoots;
     /**
      * Gets ParentChild association of given Runtime Entity.
      *
@@ -698,15 +967,22 @@ interface EntitySelectorDialogResult {
     name?: string;
 }
 
-declare class EntitySelectorDialogComponent {
+declare class EntitySelectorDialogComponent implements OnInit {
     private readonly windowRef;
     readonly treeDataSource: RuntimeBrowserDataSource;
+    private readonly tree?;
+    /** Selectable tree perspectives (AB#4263); switcher hides itself when <= 1. */
+    protected readonly perspectives: _angular_core.WritableSignal<PerspectiveDefinition[]>;
+    protected readonly activePerspectiveKey: _angular_core.WritableSignal<string>;
     data: EntitySelectorDialogData;
     selectedEntity: {
         rtId: string;
         ckTypeId: string;
         name?: string;
     } | null;
+    ngOnInit(): Promise<void>;
+    /** Switches the active perspective and reloads the picker tree. */
+    onPerspectiveChange(key: string): Promise<void>;
     onNodeSelected(node: TreeItemData): void;
     onConfirm(): void;
     onCancel(): void;
@@ -1561,6 +1837,8 @@ interface RuntimeBrowserMessages {
     mappingSelect?: string;
     /** Empty-state hint shown when no mappings exist. Default: "No data point mappings configured yet." */
     mappingNoneConfigured?: string;
+    /** Label before the tree perspective switcher (AB#4263). Default: "Perspective" */
+    perspective?: string;
 }
 /**
  * Default English messages for the RuntimeBrowser components.
@@ -2168,6 +2446,12 @@ declare class RuntimeBrowserComponent implements AfterViewInit {
      */
     expressionValidator: _angular_core.InputSignal<ExpressionValidatorFn | undefined>;
     protected readonly resolvedMessages: _angular_core.Signal<RuntimeBrowserMessages>;
+    /** Selectable tree perspectives (AB#4263); switcher hides itself when <= 1. */
+    protected readonly perspectives: _angular_core.WritableSignal<PerspectiveDefinition[]>;
+    protected readonly activePerspectiveKey: _angular_core.WritableSignal<string>;
+    /** Switches the active perspective and reloads the tree from its new roots. */
+    protected onPerspectiveChange(key: string): Promise<void>;
+    private loadPerspectives;
     treeDetail: BaseTreeDetailComponent<BrowserItem$1>;
     detailsPanel: RuntimeBrowserDetailsComponent;
     protected get leftToolbarActions(): CommandItem[];
@@ -3158,5 +3442,5 @@ declare class TenantSwitcherComponent {
  */
 declare function provideOctoUi(): EnvironmentProviders;
 
-export { AssociationValidationService, AttributeSelectorDialogComponent, AttributeSelectorDialogService, AttributeSortSelectorDialogComponent, AttributeSortSelectorDialogService, AttributeValueTypeDto, CkTypeSelectorDialogComponent, CkTypeSelectorDialogService, CkTypeSelectorInputComponent, DEFAULT_CK_TYPE_SELECTOR_DIALOG_MESSAGES, DEFAULT_CK_TYPE_SELECTOR_INPUT_MESSAGES, DEFAULT_DATA_POINT, DEFAULT_MAPPING_COVERAGE_TREE_CONFIG, DEFAULT_PROPERTY_GRID_MESSAGES, DEFAULT_RUNTIME_BROWSER_MESSAGES, DataMappingOverviewComponent, DataPointPickerComponent, DataPointResolverService, DefaultPropertyCategory, EntityDetailComponent, EntityIdInfoComponent, EntitySelectorDialogComponent, EntitySelectorDialogService, FieldFilterEditorComponent, MappingCoverageTreeComponent, MappingCoverageTreeDataSource, MappingEditDialogComponent, MappingEditDialogService, 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, extractDataPointNames, 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 { AttributeItemLike, AttributeSelectorDialogData, AttributeSelectorDialogResult, AttributeSelectorResult, AttributeSortItem, AttributeSortSelectorDialogData, AttributeSortSelectorDialogResult, AttributeSortSelectorResult, BinaryDownloadEvent, BrowserItem, BrowserState, CkAssociationRole, CkTypeSelectorDialogData, CkTypeSelectorDialogMessages, CkTypeSelectorDialogResult, CkTypeSelectorInputMessages, CkTypeSelectorResult, CoverageEntityRef, CoverageMappingItem, CoverageNodePayload, CoverageTreeIcons, CoverageTreeItem, DataPointMappingItem, DataPointMappingOverviewItem, EntitySelectorDialogData, EntitySelectorDialogResult, EntitySelectorResult, ExpressionValidationResult, ExpressionValidatorFn, FieldFilterItem, FilterVariable, MappingCoverageTreeConfig, MappingEditDialogData, MappingEditDialogResult, MappingEditValue, MappingOverviewSummary, MoveValidationResult, PropertyChangeEvent, PropertyGridConfig, PropertyGridItem, PropertyGridMessages, RtEntityId, RuntimeBrowserMessages, RuntimeBrowserRouteOptions, RuntimeEntityVariableDialogData, RuntimeEntityVariableDialogResult, RuntimeEntityVariableMapping, RuntimeEntityVariableResult, SortOption, ValidationMessage };
+export { AssociationValidationService, AttributeSelectorDialogComponent, AttributeSelectorDialogService, AttributeSortSelectorDialogComponent, AttributeSortSelectorDialogService, AttributeValueTypeDto, CkTypeSelectorDialogComponent, CkTypeSelectorDialogService, CkTypeSelectorInputComponent, DEFAULT_CK_TYPE_SELECTOR_DIALOG_MESSAGES, DEFAULT_CK_TYPE_SELECTOR_INPUT_MESSAGES, DEFAULT_DATA_POINT, DEFAULT_MAPPING_COVERAGE_TREE_CONFIG, DEFAULT_PROPERTY_GRID_MESSAGES, DEFAULT_RUNTIME_BROWSER_MESSAGES, DataMappingOverviewComponent, DataPointPickerComponent, DataPointResolverService, DefaultPropertyCategory, EntityDetailComponent, EntityIdInfoComponent, EntitySelectorDialogComponent, EntitySelectorDialogService, FieldFilterEditorComponent, MappingCoverageTreeComponent, MappingCoverageTreeDataSource, MappingEditDialogComponent, MappingEditDialogService, OctoGraphQlDataSource, OctoGraphQlHierarchyDataSource, OctoLoaderComponent, PropertyConverterService, PropertyDisplayMode, PropertyGridComponent, PropertyValueDisplayComponent, RUNTIME_BROWSER_MESSAGES, RecordDetailDialogComponent, RtEntityIdHelper, RuntimeBrowserComponent, RuntimeBrowserOutletComponent, RuntimeBrowserPageComponent, RuntimeBrowserStateService, RuntimeEntityVariableDialogComponent, RuntimeEntityVariableDialogService, TREE_NAVIGATION_CONFIG_CONSTANTS, TenantSwitcherComponent, TreeNavigationConfigService, account_tree, add, analytics, app_registration, article, botService, category, chat, checklist, code, component_exchange, computer, createRuntimeBrowserRoutes, customer, dashboard, event_list, extractDataPointNames, 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 { AttributeItemLike, AttributeSelectorDialogData, AttributeSelectorDialogResult, AttributeSelectorResult, AttributeSortItem, AttributeSortSelectorDialogData, AttributeSortSelectorDialogResult, AttributeSortSelectorResult, BinaryDownloadEvent, BrowserItem, BrowserState, CkAssociationRole, CkTypeSelectorDialogData, CkTypeSelectorDialogMessages, CkTypeSelectorDialogResult, CkTypeSelectorInputMessages, CkTypeSelectorResult, CoverageEntityRef, CoverageMappingItem, CoverageNodePayload, CoverageTreeIcons, CoverageTreeItem, DataPointMappingItem, DataPointMappingOverviewItem, EntitySelectorDialogData, EntitySelectorDialogResult, EntitySelectorResult, ExpressionValidationResult, ExpressionValidatorFn, FieldFilterItem, FilterVariable, MappingCoverageTreeConfig, MappingEditDialogData, MappingEditDialogResult, MappingEditValue, MappingOverviewSummary, MoveValidationResult, PerspectiveDefinition, PerspectiveDirection, PerspectiveRootMode, PropertyChangeEvent, PropertyGridConfig, PropertyGridItem, PropertyGridMessages, RtEntityId, RuntimeBrowserMessages, RuntimeBrowserRouteOptions, RuntimeEntityVariableDialogData, RuntimeEntityVariableDialogResult, RuntimeEntityVariableMapping, RuntimeEntityVariableResult, SortOption, TreeNavigationConfig, TreeNavigationRoleConfig, TreeNavigationRoleOverride, ValidationMessage };