@guiexpert/table 1.1.94 → 1.1.97

package/lib/table/calc/value-getter-context.if.d.ts

@@ -0,0 +1,35 @@
+import { AggregatorRef } from '../aggregation/aggregator-name.type.js';
+
+/**
+ * The second parameter of a {@link ValueGetter}: access to other columns of the same table – also calculated ones –
+ * and to column aggregates over the (filtered) rows. Formulas ({@link compileFormula}) use it for `[total]` and
+ * `SUM([total])`.
+ *
+ * @example
+ * ColumnDef.create({
+ *   property: "share", headerLabel: "Share",
+ *   valueGetter: (row: Item, ctx: ValueGetterContextIf) =>
+ *     Number(ctx.getValue(row, "total")) / Number(ctx.aggregate("total", "sum"))
+ * });
+ *
+ * @since 1.1.95
+ * @category Calculated columns & formulas
+ */
+export interface ValueGetterContextIf {
+    /** The property of the column that is computed. */
+    readonly property: string;
+    /**
+     * The value of another column of the row: its `valueGetter` (with protection against circular references –
+     * a cycle returns a `#CIRC!` {@link FormulaError}) or the property path.
+     */
+    getValue(row: any, property: string): unknown;
+    /** True if a column of the table shows this property. */
+    hasColumn(property: string): boolean;
+    /** True if that column is calculated (`valueGetter` or `formula`). */
+    isCalculated(property: string): boolean;
+    /**
+     * An aggregate of a column over the filtered rows of the body (cached until the data, filter or sorting changes),
+     * e.g. `aggregate("total", "sum")`. Values that are no numbers are skipped (see {@link Aggregators}).
+     */
+    aggregate(property: string, aggregator: AggregatorRef): unknown;
+}

package/lib/table/calc/value-getter.type.d.ts

@@ -0,0 +1,36 @@
+import { ValueGetterContextIf } from './value-getter-context.if.js';
+
+/**
+ * Computes the value of a calculated column from the row (`ColumnDefIf.valueGetter`). The row is the data object
+ * (in a tree the `TreeRow.data`). The data is not changed – sorting, filter (`tableApi.getRowValue`), copy, Excel and
+ * totals use the computed value.
+ *
+ * Keep it fast and free of side effects: it runs for every visible cell on each render (values are not cached) and
+ * once per row for sorting and totals.
+ *
+ * @example
+ * const total: ValueGetter<Item> = row => row.price * row.quantity;
+ * ColumnDef.create({ property: "total", headerLabel: "Total", valueGetter: total });
+ *
+ * @typeParam T - the row type
+ * @since 1.1.95
+ * @category Calculated columns & formulas
+ */
+export type ValueGetter<T = any> = (row: T, context: ValueGetterContextIf) => unknown;
+/**
+ * Writes an edited value of a calculated column back into the row (`ColumnDefIf.valueSetter`). Without a setter a
+ * calculated column cannot be edited. Return `false` to reject the value.
+ *
+ * @example
+ * // "total" is price × quantity – editing the total changes the price
+ * const setTotal: ValueSetter<Item> = (row, value) => {
+ *   const total = Number(value);
+ *   if (!Number.isFinite(total) || !row.quantity) return false;
+ *   row.price = total / row.quantity;
+ * };
+ *
+ * @typeParam T - the row type
+ * @since 1.1.95
+ * @category Calculated columns & formulas
+ */
+export type ValueSetter<T = any> = (row: T, value: unknown) => boolean | void;

package/lib/table/data/common/event/ge-batch-edit-event.d.ts

