eru-grid 0.0.53 → 0.0.55

package/package.json

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

package/types/eru-grid.d.ts

@@ -382,6 +382,7 @@ interface Field {
     default_group?: boolean;
     mapped_entity?: string;
     mapped_field?: string;
+    label_overridden?: boolean;
     tool_tip?: string;
     description?: string;
     default?: any;
@@ -481,6 +482,18 @@ declare const SELF_COLOURED_DATATYPES: ReadonlySet<string>;
  */
 declare const ACTION_COLUMN_MIN_WIDTH = 56;
 declare const SEEDED_FIELD_KEYS: readonly string[];
+/**
+ * Keys the model seeds only until the design panel overrides them EXPLICITLY,
+ * tracked by a companion flag rather than by "does the column hold a value".
+ *
+ * `label` is the case that forced this: it is in SEEDED_FIELD_KEYS' spirit —
+ * the model's label is the default and a grid may shorten it — but a column
+ * never arrives without one, so the seeded test ("column already has a value,
+ * leave it alone") was true from the first render and the model's label never
+ * reached a mapped column. A query-derived column kept showing its raw result
+ * key as the heading.
+ */
+declare const EXPLICITLY_OVERRIDDEN_FIELD_KEYS: Readonly<Record<string, keyof Field>>;
 type DataTypes = 'number' | 'textbox' | 'textarea' | 'currency' | 'date' | 'datetime' | 'duration' | 'time' | 'dropdown_single_select' | 'dropdown_multi_select' | 'location' | 'email' | 'people' | 'checkbox' | 'phone' | 'priority' | 'status' | 'progress' | 'attachment' | 'tag' | 'rating' | 'website' | 'composite' | 'page';
 /** Resolve a data-model datatype to the canonical DataTypes value. */
 declare function normalizeDatatype(datatype: any): DataTypes;
@@ -1470,6 +1483,11 @@ declare class EruGridStore {
     private readonly _activeCell;
     private readonly _pivotConfiguration;
     private readonly _pivotResult;
+    /**
+     * Widths for generated pivot leaves that have no field to hold them.
+     * Keyed by leaf name — see updateColumnWidth.
+     */
+    private readonly _pivotLeafWidths;
     private readonly _drilldown;
     private readonly _actionClick;
     private readonly _columnResize;
@@ -1529,6 +1547,7 @@ declare class EruGridStore {
     readonly rowGrandTotal: _angular_core.Signal<RowGrandTotal | null>;
     readonly pivotConfiguration: _angular_core.Signal<PivotConfiguration | null>;
     readonly pivotResult: _angular_core.Signal<PivotResult | null>;
+    readonly pivotLeafWidths: _angular_core.Signal<Map<string, number>>;
     readonly drilldown: _angular_core.Signal<Drilldown | null>;
     readonly actionClick: _angular_core.Signal<ActionClick | null>;
     readonly columnResize: _angular_core.Signal<ColumnResize | null>;
@@ -1564,6 +1583,7 @@ declare class EruGridStore {
     readonly isEditingEnabled: _angular_core.Signal<boolean>;
     readonly displayColumns: _angular_core.Signal<Field[]>;
     readonly displayData: _angular_core.Signal<PivotRow[] | Row[]>;
+    private readonly frozenGrandTotalRow;
     readonly pivotGrandTotalData: _angular_core.Signal<PivotRow[]>;
     readonly pivotDisplayData: _angular_core.Signal<PivotRow[]>;
     readonly tableDisplayData: _angular_core.Signal<Row[]>;
@@ -1669,6 +1689,19 @@ declare class EruGridStore {
     setRows(rows: Row[]): void;
     addRows(newRows: Row[]): void;
     updateRow(rowId: string, updates: Partial<Row>): void;
+    /**
+     * Merge field values into the record with this id, wherever the grid is
+     * holding it — the flat row list AND the per-group buckets a board fills.
+     *
+     * For a consumer that edits a record somewhere else on the page and needs the
+     * grid to agree without refetching. `updateRow` is not enough on two counts:
+     * it only looks at `_rows`, so a grouped/board grid keeps the stale copy, and
+     * it replaces top-level row keys rather than merging into `entity_data`,
+     * where an entity-backed row keeps its fields.
+     *
+     * Unknown ids are ignored, so a caller can announce a change blindly.
+     */
+    patchRecord(entityId: string, fields: Record<string, any>): void;
     selectRow(rowId: string): void;
     /** Mark the single active board card (last clicked) for the selected-state highlight. */
     setActiveBoardRow(row: any): void;
@@ -2170,7 +2203,6 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
      *  reference so it works for entity and query data alike. */
     isBoardCardActive(row: Row): boolean;
     initialMinHeight: number;
-    initialTotalWidth: number;
     viewport: CdkVirtualScrollViewport;
     groupsViewport: CdkVirtualScrollViewport;
     groupsScrollContainerEl?: ElementRef;
@@ -2266,6 +2298,19 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
      * @param scrollIndex The current scroll index
      */
     onPivotScroll(scrollIndex: number): void;
+    /**
+     * The sum of the rendered column widths — what every table in the grid is
+     * forced to via `--table-total-width`.
+     *
+     * A signal, not a value captured at init. A resize writes the new width to
+     * the column (or, in pivot mode, to the measure the leaf came from), and the
+     * cells and `<col>`s follow it; a cached total does not, so the table stayed
+     * at its old width while its columns changed underneath — leaving the header
+     * and body tables wider or narrower than the columns they contain, and the
+     * horizontal scroll range wrong. Pivot mode also changes its leaf SET as the
+     * data changes, so even without a resize the total goes stale.
+     */
+    readonly totalTableWidth: _angular_core.Signal<number>;
     getTotalTableWidth(): number;
     getMinHeightPx(): number;
     adjustScrollWidth(): boolean;
@@ -2364,7 +2409,7 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
     isAggregationHeader(column: Field): boolean;
     trackByColumnFn(index: number, column: Field): string;
     trackByGroupItemFn(index: number, groupItem: GroupItem): string;
-    trackByPivotRowFn(index: number, pivotRow: PivotRow): string;
+    trackByPivotRowFn(index: number, pivotRow: PivotRow | undefined): string;
     trackByRowFn(index: number, row: any): string;
     trackByGroupFn(index: number, group: RowGroup): string;
     getRowsForGroup(groupId: string): Row[];
@@ -2466,6 +2511,11 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
      * including an explicit `false` on a checkbox — wins from then on. Without the
      * column in hand there is no way to tell "not set" from "set to the opposite",
      * so an override was overwritten on every resolve.
+     *
+     * EXPLICITLY_OVERRIDDEN_FIELD_KEYS work the same way but ask a companion flag
+     * instead, for keys a column always holds a value for — `label`, whose
+     * "already set" was true from the first render, so the model's label never
+     * won and a mapped column kept its raw result key as the heading.
      */
     private buildMappedColumnPatch;
     /** Get the field name used for grouping */
@@ -4012,5 +4062,5 @@ declare class ThemeToggleComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ThemeToggleComponent, "eru-theme-toggle", never, {}, {}, never, never, true, never>;
 }
 
-export { ACTION_COLUMN_MIN_WIDTH, AttachmentComponent, CELL_RULE_OPERATORS, CheckboxComponent, ChipListComponent, ColumnConstraintsService, CompositeComponent, CurrencyComponent, CustomVirtualScrollStrategy, DATA_TYPES, DATETIME_FORMATS, DATE_FORMATS, DateComponent, DatetimeComponent, DurationComponent, 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 };
+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 };
 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 };