eru-grid 0.0.39 → 0.0.41

package/package.json

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

package/types/eru-grid.d.ts

@@ -3,6 +3,7 @@ import * as _angular_core from '@angular/core';
 import { OnInit, AfterViewInit, OnDestroy, QueryList, ElementRef, TemplateRef, EventEmitter, ChangeDetectorRef, Provider } from '@angular/core';
 import { FixedSizeVirtualScrollStrategy, CdkVirtualScrollViewport } from '@angular/cdk/scrolling';
 import { MatDatepicker } from '@angular/material/datepicker';
+import { ConnectedPosition } from '@angular/cdk/overlay';
 
 interface Row {
     entity_id: string;
@@ -157,6 +158,22 @@ interface ExcelDownloadRequest extends ExcelDownloadPayload {
     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
+ * consumer, the same way it delegates data fetching — so this follows the
+ * enqueue/drain pattern of ExcelDownloadRequest: the consumer watches
+ * `EruGridStore.serverValidationNotices()`, shows its own snackbar (red when
+ * status is 'error'), and calls removeServerValidationNotice(id).
+ */
+interface ServerValidationNotice {
+    id: string;
+    timestamp: number;
+    rowId: string;
+    fieldName: string;
+    status: 'success' | 'error';
+    msg: string;
+}
 interface GridStyles {
     subTotalStyle?: 'bold' | 'italic' | 'highlighted';
     grandTotalStyle?: 'bold' | 'italic' | 'highlighted';
@@ -200,6 +217,7 @@ interface DynamicDataRequest {
     apiName?: string;
     apiField?: string;
     search?: string;
+    filter?: Record<string, any>;
 }
 interface Field {
     name: string;
@@ -207,8 +225,8 @@ interface Field {
     datatype: DataTypes;
     field_size: number;
     grid_index: number;
-    required?: boolean;
     mandatory?: boolean;
+    required?: boolean;
     minWidth?: number;
     maxWidth?: number;
     symbol?: string;
@@ -238,31 +256,166 @@ interface Field {
     open_status?: any[];
     close_status?: any[];
     color_ranges?: {
-        from: number;
-        to: number;
-        color: string;
+        from?: number | null;
+        to?: number | null;
+        color?: string | null;
     }[];
     data_length?: number;
     start_value?: number;
     end_value?: number;
+    is_perc?: boolean;
     emoji_value?: string;
     max_files?: number;
     allowed_file_types?: any[];
-    maxFileSize?: number;
+    max_file_size?: number;
     default_country?: string;
     date_format?: string;
     dateTimeFormat?: string;
     allow_days?: string[];
+    /**
+     * Dependent-dropdown mapping, for `option_type: 'ENTITY_DATA'`.
+     *
+     * Each pair links a field on the CURRENT record to the field it filters on in
+     * the option-source entity: `def` is the key in the current entity supplying
+     * the value, `dpef` is the key in the mapped entity to match it against.
+     * Several pairs mean the list is scoped by all of them.
+     *
+     * Replaces the earlier single `dpef` string, which could only express one
+     * dependency and conflated the two sides. A lone `dpef` is still read as
+     * `{ def: dpef, dpef: dpef }` for fields saved before this existed.
+     */
+    df_fields?: {
+        def: string;
+        dpef: string;
+    }[];
+    /** Legacy single dependency. Prefer `df_fields`. */
+    dpef?: string;
+    /** Legacy: key in the current entity paired with `dpef`. */
+    def?: string;
+    multiple?: boolean;
+    searchable?: boolean;
+    max_avatars?: number;
+    people_card?: string;
+    show_people_card?: 'none' | 'hover' | 'click';
+    value_true?: string;
+    value_false?: string;
     rich_text?: boolean;
     is_hyp?: boolean;
     hypl_nm?: string;
+    is_pii?: boolean;
+    is_ephi?: boolean;
+    to_encrypt?: boolean;
+    is_pf?: boolean;
+    is_unique?: boolean;
+    unq_sa?: boolean;
+    system_validate?: string;
+    ssv_api?: string;
+    can_group?: boolean;
+    default_group?: boolean;
+    mapped_entity?: string;
+    mapped_field?: string;
     tool_tip?: string;
     description?: string;
     default?: any;
     editable?: boolean | string;
     is_hidden?: boolean;
 }
-type DataTypes = 'number' | 'textbox' | 'currency' | 'date' | 'datetime' | 'duration' | 'dropdown_single_select' | 'dropdown_multi_select' | 'location' | 'email' | 'people' | 'checkbox' | 'phone' | 'priority' | 'status' | 'progress' | 'attachment' | 'tag' | 'rating' | 'website';
+/**
+ * Field attributes a mapped column inherits from the data model.
+ *
+ * Single source of truth for two things that must agree: what
+ * `buildMappedColumnPatch()` merges onto the column on every load, and what the
+ * column design panel renders read-only. If a key is inherited but not locked,
+ * a user's edit is silently discarded on reload; if it is locked but not
+ * inherited, the control is dead. Keep both behaviours driven from this list.
+ *
+ * The rule: anything the data model authors belongs here; anything that is a
+ * property of *this view* of the field does not. Deliberately excluded —
+ *   field_size, grid_index  layout, set by column resize/reorder
+ *   tool_tip                per-grid header help text
+ *   is_hidden               hiding a column in one grid should not require
+ *                           hiding the field in the data model
+ *   dateTimeFormat          legacy alias; the model writes `date_format`
+ */
+declare const INHERITED_FIELD_KEYS: readonly string[];
+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';
+/** Resolve a data-model datatype to the canonical DataTypes value. */
+declare function normalizeDatatype(datatype: any): DataTypes;
+/** Short month names, for the `MMM` token. */
+declare const MONTH_SHORT_NAMES: string[];
+/**
+ * The date formats offered to users, in every layer.
+ *
+ * One list so eru-studio, eru-grid and the processo data model present the same
+ * choices — previously studio offered eight, while the grid's panel and processo
+ * offered three, so a format could be picked on a page and had no equivalent on
+ * a field.
+ *
+ * Values are in token form: `dd` day, `MM` month number, `MMM` month name,
+ * `yyyy` year. Casing is significant — lowercase `mm` means minutes in a
+ * datetime — so values are normalised rather than lowercased on read.
+ */
+declare const DATE_FORMATS: {
+    value: string;
+    label: string;
+}[];
+/** The same orderings with a 24-hour time part, for datetime fields. */
+declare const DATETIME_FORMATS: {
+    value: string;
+    label: string;
+}[];
+/**
+ * Normalise a date format to token casing, so a value saved in any casing
+ * matches the canonical option. The data model uppercases on save
+ * (`DD-MMM-YYYY`) and older UIs stored lowercase.
+ *
+ * `mmm` is handled before `mm`, or the longer token would be half-consumed and
+ * `dd-mmm-yyyy` would come out as `dd-MMm-yyyy`.
+ */
+declare function normalizeDateFormat(format: string | null | undefined): string;
+/**
+ * Normalise a datetime format. Only the date half is token-cased — `mm` in the
+ * time half is minutes and must stay lowercase, which is why this cannot just
+ * reuse normalizeDateFormat over the whole string. The date half is everything
+ * before the time, located by the `hh` token rather than by whitespace, since a
+ * date pattern may itself contain a space (`dd MMM yyyy`).
+ */
+declare function normalizeDateTimeFormat(format: string | null | undefined): string;
+/**
+ * Render a date with a token pattern (`dd`, `MM`, `MMM`, `yyyy`).
+ *
+ * Shared by both libraries so a date reads identically on a page and in a grid.
+ * The alternation lists longer tokens first, so `MMM` is matched before `MM`
+ * and `yyyy` is never partly consumed — the bug that a chain of string
+ * replacements invites.
+ */
+declare function formatDateWithPattern(date: Date | null, pattern: string): string;
+/**
+ * Parse text written in a token pattern back to a Date, or null.
+ *
+ * Built as a regex from the pattern rather than by splitting on a separator:
+ * a month name is not numeric, and patterns may use a space or a comma, so
+ * splitting cannot recover the field order on its own.
+ */
+declare function parseDateWithPattern(text: string, pattern: string): Date | null;
+/** One value band and the colours it paints. Either bound may be open-ended. */
+interface ColorRangeBand {
+    from?: number | null;
+    to?: number | null;
+    color?: string | null;
+    background?: string | null;
+}
+/**
+ * Resolve a numeric value against a column's `color_ranges`, returning the
+ * first matching band or null.
+ *
+ * Shared by the progress, number and currency cells so a value falling in the
+ * same band paints the same way whichever datatype renders it. A blank or
+ * absent bound is open-ended — data-model bands are authored that way ("80 and
+ * above"), and coercing a missing bound to 0 would stop such a band matching.
+ * Bands are checked in order, so the author controls precedence.
+ */
+declare function matchColorRange(value: any, ranges: any): ColorRangeBand | null;
 declare const DATA_TYPES: DataTypes[];
 type AggregationFunction = 'sum' | 'count' | 'avg' | 'min' | 'max';
 interface PivotColumnGroupState {
@@ -380,6 +533,25 @@ interface CellValueChange {
  *   </ng-template>
  *   <eru-grid [boardCardTemplate]="myCard" [gridConfig]="cfg"></eru-grid>
  */
+/**
+ * Template context injected into a personCardTemplate on EruGridComponent.
+ *
+ * eru-studio renders a whole studio page as the person card. eru-grid cannot do
+ * that — it has no page renderer, and the dependency runs studio -> grid — so it
+ * follows the same pattern as boardCardTemplate: the grid owns the trigger,
+ * positioning and dismissal, and the consumer supplies the content.
+ *
+ *   <ng-template #personCard let-userId let-column="column">…</ng-template>
+ *   <eru-grid [personCardTemplate]="personCard" [gridConfig]="cfg"></eru-grid>
+ */
+interface PersonCardContext {
+    /** The selected person's id ($implicit — bind with let-userId) */
+    $implicit: string;
+    /** The people column this avatar belongs to */
+    column: Field | null;
+    /** Page the field names as the card, from the data model's people_card */
+    cardPage?: string;
+}
 interface BoardCardContext {
     /** Row data for this card ($implicit — bind with let-row) */
     $implicit: Row;
@@ -687,6 +859,10 @@ declare class EruGridStore {
     private readonly _dataRequest;
     private readonly _requestQueue;
     private readonly _excelDownloadRequest;
+    private readonly _serverValidationNotices;
+    readonly serverValidationNotices: _angular_core.Signal<ServerValidationNotice[]>;
+    setServerValidationNotice(notice: Omit<ServerValidationNotice, 'id' | 'timestamp'>): void;
+    removeServerValidationNotice(id: string): void;
     private readonly _selectedDesignColumn;
     readonly selectedDesignColumn: _angular_core.Signal<string | null>;
     private readonly _columnDesignUpdate;
@@ -1118,6 +1294,13 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
      *   <eru-grid [boardCardTemplate]="myCard" [gridConfig]="cfg"></eru-grid>
      */
     boardCardTemplate?: TemplateRef<BoardCardContext>;
+    /**
+     * Content for a people cell's person card. The grid owns the trigger,
+     * placement and dismissal; the consumer renders the content, because the card
+     * is an eru-studio page and only the consumer can render one. Omit it and the
+     * card trigger stays inert.
+     */
+    personCardTemplate?: TemplateRef<PersonCardContext>;
     /**
      * Height in pixels of each board card slot.
      * Must match the fixed height of the card rendered by boardCardTemplate (or the default card).
@@ -1510,7 +1693,7 @@ declare class EruGridComponent implements OnInit, AfterViewInit, OnDestroy {
     requestBoardRowsForGroup(group: RowGroup): void;
     loadBoardAll(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EruGridComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EruGridComponent, "eru-grid", never, { "gridConfig": { "alias": "gridConfig"; "required": false; }; "boardCardTemplate": { "alias": "boardCardTemplate"; "required": false; }; "boardCardHeight": { "alias": "boardCardHeight"; "required": false; }; "boardCardGap": { "alias": "boardCardGap"; "required": false; }; "boardCardPadding": { "alias": "boardCardPadding"; "required": false; }; }, { "rowSelect": "rowSelect"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EruGridComponent, "eru-grid", never, { "gridConfig": { "alias": "gridConfig"; "required": false; }; "boardCardTemplate": { "alias": "boardCardTemplate"; "required": false; }; "personCardTemplate": { "alias": "personCardTemplate"; "required": false; }; "boardCardHeight": { "alias": "boardCardHeight"; "required": false; }; "boardCardGap": { "alias": "boardCardGap"; "required": false; }; "boardCardPadding": { "alias": "boardCardPadding"; "required": false; }; }, { "rowSelect": "rowSelect"; }, never, never, true, never>;
 }
 interface GroupItem {
     type: 'header' | 'row' | 'table-header' | 'row-place-holder' | 'ghost-loading';
@@ -1549,6 +1732,15 @@ declare class AttachmentComponent implements OnInit {
     fileDeleted: EventEmitter<string>;
     fileViewed: EventEmitter<string>;
     currentValue: _angular_core.WritableSignal<string[]>;
+    /**
+     * Why the last attempted file was refused, or '' when none.
+     *
+     * The checks were already here but only reached console.warn, so a user
+     * dropping an oversized file saw nothing happen at all. Shown in the panel,
+     * matching how eru-studio's attachment reports a rejection.
+     */
+    rejectionMessage: _angular_core.WritableSignal<string>;
+    private rejectFile;
     isOverlayOpen: _angular_core.WritableSignal<boolean>;
     isDragging: _angular_core.WritableSignal<boolean>;
     fileInput: ElementRef<HTMLInputElement>;
@@ -1581,25 +1773,38 @@ declare class AttachmentComponent implements OnInit {
 }
 
 declare class CheckboxComponent {
-    value: _angular_core.InputSignal<boolean>;
+    value: _angular_core.InputSignal<any>;
+    /** Column config; supplies value_true / value_false when the field uses literals. */
+    config: _angular_core.InputSignal<Field | null>;
     isEditable: _angular_core.InputSignal<boolean>;
     isActive: _angular_core.InputSignal<boolean>;
     isDrillable: _angular_core.InputSignal<boolean>;
     label: _angular_core.InputSignal<string>;
-    valueChange: EventEmitter<boolean>;
-    change: EventEmitter<boolean>;
-    blur: EventEmitter<boolean>;
+    valueChange: EventEmitter<any>;
+    change: EventEmitter<any>;
+    blur: EventEmitter<any>;
     focus: EventEmitter<void>;
-    drilldownClick: EventEmitter<boolean>;
+    drilldownClick: EventEmitter<any>;
     editModeChange: EventEmitter<boolean>;
     currentValue: _angular_core.WritableSignal<boolean>;
     constructor();
+    private toBool;
+    private literals;
+    /**
+     * Stored representation -> checked state. When the field configures
+     * value_true / value_false the backend may hold arbitrary literals ('Y'/'N',
+     * 'Yes'/'No'); left blank, both fall through to the generic coercion. Ported
+     * from the eru-studio checkbox so the two agree on what a stored value means.
+     */
+    private resolveCheckboxState;
+    /** Inverse: checked state -> the representation to store. */
+    private checkboxValueFor;
     onValueChange(event: boolean): void;
     onActivate(): void;
     onBlur(): void;
     onDrillableClick(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "eru-checkbox", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "change": "change"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "editModeChange": "editModeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "eru-checkbox", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "change": "change"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "editModeChange": "editModeChange"; }, never, never, true, never>;
 }
 
 interface CurrencyValidationResult {
@@ -1615,6 +1820,12 @@ declare class CurrencyComponent {
     isDrillable: _angular_core.InputSignal<boolean>;
     replaceZeroValue: _angular_core.InputSignal<string | undefined>;
     placeholder: _angular_core.InputSignal<string>;
+    /**
+     * The row this cell belongs to. Needed for `symbol_field`, which names another
+     * field on the SAME record supplying the currency symbol — so a multi-currency
+     * column renders each row with its own symbol instead of one column-wide one.
+     */
+    row: _angular_core.InputSignal<any>;
     valueChange: EventEmitter<string | number | null>;
     blur: EventEmitter<string | number | null>;
     focus: EventEmitter<void>;
@@ -1623,6 +1834,20 @@ declare class CurrencyComponent {
     editModeChange: EventEmitter<boolean>;
     currentValue: _angular_core.WritableSignal<string | number | null>;
     error: _angular_core.WritableSignal<string>;
+    /**
+     * Colours from the column's configured value ranges, applied over the cell's
+     * normal appearance. View mode only — tinting an active input reads as a
+     * validation state rather than a value. Null when no band matches, matching
+     * the eru-studio currency component so a value paints the same on a page and here.
+     */
+    /**
+     * Symbol to show. `symbol_field` wins when set — read from this row, so each
+     * record can carry its own currency — otherwise the column's static `symbol`.
+     * Rows may nest their values under entity_data.
+     */
+    resolvedSymbol: _angular_core.Signal<string>;
+    rangeColor: _angular_core.Signal<string | null>;
+    rangeBackground: _angular_core.Signal<string | null>;
     constructor();
     formatNumberSignal: _angular_core.Signal<string | undefined>;
     onActivate(): void;
@@ -1632,7 +1857,7 @@ declare class CurrencyComponent {
     private validateField;
     private focusAndPositionCursor;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CurrencyComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CurrencyComponent, "eru-currency", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "replaceZeroValue": { "alias": "replaceZeroValue"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "validationError": "validationError"; "editModeChange": "editModeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CurrencyComponent, "eru-currency", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "replaceZeroValue": { "alias": "replaceZeroValue"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "row": { "alias": "row"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "validationError": "validationError"; "editModeChange": "editModeChange"; }, never, never, true, never>;
 }
 
 declare class DateComponent {
@@ -1644,7 +1869,7 @@ declare class DateComponent {
     isActive: _angular_core.InputSignal<boolean>;
     isDrillable: _angular_core.InputSignal<boolean>;
     placeholder: _angular_core.InputSignal<string>;
-    readonly dateFormat: _angular_core.Signal<any>;
+    readonly dateFormat: _angular_core.Signal<string>;
     readonly allowDays: _angular_core.Signal<string[]>;
     readonly dayFilter: _angular_core.Signal<(d: Date | null) => boolean>;
     valueChange: EventEmitter<string | null>;
@@ -1653,10 +1878,22 @@ declare class DateComponent {
     editModeChange: EventEmitter<boolean>;
     currentValue: _angular_core.WritableSignal<Date | null>;
     private shouldOpenPicker;
+    /**
+     * The column's configured default, resolved to a real date.
+     *
+     * The data model expresses it as a rule rather than a fixed value: the
+     * `Current_Date` sentinel in `default`, optionally shifted by
+     * `default_value_offset_days` (negative goes back). Resolving it here means a
+     * cell with no stored value shows what the field defines, matching eru-studio
+     * — previously the grid ignored both and showed an empty cell.
+     */
+    private resolveDefaultDate;
     constructor();
     onActivate(): void;
     onDateChange(date: Date | null): void;
     onDrillableClick(event: Event): void;
+    /** Render a date in the column's configured format, via the shared token
+     *  formatter so a page and a grid read identically. */
     formatDate(date: Date | null): string;
     parseDateString(dateString: string): Date | null;
     getDisplayValue(): string;
@@ -1876,6 +2113,14 @@ declare class NumberComponent {
     editModeChange: EventEmitter<boolean>;
     currentValue: _angular_core.WritableSignal<string | number | null>;
     error: _angular_core.WritableSignal<string>;
+    /**
+     * Colours from the column's configured value ranges, applied over the cell's
+     * normal appearance. View mode only — tinting an active input reads as a
+     * validation state rather than a value. Null when no band matches, matching
+     * the eru-studio number component so a value paints the same on a page and here.
+     */
+    rangeColor: _angular_core.Signal<string | null>;
+    rangeBackground: _angular_core.Signal<string | null>;
     constructor();
     formatNumberSignal: _angular_core.Signal<string | undefined>;
     onActivate(): void;
@@ -1904,11 +2149,47 @@ declare class PeopleComponent implements OnInit {
     isDrillable: _angular_core.InputSignal<boolean>;
     columnWidth: _angular_core.InputSignal<number>;
     eruGridStore: _angular_core.InputSignal<EruGridStore | null>;
+    /**
+     * Content for the person card, supplied by the consumer. The grid owns the
+     * trigger, positioning and dismissal; only the consumer can render a page,
+     * which is what eru-studio's card is. Without a template the trigger is inert.
+     */
+    personCardTemplate: _angular_core.InputSignal<TemplateRef<PersonCardContext> | null | undefined>;
     valueChange: EventEmitter<string[] | null>;
     blur: EventEmitter<string[] | null>;
     focus: EventEmitter<void>;
     drilldownClick: EventEmitter<string[] | null>;
     editModeChange: EventEmitter<boolean>;
+    /**
+     * Whether more than one person may be picked. From the column config, so a
+     * field declared single-select in the data model is enforced here too. The
+     * stored value stays a list either way — the flag only limits how many may be
+     * chosen, so no consumer has to handle a shape change.
+     */
+    isMultiple: _angular_core.Signal<boolean>;
+    /** Show the filter box inside the dropdown. Configurable, as in eru-studio. */
+    isSearchable: _angular_core.Signal<boolean>;
+    /** mat-select holds a list when multiple, a single id otherwise. */
+    selectValue: _angular_core.Signal<any>;
+    /** Page the field names as the card. Blank means no card. */
+    cardPage: _angular_core.Signal<string>;
+    /** 'none' | 'hover' | 'click' — 'none' whenever no card page is mapped. */
+    cardTrigger: _angular_core.Signal<"none" | "hover" | "click">;
+    /** The card is a view-mode affordance, and needs content to show. */
+    cardEnabled: _angular_core.Signal<boolean>;
+    /** Beside the avatar first (right, then left), dropping below only when
+     *  neither side fits. Offsets stay small: on hover the cursor has to cross the
+     *  gap to reach the card, and a wide one makes that a miss. */
+    readonly cardPositions: ConnectedPosition[];
+    /** Person whose card is open, or null. */
+    openCardUserId: _angular_core.WritableSignal<string | null>;
+    private static readonly CARD_CLOSE_DELAY_MS;
+    private closeCardTimer;
+    onAvatarEnter(userId: string): void;
+    onAvatarLeave(): void;
+    onAvatarCardClick(event: Event, userId: string): void;
+    closeCard(): void;
+    private cancelPendingClose;
     currentValue: _angular_core.WritableSignal<string[]>;
     searchText: _angular_core.WritableSignal<string>;
     selectContainer: ElementRef<HTMLElement>;
@@ -1925,6 +2206,13 @@ declare class PeopleComponent implements OnInit {
     onActivate(): void;
     onBlur(event: Event): void;
     onValueChange(value: string[]): void;
+    /**
+     * mat-select emits a list when multiple and a bare id otherwise. The stored
+     * value is a list in both cases, so a single selection is re-wrapped here —
+     * that way turning cardinality off never changes the value's shape for
+     * consumers or for the data model.
+     */
+    onSelectionChange(value: any): void;
     onSearchChange(searchValue: string): void;
     onDrillableClick(event: Event): void;
     onOpenedChange(opened: boolean): void;
@@ -1935,7 +2223,7 @@ declare class PeopleComponent implements OnInit {
     selectedMultiSelect(value: string[]): void;
     trackByValueAndIndex(index: number, option: any): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PeopleComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PeopleComponent, "eru-people", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "columnWidth": { "alias": "columnWidth"; "required": false; "isSignal": true; }; "eruGridStore": { "alias": "eruGridStore"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "editModeChange": "editModeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PeopleComponent, "eru-people", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "columnWidth": { "alias": "columnWidth"; "required": false; "isSignal": true; }; "eruGridStore": { "alias": "eruGridStore"; "required": false; "isSignal": true; }; "personCardTemplate": { "alias": "personCardTemplate"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "editModeChange": "editModeChange"; }, never, never, true, never>;
 }
 
 interface CountryCode {
@@ -2075,6 +2363,14 @@ declare class ProgressComponent implements OnInit {
     currentValue: _angular_core.WritableSignal<number>;
     displayValue: _angular_core.Signal<number>;
     barColor: _angular_core.Signal<string | null>;
+    /**
+     * Whether to show the value as a percentage. `is_perc` is the data model's
+     * flag; it only reads as a percentage on a 0-100 scale, so a column with a
+     * custom scale shows the raw value against its bound instead.
+     */
+    showPercent: _angular_core.Signal<boolean>;
+    /** Label beside the bar: "45%" on a percentage scale, "3 / 5" otherwise. */
+    valueLabel: _angular_core.Signal<string>;
     constructor();
     ngOnInit(): void;
     onActivate(): void;
@@ -2121,6 +2417,12 @@ declare class SelectComponent implements OnInit, AfterViewInit {
     fieldSize: _angular_core.InputSignal<number>;
     multiple: _angular_core.InputSignal<boolean>;
     eruGridStore: _angular_core.InputSignal<EruGridStore | null>;
+    /**
+     * The row this cell belongs to. Needed for a dependent dropdown: `dpef` names
+     * another field on the SAME record whose value scopes this list, so the list
+     * differs per row and cannot be resolved from the column config alone.
+     */
+    row: _angular_core.InputSignal<any>;
     valueChange: EventEmitter<any>;
     blur: EventEmitter<any>;
     focus: EventEmitter<void>;
@@ -2142,6 +2444,34 @@ declare class SelectComponent implements OnInit, AfterViewInit {
     onBlur(event: Event): void;
     onValueChange(value: any | any[] | null): void;
     toggleSelectAll(checked: boolean): void;
+    /**
+     * Dependency pairs for a cascading dropdown, normalised.
+     *
+     * `def` names the field on THIS ROW supplying a value; `dpef` names the field
+     * in the option-source entity to match it against. A column saved before
+     * `df_fields` existed carries a single `dpef`, read as `{ def: dpef, dpef }`.
+     */
+    dependencyPairs: _angular_core.Signal<{
+        def: string;
+        dpef: string;
+    }[]>;
+    /** Legacy single-dependency value from this row, for API sources. */
+    private legacyDpefValue;
+    /** True when this column's options are scoped by another field on the row. */
+    isDependent: _angular_core.Signal<boolean>;
+    /**
+     * Filter sent with the options request: keys are fields in the option-source
+     * entity, values read from this row. A pair whose source value is absent is
+     * omitted rather than sent blank, since filtering on a blank would narrow the
+     * list to nothing.
+     */
+    dependencyFilter: _angular_core.Signal<Record<string, any>>;
+    /**
+     * Map key the option list is cached under. Must be identical at request time
+     * and at lookup time, or the response is written under one key and read from
+     * another — so both go through this.
+     */
+    optionsCacheKey: _angular_core.Signal<string>;
     onSearchChange(searchValue: string): void;
     onOpenedChange(opened: boolean): void;
     ngAfterViewInit(): void;
@@ -2162,7 +2492,7 @@ declare class SelectComponent implements OnInit, AfterViewInit {
      */
     private firstPrimitiveValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "eru-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "columnWidth": { "alias": "columnWidth"; "required": false; "isSignal": true; }; "fieldSize": { "alias": "fieldSize"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "eruGridStore": { "alias": "eruGridStore"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "editModeChange": "editModeChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SelectComponent, "eru-select", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "config": { "alias": "config"; "required": false; "isSignal": true; }; "isEditable": { "alias": "isEditable"; "required": false; "isSignal": true; }; "isActive": { "alias": "isActive"; "required": false; "isSignal": true; }; "isDrillable": { "alias": "isDrillable"; "required": false; "isSignal": true; }; "columnWidth": { "alias": "columnWidth"; "required": false; "isSignal": true; }; "fieldSize": { "alias": "fieldSize"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "eruGridStore": { "alias": "eruGridStore"; "required": false; "isSignal": true; }; "row": { "alias": "row"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "blur": "blur"; "focus": "focus"; "drilldownClick": "drilldownClick"; "editModeChange": "editModeChange"; }, never, never, true, never>;
 }
 
 declare class StatusComponent implements OnInit {
@@ -2449,5 +2779,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, DateComponent, DatetimeComponent, DurationComponent, EmailComponent, EruGridComponent, EruGridService, EruGridStore, LocationComponent, MATERIAL_MODULES, MATERIAL_PROVIDERS, NumberComponent, PRESET_CONFIG_DEFAULTS, PRESET_MANAGED_FIELDS, PeopleComponent, PhoneComponent, PriorityComponent, ProgressComponent, RatingComponent, SelectComponent, StatusComponent, TagComponent, TextareaComponent, TextboxComponent, ThemeService, ThemeToggleComponent, WebsiteComponent };
-export type { ActionClick, AggregationFunction, AttachmentConfig, BoardCardContext, CellValueChange, ColumnReorder, ColumnResize, ColumnWidthConstraints, CurrencyValidationResult, DataTypes, Drilldown, DurationValue, DynamicDataRequest, EmailValidationResult, ExcelDownloadPayload, ExcelDownloadRequest, Field, GridConfiguration, GridFeatures, GridMode, GridPreset, GridStyles, GridTokens, GroupItem$1 as GroupItem, LocationConfig, LocationValidationResult, NumberValidationResult, PeopleOption, PivotColumnGroupState, PivotColumnHeader, PivotConfiguration, PivotHeaderStructure, PivotMetadata, PivotResult, PivotRow, RatingConfig, Row, RowDataRequest, RowDataResponse, RowGrandTotal, RowGroup, 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, formatDateWithPattern, matchColorRange, normalizeDatatype, normalizeDateFormat, normalizeDateTimeFormat, parseDateWithPattern };
+export type { ActionClick, AggregationFunction, AttachmentConfig, BoardCardContext, CellValueChange, ColorRangeBand, ColumnReorder, ColumnResize, ColumnWidthConstraints, CurrencyValidationResult, DataTypes, Drilldown, DurationValue, DynamicDataRequest, EmailValidationResult, ExcelDownloadPayload, ExcelDownloadRequest, Field, GridConfiguration, GridFeatures, GridMode, GridPreset, GridStyles, GridTokens, GroupItem$1 as GroupItem, LocationConfig, LocationValidationResult, NumberValidationResult, PeopleOption, PersonCardContext, PivotColumnGroupState, PivotColumnHeader, PivotConfiguration, PivotHeaderStructure, PivotMetadata, PivotResult, PivotRow, RatingConfig, Row, RowDataRequest, RowDataResponse, RowGrandTotal, RowGroup, ServerValidationNotice, TextareaValidationResult, TextboxValidationResult, Theme, WebsiteValidationResult };