@@ -0,0 +1,46 @@
+import { CellChangeIf } from '../../../batch-edit/cell-change.if.js';
+
+/**
+ * What happened in a batch edit: `"start"` ({@link TableApi.startBatchEdit}), `"change"` (values were marked or a
+ * value was set back), `"commit"` (written), `"cancel"` (discarded).
+ *
+ * @category Fill handle & batch edit
+ * @since 1.1.96
+ */
+export type GeBatchEditEventType = "start" | "change" | "commit" | "cancel";
+/**
+ * Reported by {@link EventListenerIf.onBatchEditChanged}: the pending changes of a batch edit changed – e.g. to enable
+ * a "Save" button.
+ *
+ * @example
+ * const listener = new EventAdapter();
+ * listener.onBatchEditChanged = (evt: GeBatchEditEvent) => {
+ *   saveButton.disabled = evt.pendingCount === 0 || evt.invalidCount > 0;
+ *   discardButton.disabled = evt.pendingCount === 0;
+ * };
+ *
+ * @category Fill handle & batch edit
+ * @since 1.1.96
+ */
+export declare class GeBatchEditEvent {
+    /** What happened. */
+    readonly type: GeBatchEditEventType;
+    /** The cells of this step (`"commit"`: the written cells, `"cancel"`: the discarded ones). */
+    readonly changes: CellChangeIf[];
+    /** The number of pending cells after this step. */
+    readonly pendingCount: number;
+    /** The number of pending cells with an invalid value. */
+    readonly invalidCount: number;
+    private readonly pendingProvider;
+    constructor(
+    /** What happened. */
+    type: GeBatchEditEventType, 
+    /** The cells of this step (`"commit"`: the written cells, `"cancel"`: the discarded ones). */
+    changes: CellChangeIf[], 
+    /** The number of pending cells after this step. */
+    pendingCount: number, 
+    /** The number of pending cells with an invalid value. */
+    invalidCount: number, pendingProvider?: () => CellChangeIf[]);
+    /** All pending changes after this step (computed when read – it scans the shown rows once). */
+    get pendingChanges(): CellChangeIf[];
+}

package/lib/table/data/common/event/ge-detail-event.d.ts

@@ -0,0 +1,40 @@
+/**
+ * What opened or closed a detail row: a click on the icon (`"mouse"`), Enter (`"keyboard"`), the {@link TableApi}
+ * (`"api"`) or a restored table state (`"state"`).
+ *
+ * @category Master/detail
+ * @since 1.1.97
+ */
+export type GeDetailEventSource = "mouse" | "keyboard" | "api" | "state";
+/**
+ * Reported by {@link EventListenerIf.onDetailExpandedChanged}: a detail row was expanded or collapsed (master/detail,
+ * {@link MasterDetailOptionsIf}).
+ *
+ * @example
+ * const listener = new EventAdapter();
+ * listener.onDetailExpandedChanged = (evt: GeDetailEvent) => {
+ *   console.log(`order ${evt.row.id} ${evt.expanded ? "opened" : "closed"} (${evt.source})`);
+ * };
+ *
+ * @category Master/detail
+ * @since 1.1.97
+ */
+export declare class GeDetailEvent<T = any> {
+    /** The master row. */
+    readonly row: T;
+    /** Its display index (`-1` if it is not shown, e.g. filtered out). */
+    readonly rowIndex: number;
+    /** `true` = expanded, `false` = collapsed. */
+    readonly expanded: boolean;
+    /** What changed it. */
+    readonly source: GeDetailEventSource;
+    constructor(
+    /** The master row. */
+    row: T, 
+    /** Its display index (`-1` if it is not shown, e.g. filtered out). */
+    rowIndex: number, 
+    /** `true` = expanded, `false` = collapsed. */
+    expanded: boolean, 
+    /** What changed it. */
+    source: GeDetailEventSource);
+}

package/lib/table/data/common/event/ge-model-change-event.d.ts

@@ -1,9 +1,13 @@
 import { GeCellIndices } from './ge-cell-indices.js';
