@guiexpert/table 1.1.90 → 1.1.92

package/lib/table/overlay/ge-overlay-kind.type.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The overlay the table shows over its body:
+ * - `"none"` – no overlay;
+ * - `"loading"` – spinner + "Loading…" ({@link TableApi.showLoadingOverlay});
+ * - `"noRows"` – "No rows to show": the body is empty ({@link OverlayOptionsIf.autoNoRows}) or
+ *   {@link TableApi.showNoRowsOverlay} was called;
+ * - `"noMatches"` – "No matching rows": the body has rows, but the external filter hides all of them.
+ *
+ * @example
+ * if (tableApi.getOverlayState() === "noMatches") {
+ *   console.log("Reset the filter to see rows again");
+ * }
+ *
+ * @since 1.1.92
+ * @category Overlays
+ */
+export type GeOverlayKind = "none" | "loading" | "noRows" | "noMatches";

package/lib/table/overlay/table-overlay.d.ts

@@ -0,0 +1,108 @@
+import { ConvenienceDomService } from '../service/convenience-dom.service.js';
+import { OverlayOptionsIf } from '../data/options/overlay-options.if.js';
+import { OverlayOptions } from '../data/options/overlay-options.js';
+import { GeOverlayKind } from './ge-overlay-kind.type.js';
+
+/**
+ * A change of the shown overlay, reported by {@link TableOverlay.update}.
+ *
+ * @since 1.1.92
+ * @category Internals
+ */
+export interface TableOverlayChange {
+    previous: GeOverlayKind;
+    kind: GeOverlayKind;
+    /** the text of the new overlay (`""` for `"none"`) */
+    text: string;
+}
+/**
+ * The overlay layer over the table body: "Loading…" with a CSS spinner, "No rows to show", "No matching rows".
+ * One element per table (`.ge-table-overlay`, a child of the host, `aria-hidden` – the table announces the texts
+ * through its live region instead). It is created once and only changed when the shown overlay changes, so
+ * scrolling costs one comparison per frame.
+ *
+ * Apps use it through {@link TableApi.showLoadingOverlay}, {@link TableApi.showNoRowsOverlay},
+ * {@link TableApi.hideOverlay} and {@link TableApi.getOverlayState}; texts and behaviour come from
+ * {@link TableOptionsIf.overlayOptions}.
+ *
+ * @example
+ * const overlay = new TableOverlay(hostDiv, new ConvenienceDomService(new SimpleDomService()), {}, () => {
+ *   overlay.update(0, 0);
+ * });
+ * overlay.showLoading("Saving…"); // calls the update callback
+ * console.log(overlay.getState()); // "loading"
+ * overlay.destroy();
+ *
+ * @since 1.1.92
+ * @category Internals
+ */
+export declare class TableOverlay {
+    private readonly dom;
+    private readonly requestUpdate;
+    /** The overlay element (`.ge-table-overlay`). */
+    readonly element: HTMLDivElement;
+    /** The content box, centered in the overlay (`.ge-table-overlay-content`). */
+    readonly contentElement: HTMLDivElement;
+    readonly options: OverlayOptions;
+    private manual?;
+    private delayTimeout?;
+    private shownKind;
+    private shownText;
+    private shownBlocking;
+    private bounds;
+    private destroyed;
+    /**
+     * @param {HTMLDivElement} hostElement - the table host; the overlay is appended to it
+     * @param {ConvenienceDomService} dom - DOM access of the table
+     * @param {Partial<OverlayOptionsIf>} [overlayOptions] - {@link TableOptionsIf.overlayOptions}
+     * @param {() => void} [requestUpdate] - called when the requested overlay changed (API call, end of the
+     *   delay); the table answers with {@link update}
+     */
+    constructor(hostElement: HTMLDivElement, dom: ConvenienceDomService, overlayOptions?: Partial<OverlayOptionsIf>, requestUpdate?: () => void);
+    /**
+     * Requests the loading overlay (after {@link OverlayOptionsIf.loadingDelayInMs}).
+     *
+     * @param {string} [text] - text for this overlay, default {@link OverlayOptionsIf.loadingText}
+     */
+    showLoading(text?: string): void;
+    /**
+     * Requests the "no rows" overlay, also over rows and with {@link OverlayOptionsIf.autoNoRows} `false`.
+     *
+     * @param {string} [text] - text for this overlay, default {@link OverlayOptionsIf.noRowsText}
+     */
+    showNoRows(text?: string): void;
+    /** Ends a requested overlay; the automatic "no rows" / "no matching rows" stays as long as the body is empty. */
+    hide(): void;
+    /** The overlay that is shown now. */
+    getState(): GeOverlayKind;
+    /** `true` while a loading overlay blocks mouse and keyboard ({@link OverlayOptionsIf.blockInteractionWhileLoading}). */
+    isBlocking(): boolean;
+    /**
+     * `true` for a mouse event on a blocking loading overlay: the table ignores it (click, double click, mouse down,
+     * context menu, hover). The event is not stopped – page handlers (e.g. "click outside closes the menu") see it.
+     *
+     * @param {Event} evt - a mouse event that reached the host
+     * @returns {boolean} the table must not react to it
+     */
+    isEventBlocked(evt: Event): boolean;
+    /**
+     * Shows the overlay that fits the body: a requested one, else "no matching rows" / "no rows to show"
+     * for an empty body. Changes the DOM only if the result differs from what is shown.
+     *
+     * @param {number} rowCount - `getRowCount()` of the body
+     * @param {number} [unfilteredRowCount] - `getUnfilteredRowCount()` of the body (only needed for 0 rows)
+     * @returns {TableOverlayChange | undefined} the change, `undefined` if nothing changed
+     */
+    update(rowCount: number, unfilteredRowCount?: number): TableOverlayChange | undefined;
+    /**
+     * Places the overlay over the body (px, relative to the host). Unchanged values do not touch the DOM.
+     */
+    setBounds(left: number, top: number, width: number, height: number): void;
+    /** Removes the overlay element and a waiting delay. Calling it twice is harmless. */
+    destroy(): void;
+    private getText;
+    private render;
+    /** The element of {@link OverlayOptionsIf.getOverlayElement}; an error falls back to the built-in content. */
+    private getOwnElement;
+    private clearDelay;
+}

