@xh/hoist 86.2.0 → 86.4.0

package/.gitattributes

@@ -0,0 +1,4 @@
+# Launcher scripts run under node via a `#!/usr/bin/env node` shebang; a CRLF
+# shebang line breaks execution on Linux/macOS. Force LF so Windows checkouts
+# don't rewrite them to CRLF (which otherwise shows them as perpetually modified).
+bin/*.mjs text eol=lf

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # Changelog
 
+## 86.4.0 - 2026-07-15
+
+### 🎁 New Features
+
+* Added `PrefService.isSet()` to report whether the current user has an explicit value on file for a
+  preference vs. receiving its server-side default - a distinction that cannot be reliably inferred
+  by comparing the value to the default. Requires a hoist-core version that emits the backing
+  `isSet` flag; against older servers all prefs report as unset.
+
+### 🐞 Bug Fixes
+
+* `PrefService.unset()` now performs a true server-side unset, clearing the user's stored value so
+  the preference reverts to its (possibly changing) default and `isSet()` reports `false`.
+  Previously it persisted the current default as an explicit user value. Falls back to the legacy
+  behavior against hoist-core versions that predate the `xh/unsetPrefs` endpoint.
+* Fixed `FilterChooser` popover mode to render an opaque background when expanded.
+
+## 86.3.0 - 2026-07-10
+
+### 🎁 New Features
+
+* `Select` now accepts a `generateOptionFn` prop to resolve an option for a selected value that is
+  not present in the current options list (e.g. with `queryFn`-based selects or readonly forms),
+  ensuring such values render with their proper label rather than falling back to the raw value.
+* `SegmentedControl` options (desktop and mobile) now accept a `testId`, emitted on the option's
+  rendered button as `data-testid` for E2E targeting. If an option omits its own `testId` but the
+  control has one, an id is auto-derived as `${controlTestId}-${value}` - restoring parity with
+  the legacy `ButtonGroupInput` test-hook pattern for apps migrating between the two.
+
+### 🐞 Bug Fixes
+
+* Fixed grid columns configured as `hidden` becoming visible after being grouped and then
+  ungrouped. `GridModel` now re-asserts each column's configured visibility whenever `groupBy`
+  changes, keeping AG Grid's column state in sync with `columnState`.
+* Fixed `StoreFilterField` and grid Find so an active quick-filter or find query no longer returns
+  different results when the grid's `groupBy` changes.
+* Fixed inline grid cell editors to reliably commit their value when editing ends, including popup
+  editors (e.g. `textAreaEditor`) within a dialog, which previously dropped edits on Enter or
+  click-away.
+* Fixed `Select` to correctly handle non-primitive (object) values: selected-option matching and
+  async query de-duplication now use deep equality, so object values no longer render as
+  `[object Object]` or collide with one another.
+* Hardened the grid column filter's Custom tab against filters it previously mishandled -
+  multi-value clauses are now expanded into editable rows and recombined on commit, and filters it
+  cannot represent are left untouched rather than corrupted.
+* Fixed `FilterChooser` popover mode (formerly `PopoverFilterChooser`) so its collapsed control no
+  longer disappears when opened - it now always occupies its place in the layout, so surrounding
+  elements no longer shift. Its clear and favorites controls also respond to a single click rather
+  than requiring the popover to be opened first. This mode is now enabled more naturally via
+  a new option `filterChooser({popover: true})`, deprecating `PopoverFilterChooser`, which remains
+  as a thin alias.
+* Fixed "not a valid MIME type" console warnings from `FileChooser`. Accepted extensions are now
+  passed under a dummy MIME type key, silencing the warnings while continuing to filter selected
+  files by extension.
+
+### ⚙️ Typescript API Adjustments
+
+* Retyped `GridModel.colChooserModel` as the new cross-platform `IColChooserModel` interface,
+  replacing the bare `HoistModel` type and exposing `isOpen`, `open()`, and `close()` directly.
+* Added the exported `HoistRoute` type - Router5's `Route` extended with Hoist's `omit` key - and
+  retyped `HoistAppModel.getRoutes()` to return it, so declarative route exclusion (e.g.
+  `omit: !XH.getUser().isHoistAdmin`) now type-checks without a cast.
+
+### 🤖 AI Docs + Tooling
+
+* Fixed the MCP server and `hoist-ts` CLI TypeScript symbol tools (`search`, `symbol`, `members`)
+  returning no results on Windows, where a path-separator mismatch left the symbol index empty.
+  Path handling is now normalized so the developer tools work on Windows as well as macOS/Linux.
+
+### 📚 Libraries
+
+* @auth0/auth0-spa-js `2.21 → 2.23`
+* @azure/msal-browser `5.14 → 5.16`
+* swiper  `12.1 -> 14.0`
+
 ## 86.2.0 - 2026-06-25
 
 ### 🎁 New Features

package/admin/AppModel.ts

@@ -7,10 +7,11 @@
 import {GridModel} from '@xh/hoist/cmp/grid';
 import {TabConfig, TabContainerModel} from '@xh/hoist/cmp/tab';
 import {ViewManagerModel} from '@xh/hoist/cmp/viewmanager';
-import {HoistAppModel, InitContext, XH} from '@xh/hoist/core';
+import {HoistAppModel, HoistRoute, InitContext, XH} from '@xh/hoist/core';
 import {Icon} from '@xh/hoist/icon';
+import {SECONDS} from '@xh/hoist/utils/datetime';
 import {without} from 'lodash';
-import {Route} from 'router5';
+import {RoleModuleConfig} from './tabs/userData/roles/Types';
 import {activityTrackingPanel} from './tabs/activity/tracking/ActivityTrackingPanel';
 import {clientsPanel} from './tabs/clients/ClientsPanel';
 import {monitorTab} from './tabs/monitor/MonitorTab';
@@ -28,6 +29,9 @@ export class AppModel extends HoistAppModel {
 
     viewManagerModels: Record<string, ViewManagerModel> = {};
 
+    /** Role-module config, loaded once at init and shared with the Roles tab. */
+    roleModuleConfig: RoleModuleConfig = null;
+
     static get readonly() {
         return !XH.getUser().isHoistAdmin;
     }
