eru-grid 0.0.46 → 0.0.48

package/package.json

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

package/types/eru-grid.d.ts

@@ -45,7 +45,6 @@ interface GridFeatures {
     columnReorderable: boolean;
     cellSelection: boolean;
     rowSelection: boolean;
-    exportable: boolean;
     filtering: boolean;
     showColumnLines?: boolean;
     showRowLines?: boolean;
@@ -156,6 +155,17 @@ interface ExcelDownloadPayload {
             }];
         };
     }>;
+    pivot_config?: Record<string, ExcelPivotConfig>;
+}
+interface ExcelPivotConfig {
+    rows: string[];
+    columns: string[];
+    aggregations: {
+        aggregation_function: string;
+        field_name: string;
+    }[];
+    show_columns_totals: boolean;
+    show_rows_totals: boolean;
 }
 /**
  * Descriptor enqueued by the grid when the excel-download icon is clicked.
@@ -284,6 +294,7 @@ interface Field {
     enableDrilldown?: boolean;
     open_status?: any[];
     close_status?: any[];
+    status_view?: 'pill' | 'dot';
     color_ranges?: {
         from?: number | null;
         to?: number | null;
@@ -392,6 +403,33 @@ interface StatusPillColors {
  * look different depending on which control renders it.
  */
 declare function statusPillColors(color: string | null | undefined): StatusPillColors;
+/** The colours a tag pill is painted with. */
+interface TagPillColors {
+    background: string;
+    text: string;
+    dot: string;
+}
+/**
+ * The colours for a tag pill, from the single colour the data model gives it.
+ *
+ * A tag is deliberately not a status. Status owns the ringed pill — a tint fill
+ * inside a full-saturation border — because a record has exactly one status and
+ * it is the state the row is judged by. A tag field holds a list, so the same
+ * treatment repeated four times across one cell turns into four competing
+ * outlines. Tags instead get a tint fill with no border and a full-saturation
+ * dot ahead of the label: quieter than status at a glance, still carrying the
+ * palette colour at full strength in the dot so a pale entry stays identifiable.
+ *
+ * The fill is lightened 88% toward white and the text darkened 35% — slightly
+ * more contrast than the status pill, since with no border the fill alone has
+ * to describe the pill's edge.
+ *
+ * Lives here beside `statusPillColors` because eru-grid's tag cell and
+ * eru-studio's tag control paint the same values, and two copies of this
+ * arithmetic is two ways for one field to look different depending on which
+ * control renders it.
+ */
+declare function tagPillColors(color: string | null | undefined): TagPillColors;
 /** Short month names, for the `MMM` token. */
 declare const MONTH_SHORT_NAMES: string[];
 /**
@@ -1147,6 +1185,14 @@ declare class EruGridStore {
     setCellValueChange(change: CellValueChange): void;
     setGroups(groups: RowGroup[]): void;
     toggleGroupExpansion(groupId: string): void;
+    /**
+     * Merge server-computed subtotals into the groups already on screen, keyed by
+     * group id. Needed because the totals can arrive after the group list: the
+     * columns a grid aggregates are not always known when the group call goes
+     * out, so a later pass fills them in. Everything else about a group — its
+     * loaded rows, counts, expansion state — is left alone.
+     */
+    setGroupSubtotals(subtotals: Record<string, Record<string, number>>): void;
     updateGroupLoadingState(groupId: string, isLoading: boolean): void;
     updateGroupAfterLoading(groupId: string, loadedCount: number, fullyExhausted?: boolean): void;
     setRows(rows: Row[]): void;
@@ -1590,6 +1636,25 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     onExcelDownloadClick(event: Event): void;
     private buildExcelDownloadPayload;
+    /**
+     * The columns the `columns` block of the excel-download payload describes.
+     * Always the grid's own source columns — the same set table mode sends — even
+     * in pivot mode, where displayColumns() would hand back the generated
+     * cross-tab leaves (`<dimension value>|<measure>`, `_count_column_grand_total_*`)
+     * that mean nothing to the server. The pivot layout travels separately, in
+     * `pivot_config`.
+     */
+    private excelDownloadColumns;
+    /**
+     * The pivot half of the excel-download payload — the cross-tab layout the
+     * server rebuilds in the sheet. Null outside pivot mode, so the payload keeps
+     * the exact shape table/board mode has always sent.
+     *
+     * Dimensions and measures are emitted as their display labels (the same
+     * header_label the `columns` block carries) rather than field names, because
+     * that is what the sheet's own header row reads.
+     */
+    private buildExcelPivotConfig;
     /** Whether a board card is the active (last-clicked) one. Compared by row
      *  reference so it works for entity and query data alike. */
     isBoardCardActive(row: Row): boolean;
@@ -1636,7 +1701,10 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
     grandTotalPositionColumn: _angular_core.Signal<"before" | "after">;
     enableColumnGrandTotal: _angular_core.Signal<boolean>;
     enableColumnSubtotals: _angular_core.Signal<boolean>;
+    enableRowSubtotals: _angular_core.Signal<boolean>;
+    enableGrandTotal: _angular_core.Signal<boolean>;
     subtotalPositionColumn: _angular_core.Signal<"before" | "after">;