package/lib/table/render-scope.d.ts

@@ -1,25 +1,29 @@
-import { EleScope } from './ele-scope';
-import { TableModelIf } from './data/tablemodel/table-model.if';
-import { ConvenienceDomService } from './service/convenience-dom.service';
-import { TableOptionsIf } from './data/options/table-options.if';
-import { CellRange } from './data/common/cell-range';
-import { RendererCleanupFnType } from './renderer/renderer-cleanup-fn.type';
-import { AreaIdent } from './data/tablemodel/area-ident.type';
-import { SideIdent } from './data/side-ident.type';
-import { DivScope } from './data/div-scope.type';
-import { AreaModelIf } from './data/tablemodel/areamodel/area-model.if';
-import { ArgsAdjustColumnsToRowParentParams } from './data/common/args-adjust-columns-to-row-parent-params';
-import { ArgsRenderCellDiv } from './data/common/args-render-cell-div';
-import { StoreStateScrollPosService } from './service/store-state-scroll-pos.service';
-import { GeMouseEvent } from './data/common/event/ge-mouse-event';
-import { GeoData } from './data/geo-data';
-import { SelectionModelIf } from './selection/selection-model.if';
-import { GetT } from './data/common/get-t';
-import { FocusModelIf } from './focus/focus-model.if';
-import { ColAndRowspanModel } from './data/tablemodel/areamodel/col-and-rowspan-model';
-import { AreaObjectMapType } from './data/common/area-map.type';
-import { TableCellUpdateEventIf } from './data/common/event/input/table-cell-update-event.if';
+import { TableOverlayChange } from './overlay/table-overlay.js';
+import { EleScope } from './ele-scope.js';
+import { TableModelIf } from './data/tablemodel/table-model.if.js';
+import { ConvenienceDomService } from './service/convenience-dom.service.js';
+import { TableOptionsIf } from './data/options/table-options.if.js';
+import { CellRange } from './data/common/cell-range.js';
+import { RendererCleanupFnType } from './renderer/renderer-cleanup-fn.type.js';
+import { AreaIdent } from './data/tablemodel/area-ident.type.js';
+import { SideIdent } from './data/side-ident.type.js';
+import { DivScope } from './data/div-scope.type.js';
+import { AreaModelIf } from './data/tablemodel/areamodel/area-model.if.js';
+import { ArgsAdjustColumnsToRowParentParams } from './data/common/args-adjust-columns-to-row-parent-params.js';
+import { ArgsRenderCellDiv } from './data/common/args-render-cell-div.js';
+import { StoreStateScrollPosService } from './service/store-state-scroll-pos.service.js';
+import { GeMouseEvent } from './data/common/event/ge-mouse-event.js';
+import { GeoData } from './data/geo-data.js';
+import { SelectionModelIf } from './selection/selection-model.if.js';
+import { GetT } from './data/common/get-t.js';
+import { FocusModelIf } from './focus/focus-model.if.js';
+import { ColAndRowspanModel } from './data/tablemodel/areamodel/col-and-rowspan-model.js';
+import { AreaObjectMapType } from './data/common/area-map.type.js';
+import { TableCellUpdateEventIf } from './data/common/event/input/table-cell-update-event.if.js';
+import { AriaGridInfo } from './aria/aria-grid-info.js';
+import { AriaTextsIf } from './aria/aria-texts.if.js';
 
