@dragonworks/ngx-dashboard 21.1.1 → 21.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dragonworks/ngx-dashboard",
-  "version": "21.1.1",
+  "version": "21.2.1",
   "description": "Angular library for building drag-and-drop grid dashboards with resizable cells and customizable widgets",
   "peerDependencies": {
     "@angular/common": "^21.0.0",

package/types/dragonworks-ngx-dashboard.d.ts

@@ -4,7 +4,7 @@ import { Type, ViewContainerRef, ComponentRef, OnChanges, SimpleChanges, Injecti
 import * as _ngrx_signals from '@ngrx/signals';
 import { SafeHtml } from '@angular/platform-browser';
 
-declare const NGX_DASHBOARD_VERSION = "21.1.1";
+declare const NGX_DASHBOARD_VERSION = "21.2.1";
 
 /**
  * Branded type for cell identifiers to ensure type safety when working with grid coordinates.
@@ -82,7 +82,14 @@ interface CellDisplayData {
 interface DashboardDataDto {
     /** Version for future compatibility and migration support */
     version: string;
-    /** Unique dashboard identifier managed by the client */
+    /**
+     * Unique dashboard identifier managed by the client.
+     * Set once when a dashboard is first mounted via `[dashboardData]`.
+     * On subsequent imperative `loadDashboard()` calls this field is treated
+     * as informational metadata (i.e. where the file came from) — the store's
+     * existing id is preserved so that bridge registration stays stable and
+     * Export→Import across dashboards works without rewriting the id.
+     */
     dashboardId: string;
     /** Grid dimensions */
     rows: number;
@@ -241,6 +248,15 @@ interface SelectionFilterOptions {
     padding?: number;
 }
 
+/**
+ * Keyboard modifier that gates drag-to-select.
+ *
+ * When set on `DashboardComponent.selectionModifier`, the selection overlay
+ * is mounted but transparent to pointer events until the modifier is held
+ * (or a drag started while the modifier was held is in progress).
+ */
+type SelectionModifier = 'shift' | 'ctrl' | 'alt' | 'meta';
+
 /**
  * Interface for providing shared state across all instances of a widget type.
  *
@@ -437,6 +453,8 @@ declare class DashboardComponent implements OnChanges {
     editMode: _angular_core.InputSignal<boolean>;
     reservedSpace: _angular_core.InputSignal<ReservedSpace | undefined>;
     enableSelection: _angular_core.InputSignal<boolean>;
+    selectionModifier: _angular_core.InputSignal<SelectionModifier | null>;
+    dragThreshold: _angular_core.InputSignal<number>;
     selectionComplete: _angular_core.OutputEmitterRef<GridSelection>;
     cells: _angular_core.Signal<CellData[]>;
     private dashboardEditor;
@@ -454,7 +472,7 @@ declare class DashboardComponent implements OnChanges {
     getCurrentDashboardData(): DashboardDataDto;
     clearDashboard(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DashboardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DashboardComponent, "ngx-dashboard", never, { "dashboardData": { "alias": "dashboardData"; "required": true; "isSignal": true; }; "editMode": { "alias": "editMode"; "required": false; "isSignal": true; }; "reservedSpace": { "alias": "reservedSpace"; "required": false; "isSignal": true; }; "enableSelection": { "alias": "enableSelection"; "required": false; "isSignal": true; }; }, { "selectionComplete": "selectionComplete"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DashboardComponent, "ngx-dashboard", never, { "dashboardData": { "alias": "dashboardData"; "required": true; "isSignal": true; }; "editMode": { "alias": "editMode"; "required": false; "isSignal": true; }; "reservedSpace": { "alias": "reservedSpace"; "required": false; "isSignal": true; }; "enableSelection": { "alias": "enableSelection"; "required": false; "isSignal": true; }; "selectionModifier": { "alias": "selectionModifier"; "required": false; "isSignal": true; }; "dragThreshold": { "alias": "dragThreshold"; "required": false; "isSignal": true; }; }, { "selectionComplete": "selectionComplete"; }, never, never, true, never>;
 }
 
 interface WidgetDisplayItem extends WidgetMetadata {
@@ -665,4 +683,4 @@ declare class WidgetListContextMenuProvider extends EmptyCellContextProvider {
 }
 
 export { CELL_SETTINGS_DIALOG_PROVIDER, CellSettingsDialogProvider, DashboardComponent, DashboardService, DefaultCellSettingsDialogProvider, DefaultEmptyCellContextProvider, EMPTY_CELL_CONTEXT_PROVIDER, EmptyCellContextProvider, NGX_DASHBOARD_VERSION, WidgetListComponent, WidgetListContextMenuProvider, createDefaultDashboard, createEmptyDashboard };
-export type { CellDataDto, DashboardDataDto, EmptyCellContext, GridSelection, ReservedSpace, SelectionFilterOptions, Widget, WidgetMetadata, WidgetSharedStateProvider };
+export type { CellDataDto, DashboardDataDto, EmptyCellContext, GridSelection, ReservedSpace, SelectionFilterOptions, SelectionModifier, Widget, WidgetMetadata, WidgetSharedStateProvider };