+import { CellChangeIf, CellChangeSource } from '../../../batch-edit/cell-change.if.js';
 
 /**
  * Reported by {@link EventListenerIf.onModelChanged} after cells were edited: the row and column indices
  * of the changed cells. The new values are already written into the area model.
  *
+ * Since 1.1.96 the event comes **once per change** – an edit, a fill (fill handle, Ctrl/⌘+D), a commit of a batch
+ * edit or {@link TableApi.applyCellChanges} – with all cells, and {@link changes} tells old and new values.
+ *
  * @example
  * override onModelChanged(evt: GeModelChangeEvent): void {
  *   for (const { rowIndex } of evt.cells) {
@@ -19,6 +23,28 @@ import { GeCellIndices } from './ge-cell-indices.js';
  */
 export declare class GeModelChangeEvent {
     cells: GeCellIndices[];
-    constructor(cells: GeCellIndices[]);
+    /**
+     * The changed cells with row object, property, old and new value (since 1.1.96; `undefined` for events created by
+     * own code with the old constructor).
+     */
+    changes?: CellChangeIf<any>[] | undefined;
+    /** What changed the cells: `"edit"`, `"fill"`, `"commit"` or `"api"` (since 1.1.96). */
+    source?: CellChangeSource | undefined;
+    constructor(cells: GeCellIndices[], 
+    /**
+     * The changed cells with row object, property, old and new value (since 1.1.96; `undefined` for events created by
+     * own code with the old constructor).
+     */
+    changes?: CellChangeIf<any>[] | undefined, 
+    /** What changed the cells: `"edit"`, `"fill"`, `"commit"` or `"api"` (since 1.1.96). */
+    source?: CellChangeSource | undefined);
+    /**
+     * An event for a change set (since 1.1.96): `cells` from the row and column indices of the changes.
+     *
+     * @param {CellChangeIf[]} changes - the changed cells
+     * @param {CellChangeSource} source - what changed them
+     * @returns {GeModelChangeEvent} the event
+     */
+    static createForChanges(changes: CellChangeIf[], source: CellChangeSource): GeModelChangeEvent;
     static createSingle(rowIndex: number, columnIndex: number): GeModelChangeEvent;
 }

package/lib/table/data/common/event/ge-row-drag-event.d.ts

@@ -0,0 +1,89 @@
+import { RowDropTargetIf } from '../../../row-drag/row-drop-target.if.js';
+
+/**
+ * Phase of a row drag: `"start"` (the pointer moved past the threshold, or a move key), `"move"` (the drop target
+ * changed), `"end"` (dropped) or `"cancel"` (Escape, `pointercancel`, `tableApi.cancelRowDrag()`, destroy).
+ *
+ * @category Row drag
+ * @since 1.1.95
+ */
+export type GeRowDragEventType = "start" | "move" | "end" | "cancel";
+/**
+ * What started the drag: the pointer (mouse, touch, pen) on a drag handle, or the keyboard
+ * (`MOVE_ROW_UP` / `MOVE_ROW_DOWN`, Ctrl+Alt+↑/↓).
+ *
+ * @category Row drag
+ * @since 1.1.95
+ */
+export type GeRowDragSource = "pointer" | "keyboard";
+/**
+ * A row drag ({@link EventListenerIf.onRowDragStart}, {@link EventListenerIf.onRowDragMove},
+ * {@link EventListenerIf.onRowDragEnd}).
+ *
+ * Call {@link preventDefault} to veto: in `"start"` no drag happens, in `"move"` the target is invalid (no drop
+ * marker, no drop). In managed mode `"end"` comes after the move (`moved`, `toIndex` = the real position).
+ *
+ * @example
+ * const listener = new EventAdapter();
+ * listener.onRowDragEnd = (evt: GeRowDragEvent<Order>) => {
+ *   if (evt.moved) {
+ *     const ids = evt.rows.map(order => order.id);
+ *     void fetch("/api/orders/move", { method: "POST", body: JSON.stringify({ ids, toIndex: evt.toIndex }) });
+ *   }
+ * };
+ *
+ * @category Row drag
+ * @since 1.1.95
+ */
+export declare class GeRowDragEvent<T = any> {
+    /** Phase of the drag. */
+    readonly type: GeRowDragEventType;
+    /** Pointer or keyboard. */
+    readonly source: GeRowDragSource;
+    /** The dragged row objects (tree: the `TreeRow`s) in display order. */
+    readonly rows: T[];
+    /** Display indices of the dragged rows when the drag started (ascending). */
+    readonly rowIndices: number[];
+    /** The current drop target – `undefined` if there is none (invalid, vetoed, outside the table). */
+    readonly target: RowDropTargetIf | undefined;
+    /**
+     * Flat tables: display index of the first dragged row after the drop (`0` = first row), `-1` without target.
+     * Trees: `-1` before the move; in a managed `"end"` the index the row really got.
+     */
+    toIndex: number;
+    /** true if the pointer is outside the table – e.g. over an own drop zone of the page. */
+    readonly outside: boolean;
+    /** true if the table moves the rows itself ({@link RowDragOptionsIf.managed}). */
+    readonly managed: boolean;
+    /** The browser event behind this event (pointer or keyboard). */
+    readonly originalEvent?: PointerEvent | KeyboardEvent | undefined;
+    /** true if the moved rows changed in the table (managed mode, `"end"`, not prevented). */
+    moved: boolean;
+    private prevented;
+    constructor(
+    /** Phase of the drag. */
+    type: GeRowDragEventType, 
+    /** Pointer or keyboard. */
+    source: GeRowDragSource, 
+    /** The dragged row objects (tree: the `TreeRow`s) in display order. */
+    rows: T[], 
+    /** Display indices of the dragged rows when the drag started (ascending). */
+    rowIndices: number[], 
+    /** The current drop target – `undefined` if there is none (invalid, vetoed, outside the table). */
+    target: RowDropTargetIf | undefined, 
+    /**
+     * Flat tables: display index of the first dragged row after the drop (`0` = first row), `-1` without target.
+     * Trees: `-1` before the move; in a managed `"end"` the index the row really got.
+     */
+    toIndex: number, 
+    /** true if the pointer is outside the table – e.g. over an own drop zone of the page. */
+    outside: boolean, 
+    /** true if the table moves the rows itself ({@link RowDragOptionsIf.managed}). */
+    managed: boolean, 
+    /** The browser event behind this event (pointer or keyboard). */
+    originalEvent?: PointerEvent | KeyboardEvent | undefined);
+    /** true after {@link preventDefault}. */
+    get defaultPrevented(): boolean;
+    /** Veto: no drag (`"start"`), invalid target (`"move"`); no effect in `"end"` and `"cancel"`. */
+    preventDefault(): void;
+}