+    subtotalPosition: _angular_core.Signal<"before" | "after">;
     subtotalLabel: _angular_core.Signal<string>;
     /**
      * Check if a group has subtotal data
@@ -2902,6 +2970,12 @@ declare class StatusComponent implements OnInit {
         text: string;
         color: string;
     }>;
+    /**
+     * How the read-only cell paints the status: the labelled pill, or a colour dot
+     * that carries the label in its tooltip. Anything the column does not set
+     * reads as the pill, so existing grids are untouched.
+     */
+    statusView: _angular_core.Signal<"pill" | "dot">;
     constructor();
     ngOnInit(): void;
     onActivate(): void;
@@ -2991,10 +3065,7 @@ declare class TagComponent implements OnInit {
     onDrillableClick(event: Event): void;
     getProperty(property: string): any;
     removeTag(tag: string, event: Event): void;
-    getTagColor(tag: string): {
-        background: string;
-        color: string;
-    };
+    getTagColor(tag: string): TagPillColors;
     isTagSelected(tagValue: string): boolean;
     trackByValueAndIndex(index: number, option: {
         value: string;
@@ -3144,5 +3215,5 @@ declare class ThemeToggleComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThemeToggleComponent, "eru-theme-toggle", never, {}, {}, never, never, true, never>;
 }
 
-export { AttachmentComponent, CheckboxComponent, ColumnConstraintsService, CurrencyComponent, CustomVirtualScrollStrategy, DATA_TYPES, DATETIME_FORMATS, DATE_FORMATS, DateComponent, DatetimeComponent, DurationComponent, EmailComponent, EruGridComponent, EruGridService, EruGridStore, INHERITED_FIELD_KEYS, LocationComponent, MATERIAL_MODULES, MATERIAL_PROVIDERS, MONTH_SHORT_NAMES, NumberComponent, PRESET_CONFIG_DEFAULTS, PRESET_MANAGED_FIELDS, PeopleComponent, PhoneComponent, PriorityComponent, ProgressComponent, RatingComponent, SelectComponent, StatusComponent, TagComponent, TextareaComponent, TextboxComponent, ThemeService, ThemeToggleComponent, WebsiteComponent, evaluateRowCondition, formatDateWithPattern, matchColorRange, normalizeDatatype, normalizeDateFormat, normalizeDateTimeFormat, parseDateWithPattern, resolveRowValue, statusPillColors };
-export type { ActionClick, AggregationFunction, AttachmentConfig, BoardCardContext, CellValueChange, ColorRangeBand, ColumnReorder, ColumnResize, ColumnWidthConstraints, CurrencyValidationResult, DataTypes, Drilldown, DurationValue, DynamicDataRequest, EmailValidationResult, ExcelDownloadPayload, ExcelDownloadRequest, Field, GridAction, GridConfiguration, GridFeatures, GridMode, GridPreset, GridStyles, GridTokens, GroupItem$1 as GroupItem, LocationConfig, LocationValidationResult, NumberValidationResult, PeopleOption, PersonCardContext, PivotColumnGroupState, PivotColumnHeader, PivotColumnKind, PivotConfiguration, PivotHeaderStructure, PivotMetadata, PivotResult, PivotRow, PivotRowKind, RatingConfig, Row, RowDataRequest, RowDataResponse, RowGrandTotal, RowGroup, ServerValidationNotice, StatusPillColors, TextareaValidationResult, TextboxValidationResult, Theme, WebsiteValidationResult };
+export { AttachmentComponent, CheckboxComponent, ColumnConstraintsService, CurrencyComponent, CustomVirtualScrollStrategy, DATA_TYPES, DATETIME_FORMATS, DATE_FORMATS, DateComponent, DatetimeComponent, DurationComponent, EmailComponent, EruGridComponent, EruGridService, EruGridStore, INHERITED_FIELD_KEYS, LocationComponent, MATERIAL_MODULES, MATERIAL_PROVIDERS, MONTH_SHORT_NAMES, NumberComponent, PRESET_CONFIG_DEFAULTS, PRESET_MANAGED_FIELDS, PeopleComponent, PhoneComponent, PriorityComponent, ProgressComponent, RatingComponent, SelectComponent, StatusComponent, TagComponent, TextareaComponent, TextboxComponent, ThemeService, ThemeToggleComponent, WebsiteComponent, evaluateRowCondition, formatDateWithPattern, matchColorRange, normalizeDatatype, normalizeDateFormat, normalizeDateTimeFormat, parseDateWithPattern, resolveRowValue, statusPillColors, tagPillColors };
+export type { ActionClick, AggregationFunction, AttachmentConfig, BoardCardContext, CellValueChange, ColorRangeBand, ColumnReorder, ColumnResize, ColumnWidthConstraints, CurrencyValidationResult, DataTypes, Drilldown, DurationValue, DynamicDataRequest, EmailValidationResult, ExcelDownloadPayload, ExcelDownloadRequest, ExcelPivotConfig, Field, GridAction, GridConfiguration, GridFeatures, GridMode, GridPreset, GridStyles, GridTokens, GroupItem$1 as GroupItem, LocationConfig, LocationValidationResult, NumberValidationResult, PeopleOption, PersonCardContext, PivotColumnGroupState, PivotColumnHeader, PivotColumnKind, PivotConfiguration, PivotHeaderStructure, PivotMetadata, PivotResult, PivotRow, PivotRowKind, RatingConfig, Row, RowDataRequest, RowDataResponse, RowGrandTotal, RowGroup, ServerValidationNotice, StatusPillColors, TagPillColors, TextareaValidationResult, TextboxValidationResult, Theme, WebsiteValidationResult };