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

package/CHANGELOG.md

@@ -23,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/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/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/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/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. */

package/desktop/appcontainer/AppContainer.ts

@@ -27,6 +27,7 @@ import {zoneMapperDialog as zoneMapper} from '@xh/hoist/desktop/cmp/zoneGrid/imp
 import {useContextMenu, useHotkeys} from '@xh/hoist/desktop/hooks';
 import {DynamicTabSwitcherModel, installDesktopImpls} from '@xh/hoist/dynamics/desktop';
 import {inspectorPanel} from '@xh/hoist/inspector/InspectorPanel';
+import {collapsibleSetButton} from '@xh/hoist/desktop/cmp/button/CollapsibleSetButton';
 import {blueprintProvider} from '@xh/hoist/kit/blueprint';
 import {consumeEvent} from '@xh/hoist/utils/js';
 import {elementFromContent, useOnMount} from '@xh/hoist/utils/react';
@@ -46,6 +47,7 @@ import {toastSource} from './ToastSource';
 import {versionBar} from './VersionBar';
 
 installDesktopImpls({
+    collapsibleSetButton,
     tabContainerImpl,
     dockContainerImpl,
     storeFilterFieldImpl,

package/desktop/cmp/button/CollapsibleSetButton.ts

@@ -0,0 +1,57 @@
+/*
+ * 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 {type ReactElement, type ReactNode, type JSX, useState} from 'react';
+import {tooltip as bpTooltip} from '@xh/hoist/kit/blueprint';
+import {hoistCmp} from '@xh/hoist/core';
+import type {Intent, HoistProps} from '@xh/hoist/core';
+import {button} from '@xh/hoist/desktop/cmp/button';
+import {legend} from '@xh/hoist/cmp/layout';
+import {Icon} from '@xh/hoist/icon/Icon';
+
+export interface CollapsibleSetButtonProps extends HoistProps {
+    icon?: ReactElement;
+    text: ReactNode;
+    tooltip?: JSX.Element | string;
+    clickHandler?: (boolean) => void;
+    intent?: Intent;
+    collapsed?: boolean;
+    disabled?: boolean;
+}
+
+export const [CollapsibleSetButton, collapsibleSetButton] =
+    hoistCmp.withFactory<CollapsibleSetButtonProps>({
+        displayName: 'CollapsibleSetButton',
+        model: false,
+        render({icon, text, tooltip, intent, clickHandler, collapsed, disabled}) {
+            const [isCollapsed, setIsCollapsed] = useState<boolean>(collapsed === true),
+                btn = button({
+                    text,
+                    icon,
+                    rightIcon: isCollapsed ? Icon.angleDown() : Icon.angleUp(),
+                    outlined: isCollapsed && !intent,
+                    minimal: !intent || (intent && !isCollapsed),
+                    intent,
+                    disabled,
+                    onClick: () => {
+                        const val = !isCollapsed;
+                        setIsCollapsed(val);
+                        clickHandler?.(val);
+                    }
+                });
+
+            return legend(
+                tooltip
+                    ? bpTooltip({
+                          item: btn,
+                          content: tooltip,
+                          intent
+                      })
+                    : btn
+            );
+        }
+    });

package/desktop/cmp/dash/canvas/DashCanvas.ts

@@ -10,7 +10,7 @@ import ReactGridLayout, {
     useContainerWidth,
     getCompactor
 } from 'react-grid-layout';
-import {GridBackground, type GridBackgroundProps} from 'react-grid-layout/extras';
+import {GridBackground, type GridBackgroundProps, wrapCompactor} from 'react-grid-layout/extras';
 import composeRefs from '@seznam/compose-react-refs';
 import {div, vbox, vspacer} from '@xh/hoist/cmp/layout';
 import {
@@ -62,7 +62,11 @@ export const [DashCanvas, dashCanvas] = hoistCmp.withFactory<DashCanvasProps>({
     render({className, model, rglOptions, testId}, ref) {
         const isDraggable = !model.layoutLocked,
             isResizable = !model.layoutLocked,
-            {width, containerRef, mounted} = useContainerWidth();
+            {width, containerRef, mounted} = useContainerWidth(),
+            defaultDroppedItemDims = {
+                w: Math.floor(model.columns / 3),
+                h: Math.floor(model.columns / 3)
+            };
 
         return refreshContextView({
             model: model.refreshContextModel,
@@ -98,7 +102,20 @@ export const [DashCanvas, dashCanvas] = hoistCmp.withFactory<DashCanvasProps>({
                                 resizeConfig: {
                                     enabled: isResizable
                                 },
-                                compactor: getCompactor(model.compact, false, false),
+                                dropConfig: {
+                                    enabled: model.contentLocked ? false : model.allowsDrop,
+                                    defaultItem: defaultDroppedItemDims,
+                                    onDragOver: (evt: DragEvent) => model.onDropDragOver(evt)
+                                },
+                                onDrop: (
+                                    layout: LayoutItem[],
+                                    layoutItem: LayoutItem,
+                                    evt: Event
+                                ) => model.onDrop(layout, layoutItem, evt),
+                                compactor:
+                                    model.compact === 'wrap'
+                                        ? wrapCompactor
+                                        : getCompactor(model.compact, false, false),
                                 onLayoutChange: (layout: LayoutItem[]) =>
                                     model.onRglLayoutChange(layout),
                                 onResizeStart: () => (model.isResizing = true),
@@ -116,7 +133,7 @@ export const [DashCanvas, dashCanvas] = hoistCmp.withFactory<DashCanvasProps>({
                         ),
                         width
                     }),
-                    emptyContainerOverlay({omit: !mounted})
+                    emptyContainerOverlay({omit: !mounted || !model.showAddViewButtonWhenEmpty})
                 ],
                 [TEST_ID]: testId
             })