@xh/hoist 80.0.0-SNAPSHOT.1768251023007 → 80.0.0-SNAPSHOT.1768251400948

package/CHANGELOG.md

@@ -11,15 +11,9 @@
       so there is no deprecated alias. Any app usages should swap to `XH.appLoadObserver`.
     * Removed additional references to deprecated `loadModel` within Hoist itself.
 * Removed the following instance getters - use new static typeguards instead:
-    * `Store.isStore`
-    * `View.isView`
-    * `Filter.isFilter`
-
-### 🎁 New Features
-
-* Added new `AppMenuButton.renderWithUserProfile` prop as a built-in alternative to the default
-  hamburger menu. Set to `true` to render the current user's initials instead or provide a function
-  to render a custom element for the user.
+  * `Store.isStore`
+  * `View.isView`
+  * `Filter.isFilter`
 
 ### ⚙️ Typescript API Adjustments
 
@@ -29,6 +23,17 @@
   possible to use these models with other, alternate implementations if needed.
 * Added new static typeguard methods on `Store`, `View`, and `Filter` + subclasses.
 
+### 🎁 New Features
+
+* DashCanvas:
+    * supports dragging and dropping widgets in from an external container.
+    * supports new compacting strategy: 'wrap'
+* new elementFactory tags: `fieldset`, `legend`
+
+### 📚 Libraries
+
+* react-grid-layout `2.1 → 2.2.2`
+
 ## 79.0.0 - 2026-01-05
 
 ### 💥 Breaking Changes

package/build/types/cmp/grid/GridModel.d.ts