+/** @category Internals */
 export declare class RenderScope extends EleScope {
     firstVisibleRowIndex: number;
     lastVisibleRowIndex: number;
@@ -31,11 +35,11 @@ export declare class RenderScope extends EleScope {
     protected dragging: boolean;
     protected editing: boolean;
     protected storedColumnWidths: number[];
+    /** @deprecated since 1.1.92 – no longer used, see {@link TableStateService}. */
     protected storeScrollPosStateService?: StoreStateScrollPosService;
     protected getSelectionModel?: GetT<SelectionModelIf>;
     protected getFocusModel?: GetT<FocusModelIf>;
     protected scrollLeft: number;
-    private scrollPosSaveTimeout?;
     protected scrollViewportLeft: number;
     protected scrollFactorY: number;
     protected scrollFactorX: number;
@@ -59,11 +63,27 @@ export declare class RenderScope extends EleScope {
     protected areaHeightsOfRenderPass?: {
         [key in AreaIdent]?: number;
     };
-    private debounceTimeout?;
+    protected debounceTimeout?: ReturnType<typeof setTimeout> | null;
     private editorRenderer?;
     private editorRendererColumn?;
     private editorRendererRow?;
     private removables;
+    /** Texts for screen readers (English defaults + `tableOptions.ariaTexts`). @since 1.1.91 */
+    readonly ariaTexts: AriaTextsIf;
+    /** Row/column numbers of the current render pass (see {@link getAriaGridInfo}). */
+    private ariaGridInfo?;
+    private readonly treeAriaInfo;
+    /** The cell that has the keyboard focus in this render pass (→ `aria-activedescendant`). */
+    private ariaFocusedCell?;
+    /** `aria-selected` on body cells ("cell") or rows ("row") – from the type of the selection model. */
+    private ariaSelectionKind;
+    /** Span cells rendered in their row this pass – drawBigCell() draws them again on top (screen readers: once). */
+    private renderedSpanCells;
+    /**
+     * The header cell with the keyboard focus (row, column of the cell's origin) – set by the arrow-up key in the
+     * first body row, see `TableScope`. `undefined`: the focus is in the body ({@link FocusModelIf}).
+     */
+    protected headerFocus?: [number, number];
     constructor(hostElement: HTMLDivElement, tableModel: TableModelIf, dom: ConvenienceDomService, tableOptions: TableOptionsIf);
     isEditing(): boolean;
     /**
@@ -105,20 +125,51 @@ export declare class RenderScope extends EleScope {
      */
     repaintHard(): void;
     /**
-     * Recalculates the column widths of the table.
+     * Recalculates the column widths of the table (% and weight columns depend on the available width) and repaints.
      *
-     * @param {number} [clientWidth] - The client width of the table. If not provided, the client width of the scroll viewport will be used.
+     * @param {number} [clientWidth] - The (new) width of the host element, e.g. from a ResizeObserver.
+     *                                 Default: its current width.
      *
      * @return {undefined}
      */
     recalcColumnWidths(clientWidth?: number): void;
+    /**
+     * The width that % and weight columns share: host width minus the fixed west columns and a vertical scroll bar.
+     *
+     * @param {number} [hostWidth] - the width of the host element (default: its current client width)
+     * @returns {number} the width in px (0 if the host has no width yet, e.g. while it is hidden)
+     */
+    protected getAvailableColumnWidth(hostWidth?: number): number;
     /**
      * Adjusts the table after scrolling. This method performs various adjustments
      * to the table's appearance and behavior after a scroll event occurs.
      */
     adjustAfterScrolling(): void;
     /**
-     * Checks if the scroll position should be saved and saves it.
+     * Called at the end of every render pass (scroll, repaint). {@link TableScope} marks the scroll position of the
+     * table state as changed here (stored and reported debounced, see {@link TableStateService}).
+     *
+     * @since 1.1.92
+     */
+    protected afterRenderPass(): void;
+    /**
+     * Shows the overlay that fits the body now (see {@link TableOverlay.update}) and reports a change to
+     * {@link onOverlayChanged}.
+     *
+     * @since 1.1.92
+     */
+    protected updateOverlay(): void;
+    /**
+     * Called after the shown overlay changed (ARIA in {@link TableScope}).
+     *
+     * @param {TableOverlayChange} _change - previous and new overlay, its text
+     * @since 1.1.92
+     */
+    protected onOverlayChanged(_change: TableOverlayChange): void;
+    /**
+     * Marks the scroll position as changed (it is stored with the table state, see {@link TableStateService}).
+     *
+     * @deprecated since 1.1.92 – the table does this after every render pass.
      *
      * @return {void}
      */
@@ -225,6 +276,56 @@ export declare class RenderScope extends EleScope {
      * @protected
      */
     protected adjustArea(areaIdent: AreaIdent, yStart?: number): void;
+    /**
+     * Row and column numbers for screen readers of the current render pass (computed at its start).
+     *
+     * @returns {AriaGridInfo} the counts
+     * @since 1.1.91
+     */
+    getAriaGridInfo(): AriaGridInfo;
+    /** `role="row"` and `aria-rowindex`; body rows of a tree: level, position, expanded; row selection: selected. */
+    protected applyRowAria(rowDiv: HTMLDivElement, areaIdent: AreaIdent, areaModel: AreaModelIf, rowIndex: number, rowState?: boolean): void;
+    /**
+     * `role`, `aria-colindex`, spans and `aria-sort` of a cell.
+     *
+     * @returns {[number, number]} rowspan and colspan of the cell (≥ 1)
+     */
+    protected applyCellAria(cell: HTMLDivElement, areaIdent: AreaIdent, areaModel: AreaModelIf, rowIndex: number, columnIndex: number): [number, number];
+    /** An empty row group has role "presentation" (a rowgroup needs rows) – changed only when it changes. */
+    private updateRowGroupRoles;
+    /** Writes an attribute of the host only if it changed (every write may notify screen readers). */
+    private setHostAttribute;
+    /** Counts, multi selection and the active cell on the host – at the end of every render pass. */
+    private updateHostAria;
+    /**
+     * Remembers the focused cell of this pass. A cell drawn twice (header groups: in its row and again by
+     * drawBigCell, that copy is aria-hidden) keeps the first, visible-to-screen-readers element.
+     */
+    private setAriaFocusedCell;
+    /** "row" for a row selection model, "none" for type "none" (or no model), otherwise "cell". */
+    private getAriaSelectionKind;
+    /**
+     * The label of a column for screen readers: the header label of its column definition, otherwise the text of the
+     * lowest header row, otherwise the property.
+     *
+     * @param {number} columnIndex - model column index
+     * @returns {string} e.g. "Total"
+     * @since 1.1.91
+     */
+    getColumnAriaLabel(columnIndex: number): string;
+    /** Name of a row checkbox: "Select row 5" (body) resp. "Select all rows" (header). */
+    protected getCheckboxAriaLabel(areaIdent: AreaIdent, rowIndex: number): string;
+    /** Gives a form control a name, unless the renderer gave it one. */
+    private labelControl;
+    /**
+     * Names for controls of built-in renderers: row checkboxes ({@link CheckboxColumnDef}), boolean property
+     * checkboxes and – with own `ariaTexts` – header group toggles. Cheap class checks first: most cells have none.
+     */
+    private labelRendererControls;
+    /** The cell div of a column among the children of the given row divs. */
+    private findCellDiv;
+    /** Removes the cached row divs that are no longer in the area (see `ConvenienceDomService.addRowDiv`). */
+    private pruneRowDivCache;
     /**
      * Draws big cells (rowspan and or colspan) in body/center
      * @param range CellRange
@@ -318,6 +419,19 @@ export declare class RenderScope extends EleScope {
      * @param {GeMouseEvent} mouseMoveEvent - The mouse move event object.
      */
     protected adjustHoverColumns(mouseMoveEvent: GeMouseEvent): void;
+    /**
+     * The x position of a column relative to the host element: fixed west and east columns do not scroll.
+     *
+     * @param {number} columnIndex - model index of the column
+     * @param {number} columnLeft - x position of the column over all columns (`getXPosByColumnIndex`)
+     * @returns {number} the left position in px
+     */
+    protected getColumnLeftInHost(columnIndex: number, columnLeft: number): number;
+    /**
+     * Content pixels of the center columns scrolled out on the left – the offset that is actually rendered
+     * (see adjustColumnsToRowParent), the horizontal counterpart of `contentScrollTop`.
+     */
+    protected getContentScrollLeft(): number;
     /**
      * Hide hover column.
      *
@@ -366,7 +480,7 @@ export declare class RenderScope extends EleScope {
      * @param {number} [y=0] - The starting y-position.
      * @return {number} The final y-position after rendering all the content.
      */
-    protected renderContentOfDraggingColumnForArea(columnGeo: GeoData, areaIdent: AreaIdent, y?: number): number;
+    protected renderContentOfDraggingColumnForArea(columnGeo: GeoData, areaIdent: AreaIdent, y?: number, firstRowIndex?: number, maxY?: number): number;
     /**
      * Hides the dragging column by applying a 'display: none' style to it.
      * This method is protected and can only be accessed within the class.

package/lib/table/renderer/action/action-event-listener.if.d.ts

@@ -1,5 +1,6 @@
-import { ActionEventIf } from './action-event.if';
+import { ActionEventIf } from './action-event.if.js';
 
+/** @category Renderers & editing */
 export interface ActionEventListenerIf {
     onActionEvent(actionEvent: ActionEventIf): void;
 }

package/lib/table/renderer/action/action-event.d.ts

@@ -1,7 +1,8 @@
-import { AreaIdent } from '../../data/tablemodel/area-ident.type';
-import { ActionEventIf } from './action-event.if';
-import { AreaModelIf } from '../../data/tablemodel/areamodel/area-model.if';
+import { AreaIdent } from '../../data/tablemodel/area-ident.type.js';
+import { ActionEventIf } from './action-event.if.js';
+import { AreaModelIf } from '../../data/tablemodel/areamodel/area-model.if.js';
 
+/** @category Renderers & editing */
 export declare class ActionEvent implements ActionEventIf {
     action: string;
     area: AreaIdent;

package/lib/table/renderer/action/action-event.if.d.ts

@@ -1,5 +1,6 @@
-import { AreaIdent } from '../../data/tablemodel/area-ident.type';
+import { AreaIdent } from '../../data/tablemodel/area-ident.type.js';
 
+/** @category Renderers & editing */
 export interface ActionEventIf {
     action: string;
     area: AreaIdent;

package/lib/table/renderer/action/actions-cell-renderer.d.ts

@@ -1,11 +1,12 @@
-import { CellRendererIf } from '../cell-render.if';
-import { AreaIdent } from '../../data/tablemodel/area-ident.type';
-import { AreaModelIf } from '../../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../../service/dom-service.if';
-import { RendererCleanupFnType } from '../renderer-cleanup-fn.type';
-import { ActionEventListenerIf } from './action-event-listener.if';
-import { CrudAction } from '../../crud/crud-action';
+import { CellRendererIf } from '../cell-render.if.js';
+import { AreaIdent } from '../../data/tablemodel/area-ident.type.js';
+import { AreaModelIf } from '../../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../../service/dom-service.if.js';
+import { RendererCleanupFnType } from '../renderer-cleanup-fn.type.js';
+import { ActionEventListenerIf } from './action-event-listener.if.js';
+import { CrudAction } from '../../crud/crud-action.js';
 
+/** @category Renderers & editing */
 export declare class ActionsCellRenderer implements CellRendererIf {
     private actionEventListener;
     private crudActions;

package/lib/table/renderer/cell-group-ext-cell-renderer.d.ts

@@ -1,11 +1,12 @@
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { CellRendererIf } from './cell-render.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
-import { CellGroupExt } from '../data/tablemodel/cellgroup/cell-group-ext';
-import { HeaderGroupOptionsIf } from '../data/options/header-group-options.if';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { CellRendererIf } from './cell-render.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
+import { CellGroupExt } from '../data/tablemodel/cellgroup/cell-group-ext.js';
+import { HeaderGroupOptionsIf } from '../data/options/header-group-options.if.js';
 
+/** @category Header groups */
 export declare class CellGroupExtCellRenderer implements CellRendererIf {
     private headerGroupOptions;
     private static toggleHeaderGroup;

package/lib/table/renderer/cell-render.if.d.ts

@@ -1,8 +1,45 @@
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
 
+/**
+ * Decides how a cell **looks** – the value stays the same for sorting, filtering, copy and Excel export.
+ * Assign it per column and area (`columnDef.rendererMap.body = …`, or `bodyRenderer` in {@link ColumnDef.create})
+ * or return it from {@link AreaModelIf.getCellRenderer}.
+ *
+ * Renderers are called only for visible cells, on every repaint – keep them cheap.
+ *
+ * @example
+ * class StatusBadgeRenderer implements CellRendererIf {
+ *   render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent,
+ *          areaModel: AreaModelIf, cellValue: string, dom: DomServiceIf): RendererCleanupFnType | undefined {
+ *     const badge = dom.createElement<HTMLSpanElement>("span");
+ *     dom.addClass(badge, `status-${cellValue}`);
+ *     badge.textContent = cellValue;
+ *     dom.appendChild(cellDiv, badge);
+ *     return undefined;                       // or a cleanup function (listeners, timers …)
+ *   }
+ * }
+ * columnDefs[9].rendererMap.body = new StatusBadgeRenderer();
+ *
+ * @see Training: [Cell renderers](https://gui.expert/training/cell-renderers/),
+ *   [Framework components as cells](https://gui.expert/training/framework-components/)
+ *
+ * @category Renderers & editing
+ */
 export interface CellRendererIf {
+    /**
+     * Fills the (empty) cell element.
+     *
+     * @param cellDiv - the cell element, already positioned and sized
+     * @param rowIndex - row in the area (as displayed)
+     * @param columnIndex - column index (west + center + east)
+     * @param areaIdent - `"header"`, `"body"` or `"footer"`
+     * @param areaModel - the model of this area (e.g. for `getRowByIndex(rowIndex)`)
+     * @param cellValue - the value of the cell (`areaModel.getValueAt(rowIndex, columnIndex)`)
+     * @param domService - create and change elements through it (works with Angular's Renderer2, too)
+     * @returns optionally a cleanup function, called before the cell is drawn again
+     */
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, areaModel: AreaModelIf, cellValue: any, domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/checkbox-boolean-property-cell-renderer.d.ts

@@ -1,11 +1,13 @@
-import { CellRendererIf } from './cell-render.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
-import { AreaModelObjectArray } from '../data/tablemodel/areamodel/area-model-object-array';
+import { CellRendererIf } from './cell-render.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
+import { AreaModelObjectArray } from '../data/tablemodel/areamodel/area-model-object-array.js';
 
 /**
  * Works with AreaModelObjectArray only
+ *
+ * @category Renderers & editing
  */
 export declare class CheckboxBooleanPropertyCellRenderer<T> implements CellRendererIf {
     property: string;

package/lib/table/renderer/checkbox-cell-renderer.d.ts

@@ -1,9 +1,12 @@
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { CellRendererIf } from './cell-render.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { CellRendererIf } from './cell-render.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
 
+/** @category Renderers & editing */
 export declare class CheckboxCellRenderer implements CellRendererIf {
+    /** Marker for {@link isCheckboxCellRenderer} (works across copies of the core). @since 1.1.91 */
+    readonly type = "CheckboxCellRenderer";
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, areaModel: AreaModelIf, _cellValue: any, domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/date-to-int-date-cell-renderer.d.ts

@@ -1,9 +1,10 @@
-import { CellRendererIf } from './cell-render.if';
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
+import { CellRendererIf } from './cell-render.if.js';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
 
+/** @category Renderers & editing */
 export declare class DateToIntlDDMMYYYYCellRenderer implements CellRendererIf {
     readonly formatter: Intl.DateTimeFormat;
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, _domService: DomServiceIf): RendererCleanupFnType | undefined;

package/lib/table/renderer/date-to-iso-cell-renderer.d.ts

@@ -1,9 +1,10 @@
-import { CellRendererIf } from './cell-render.if';
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
+import { CellRendererIf } from './cell-render.if.js';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
 
+/** @category Renderers & editing */
 export declare class DateToIsoCellRenderer implements CellRendererIf {
     render(cellDiv: HTMLDivElement, _rowIndex: number, _columnIndex: number, _areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, _domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/date-to-locale-date-cell-renderer.d.ts

@@ -1,9 +1,10 @@
-import { CellRendererIf } from './cell-render.if';
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
+import { CellRendererIf } from './cell-render.if.js';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
 
+/** @category Renderers & editing */
 export declare class DateToLocaleDateCellRenderer implements CellRendererIf {
     render(cellDiv: HTMLDivElement, _rowIndex: number, _columnIndex: number, _areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, _domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/date-to-tec-cell-renderer.d.ts

@@ -1,9 +1,10 @@
-import { CellRendererIf } from './cell-render.if';
-import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../service/dom-service.if';
-import { AreaIdent } from '../data/tablemodel/area-ident.type';
-import { RendererCleanupFnType } from './renderer-cleanup-fn.type';
+import { CellRendererIf } from './cell-render.if.js';
+import { AreaModelIf } from '../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../service/dom-service.if.js';
+import { AreaIdent } from '../data/tablemodel/area-ident.type.js';
+import { RendererCleanupFnType } from './renderer-cleanup-fn.type.js';
 
+/** @category Renderers & editing */
 export declare class DateToTecCellRenderer implements CellRendererIf {
     render(cellDiv: HTMLDivElement, _rowIndex: number, _columnIndex: number, _areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, _domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/edit/edit-cell-renderer.type.d.ts

@@ -1,3 +1,4 @@
-import { CellRendererIf } from '../cell-render.if';
+import { CellRendererIf } from '../cell-render.if.js';
 
+/** @category Renderers & editing */
 export type GetEditRenderer = (rowIndex: number, columnIndex: number) => CellRendererIf | undefined;

package/lib/table/renderer/edit/edit-input-pipe-for-number.d.ts

@@ -1,3 +1,4 @@
-import { editInputPipe } from './edit-input-pipe.if';
+import { editInputPipe } from './edit-input-pipe.if.js';
 
+/** @category Renderers & editing */
 export declare const editInputPipeForNumber: editInputPipe;

package/lib/table/renderer/edit/edit-input-pipe.if.d.ts

@@ -5,6 +5,8 @@
  * @param {number} rowIndex - The index of the row.
  * @param {number} columnIndex - The index of the column.
  * @returns {any|undefined} - The modified input object or undefined.
+ *
+ * @category Renderers & editing
  */
 export interface editInputPipe {
     (input: any, rowIndex: number, columnIndex: number): any | undefined;

package/lib/table/renderer/edit/input-cell-renderer.d.ts

@@ -1,9 +1,10 @@
-import { CellRendererIf } from '../cell-render.if';
-import { AreaIdent } from '../../data/tablemodel/area-ident.type';
-import { AreaModelIf } from '../../data/tablemodel/areamodel/area-model.if';
-import { DomServiceIf } from '../../service/dom-service.if';
-import { RendererCleanupFnType } from '../renderer-cleanup-fn.type';
+import { CellRendererIf } from '../cell-render.if.js';
+import { AreaIdent } from '../../data/tablemodel/area-ident.type.js';
+import { AreaModelIf } from '../../data/tablemodel/areamodel/area-model.if.js';
+import { DomServiceIf } from '../../service/dom-service.if.js';
+import { RendererCleanupFnType } from '../renderer-cleanup-fn.type.js';
 
+/** @category Renderers & editing */
 export declare class InputCellRenderer implements CellRendererIf {
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, areaModel: AreaModelIf, _cellValue: any, domService: DomServiceIf): RendererCleanupFnType | undefined;
 }