package/lib/table/data/options/auto-restore-options.d.ts

@@ -44,6 +44,8 @@ export declare class AutoRestoreOptions<T> implements AutoRestoreOptionsIf<T> {
     autoRestoreHeaderGroupState: boolean;
     /** @since 1.1.92 */
     autoRestoreCustomState: boolean;
+    /** @since 1.1.97 */
+    autoRestoreDetailState: boolean;
     getStorageKeyFn: undefined;
     /** @deprecated since 1.1.92 – never used by the table. */
     isSame: (r1: T, r2: T, options: AutoRestoreOptionsIf<T>) => boolean;

package/lib/table/data/options/auto-restore-options.if.d.ts

@@ -51,6 +51,7 @@ export type GetStorageKeyFn = (() => string);
  * | {@link autoRestoreCheckedState} | checked rows | 1.1.92 (declared before, without effect) |
  * | {@link autoRestoreSelectedState} | selection | 1.1.92 (declared before, without effect) |
  * | {@link autoRestoreCustomState} | your data ({@link TableApi.setCustomState}) | 1.1.92 |
+ * | {@link autoRestoreDetailState} | expanded detail rows (master/detail) | 1.1.97 |
  *
  * Before 1.1.92 sorting, scroll position and tree were stored under three keys (`<key>sortingState`,
  * `<key>scrollState`, `<key>collapsedExpandedState`); they are read once and removed with the next save.
@@ -103,6 +104,11 @@ export interface AutoRestoreOptionsIf<T> {
      * @since 1.1.92
      */
     autoRestoreCustomState?: boolean;
+    /**
+     * Remember the expanded detail rows of master/detail ({@link TableOptionsIf.masterDetail}, by {@link getRowId}).
+     * @since 1.1.97
+     */
+    autoRestoreDetailState?: boolean;
     /**
      * A unique, stable id per row (tree: per node). With the default of {@link AutoRestoreOptions} the table uses the
      * property `id`, then `uuid`; rows without them are not stored (since 1.1.92 – the JSON of the row would write

package/lib/table/data/options/table-options.d.ts

@@ -1,3 +1,4 @@
+import { MasterDetailOptionsIf } from '../../master-detail/master-detail-options.if.js';
 import { DefaultRowHeightsIf } from './default-row-heights.if.js';
 import { TableOptionsIf } from './table-options.if.js';
 import { TreeOptions } from './tree-options.js';
@@ -12,6 +13,9 @@ import { ShortcutActionIdMapping } from '../../action/shortcut-actionid-mapping.
 import { HeaderGroupOptions } from './header-group-options.js';
 import { AriaTextsIf } from '../../aria/aria-texts.if.js';
 import { OverlayOptionsIf } from './overlay-options.if.js';
+import { RowDragOptionsIf } from '../../row-drag/row-drag-options.if.js';
+import { FillHandleOptionsIf } from '../../fill/fill-handle-options.if.js';
+import { BatchEditOptionsIf } from '../../batch-edit/batch-edit-options.if.js';
 
 /**
  * All default options of a table – see {@link TableOptionsIf} for the meaning of each field.
@@ -80,4 +84,8 @@ export declare class TableOptions implements TableOptionsIf {
     ariaTexts?: Partial<AriaTextsIf>;
     /** Texts and behaviour of the "Loading…" / "No rows" overlays; missing fields use {@link OverlayOptions}. @since 1.1.92 */
     overlayOptions?: Partial<OverlayOptionsIf>;
+    rowDragOptions?: Partial<RowDragOptionsIf>;
+    fillHandle?: boolean | Partial<FillHandleOptionsIf>;
+    masterDetail?: Partial<MasterDetailOptionsIf>;
+    batchEdit?: boolean | Partial<BatchEditOptionsIf>;
 }

package/lib/table/data/options/table-options.if.d.ts

@@ -1,3 +1,7 @@
+import { MasterDetailOptionsIf } from '../../master-detail/master-detail-options.if.js';
+import { RowDragOptionsIf } from '../../row-drag/row-drag-options.if.js';
+import { FillHandleOptionsIf } from '../../fill/fill-handle-options.if.js';
+import { BatchEditOptionsIf } from '../../batch-edit/batch-edit-options.if.js';
 import { DefaultRowHeightsIf } from './default-row-heights.if.js';
 import { TreeOptionsIf } from './tree-options.if.js';
 import { FilterFunction } from '../common/filter-function.js';
@@ -317,6 +321,64 @@ export interface TableOptionsIf {
      * @since 1.1.92
      */
     overlayOptions?: Partial<OverlayOptionsIf>;
+    /**
+     * Row drag: managed or events only, multi-row drag, tree drop, auto-scroll (see {@link RowDragOptionsIf}). The drag
+     * handles come from {@link ColumnDefIf.rowDrag}. Fields you leave out keep their default ({@link RowDragOptions}).
+     *
+     * @example
+     * const tableOptions: TableOptionsIf = {
+     *   ...new TableOptions(),
+     *   rowDragOptions: { managed: false },   // only events – e.g. the server decides
+     * };
+     *
+     * @since 1.1.95
+     */
+    rowDragOptions?: Partial<RowDragOptionsIf>;
+    /**
+     * The fill handle: a small square at the bottom right corner of the selected range. Dragging it fills the
+     * neighbouring cells (copy, or a series: 1, 2, 3 …, dates, `Item 1` → `Item 2`); ⌥/Alt switches between series and
+     * copy. Keyboard: Ctrl/⌘+D fills down, Ctrl/⌘+R fills right. Needs a selection model of the type `"range"`;
+     * only editable cells are filled. `true` = defaults ({@link FillHandleOptions}).
+     *
+     * @example
+     * const selectionModel = new SelectionModel("range", "multi");   // one model – not a new one per call
+     * const tableOptions: TableOptionsIf = {
+     *   ...new TableOptions(),
+     *   getSelectionModel: () => selectionModel,
+     *   fillHandle: true,
+     * };
+     *
+     * @since 1.1.96
+     */
+    fillHandle?: boolean | Partial<FillHandleOptionsIf>;
+    /**
+     * Batch edit always on: edited and filled values are collected (marked `ge-table-cell-pending`) and written with
+     * {@link TableApi.commitBatchEdit} or discarded with {@link TableApi.cancelBatchEdit}. Without it, start a batch
+     * edit with {@link TableApi.startBatchEdit} (it ends with commit or cancel).
+     *
+     * @example
+     * const tableOptions: TableOptionsIf = { ...new TableOptions(), batchEdit: true };
+     *
+     * @since 1.1.96
+     */
+    batchEdit?: boolean | Partial<BatchEditOptionsIf>;
+    /**
+     * Master/detail: master rows get an expand icon; below an expanded row a detail row over the full width shows any
+     * content (a nested table, a form, a framework component – see {@link MasterDetailOptionsIf}). Only for flat body
+     * models. Fields you leave out keep their default ({@link MasterDetailOptions}); `detailRenderer` is required.
+     *
+     * @example
+     * const tableOptions: TableOptionsIf = {
+     *   ...new TableOptions(),
+     *   masterDetail: {
+     *     detailHeight: "auto",
+     *     detailRenderer: (container, row) => { container.textContent = `Notes: ${row.notes}`; }
+     *   }
+     * };
+     *
+     * @since 1.1.97
+     */
+    masterDetail?: Partial<MasterDetailOptionsIf>;
     /**
      * The state the table starts with: column layout, sorting, tree, checked and selected rows … – e.g. loaded from
      * your server ({@link TableApi.getState}, {@link EventListenerIf.onStateChanged}). A state stored by

package/lib/table/data/tablemodel/areamodel/abstract-area-model.d.ts

@@ -7,6 +7,7 @@ import { CheckboxModelIf } from '../../../checkbox/checkbox-model.if.js';
 import { FilterFunction } from '../../common/filter-function.js';
 import { SortItem } from '../../common/sort-item.js';
 import { HasDefaultRowHeightIf } from './has-default-row-height-if.js';
+import { ColumnValues } from '../../../calc/column-values.js';
 
 /** @category Area models */
 export declare abstract class AbstractAreaModel<T> implements AreaModelIf, HasDefaultRowHeightIf {
@@ -14,6 +15,8 @@ export declare abstract class AbstractAreaModel<T> implements AreaModelIf, HasDe
     protected columnDefs: ColumnDefIf[];
     defaultRowHeight: number;
     rowSelectionModel: CheckboxModelIf<any> | undefined;
+    private columnValuesInstance?;
+    private calcTextRenderer?;
     protected cellRenderers: (CellRendererIf | undefined)[];
     protected yPositions: number[];
     constructor(areaIdent: AreaIdent, columnDefs?: ColumnDefIf[], defaultRowHeight?: number);
@@ -48,4 +51,67 @@ export declare abstract class AbstractAreaModel<T> implements AreaModelIf, HasDe
     protected setPropertyValue(o: any, props: string[], value: any): boolean;
     protected arrayMove(arr: any[], fromIndex: number, toIndex: number): any[];
     private calcYPositions;
+    /**
+     * True if a column of this model with this property is calculated (`valueGetter` or `formula`).
+     *
+     * @param {string} property - the property of the column
+     * @returns {boolean} whether its values are computed
+     *
+     * @example
+     * tableModel.getBodyModel().isCalculatedProperty?.("total");   // true
+     *
+     * @since 1.1.95
+     */
+    isCalculatedProperty(property: string): boolean;
+    /**
+     * The value of a column for a row object – the computed value of a calculated column, otherwise the property
+     * (path). A `TreeRow` is unwrapped. The table API offers it as {@link TableApi.getRowValue}.
+     *
+     * @param {any} row - a row object (or `TreeRow`)
+     * @param {string} property - the property of the column
+     * @returns {unknown} the value
+     *
+     * @example
+     * const body = tableModel.getBodyModel() as AreaModelObjectArray<Item>;
+     * body.getRowValue({ price: 25, quantity: 10 }, "total");   // 250
+     *
+     * @since 1.1.95
+     */
+    getRowValue(row: any, property: string): unknown;
+    /**
+     * True if the model has calculated or „Show values as“ columns – their cells depend on other cells
+     * (the table redraws them after `updateCells`).
+     *
+     * @returns {boolean} whether derived columns exist
+     * @since 1.1.95
+     */
+    hasDerivedColumns(): boolean;
+    /**
+     * True if the cells of a column depend on other cells (calculated or „Show values as“).
+     *
+     * @param {string} property - the property of the column
+     * @returns {boolean} whether the column is derived
+     * @since 1.1.95
+     */
+    isDerivedProperty(property: string): boolean;
+    /** The resolver of calculated values of this model (created on first use). @internal */
+    protected getColumnValues(): ColumnValues;
+    /** Drops the cached aggregates and the getter lookup of calculated columns. */
+    protected invalidateColumnValues(): void;
+    /** The value of a property path – overridden by the models with their own path semantics. */
+    protected readPropertyPath(row: any, property: string): unknown;
+    /** The rows of column aggregates in formulas (`SUM([total])`): the filtered row objects. */
+    protected getAggregationSourceForValues(): {
+        signal: unknown;
+        length: number;
+        rows: () => ArrayLike<unknown>;
+    };
+    /** Writes an edited value of a calculated column through its `valueSetter`; without one: rejected. */
+    protected setCalculatedValue(row: any, columnDef: ColumnDefIf, value: any): boolean;
+    /** The text of a cell of a calculated / „Show values as“ column; `undefined` for a normal column. */
+    protected getCalculatedText(property: string | undefined, value: unknown): string | undefined;
+    /** The renderer of a „Show values as“ column without an own renderer: the text of `getTextValueAt`. */
+    protected getCalculatedRenderer(property: string | undefined): CellRendererIf | undefined;
+    /** The CSS class and tooltip of an error value of a formula. */
+    protected addCalculatedClasses(classes: string[], property: string | undefined, value: () => unknown): string[];
 }

package/lib/table/data/tablemodel/areamodel/area-model-aggregate-footer.d.ts

@@ -140,6 +140,11 @@ export declare class AreaModelAggregateFooter<T = any> extends AreaModel impleme
      * @internal
      */
     protected createIndexGetter(body: AreaModelIf, spec: ResolvedAggregateSpec<T>): ((rowIndex: number) => unknown) | undefined;
+    /**
+     * A spec whose value is the property of a calculated column of the body (`footerAggregates: { total: "sum" }` with
+     * `total` = `price * quantity`) sums the computed values, not the (missing) property of the row (since 1.1.95).
+     */
+    private withCalculatedValues;
     private compute;
 }
 export {};

package/lib/table/data/tablemodel/areamodel/area-model-array-of-arrays.d.ts

@@ -2,6 +2,7 @@ import { AbstractAreaModel } from './abstract-area-model.js';
 import { AreaIdent } from '../area-ident.type.js';
 import { ColumnDefIf } from '../column/column-def.if.js';
 import { FilterFunction } from '../../common/filter-function.js';
+import { RowDropTargetIf } from '../../../row-drag/row-drop-target.if.js';
 
 /**
  * Represents a model for an area containing a two-dimensional array of data.
@@ -25,6 +26,29 @@ export declare class AreaModelArrayOfArrays<T> extends AbstractAreaModel<T[][]>
      * @since 1.1.92
      */
     getUnfilteredRowCount(): number;
+    /**
+     * Row drag: true if the rows can be moved (no filter hides a row, target `"before"` / `"after"` a row).
+     *
+     * @param {number[]} rowIndices - display indices of the dragged rows
+     * @param {RowDropTargetIf} target - the drop target
+     * @returns {boolean} true if {@link moveRows} would move them
+     * @since 1.1.95
+     */
+    canMoveRows(rowIndices: number[], target: RowDropTargetIf): boolean;
+    /**
+     * Row drag: moves the rows – in place in the displayed rows and in {@link arr}.
+     *
+     * @param {number[]} rowIndices - display indices of the dragged rows
+     * @param {RowDropTargetIf} target - the drop target (display index before the move)
+     * @returns {boolean} true if moved
+     *
+     * @example
+     * const model = new AreaModelArrayOfArrays("body", [["a"], ["b"], ["c"]], 30);
+     * model.moveRows([0], { rowIndex: 2, position: "after" });   // b, c, a
+     *
+     * @since 1.1.95
+     */
+    moveRows(rowIndices: number[], target: RowDropTargetIf): boolean;
     getValueAt(rowIndex: number, columnIndex: number): any;
     setValue(rowIndex: number, columnIndex: number, value: any): boolean;
     getRowByIndex(rowIndex: number): any;

package/lib/table/data/tablemodel/areamodel/area-model-object-array.d.ts

@@ -5,6 +5,10 @@ import { FilterFunction } from '../../common/filter-function.js';
 import { SorterService } from '../../../service/sorter.service.js';
 import { SortItem } from '../../common/sort-item.js';
 import { ObjectArrayHolderIf } from './object-array-holder.if.js';
+import { CellRendererIf } from '../../../renderer/cell-render.if.js';
+import { DerivedValuesChangeIf } from './derived-values-change.if.js';
+import { ShowValuesAsIf } from '../../../calc/show-values-as.type.js';
+import { RowDropTargetIf } from '../../../row-drag/row-drop-target.if.js';
 
 /**
  * @class AreaModelObjectArray
@@ -171,6 +175,8 @@ export declare class AreaModelObjectArray<T> extends AbstractAreaModel<T> implem
      * @internal
      */
     protected sorterService: SorterService;
+    /** Cached „Show values as“ values per property (cleared on filter, sorting and invalidation). */
+    private showValuesCache;
     /**
      * Creates an instance of AreaModelObjectArray.
      *
@@ -280,6 +286,36 @@ export declare class AreaModelObjectArray<T> extends AbstractAreaModel<T> implem
      * @since 1.1.92
      */
     getUnfilteredRowCount(): number;
+    /**
+     * Row drag: true if the rows can be moved – no filter hides a row and the target is a row of this model
+     * (`"before"` / `"after"`).
+     *
+     * @param {number[]} rowIndices - display indices of the dragged rows
+     * @param {RowDropTargetIf} target - the drop target
+     * @returns {boolean} true if {@link moveRows} would move them
+     *
+     * @example
+     * bodyAreaModel.canMoveRows([2], { rowIndex: 6, position: "after" });   // true without a filter
+     *
+     * @since 1.1.95
+     */
+    canMoveRows(rowIndices: number[], target: RowDropTargetIf): boolean;
+    /**
+     * Row drag: moves the rows in the display order and writes that order back to {@link getAllRows} – **in place**
+     * (like `Array.prototype.sort`: with `TableFactory.createTableModel({ rows })` your array has the new order).
+     * Works only without a hiding filter ({@link canMoveRows}). The table repaints after a drop; from code use
+     * `tableApi.moveRows()`.
+     *
+     * @param {number[]} rowIndices - display indices of the dragged rows
+     * @param {RowDropTargetIf} target - the drop target (display index before the move)
+     * @returns {boolean} true if moved
+     *
+     * @example
+     * bodyAreaModel.moveRows([2], { rowIndex: 6, position: "after" });   // row 3 becomes row 7
+     *
+     * @since 1.1.95
+     */
+    moveRows(rowIndices: number[], target: RowDropTargetIf): boolean;
     /**
      * Gets the value at the specified row and column indices.
      * This method handles tree rows and nested properties.
@@ -302,6 +338,35 @@ export declare class AreaModelObjectArray<T> extends AbstractAreaModel<T> implem
      * }
      */
     getValueAt(rowIndex: number, columnIndex: number): any;
+    /**
+     * The text of a cell: for a „Show values as“ column the formatted value (`"66.7%"`), for a formula error its code;
+     * otherwise like before (`'' + value`).
+     *
+     * @param {number} rowIndex - the row
+     * @param {number} columnIndex - the column
+     * @returns {string} the text
+     */
+    getTextValueAt(rowIndex: number, columnIndex: number): string;
+    /** A „Show values as“ column without an own body renderer shows the formatted text. */
+    getCellRenderer(rowIndex: number, columnIndex: number): CellRendererIf | undefined;
+    /** The message of a formula error as tooltip. */
+    getTooltipAt(rowIndex: number, columnIndex: number): any;
+    /**
+     * Drops derived values: cached aggregates of formulas and „Show values as“ (called by the table on filter,
+     * sorting, editing, `updateCells` and `api.repaint()`).
+     *
+     * @param {DerivedValuesChangeIf} [_change] - the changed rows (not used)
+     * @since 1.1.95
+     */
+    invalidateDerivedValues(_change?: DerivedValuesChangeIf): void;
+    /** „Show values as“ of one cell; the reference are the filtered rows in display order. */
+    protected applyShowValuesAs(rowIndex: number, property: string, value: unknown, options: ShowValuesAsIf): unknown;
+    protected readPropertyPath(t: any, property: string): unknown;
+    protected getAggregationSourceForValues(): {
+        signal: unknown;
+        length: number;
+        rows: () => ArrayLike<unknown>;
+    };
     /**
      * Retrieves the filtered and sorted rows from the dataset.
      * These rows are used for rendering the table.
@@ -565,6 +630,11 @@ export declare class AreaModelObjectArray<T> extends AbstractAreaModel<T> implem
      * const sortedRows = [...this.getFilteredRows()].sort(comparator);
      */
     protected genericFlatTableSortComparator(property: string, f: number): (a: T, b: T) => number;
+    /**
+     * The value of a row for a sort pass: a calculated column is computed once per row (memo for this pass, not
+     * 2·n·log n times); formula errors sort last (as `undefined`).
+     */
+    protected createSortValueReader(property: string): (row: T) => unknown;
     /**
      * Recursively gets a value from an object using an array of property names.
      * This is a helper method used by `getValueByT` to access nested properties.