@@ -553,9 +553,9 @@ export declare class GridModel extends HoistModel {
     autosizeAsync(overrideOpts?: Omit<GridAutosizeOptions, 'mode'>): Promise<void>;
     /**
      * Begin an inline editing session.
-     * @param record - StoreRecord/ID to edit. If unspecified, the first selected StoreRecord
+     * @param opts.record - StoreRecord/ID to edit. If unspecified, the first selected StoreRecord
      *      will be used, if any, or the first overall StoreRecord in the grid.
-     * @param colId - ID of column on which to start editing. If unspecified, the first
+     * @param opts.colId - ID of column on which to start editing. If unspecified, the first
      *      editable column will be used.
      */
     beginEditAsync(opts?: {

package/build/types/cmp/layout/CollapsibleSet.d.ts

@@ -0,0 +1,14 @@
+import { type FieldsetHTMLAttributes, type ReactElement, type ReactNode } from 'react';
+import type { HoistProps, Intent, LayoutProps, RenderMode, TestSupportProps } from '@xh/hoist/core';
+import './CollapsibleSet.scss';
+export interface CollapsibleSetProps extends FieldsetHTMLAttributes<HTMLFieldSetElement>, HoistProps, TestSupportProps, LayoutProps {
+    icon?: ReactElement;
+    label: ReactNode;
+    tooltip?: JSX.Element | string;
+    intent?: Intent;
+    clickHandler?: () => void;
+    collapsed?: boolean;
+    hideItemCount?: boolean;
+    renderMode?: RenderMode;
+}
+export declare const CollapsibleSet: import("react").FC<CollapsibleSetProps>, collapsibleSet: import("@xh/hoist/core").ElementFactory<CollapsibleSetProps>;

package/build/types/cmp/layout/Tags.d.ts

@@ -10,6 +10,7 @@ export declare const a: import("@xh/hoist/core").ElementFactory<import("react").
 export declare const br: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLBRElement>, HTMLBRElement>>;
 export declare const code: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement>>;
 export declare const div: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const fieldset: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>>;
 export declare const form: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").FormHTMLAttributes<HTMLFormElement>, HTMLFormElement>>;
 export declare const hr: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHRElement>, HTMLHRElement>>;
 export declare const h1: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
@@ -17,6 +18,7 @@ export declare const h2: import("@xh/hoist/core").ElementFactory<import("react")
 export declare const h3: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
 export declare const h4: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
 export declare const label: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").LabelHTMLAttributes<HTMLLabelElement>, HTMLLabelElement>>;
+export declare const legend: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLLegendElement>, HTMLLegendElement>>;
 export declare const li: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").LiHTMLAttributes<HTMLLIElement>, HTMLLIElement>>;
 export declare const nav: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement>>;
 export declare const ol: import("@xh/hoist/core").ElementFactory<import("react").DetailedHTMLProps<import("react").OlHTMLAttributes<HTMLOListElement>, HTMLOListElement>>;

package/build/types/cmp/tab/TabContainerModel.d.ts

@@ -75,7 +75,7 @@ export declare class TabContainerModel extends HoistModel {
     protected lastActiveTabId: string;
     /**
      * @param config - TabContainer configuration.
-     * @param [depth] - Depth in hierarchy of nested TabContainerModels. Not for application use.
+     * @param depth - Depth in hierarchy of nested TabContainerModels. Not for application use.
      */
     constructor({ tabs, defaultTabId, route, track, renderMode, refreshMode, persistWith, emptyText, xhImpl, switcher }: TabContainerConfig, depth?: number);
     /** Set/replace all tabs within the container. */

package/build/types/core/XH.d.ts

@@ -1,7 +1,7 @@
 import { RouterModel } from '@xh/hoist/appcontainer/RouterModel';
 import { HoistAuthModel } from '@xh/hoist/core/HoistAuthModel';
 import { Store } from '@xh/hoist/data';
-import { AlertBannerService, AutoRefreshService, ChangelogService, ClientHealthService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, SessionStorageService, TrackService, WebSocketService } from '@xh/hoist/svc';
+import { AlertBannerService, AutoRefreshService, ChangelogService, ConfigService, EnvironmentService, FetchOptions, FetchService, GridAutosizeService, GridExportService, IdentityService, IdleService, InspectorService, JsonBlobService, LocalStorageService, PrefService, SessionStorageService, TrackService, WebSocketService, ClientHealthService } from '@xh/hoist/svc';
 import { LogLevel } from '@xh/hoist/utils/js';
 import { Router, State } from 'router5';
 import { CancelFn } from 'router5/types/types/base';
@@ -175,8 +175,6 @@ export declare class XHApi {
      * @see IdentityService.username
      */
     getUsername(): string;
-    /** @returns the current acting user's initials. */
-    getUserInitials(): string;
     /**
      * Logout the current user.
      * @see HoistAuthModel.logoutAsync

package/build/types/core/enums/RenderMode.d.ts

@@ -1,6 +1,6 @@
 /**
  * Options for how contents should be rendered by their parent container.
- * Used by {@link TabContainerModel}, {@link DashContainerModel}, and {@link PanelModel}.
+ * Used by {@link TabContainerModel}, {@link DashContainerModel}, {@link PanelModel}, and {@link CollapsibleSet}.
  */
 export declare const RenderMode: Readonly<{
     /** Always render contents when the parent container is rendered, even if inactive. */

package/build/types/desktop/cmp/button/AppMenuButton.d.ts

@@ -1,7 +1,6 @@
-import { HoistUser, MenuItemLike } from '@xh/hoist/core';
+import { MenuItemLike } from '@xh/hoist/core';
 import { ButtonProps } from '@xh/hoist/desktop/cmp/button';
 import '@xh/hoist/desktop/register';
-import { ReactNode } from 'react';
 export interface AppMenuButtonProps extends ButtonProps {
     /**
      * Array of extra menu items. Can contain:
@@ -32,13 +31,5 @@ export interface AppMenuButtonProps extends ButtonProps {
     hideOptionsItem?: boolean;
     /** True to hide the Theme Toggle button. */
     hideThemeItem?: boolean;
-    /**
-     * Replace the default hamburger icon with a user profile representation. Set to true to render
-     * the user's initials from their `HoistUser.displayName`. Alternately, provide a custom
-     * function to render an alternate compact string or element for the current user.
-     */
-    renderWithUserProfile?: boolean | RenderWithUserProfileCustomFn;
 }
-type RenderWithUserProfileCustomFn = (user: HoistUser) => ReactNode;
 export declare const AppMenuButton: import("react").FC<AppMenuButtonProps>, appMenuButton: import("@xh/hoist/core").ElementFactory<AppMenuButtonProps>;
-export {};

package/build/types/desktop/cmp/button/CollapsibleSetButton.d.ts

@@ -0,0 +1,12 @@
+import { type ReactElement, type ReactNode, type JSX } from 'react';
+import type { Intent, HoistProps } from '@xh/hoist/core';
+export interface CollapsibleSetButtonProps extends HoistProps {
+    icon?: ReactElement;
+    text: ReactNode;
+    tooltip?: JSX.Element | string;
+    clickHandler?: (boolean: any) => void;
+    intent?: Intent;
+    collapsed?: boolean;
+    disabled?: boolean;
+}
+export declare const CollapsibleSetButton: import("react").FC<CollapsibleSetButtonProps>, collapsibleSetButton: import("@xh/hoist/core").ElementFactory<CollapsibleSetButtonProps>;

package/build/types/desktop/cmp/dash/canvas/DashCanvasModel.d.ts

@@ -14,11 +14,12 @@ export interface DashCanvasConfig extends DashConfig<DashCanvasViewSpec, DashCan
      */
     rowHeight?: number;
     /**
-     * Whether views should "compact" vertically or horizontally
+     * Whether views should "compact" vertically, horizontally or wrap
      * to condense space. Default `true` defaults to vertical compaction.
+     * Use `wrap` with caution.  It only works well if all items are 1 row high.
      * See react-grid-layout docs for more information.
-     * */
-    compact?: boolean | 'vertical' | 'horizontal';
+     */
+    compact?: boolean | 'vertical' | 'horizontal' | 'wrap';
     /** Between items [x,y] in pixels. Default `[10, 10]`. */
     margin?: [number, number];
     /** Padding inside the container [x, y] in pixels. Defaults to same as `margin`. */
@@ -29,6 +30,31 @@ export interface DashCanvasConfig extends DashConfig<DashCanvasViewSpec, DashCan
      * Whether a grid background should be shown. Default false.
      */
     showGridBackground?: boolean;
+    /**
+     * Whether the canvas should accept drag-and-drop of views from outside
+     * the canvas. Default false.
+     */
+    allowsDrop?: boolean;
+    /**
+     * Optional callback to invoke after a view is successfully dropped onto the canvas.
+     */
+    onDropDone?: (viewModel: DashCanvasViewModel) => void;
+    /**
+     * Optional callback to invoke when an item is dragged over the canvas. This may be used to
+     * customize how the size of the dropping placeholder is calculated. The callback should
+     * return an object with optional properties indicating the desired width, height (in grid units),
+     * and offset (in pixels) of the dropping placeholder.  The method's signature is the same as
+     * the `onDropDragOver` prop of ReactGridLayout.
+     * Returning `false` will prevent the dropping placeholder from being shown, and prevents a drop.
+     * Returning `void` will use the default behavior, which is to size the placeholder as per the
+     * `dropConfig.defaultItem` specification.
+     */
+    onDropDragOver?: (e: DragEvent) => OnDropDragOverResult;
+    /**
+     * Whether an overlay with an Add View button should be rendered
+     * when the canvas is empty. Default true.
+     */
+    showAddViewButtonWhenEmpty?: boolean;
 }
 export interface DashCanvasItemState {
     layout: DashCanvasItemLayout;
@@ -42,6 +68,12 @@ export interface DashCanvasItemLayout {
     w: number;
     h: number;
 }
+export type OnDropDragOverResult = {
+    w?: number;
+    h?: number;
+    dragOffsetX?: number;
+    dragOffsetY?: number;
+} | false | void;
 /**
  * Model for {@link DashCanvas}, managing all configurable options for the component and publishing
  * the observable state of its current widgets and their layout.
@@ -51,12 +83,17 @@ export declare class DashCanvasModel extends DashModel<DashCanvasViewSpec, DashC
 }> {
     columns: number;
     rowHeight: number;
-    compact: 'vertical' | 'horizontal';
+    compact: 'vertical' | 'horizontal' | 'wrap';
     margin: [number, number];
     containerPadding: [number, number];
     showGridBackground: boolean;
     rglHeight: number;
+    showAddViewButtonWhenEmpty: boolean;
+    DROPPING_ELEM_ID: string;
     maxRows: number;
+    allowsDrop: boolean;
+    onDropDone: (viewModel: DashCanvasViewModel) => void;
+    draggedInView: DashCanvasItemState;
     /** Current number of rows in canvas */
     get rows(): number;
     get isEmpty(): boolean;
@@ -65,7 +102,7 @@ export declare class DashCanvasModel extends DashModel<DashCanvasViewSpec, DashC
     isResizing: boolean;
     private isLoadingState;
     get rglLayout(): any[];
-    constructor({ viewSpecs, viewSpecDefaults, initialState, layoutLocked, contentLocked, renameLocked, persistWith, emptyText, addViewButtonText, columns, rowHeight, compact, margin, maxRows, containerPadding, extraMenuItems, showGridBackground }: DashCanvasConfig);
+    constructor({ viewSpecs, viewSpecDefaults, initialState, layoutLocked, contentLocked, renameLocked, persistWith, emptyText, addViewButtonText, columns, rowHeight, compact, margin, maxRows, containerPadding, extraMenuItems, showGridBackground, showAddViewButtonWhenEmpty, allowsDrop, onDropDone, onDropDragOver }: DashCanvasConfig);
     /** Removes all views from the canvas */
     clear(): void;
     /**
@@ -103,6 +140,10 @@ export declare class DashCanvasModel extends DashModel<DashCanvasViewSpec, DashC
     renameView(id: string): void;
     /** Scrolls a DashCanvasView into view. */
     ensureViewVisible(id: string): void;
+    onDrop(rglLayout: LayoutItem[], layoutItem: LayoutItem, evt: Event): void;
+    setDraggedInView(view?: DashCanvasItemState): void;
+    onDropDragOver(evt: DragEvent): OnDropDragOverResult;
+    getViewsBySpecId(id: any): DashCanvasViewModel[];
     getPersistableState(): PersistableState<{
         state: DashCanvasItemState[];
     }>;
@@ -123,6 +164,5 @@ export declare class DashCanvasModel extends DashModel<DashCanvasViewSpec, DashC
     private setViewLayout;
     private getSpec;
     private hasSpec;
-    private getViewsBySpecId;
     private getNextAvailablePosition;
 }

package/build/types/desktop/cmp/dash/canvas/widgetwell/DashCanvasWidgetWell.d.ts

@@ -0,0 +1,19 @@
+import { HoistProps, TestSupportProps } from '@xh/hoist/core';
+import { DashCanvasModel } from '@xh/hoist/desktop/cmp/dash';
+import './DashCanvasWidgetWell.scss';
+export interface DashCanvasWidgetWellProps extends HoistProps, TestSupportProps {
+    /** DashCanvasModel for which this widget well should allow the user to add views from. */
+    dashCanvasModel?: DashCanvasModel;
+    /** Defaults to `column` */
+    flexDirection?: 'row' | 'column';
+}
+/**
+ * Widget Well from which to add items to a DashCanvas by drag-and-drop.
+ *
+ * Available view specs are listed in their defined order,
+ * grouped by their 'groupName' property if present.
+ *
+ * Typically, an app developer would place this inside a collapsible panel to the side of
+ * a DashCanvas.
+ */
+export declare const DashCanvasWidgetWell: import("react").FC<DashCanvasWidgetWellProps>, dashCanvasWidgetWell: import("@xh/hoist/core").ElementFactory<DashCanvasWidgetWellProps>;

package/build/types/desktop/cmp/dash/canvas/widgetwell/DashCanvasWidgetWellModel.d.ts

@@ -0,0 +1,11 @@
+import { DragEvent } from 'react';
+import { DashCanvasModel } from '@xh/hoist/desktop/cmp/dash';
+import { HoistModel } from '@xh/hoist/core';
+import '@xh/hoist/desktop/register';
+export declare class DashCanvasWidgetWellModel extends HoistModel {
+    dashCanvasModel: DashCanvasModel;
+    constructor();
+    onLinked(): void;
+    onDragStart(evt: DragEvent<HTMLDivElement>): void;
+    onDragEnd(evt: DragEvent<HTMLDivElement>): void;
+}

package/build/types/dynamics/desktop.d.ts

@@ -8,6 +8,7 @@
  *
  * See the platform specific AppContainer where these implementations are actually provided.
  */
+export declare let collapsibleSetButton: any;
 export declare let ColChooserModel: any;
 export declare let ColumnHeaderFilterModel: any;
 export declare let ModalSupportModel: any;

package/build/types/dynamics/mobile.d.ts

@@ -8,6 +8,7 @@
  *
  * See the platform specific AppContainer where these implementations are actually provided.
  */
+export declare let collapsibleSetButton: any;
 export declare let ColChooserModel: any;
 export declare let colChooser: any;
 export declare let zoneMapper: any;

package/build/types/mobile/cmp/button/CollapsibleSetButton.d.ts

@@ -0,0 +1,12 @@
+import { type ReactElement, type ReactNode, type JSX } from 'react';
+import type { Intent, HoistProps } from '@xh/hoist/core';
+export interface CollapsibleSetButtonProps extends HoistProps {
+    icon?: ReactElement;
+    text: ReactNode;
+    tooltip?: JSX.Element | string;
+    clickHandler?: (boolean: any) => void;
+    intent?: Intent;
+    collapsed?: boolean;
+    disabled?: boolean;
+}
+export declare const CollapsibleSetButton: import("react").FC<CollapsibleSetButtonProps>, collapsibleSetButton: import("@xh/hoist/core").ElementFactory<CollapsibleSetButtonProps>;

package/build/types/mobile/cmp/header/AppMenuButton.d.ts

@@ -1,7 +1,6 @@
-import { HoistUser, MenuItemLike } from '@xh/hoist/core';
+import { MenuItemLike } from '@xh/hoist/core';
 import { MenuButtonProps } from '@xh/hoist/mobile/cmp/menu';
 import '@xh/hoist/mobile/register';
-import { ReactNode } from 'react';
 export interface AppMenuButtonProps extends MenuButtonProps {
     /** Array of app-specific MenuItems or configs to create them. */
     extraItems?: MenuItemLike[];
@@ -22,14 +21,7 @@ export interface AppMenuButtonProps extends MenuButtonProps {
     hideThemeItem?: boolean;
     /** True to hide the About button */
     hideAboutItem?: boolean;
-    /**
-     * Replace the default hamburger icon with a user profile representation. Set to true to render
-     * the user's initials from their `HoistUser.displayName`. Alternately, provide a custom
-     * function to render an alternate compact string or element for the current user.
-     */
-    renderWithUserProfile?: boolean | RenderWithUserProfileCustomFn;
 }
-type RenderWithUserProfileCustomFn = (user: HoistUser) => ReactNode;
 /**
  * A top-level application drop down menu, which installs a standard set of menu items for common
  * application actions. Application specific items can be displayed before these standard items.
@@ -38,4 +30,3 @@ type RenderWithUserProfileCustomFn = (user: HoistUser) => ReactNode;
  * or they can each be explicitly hidden.
  */
 export declare const AppMenuButton: import("react").FC<AppMenuButtonProps>, appMenuButton: import("@xh/hoist/core").ElementFactory<AppMenuButtonProps>;
-export {};

package/build/types/svc/IdentityService.d.ts

@@ -11,12 +11,10 @@ export declare class IdentityService extends HoistService {
     private _authUser;
     private _apparentUser;
     initAsync(): Promise<void>;
-    /** @returns current acting user (see authUser for notes on impersonation) */
+    /** Current acting user (see authUser for notes on impersonation) */
     get user(): HoistUser;
-    /** @returns current acting user's username. */
+    /** Current acting user's username. */
     get username(): string;
-    /** @returns current acting user's initials, based on displayName. */
-    get userInitials(): string;
     /**
      * Actual user who authenticated to the web application.
      * This will be the same as the user except when an administrator is impersonation another

package/cmp/grid/GridModel.ts

@@ -1442,9 +1442,9 @@ export class GridModel extends HoistModel {
 
     /**
      * Begin an inline editing session.
-     * @param record - StoreRecord/ID to edit. If unspecified, the first selected StoreRecord
+     * @param opts.record - StoreRecord/ID to edit. If unspecified, the first selected StoreRecord
      *      will be used, if any, or the first overall StoreRecord in the grid.
-     * @param colId - ID of column on which to start editing. If unspecified, the first
+     * @param opts.colId - ID of column on which to start editing. If unspecified, the first
      *      editable column will be used.
      */
     async beginEditAsync(opts: {record?: StoreRecordOrId; colId?: string} = {}) {

package/cmp/layout/CollapsibleSet.scss

@@ -0,0 +1,49 @@
+/*
+ * This file belongs to Hoist, an application development toolkit
+ * developed by Extremely Heavy Industries (www.xh.io | info@xh.io)
+ *
+ * Copyright © 2026 Extremely Heavy Industries Inc.
+ */
+
+.xh-collapsible-set {
+  &--collapsed {
+    border-bottom: none;
+    border-left: none;
+    border-right: none;
+
+    &--render-mode--always,
+    &--render-mode--lazy {
+      > *:not(:first-child) {
+        display: none;
+      }
+    }
+  }
+
+  &.xh-collapsible-set--intent-primary {
+    border-color: var(--xh-intent-primary-trans2);
+    &.xh-collapsible-set--enabled {
+      border-color: var(--xh-intent-primary);
+    }
+  }
+
+  &.xh-collapsible-set--intent-success {
+    border-color: var(--xh-intent-success-trans2);
+    &.xh-collapsible-set--enabled {
+      border-color: var(--xh-intent-success);
+    }
+  }
+
+  &.xh-collapsible-set--intent-warning {
+    border-color: var(--xh-intent-warning-trans2);
+    &.xh-collapsible-set--enabled {
+      border-color: var(--xh-intent-warning);
+    }
+  }
+
+  &.xh-collapsible-set--intent-danger {
+    border-color: var(--xh-intent-danger-trans2);
+    &.xh-collapsible-set--enabled {
+      border-color: var(--xh-intent-danger);
+    }
+  }
+}

package/cmp/layout/CollapsibleSet.ts

@@ -0,0 +1,135 @@
+/*
+ * This file belongs to Hoist, an application development toolkit
+ * developed by Extremely Heavy Industries (www.xh.io | info@xh.io)
+ *
+ * Copyright © 2026 Extremely Heavy Industries Inc.
+ */
+
+import classNames from 'classnames';
+import {castArray} from 'lodash';
+import {type FieldsetHTMLAttributes, type ReactElement, type ReactNode, useState} from 'react';
+import {XH, hoistCmp} from '@xh/hoist/core';
+import type {HoistProps, Intent, LayoutProps, RenderMode, TestSupportProps} from '@xh/hoist/core';
+import {fieldset} from '@xh/hoist/cmp/layout';
+import {TEST_ID, mergeDeep} from '@xh/hoist/utils/js';
+import {splitLayoutProps} from '@xh/hoist/utils/react';
+import {collapsibleSetButton as desktopCollapsibleSetButtonImpl} from '@xh/hoist/dynamics/desktop';
+import {collapsibleSetButton as mobileCollapsibleSetButtonImpl} from '@xh/hoist/dynamics/mobile';
+
+import './CollapsibleSet.scss';
+
+export interface CollapsibleSetProps
+    extends FieldsetHTMLAttributes<HTMLFieldSetElement>, HoistProps, TestSupportProps, LayoutProps {
+    icon?: ReactElement;
+    label: ReactNode;
+    tooltip?: JSX.Element | string;
+    intent?: Intent;
+    clickHandler?: () => void;
+    collapsed?: boolean;
+    hideItemCount?: boolean;
+    renderMode?: RenderMode;
+}
+
+export const [CollapsibleSet, collapsibleSet] = hoistCmp.withFactory<CollapsibleSetProps>({
+    displayName: 'CollapsibleSet',
+    model: false,
+    className: 'xh-collapsible-set',
+    render({
+        icon,
+        label,
+        tooltip,
+        intent,
+        collapsed,
+        children,
+        hideItemCount,
+        className,
+        disabled,
+        display = 'flex',
+        flexDirection = 'column',
+        flexWrap = 'wrap',
+        renderMode = 'unmountOnHide',
+        ...rest
+    }) {
+        // Note `model` destructured off of non-layout props to avoid setting
+        // model as a bogus DOM attribute. This low-level component may easily be passed one from
+        // a parent that has not properly managed its own props.
+        let [layoutProps, {model, testId, ...restProps}] = splitLayoutProps(rest);
+
+        restProps = mergeDeep(
+            {style: {display, flexDirection, flexWrap, ...layoutProps}},
+            {[TEST_ID]: testId},
+            restProps
+        );
+
+        const [isCollapsed, setIsCollapsed] = useState<boolean>(collapsed === true),
+            [expandCount, setExpandCount] = useState<number>(!collapsed ? 1 : 0),
+            items = castArray(children),
+            itemCount = hideItemCount === true ? '' : ` (${items.length})`,
+            classes = [];
+
+        if (isCollapsed) {
+            classes.push('xh-collapsible-set--collapsed');
+        } else {
+            classes.push('xh-collapsible-set--expanded');
+        }
+
+        if (disabled) {
+            classes.push('xh-collapsible-set--disabled');
+        } else {
+            classes.push('xh-collapsible-set--enabled');
+        }
+
+        if (intent) {
+            classes.push(`xh-collapsible-set--intent-${intent}`);
+        } else {
+            classes.push(`xh-collapsible-set--intent-none`);
+        }
+
+        const btn = XH.isMobileApp
+            ? mobileCollapsibleSetButtonImpl
+            : desktopCollapsibleSetButtonImpl;
+
+        let content;
+        switch (renderMode) {
+            case 'always':
+                content = items;
+                if (isCollapsed) {
+                    classes.push('xh-collapsible-set--collapsed--render-mode--always');
+                }
+                break;
+
+            case 'lazy':
+                content = isCollapsed && !expandCount ? [] : items;
+                if (isCollapsed) {
+                    classes.push('xh-collapsible-set--collapsed--render-mode--lazy');
+                }
+                break;
+
+            // unmountOnHide
+            default:
+                content = isCollapsed ? [] : items;
+                break;
+        }
+
+        return fieldset({
+            className: classNames(className, classes),
+            items: [
+                btn({
+                    icon,
+                    text: `${label}${itemCount}`,
+                    tooltip,
+                    intent,
+                    clickHandler: val => {
+                        setIsCollapsed(val);
+                        setExpandCount(expandCount + 1);
+                    },
+                    collapsed: isCollapsed,
+                    disabled
+                }),
+                ...content
+            ],
+            disabled,
+            ...restProps
+        });
+    }
+});

package/cmp/layout/Tags.ts

@@ -29,6 +29,7 @@ export const a = elementFactory('a');
 export const br = elementFactory('br');
 export const code = elementFactory('code');
 export const div = elementFactory('div');
+export const fieldset = elementFactory('fieldset');
 export const form = elementFactory('form');
 export const hr = elementFactory('hr');
 export const h1 = elementFactory('h1');
@@ -36,6 +37,7 @@ export const h2 = elementFactory('h2');
 export const h3 = elementFactory('h3');
 export const h4 = elementFactory('h4');
 export const label = elementFactory('label');
+export const legend = elementFactory('legend');
 export const li = elementFactory('li');
 export const nav = elementFactory('nav');
 export const ol = elementFactory('ol');

package/cmp/tab/TabContainerModel.ts

@@ -123,7 +123,7 @@ export class TabContainerModel extends HoistModel {
 
     /**
      * @param config - TabContainer configuration.
-     * @param [depth] - Depth in hierarchy of nested TabContainerModels. Not for application use.
+     * @param depth - Depth in hierarchy of nested TabContainerModels. Not for application use.
      */
     constructor(
         {

package/core/XH.ts

@@ -14,7 +14,6 @@ import {
     AlertBannerService,
     AutoRefreshService,
     ChangelogService,
-    ClientHealthService,
     ConfigService,
     EnvironmentService,
     FetchOptions,
@@ -29,13 +28,13 @@ import {
     PrefService,
     SessionStorageService,
     TrackService,
-    WebSocketService
+    WebSocketService,
+    ClientHealthService
 } from '@xh/hoist/svc';
-import {apiDeprecated, getLogLevel, LogLevel, setLogLevel} from '@xh/hoist/utils/js';
+import {getLogLevel, setLogLevel, LogLevel, apiDeprecated} from '@xh/hoist/utils/js';
 import {camelCase, flatten, isString, uniqueId} from 'lodash';
 import {Router, State} from 'router5';
 import {CancelFn} from 'router5/types/types/base';
-import ShortUniqueId from 'short-unique-id';
 import {SetOptional} from 'type-fest';
 import {AppContainerModel} from '../appcontainer/AppContainerModel';
 import {BannerModel} from '../appcontainer/BannerModel';
@@ -67,6 +66,7 @@ import {
 import {installServicesAsync} from './impl/InstallServices';
 import {instanceManager} from './impl/InstanceManager';
 import {HoistModel, ModelSelector, RefreshContextModel} from './model';
+import ShortUniqueId from 'short-unique-id';
 
 export const MIN_HOIST_CORE_VERSION = '31.2';
 
@@ -360,11 +360,6 @@ export class XHApi {
         return this.identityService?.username ?? null;
     }
 
-    /** @returns the current acting user's initials. */
-    getUserInitials(): string {
-        return this.identityService?.userInitials ?? null;
-    }
-
     /**
      * Logout the current user.
      * @see HoistAuthModel.logoutAsync

package/core/enums/RenderMode.ts

@@ -7,7 +7,7 @@
 
 /**
  * Options for how contents should be rendered by their parent container.
- * Used by {@link TabContainerModel}, {@link DashContainerModel}, and {@link PanelModel}.
+ * Used by {@link TabContainerModel}, {@link DashContainerModel}, {@link PanelModel}, and {@link CollapsibleSet}.
  */
 export const RenderMode = Object.freeze({
     /** Always render contents when the parent container is rendered, even if inactive. */