@@ -35,21 +39,23 @@ export class AppModel extends HoistAppModel {
     constructor() {
         super();
 
-        this.tabModel = new TabContainerModel({
-            route: 'default',
-            tabs: this.createTabs()
-        });
-
         // Enable managed autosize mode across Hoist Admin console grids.
         GridModel.defaults.autosizeMode = 'managed';
     }
 
     override async initAsync(ctx: InitContext) {
+        await this.loadRoleModuleConfigAsync(ctx);
+
+        this.tabModel = new TabContainerModel({
+            route: 'default',
+            tabs: this.createTabs()
+        });
+
         await this.initViewManagerModelsAsync(ctx);
         await super.initAsync(ctx);
     }
 
-    override getRoutes(): Route[] {
+    override getRoutes(): HoistRoute[] {
         return [
             {
                 name: 'default',
@@ -66,7 +72,7 @@ export class AppModel extends HoistAppModel {
         return [];
     }
 
-    getTabRoutes(): Route[] {
+    getTabRoutes(): HoistRoute[] {
         return [
             {
                 name: 'general',
@@ -123,7 +129,8 @@ export class AppModel extends HoistAppModel {
     }
 
     createTabs(): TabConfig[] {
-        const conf = XH.getConf('xhAdminAppConfig', {});
+        const conf = XH.getConf('xhAdminAppConfig', {}),
+            rolesEnabled = this.roleModuleConfig?.enabled ?? false;
 
         return [
             {
@@ -160,6 +167,7 @@ export class AppModel extends HoistAppModel {
             },
             {
                 id: 'userData',
+                title: rolesEnabled ? 'User Data & Roles' : 'User Data',
                 icon: Icon.users(),
                 content: {
                     refreshMode: 'onShowAlways',
@@ -173,7 +181,8 @@ export class AppModel extends HoistAppModel {
                         {
                             id: 'roles',
                             icon: Icon.idBadge(),
-                            content: rolePanel
+                            content: rolePanel,
+                            omit: !rolesEnabled
                         },
                         {
                             id: 'prefs',
@@ -220,4 +229,22 @@ export class AppModel extends HoistAppModel {
             ctx
         );
     }
+
+    //----------------
+    // Implementation
+    //----------------
+    private async loadRoleModuleConfigAsync(ctx: InitContext) {
+        // Load role config up-front to title/show the Roles tab (see createTabs).
+        // Never block startup if it can't load - the tab defaults to hidden.
+        try {
+            this.roleModuleConfig = await this.runner(ctx)
+                .span('loadRoleModuleConfig')
+                .fetchJson({url: 'roleAdmin/config', timeout: 10 * SECONDS});
+        } catch (e) {
+            XH.handleException(e, {
+                message: 'Unable to load roles configuration',
+                alertType: 'toast'
+            });
+        }
+    }
 }

package/admin/tabs/activity/tracking/ActivityTrackingModel.ts

@@ -15,7 +15,17 @@ import {FilterChooserModel} from '@xh/hoist/cmp/filter';
 import {FormModel} from '@xh/hoist/cmp/form';
 import {ColumnRenderer, ColumnSpec, GridModel, TreeStyle} from '@xh/hoist/cmp/grid';
 import {GroupingChooserModel} from '@xh/hoist/cmp/grouping';
-import {HoistModel, LoadSpec, managed, PlainObject, XH} from '@xh/hoist/core';
+import {
+    HoistModel,
+    LoadSpec,
+    LocalDateUnit,
+    managed,
+    PersistableState,
+    PersistenceProvider,
+    persistOptions,
+    PlainObject,
+    XH
+} from '@xh/hoist/core';
 import {Cube, CubeFieldSpec, FieldSpec, ViewRowData} from '@xh/hoist/data';
 import {dateRenderer, dateTimeSecRenderer, numberRenderer} from '@xh/hoist/format';
 import {action, computed, makeObservable, observable} from '@xh/hoist/mobx';
@@ -24,6 +34,23 @@ import {compact, get, isEmpty, isEqual, round} from 'lodash';
 import moment from 'moment';
 import {ActivityDetailProvider} from './detail/ActivityDetailModel';
 
+/**
+ * A relative time interval (e.g. 7 days) ending on the current app day. Drives the quick-select
+ * buttons and the persisted time period, which rolls forward to end on today on restore.
+ */
+export interface ActivityInterval {
+    value: number;
+    unit: LocalDateUnit;
+}
+
+/** Quick-select intervals offered in the toolbar - labels are derived as `${value}${unit[0]}`. */
+export const INTERVALS: ActivityInterval[] = [
+    {value: 6, unit: 'months'},
+    {value: 1, unit: 'months'},
+    {value: 7, unit: 'days'},
+    {value: 1, unit: 'days'}
+];
+
 export class ActivityTrackingModel extends HoistModel implements ActivityDetailProvider {
     override telemetryPrefix = 'xh.client.admin.tracking';
 
@@ -115,6 +142,7 @@ export class ActivityTrackingModel extends HoistModel implements ActivityDetailP
         this.markPersist('showFilterChooser');
 
         this.formModel = this.createQueryFormModel();
+        this.setupPeriodPersistence();
 
         this.dataFieldsEditorModel = new DataFieldsEditorModel(this);
         this.markPersist('dataFields');
@@ -203,17 +231,17 @@ export class ActivityTrackingModel extends HoistModel implements ActivityDetailP
         endDay.setValue(newEnd);
     }
 
-    // Set the start date by taking the end date and pushing back [value] [units] - then pushing
+    // Set the start date by taking the end date and pushing back the interval - then pushing
     // forward one day as the day range query is inclusive.
-    adjustStartDate(value, unit) {
+    adjustStartDate(interval: ActivityInterval) {
         this.formModel.setValues({
-            startDay: this.endDay.subtract(value, unit).nextDay()
+            startDay: this.endDay.subtract(interval.value, interval.unit).nextDay()
         });
     }
 
-    isInterval(value, unit) {
+    isInterval(interval: ActivityInterval) {
         const {startDay, endDay} = this.formModel.values;
-        return startDay === endDay.subtract(value, unit).nextDay();
+        return startDay === endDay.subtract(interval.value, interval.unit).nextDay();
     }
 
     getDisplayName(fieldName: string) {
@@ -234,6 +262,28 @@ export class ActivityTrackingModel extends HoistModel implements ActivityDetailP
         });
     }
 
+    // Persist the selected time period as part of the active view, if endDay is currentDay
+    private setupPeriodPersistence() {
+        PersistenceProvider.create<ActivityInterval>({
+            persistOptions: persistOptions({path: 'queryPeriod'}, this.persistWith),
+            owner: this,
+            target: {
+                getPersistableState: () => {
+                    const currDay = this.endDay === LocalDate.currentAppDay(),
+                        interval = currDay ? INTERVALS.find(it => this.isInterval(it)) : null;
+                    return new PersistableState(interval ?? null);
+                },
+                setPersistableState: ({value}) => {
+                    if (value) {
+                        const endDay = LocalDate.currentAppDay();
+                        this.formModel.setValues({endDay});
+                        this.adjustStartDate(value);
+                    }
+                }
+            }
+        });
+    }
+
     private async loadGridAsync() {
         const {cube, gridModel, dimensions} = this,
             data = cube.executeQuery({

package/admin/tabs/activity/tracking/ActivityTrackingPanel.ts

@@ -11,7 +11,7 @@ import {grid} from '@xh/hoist/cmp/grid';
 import {div, filler, hframe} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp} from '@xh/hoist/core';
 import {button, buttonGroup, colChooserButton, exportButton} from '@xh/hoist/desktop/cmp/button';
-import {popoverFilterChooser} from '@xh/hoist/desktop/cmp/filter';
+import {filterChooser} from '@xh/hoist/desktop/cmp/filter';
 import {formField} from '@xh/hoist/desktop/cmp/form';
 import {groupingChooser} from '@xh/hoist/desktop/cmp/grouping';
 import {dateInput, DateInputProps, select} from '@xh/hoist/desktop/cmp/input';
@@ -20,7 +20,7 @@ import {toolbar, toolbarSep} from '@xh/hoist/desktop/cmp/toolbar';
 import {viewManager} from '@xh/hoist/desktop/cmp/viewmanager';
 import {Icon} from '@xh/hoist/icon';
 import {LocalDate} from '@xh/hoist/utils/datetime';
-import {ActivityTrackingModel} from './ActivityTrackingModel';
+import {INTERVALS, ActivityTrackingModel} from './ActivityTrackingModel';
 import {aggChartPanel} from '@xh/hoist/admin/tabs/activity/tracking/chart/AggChartPanel';
 import {activityDetailView} from './detail/ActivityDetailView';
 import './ActivityTracking.scss';
@@ -75,32 +75,14 @@ const tbar = hoistCmp.factory<ActivityTrackingModel>(({model}) => {
                     disabled: model.endDay >= LocalDate.currentAppDay()
                 }),
                 buttonGroup({
-                    items: [
+                    items: INTERVALS.map(interval =>
                         button({
-                            text: '6m',
-                            onClick: () => model.adjustStartDate(6, 'months'),
-                            active: model.isInterval(6, 'months'),
-                            ...dateBtn
-                        }),
-                        button({
-                            text: '1m',
-                            onClick: () => model.adjustStartDate(1, 'months'),
-                            active: model.isInterval(1, 'months'),
-                            ...dateBtn
-                        }),
-                        button({
-                            text: '7d',
-                            onClick: () => model.adjustStartDate(7, 'days'),
-                            active: model.isInterval(7, 'days'),
-                            ...dateBtn
-                        }),
-                        button({
-                            text: '1d',
-                            onClick: () => model.adjustStartDate(1, 'days'),
-                            active: model.isInterval(1, 'days'),
+                            text: `${interval.value}${interval.unit[0]}`,
+                            onClick: () => model.adjustStartDate(interval),
+                            active: model.isInterval(interval),
                             ...dateBtn
                         })
-                    ]
+                    )
                 }),
                 toolbarSep(),
                 filterChooserToggleButton(),
@@ -137,7 +119,8 @@ const filterChooserToggleButton = hoistCmp.factory<ActivityTrackingModel>(({mode
 const filterBar = hoistCmp.factory<ActivityTrackingModel>(({model}) => {
     return model.showFilterChooser
         ? toolbar(
-              popoverFilterChooser({
+              filterChooser({
+                  popover: true,
                   flex: 1,
                   enableClear: true
               })

package/admin/tabs/clients/ClientsModel.ts

@@ -9,7 +9,7 @@ import {AppModel} from '@xh/hoist/admin/AppModel';
 import * as Col from '@xh/hoist/admin/columns';
 import {GridModel} from '@xh/hoist/cmp/grid';
 import {div, p} from '@xh/hoist/cmp/layout';
-import {LoadSpec, managed, XH} from '@xh/hoist/core';
+import {LoadSpec, managed, persistOptions, XH} from '@xh/hoist/core';
 import {RecordActionSpec, StoreRecord} from '@xh/hoist/data';
 import {textInput} from '@xh/hoist/desktop/cmp/input';
 import {Icon} from '@xh/hoist/icon';
@@ -23,6 +23,8 @@ import {BaseAdminTabModel} from '@xh/hoist/admin/tabs/BaseAdminTabModel';
 export class ClientsModel extends BaseAdminTabModel {
     override telemetryPrefix = 'xh.client.admin.clients';
 
+    override persistWith = {localStorageKey: 'xhAdminClientsState'};
+
     @observable
     lastRefresh: number;
 
@@ -150,6 +152,7 @@ export class ClientsModel extends BaseAdminTabModel {
         return new GridModel({
             emptyText: 'No clients connected.',
             groupBy: this.groupBy,
+            persistWith: persistOptions(this.persistWith, {path: 'mainGrid'}),
             colChooserModel: true,
             enableExport: true,
             selModel: 'multiple',

package/admin/tabs/clients/activity/ClientDetailModel.ts

@@ -6,7 +6,7 @@
  */
 import {ClientsModel} from '../ClientsModel';
 import {ColumnSpec} from '@xh/hoist/cmp/grid';
-import {HoistModel, LoadSpec, lookup, PlainObject, XH} from '@xh/hoist/core';
+import {HoistModel, LoadSpec, lookup, persistOptions, PlainObject, XH} from '@xh/hoist/core';
 import {StoreRecord} from '@xh/hoist/data';
 import {bindable, computed, makeObservable} from '@xh/hoist/mobx';
 import {ReactNode} from 'react';
@@ -53,6 +53,10 @@ export class ClientDetailModel extends HoistModel implements ActivityDetailProvi
     override onLinked() {
         super.onLinked();
 
+        this.persistWith = persistOptions(this.clientsModel.persistWith, {
+            pathPrefix: 'activityGrid'
+        });
+
         this.addReaction(
             {
                 track: () => this.clientsModel.gridModel.selectedRecord,

package/admin/tabs/userData/roles/RoleModel.ts

@@ -4,12 +4,13 @@
  *
  * Copyright © 2026 Extremely Heavy Industries Inc.
  */
+import {getAppModel} from '@xh/hoist/admin/AdminUtils';
 import {RecategorizeDialogModel} from '@xh/hoist/admin/tabs/userData/roles/recategorize/RecategorizeDialogModel';
 import {FilterChooserModel} from '@xh/hoist/cmp/filter';
 import {GridModel, tagsRenderer, TreeStyle} from '@xh/hoist/cmp/grid';
 import * as Col from '@xh/hoist/cmp/grid/columns';
 import {fragment, p} from '@xh/hoist/cmp/layout';
-import {CallContext, HoistModel, LoadSpec, managed, XH} from '@xh/hoist/core';
+import {HoistModel, LoadSpec, managed, XH} from '@xh/hoist/core';
 import {RecordActionSpec} from '@xh/hoist/data';
 import {actionCol, calcActionColWidth} from '@xh/hoist/desktop/cmp/grid';
 import {Icon} from '@xh/hoist/icon';
@@ -39,10 +40,14 @@ export class RoleModel extends HoistModel {
     @managed recategorizeDialogModel = new RecategorizeDialogModel(this);
 
     @observable.ref allRoles: HoistRole[] = [];
-    @observable.ref moduleConfig: RoleModuleConfig;
 
     @bindable showInGroups = true;
 
+    /** Role-module config - loaded at init. */
+    get moduleConfig(): RoleModuleConfig {
+        return getAppModel().roleModuleConfig;
+    }
+
     get readonly() {
         return !XH.getUser().isHoistRoleManager;
     }
@@ -56,6 +61,10 @@ export class RoleModel extends HoistModel {
     constructor() {
         super();
         makeObservable(this);
+
+        this.gridModel = this.createGridModel();
+        this.filterChooserModel = this.createFilterChooserModel();
+
         this.addReaction({
             track: () => this.showInGroups,
             run: showInGroups => {
@@ -74,9 +83,6 @@ export class RoleModel extends HoistModel {
         return this.runner({loadSpec})
             .span('list')
             .run(async ctx => {
-                await this.ensureInitializedAsync(ctx);
-                if (!this.moduleConfig.enabled) return;
-
                 const {data} = await XH.fetchJson({url: 'roleAdmin/list'}, ctx);
                 if (loadSpec.isStale) return;
 
@@ -233,19 +239,6 @@ export class RoleModel extends HoistModel {
         gridModel.autosizeAsync({includeCollapsedChildren: true});
     }
 
-    private async ensureInitializedAsync(ctx: CallContext) {
-        if (this.moduleConfig) return;
-
-        const config = await this.runner(ctx).fetchJson({url: 'roleAdmin/config'});
-        runInAction(() => {
-            this.moduleConfig = config;
-            if (config.enabled) {
-                this.gridModel = this.createGridModel();
-                this.filterChooserModel = this.createFilterChooserModel();
-            }
-        });
-    }
-
     private processRolesFromServer(roles: Partial<HoistRole>[]): HoistRole[] {
         return roles.map(role => {
             const membersByType = mapValues(groupBy(role.members, 'type'), members =>

package/admin/tabs/userData/roles/RolePanel.ts

@@ -9,8 +9,7 @@ import {grid} from '@xh/hoist/cmp/grid';
 import {fragment, hframe, vframe} from '@xh/hoist/cmp/layout';
 import {creates, hoistCmp} from '@xh/hoist/core';
 import {button, colChooserButton} from '@xh/hoist/desktop/cmp/button';
-import {errorMessage} from '@xh/hoist/cmp/error';
-import {popoverFilterChooser} from '@xh/hoist/desktop/cmp/filter';
+import {filterChooser} from '@xh/hoist/desktop/cmp/filter';
 import {switchInput} from '@xh/hoist/desktop/cmp/input';
 import {panel} from '@xh/hoist/desktop/cmp/panel';
 import {recordActionBar} from '@xh/hoist/desktop/cmp/record';
@@ -25,12 +24,6 @@ export const rolePanel = hoistCmp.factory({
     model: creates(RoleModel),
 
     render({className, model}) {
-        const {moduleConfig} = model;
-        if (!moduleConfig) return null;
-        if (!moduleConfig.enabled) {
-            return errorMessage({error: 'Default Role Module not enabled.'});
-        }
-
         const {gridModel, readonly} = model;
         return fragment(
             panel({
@@ -44,7 +37,7 @@ export const rolePanel = hoistCmp.factory({
                         selModel: gridModel.selModel
                     }),
                     '-',
-                    popoverFilterChooser({flex: 1}),
+                    filterChooser({popover: true, flex: 1}),
                     '-',
                     switchInput({
                         bind: 'showInGroups',

package/appcontainer/RouterModel.ts

@@ -4,7 +4,7 @@
  *
  * Copyright © 2026 Extremely Heavy Industries Inc.
  */
-import {HoistModel} from '../core';
+import {HoistModel, HoistRoute} from '../core';
 import {action, observable, makeObservable} from '@xh/hoist/mobx';
 import {mergeDeep} from '@xh/hoist/utils/js';
 import {isOmitted} from '@xh/hoist/utils/impl';
@@ -38,11 +38,11 @@ export class RouterModel extends HoistModel {
     /**
      * Add routes to the router.
      *
-     * @param routes - collection of router5 route spec.
-     *      This method supports an additional keyword 'omit' on each spec, in order to allow declarative
-     *      exclusion.  Otherwise these are Router5 configs to be passed directly to the Router5 API.
+     * @param routes - collection of {@link HoistRoute} specs. In addition to the standard Router5
+     *      route config, each spec supports an `omit` keyword to allow declarative exclusion.
+     *      Otherwise these are Router5 configs to be passed directly to the Router5 API.
      */
-    addRoutes(routes: object[]) {
+    addRoutes(routes: HoistRoute[]) {
         this.router.add(this.preprocessRoutes(routes));
     }
 
@@ -100,7 +100,7 @@ export class RouterModel extends HoistModel {
         return ret;
     }
 
-    private preprocessRoutes(routes) {
+    private preprocessRoutes(routes: HoistRoute[]): HoistRoute[] {
         const ret = routes.filter(r => !isOmitted(r));
         ret.forEach(r => {
             if (r.children) r.children = this.preprocessRoutes(r.children);

package/build/types/admin/AppModel.d.ts

@@ -1,19 +1,22 @@
 import { TabConfig, TabContainerModel } from '@xh/hoist/cmp/tab';
 import { ViewManagerModel } from '@xh/hoist/cmp/viewmanager';
-import { HoistAppModel, InitContext } from '@xh/hoist/core';
-import { Route } from 'router5';
+import { HoistAppModel, HoistRoute, InitContext } from '@xh/hoist/core';
+import { RoleModuleConfig } from './tabs/userData/roles/Types';
 export declare class AppModel extends HoistAppModel {
     tabModel: TabContainerModel;
     viewManagerModels: Record<string, ViewManagerModel>;
+    /** Role-module config, loaded once at init and shared with the Roles tab. */
+    roleModuleConfig: RoleModuleConfig;
     static get readonly(): boolean;
     constructor();
     initAsync(ctx: InitContext): Promise<void>;
-    getRoutes(): Route[];
+    getRoutes(): HoistRoute[];
     getAppMenuButtonExtraItems(): any[];
-    getTabRoutes(): Route[];
+    getTabRoutes(): HoistRoute[];
     createTabs(): TabConfig[];
     /** Open the primary business-facing application, typically 'app'. */
     openPrimaryApp(): void;
     getPrimaryAppCode(): string;
     initViewManagerModelsAsync(ctx: InitContext): Promise<void>;
+    private loadRoleModuleConfigAsync;
 }

package/build/types/admin/tabs/activity/tracking/ActivityTrackingModel.d.ts

@@ -3,10 +3,20 @@ import { FilterChooserModel } from '@xh/hoist/cmp/filter';
 import { FormModel } from '@xh/hoist/cmp/form';
 import { ColumnSpec, GridModel } from '@xh/hoist/cmp/grid';
 import { GroupingChooserModel } from '@xh/hoist/cmp/grouping';
-import { HoistModel, LoadSpec, PlainObject } from '@xh/hoist/core';
+import { HoistModel, LoadSpec, LocalDateUnit, PlainObject } from '@xh/hoist/core';
 import { Cube } from '@xh/hoist/data';
 import { LocalDate } from '@xh/hoist/utils/datetime';
 import { ActivityDetailProvider } from './detail/ActivityDetailModel';
+/**
+ * A relative time interval (e.g. 7 days) ending on the current app day. Drives the quick-select
+ * buttons and the persisted time period, which rolls forward to end on today on restore.
+ */
+export interface ActivityInterval {
+    value: number;
+    unit: LocalDateUnit;
+}
+/** Quick-select intervals offered in the toolbar - labels are derived as `${value}${unit[0]}`. */
+export declare const INTERVALS: ActivityInterval[];
 export declare class ActivityTrackingModel extends HoistModel implements ActivityDetailProvider {
     telemetryPrefix: string;
     /** FormModel for server-side querying controls. */
@@ -45,10 +55,11 @@ export declare class ActivityTrackingModel extends HoistModel implements Activit
     setDataFields(dataFields: ActivityTrackingDataFieldSpec[]): void;
     toggleFilterChooser(): void;
     adjustDates(dir: 'add' | 'subtract'): void;
-    adjustStartDate(value: any, unit: any): void;
-    isInterval(value: any, unit: any): boolean;
+    adjustStartDate(interval: ActivityInterval): void;
+    isInterval(interval: ActivityInterval): boolean;
     getDisplayName(fieldName: string): string;
     private createQueryFormModel;
+    private setupPeriodPersistence;
     private loadGridAsync;
     private cubeLabelComparator;
     private getComparableValForDim;

package/build/types/admin/tabs/clients/ClientsModel.d.ts

@@ -4,6 +4,9 @@ import { RecordActionSpec, StoreRecord } from '@xh/hoist/data';
 import { BaseAdminTabModel } from '@xh/hoist/admin/tabs/BaseAdminTabModel';
 export declare class ClientsModel extends BaseAdminTabModel {
     telemetryPrefix: string;
+    persistWith: {
+        localStorageKey: string;
+    };
     lastRefresh: number;
     gridModel: GridModel;
     groupBy: 'user' | 'instance';

package/build/types/admin/tabs/userData/roles/RoleModel.d.ts

@@ -19,8 +19,9 @@ export declare class RoleModel extends HoistModel {
     readonly roleEditorModel: RoleEditorModel;
     recategorizeDialogModel: RecategorizeDialogModel;
     allRoles: HoistRole[];
-    moduleConfig: RoleModuleConfig;
     showInGroups: boolean;
+    /** Role-module config - loaded at init. */
+    get moduleConfig(): RoleModuleConfig;
     get readonly(): boolean;
     get selectedRole(): HoistRole;
     constructor();
@@ -36,7 +37,6 @@ export declare class RoleModel extends HoistModel {
     private deleteAction;
     private groupByAction;
     private displayRoles;
-    private ensureInitializedAsync;
     private processRolesFromServer;
     private processRolesForTreeGrid;
     private createGridModel;