eru-grid 0.0.57 → 0.0.59

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eru-grid",
-  "version": "0.0.57",
+  "version": "0.0.59",
   "peerDependencies": {
     "@angular/common": "^21.1.2",
     "@angular/core": "^21.1.2",

package/types/eru-grid.d.ts

@@ -73,6 +73,7 @@ interface GridFeatures {
     groupBar?: boolean;
     excel_download?: boolean;
     excel_download_icon?: boolean;
+    refresh_icon?: boolean;
     response_key?: string;
     header_fill_color?: string[];
     header_fill_type?: string;
@@ -98,6 +99,7 @@ interface GridFeatures {
     headerRowHeight?: number;
     dataRowHeight?: number;
     cursorOnHover?: string;
+    boardCardBg?: string;
     boardCardHoverBg?: string;
     boardCardSelectedBg?: string;
     boardCardSelectedOutline?: string;
@@ -180,6 +182,18 @@ interface ExcelDownloadRequest extends ExcelDownloadPayload {
     id: number;
     timestamp: number;
 }
+/**
+ * A request to reload the grid's data, queued for the consumer.
+ *
+ * eru-grid never fetches its own rows, so the refresh icon cannot reload
+ * anything by itself — it follows ExcelDownloadRequest's enqueue/drain shape:
+ * the consumer watches `EruGridStore.refreshRequest()`, re-runs whatever
+ * populates the grid, and calls removeRefreshRequest(id).
+ */
+interface RefreshRequest {
+    id: number;
+    timestamp: number;
+}
 /**
  * A message from a cell's server-side validation check, queued for the consumer
  * to display. eru-grid does not render a snackbar — it delegates chrome to the
@@ -1569,6 +1583,8 @@ declare class EruGridStore {
     readonly dynamicDataRequest: _angular_core.Signal<DynamicDataRequest[] | null>;
     readonly dynamicData: _angular_core.Signal<Map<string, any> | null>;
     readonly excelDownloadRequest: _angular_core.Signal<ExcelDownloadRequest[]>;
+    private readonly _refreshRequest;
+    readonly refreshRequest: _angular_core.Signal<RefreshRequest[]>;
     /**
      * Every row currently in memory that can be selected, deduped by selection key.
      *
@@ -1842,6 +1858,12 @@ declare class EruGridStore {
      * Enqueue an excel-download request (called by the grid component when the
      * excel-download icon is clicked).
      */
+    addRefreshRequest(request: RefreshRequest): void;
+    /**
+     * Remove a refresh request from the queue (called by the consumer once it has
+     * reloaded the grid's data for that request).
+     */
+    removeRefreshRequest(id: number): void;
     addExcelDownloadRequest(request: ExcelDownloadRequest): void;
     /**
      * Remove an excel-download request from the queue (called by the consumer
@@ -2183,6 +2205,18 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
      * request via gridStore.removeExcelDownloadRequest(id) once done.
      */
     onExcelDownloadClick(event: Event): void;
+    /**
+     * Fires when the user clicks the refresh icon (shown when
+     * `config.refresh_icon` is enabled). Enqueues a RefreshRequest the same way
+     * the excel icon enqueues its export — the grid holds no data source of its
+     * own, so reloading is the consumer's job.
+     */
+    onRefreshClick(event: Event): void;
+    /**
+     * Enqueue a refresh request without a click, so a host can drive the same
+     * reload from its own button when the built-in icon is off.
+     */
+    requestRefresh(): void;
     /**
      * Enqueue an excel-download request without a click. This is the same path
      * the icon takes, exposed so a host can trigger the export from its own
@@ -2260,6 +2294,9 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
     showBoardColumnHeader: _angular_core.Signal<boolean>;
     showGroupBar: _angular_core.Signal<boolean>;
     showExcelDownload: _angular_core.Signal<boolean>;
+    showRefreshIcon: _angular_core.Signal<boolean>;
+    /** Whether the bar above the grid has anything to hold. */
+    showGridActionBar: _angular_core.Signal<boolean>;
     wrapHeaders: _angular_core.Signal<boolean>;
     headerRowHeight: _angular_core.Signal<number>;
     dataRowHeight: _angular_core.Signal<number>;
@@ -4140,4 +4177,4 @@ declare class ThemeToggleComponent {
 }
 
 export { ACTION_COLUMN_MIN_WIDTH, AttachmentComponent, CELL_RULE_OPERATORS, CheckboxComponent, ChipListComponent, ColumnConstraintsService, CompositeComponent, CurrencyComponent, CustomVirtualScrollStrategy, DATA_TYPES, DATETIME_FORMATS, DATE_FORMATS, DateComponent, DatetimeComponent, DurationComponent, EXPLICITLY_OVERRIDDEN_FIELD_KEYS, EmailComponent, EruGridComponent, EruGridService, EruGridStore, GRID_COLOR_TOKENS, INHERITED_FIELD_KEYS, LocationComponent, MATERIAL_MODULES, MATERIAL_PROVIDERS, MONTH_SHORT_NAMES, NumberComponent, NumericInputDirective, PRESENTATION_DATATYPES, PRESET_CONFIG_DEFAULTS, PRESET_MANAGED_FIELDS, PeopleComponent, PhoneComponent, PriorityComponent, ProgressComponent, RatingComponent, SEEDED_FIELD_KEYS, SELF_COLOURED_DATATYPES, SelectComponent, StatusComponent, TagComponent, TextareaComponent, TextboxComponent, ThemeService, ThemeToggleComponent, WebsiteComponent, abbreviateNumber, abbreviationScaleFor, cellRuleBarPercent, cellRuleMatches, cellRuleToCss, cellStatAlias, cellTextStyleToCss, collectColumnStatRequests, columnCellRules, composeColorValue, effectiveValueDatatype, evaluateRowCondition, formatCellValue, formatDateTimeWithPattern, formatDateWithPattern, formatNumberValue, hasOwnCellRules, matchCellRule, matchColorRange, normalizeCellRender, normalizeDatatype, normalizeDateFormat, normalizeDateTimeFormat, parseCellDate, parseCellDateTime, parseColorValue, parseDateWithPattern, readRowValue, resolveColumnRules, resolveRowValue, resolveStatValue, rowSelectionKey, statusPillColors, tagPillColors, toDateOnlyString, toDateTimeString, toStatusOptionsField };
-export type { ActionClick, AggregationFunction, AttachmentConfig, BoardCardContext, CellFormatRule, CellRender, CellRuleOperator, CellStatRef, CellStatVerb, CellTemplateContext, CellTextStyle, CellValueChange, ChipListItem, ColorRangeBand, ColumnReorder, ColumnResize, ColumnStatRequest, ColumnWidthConstraints, CompositePart, CurrencyValidationResult, DataTypes, Drilldown, DurationValue, DynamicDataRequest, EmailValidationResult, ExcelDownloadPayload, ExcelDownloadRequest, ExcelPivotConfig, Field, GridAction, GridConfiguration, GridFeatures, GridMode, GridPreset, GridStyles, GridTokens, GroupItem$1 as GroupItem, LocationConfig, LocationValidationResult, NumberValidationResult, ParsedColorValue, PeopleOption, PersonCardContext, PivotColumnGroupState, PivotColumnHeader, PivotColumnKind, PivotConfiguration, PivotHeaderStructure, PivotMetadata, PivotResult, PivotRow, PivotRowKind, RatingConfig, Row, RowDataRequest, RowDataResponse, RowGrandTotal, RowGroup, ServerValidationNotice, StatusPillColors, TagPillColors, TextareaValidationResult, TextboxValidationResult, Theme, WebsiteValidationResult };
+export type { ActionClick, AggregationFunction, AttachmentConfig, BoardCardContext, CellFormatRule, CellRender, CellRuleOperator, CellStatRef, CellStatVerb, CellTemplateContext, CellTextStyle, CellValueChange, ChipListItem, ColorRangeBand, ColumnReorder, ColumnResize, ColumnStatRequest, ColumnWidthConstraints, CompositePart, CurrencyValidationResult, DataTypes, Drilldown, DurationValue, DynamicDataRequest, EmailValidationResult, ExcelDownloadPayload, ExcelDownloadRequest, ExcelPivotConfig, Field, GridAction, GridConfiguration, GridFeatures, GridMode, GridPreset, GridStyles, GridTokens, GroupItem$1 as GroupItem, LocationConfig, LocationValidationResult, NumberValidationResult, ParsedColorValue, PeopleOption, PersonCardContext, PivotColumnGroupState, PivotColumnHeader, PivotColumnKind, PivotConfiguration, PivotHeaderStructure, PivotMetadata, PivotResult, PivotRow, PivotRowKind, RatingConfig, RefreshRequest, Row, RowDataRequest, RowDataResponse, RowGrandTotal, RowGroup, ServerValidationNotice, StatusPillColors, TagPillColors, TextareaValidationResult, TextboxValidationResult, Theme, WebsiteValidationResult };