@guiexpert/table 1.1.89 → 1.1.91

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

@@ -1,25 +1,28 @@
-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 { 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;
@@ -59,11 +62,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,13 +124,21 @@ 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.
@@ -225,6 +252,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 +395,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 +456,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;
 }

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

@@ -1,10 +1,11 @@
-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 { ValueLabelIf } from '../../data/common/value-label.if';
+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 { ValueLabelIf } from '../../data/common/value-label.if.js';
 
+/** @category Renderers & editing */
 export declare class SelectCellRenderer implements CellRendererIf {
     protected options: ValueLabelIf[];
     constructor(options: ValueLabelIf[]);

package/lib/table/renderer/male-female-to-icon-cell-renderer.d.ts

@@ -1,9 +1,22 @@
-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 MaleFemaleToIconCellRenderer implements CellRendererIf {
-    render(cellDiv: HTMLDivElement, _rowIndex: number, _columnIndex: number, _areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, _domService: DomServiceIf): RendererCleanupFnType | undefined;
+    ariaLabels: {
+        male: string;
+        female: string;
+    };
+    /**
+     * @param ariaLabels - texts for screen readers (the symbols ♂ / ♀ are images). Default: "male" / "female". @since 1.1.91
+     */
+    constructor(ariaLabels?: {
+        male: string;
+        female: string;
+    });
+    render(cellDiv: HTMLDivElement, _rowIndex: number, _columnIndex: number, _areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, domService: DomServiceIf): RendererCleanupFnType | undefined;
+    private addSymbol;
 }

package/lib/table/renderer/number-cell-progress-bar-cell-renderer.d.ts

@@ -1,12 +1,17 @@
-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';
 
+/** @category Renderers & editing */
 export declare class NumberCellProgressBarCellRenderer<T> implements CellRendererIf {
     maxValue: number;
     labelVisible: boolean;
-    constructor(maxValue?: number, labelVisible?: boolean);
+    /** Text for screen readers (the bar is an image). Default: `"75 %"`. @since 1.1.91 */
+    ariaLabel: (percent: number, value: number) => string;
+    constructor(maxValue?: number, labelVisible?: boolean, 
+    /** Text for screen readers (the bar is an image). Default: `"75 %"`. @since 1.1.91 */
+    ariaLabel?: (percent: number, value: number) => string);
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, _areaModel: AreaModelObjectArray<T>, cellValue: number, domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/number-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 NumberCellRenderer implements CellRendererIf {
     protected min: number;
     protected max: number;

package/lib/table/renderer/positive-and-negative-number-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 PositiveAndNegativeNumberRenderer implements CellRendererIf {
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, _areaModel: AreaModelIf, cellValue: any, domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/progress-bar-cell-renderer.d.ts

@@ -1,16 +1,22 @@
-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 ProgressBarCellRenderer<T> implements CellRendererIf {
     property: string;
     maxValue: number;
     labelVisible: boolean;
-    constructor(property: string, maxValue?: number, labelVisible?: boolean);
+    /** Text for screen readers (the bar is an image). Default: `"75 %"`. @since 1.1.91 */
+    ariaLabel: (percent: number, value: number) => string;
+    constructor(property: string, maxValue?: number, labelVisible?: boolean, 
+    /** Text for screen readers (the bar is an image). Default: `"75 %"`. @since 1.1.91 */
+    ariaLabel?: (percent: number, value: number) => string);
     render(cellDiv: HTMLDivElement, rowIndex: number, columnIndex: number, areaIdent: AreaIdent, areaModel: AreaModelObjectArray<T>, _cellValue: any, domService: DomServiceIf): RendererCleanupFnType | undefined;
 }

package/lib/table/renderer/renderer-cleanup-fn.type.d.ts

@@ -1 +1,2 @@
+/** @category Renderers & editing */
 export type RendererCleanupFnType = Function;

package/lib/table/renderer/renderer.d.ts

@@ -1,6 +1,7 @@
-import { CellRendererIf } from './cell-render.if';
-import { AreaObjectMap } from '../data/common/area-map';
+import { CellRendererIf } from './cell-render.if.js';
+import { AreaObjectMap } from '../data/common/area-map.js';
 
+/** @category Renderers & editing */
 export declare class Renderer {
     static bodyRenderer(bodyCellRenderer: CellRendererIf): AreaObjectMap<CellRendererIf>;
 }