@guiexpert/table 1.1.90 → 1.1.91

package/lib/table/data/div-scope.type.d.ts

@@ -6,6 +6,8 @@
  *   child: HTMLDivElement,
  *   cache: { [key: number]: HTMLDivElement }
  * }} DivScope
+ *
+ * @category Area models
  */
 export type DivScope = {
     parent: HTMLDivElement;

package/lib/table/data/event/mouse-target-data.d.ts

@@ -1,6 +1,6 @@
-import { AreaIdent } from '../tablemodel/area-ident.type';
-import { AreaModelIf } from '../tablemodel/areamodel/area-model.if';
-import { TableScope } from '../../table-scope';
+import { AreaIdent } from '../tablemodel/area-ident.type.js';
+import { AreaModelIf } from '../tablemodel/areamodel/area-model.if.js';
+import { TableScope } from '../../table-scope.js';
 
 /**
  * The MouseTargetData class is used to process and provide information about user interaction, especially mouse events, with specific areas and elements of a table built using HTML Div elements, Span elements, and Input elements.
@@ -25,6 +25,8 @@ import { TableScope } from '../../table-scope';
  *
  * @example
  * const mouseTarget = new MouseTargetData(eventTarget, tableScope);
+ *
+ * @category Internals
  */
 export declare class MouseTargetData {
     rowIdx: number;

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

@@ -1,5 +1,7 @@
 /**
  * Represents geometric data with left, width, height, top coordinates and an optional index.
+ *
+ * @category Utilities
  */
 export declare class GeoData {
     left: number;

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

@@ -1,5 +1,36 @@
-import { AutoRestoreOptionsIf } from './auto-restore-options.if';
+import { AutoRestoreOptionsIf } from './auto-restore-options.if.js';
 
+/**
+ * Defaults for {@link TableOptionsIf.autoRestoreOptions}: everything off. Spread it and switch on what the table
+ * should remember in `localStorage` (one key per table).
+ *
+ * @example
+ * const tableOptions: TableOptionsIf = {
+ *   ...new TableOptions(),
+ *   autoRestoreOptions: {
+ *     ...new AutoRestoreOptions<Order>(),
+ *     getStorageKeyFn: () => "orders-table",          // unique per table
+ *     autoRestoreSortingState: true,
+ *     autoRestoreScrollPosition: true
+ *   }
+ * };
+ *
+ * @example
+ * // trees: remember expanded nodes – needs a stable id per node
+ * const treeOptions: TableOptionsIf = {
+ *   ...new TableOptions(),
+ *   autoRestoreOptions: {
+ *     ...new AutoRestoreOptions<OrderNode>(),
+ *     getStorageKeyFn: () => "order-tree",
+ *     getRowId: (node: OrderNode) => node.id,
+ *     autoRestoreCollapsedExpandedState: true
+ *   }
+ * };
+ *
+ * @see Training: [Remember the state](https://gui.expert/training/persist-state/)
+ *
+ * @category Options
+ */
 export declare class AutoRestoreOptions<T> implements AutoRestoreOptionsIf<T> {
     autoRestoreSortingState: boolean;
     autoRestoreCollapsedExpandedState: boolean;

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

@@ -14,6 +14,8 @@
  * @param {AutoRestoreOptionsIf<T>} optionsIf - The options that dictate the behavior of auto-restoring.
  *
  * @returns {boolean} - Returns `true` if the two instances are considered the same, `false` otherwise.
+ *
+ * @category Options
  */
 export type IsSameFn<T> = (r1: T, r2: T, optionsIf: AutoRestoreOptionsIf<T>) => boolean;
 /**
@@ -22,12 +24,16 @@ export type IsSameFn<T> = (r1: T, r2: T, optionsIf: AutoRestoreOptionsIf<T>) =>
  * AutoRestoreOptionsIf interface.
  * @typedef
  * @typeparam T - The type of the object that the function is going to use.
+ *
+ * @category Options
  */
 export type GetRowIdFn<T> = ((row: T) => string | number);
 /**
  * GetStorageKeyFn is a type alias for a function that returns a unique key (as a string) for storage.
  * It is used for restoring state in conjunction with the AutoRestoreOptionsIf interface.
  * @typedef
+ *
+ * @category Options
  */
 export type GetStorageKeyFn = (() => string);
 /**
@@ -60,6 +66,8 @@ export type GetStorageKeyFn = (() => string);
  *
  * @property {(r1: T, r2: T, optionsIf: AutoRestoreOptionsIf<T>) => boolean} isSame - Function for checking
  * if two instances of T are considered the same when restoring state. If not provided, strict equality check (===) will be used.
+ *
+ * @category Options
  */
 export interface AutoRestoreOptionsIf<T> {
     autoRestoreSortingState: boolean;

package/lib/table/data/options/default-row-heights.d.ts

@@ -1,8 +1,26 @@
-import { DefaultRowHeightsIf } from './default-row-heights.if';
+import { DefaultRowHeightsIf } from './default-row-heights.if.js';
 
+/**
+ * Row heights of header, body and footer in px – default 34 each. Used in {@link TableOptionsIf.defaultRowHeights}
+ * and {@link CreateTableModelPara.defaultRowHeights}.
+ *
+ * @example
+ * const tableOptions: TableOptionsIf = { ...new TableOptions(), defaultRowHeights: new DefaultRowHeights(40, 30, 36) };
+ *
+ * @category Options
+ */
 export declare class DefaultRowHeights implements DefaultRowHeightsIf {
+    /** Height of header rows in px. */
     header: number;
+    /** Height of body rows in px. */
     body: number;
+    /** Height of footer rows in px. */
     footer: number;
-    constructor(header?: number, body?: number, footer?: number);
+    constructor(
+    /** Height of header rows in px. */
+    header?: number, 
+    /** Height of body rows in px. */
+    body?: number, 
+    /** Height of footer rows in px. */
+    footer?: number);
 }

package/lib/table/data/options/default-row-heights.if.d.ts

@@ -7,6 +7,8 @@
  * @property `body`: It sets the height of the body rows present in the table. This value can be individually adjusted by developers.
  * @property `footer`: This property represents the height of the table footer row. It has a mutable value that can be modified as per requirements.
  *
+ * See {@link DefaultRowHeights} for the defaults (34 px each).
+ *
  * @example
  * // declaring a variable with default row heights
  * let rowHeights: DefaultRowHeightsIf = {
@@ -14,8 +16,9 @@
  *     body: 100,
  *     footer: 60
  * };
+
  *
- * For implementation details, refer to the `DefaultRowHeights` class.
+ * @category Options
  */
 export interface DefaultRowHeightsIf {
     header: number;

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

@@ -1,6 +1,7 @@
-import { IconIf } from './icon.if';
-import { HeaderGroupOptionsIf } from './header-group-options.if';
+import { IconIf } from './icon.if.js';
+import { HeaderGroupOptionsIf } from './header-group-options.if.js';
 
+/** @category Header groups */
 export declare class HeaderGroupOptions implements HeaderGroupOptionsIf {
     iconExpanded: IconIf;
     iconCollapsed: IconIf;

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

@@ -1,4 +1,4 @@
-import { IconIf } from './icon.if';
+import { IconIf } from './icon.if.js';
 
 /**
  * The `HeaderGroupOptionsIf` interface is part of the TypeScript project,
@@ -32,10 +32,9 @@ import { IconIf } from './icon.if';
  *     classes: ["my-collapsed-icon-class"]
  *   }
  * };
+
  *
- * This example creates an object conforming to the `HeaderGroupOptionsIf`
- * interface where `iconExpanded` and `iconCollapsed` each hold the specifications
- * for the expanded and collapsed states of a header group component respectively.
+ * @category Header groups
  */
 export interface HeaderGroupOptionsIf {
     iconExpanded: IconIf;

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

@@ -1,5 +1,6 @@
-import { IconIf } from './icon.if';
+import { IconIf } from './icon.if.js';
 
+/** @category Options */
 export declare class Icon implements IconIf {
     content: string;
     style: string;

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

@@ -10,6 +10,8 @@
  * )
  *
  * @interface
+ *
+ * @category Options
  */
 export interface IconIf {
     content: string;

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

@@ -1,6 +1,7 @@
-import { IconIf } from './icon.if';
-import { SortedOptionsIf } from './sorted-options.if';
+import { IconIf } from './icon.if.js';
+import { SortedOptionsIf } from './sorted-options.if.js';
 
+/** @category Options */
 export declare class SortedOptions implements SortedOptionsIf {
     iconAsc: IconIf;
     iconDesc: IconIf;

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

@@ -1,4 +1,4 @@
-import { IconIf } from './icon.if';
+import { IconIf } from './icon.if.js';
 
 /**
  * This TypeScript interface, `SortedOptionsIf`, represents the configuration options for sorting.
@@ -21,6 +21,8 @@ import { IconIf } from './icon.if';
  * Note that the `classes` property in `IconIf` expects an array of strings, each string indicating a CSS class that should be applied to the icon.
  *
  * @interface
+ *
+ * @category Options
  */
 export interface SortedOptionsIf {
     iconAsc: IconIf;

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

@@ -1,18 +1,34 @@
-import { DefaultRowHeightsIf } from './default-row-heights.if';
-import { TableOptionsIf } from './table-options.if';
-import { TreeOptions } from './tree-options';
-import { FilterFunction } from '../common/filter-function';
-import { SortState } from '../common/sort-state.type';
-import { SortedOptions } from './sorted-options';
-import { GetEditRenderer } from '../../renderer/edit/edit-cell-renderer.type';
-import { SelectionModelIf } from '../../selection/selection-model.if';
-import { GetT } from '../common/get-t';
-import { FocusModelIf } from '../../focus/focus-model.if';
-import { ShortcutActionIdMapping } from '../../action/shortcut-actionid-mapping.type';
-import { HeaderGroupOptions } from './header-group-options';
+import { DefaultRowHeightsIf } from './default-row-heights.if.js';
+import { TableOptionsIf } from './table-options.if.js';
+import { TreeOptions } from './tree-options.js';
+import { FilterFunction } from '../common/filter-function.js';
+import { SortState } from '../common/sort-state.type.js';
+import { SortedOptions } from './sorted-options.js';
+import { GetEditRenderer } from '../../renderer/edit/edit-cell-renderer.type.js';
+import { SelectionModelIf } from '../../selection/selection-model.if.js';
+import { GetT } from '../common/get-t.js';
+import { FocusModelIf } from '../../focus/focus-model.if.js';
+import { ShortcutActionIdMapping } from '../../action/shortcut-actionid-mapping.type.js';
+import { HeaderGroupOptions } from './header-group-options.js';
+import { AriaTextsIf } from '../../aria/aria-texts.if.js';
 
 /**
- * TableOptions class provides configuration options for the table.
+ * All default options of a table – see {@link TableOptionsIf} for the meaning of each field.
+ *
+ * Use it with the spread pattern: all defaults, plus your changes.
+ *
+ * @example
+ * const tableOptions: TableOptionsIf = {
+ *   ...new TableOptions(),
+ *   hoverColumnVisible: false,
+ *   verticalBorderVisible: false,
+ *   defaultRowHeights: { header: 40, body: 30, footer: 36 },
+ *   externalFilterFunction: (order: Order) => order.total > 1000
+ * };
+ *
+ * @see Training: [TableOptions: behaviour and look](https://gui.expert/training/table-options/)
+ *
+ * @category Options
  */
 export declare class TableOptions implements TableOptionsIf {
     overflowX: "auto" | "scroll";
@@ -53,4 +69,12 @@ export declare class TableOptions implements TableOptionsIf {
      * Focus model of the table. Not set (default): every table creates its own `new FocusModel("cell")`.
      */
     getFocusModel?: GetT<FocusModelIf>;
+    /** Accessible name of the table (`aria-label`). Default: none. @since 1.1.91 */
+    ariaLabel?: string;
+    /** Id of the element that names the table (`aria-labelledby`). Default: none. @since 1.1.91 */
+    ariaLabelledBy?: string;
+    /** Id of the element that describes the table (`aria-describedby`). Default: none. @since 1.1.91 */
+    ariaDescribedBy?: string;
+    /** Own screen reader texts; missing functions use the English defaults ({@link AriaTexts}). @since 1.1.91 */
+    ariaTexts?: Partial<AriaTextsIf>;
 }

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

@@ -1,15 +1,16 @@
-import { DefaultRowHeightsIf } from './default-row-heights.if';
-import { TreeOptionsIf } from './tree-options.if';
-import { FilterFunction } from '../common/filter-function';
-import { SortState } from '../common/sort-state.type';
-import { SortedOptionsIf } from './sorted-options.if';
-import { AutoRestoreOptionsIf } from './auto-restore-options.if';
-import { GetEditRenderer } from '../../renderer/edit/edit-cell-renderer.type';
-import { SelectionModelIf } from '../../selection/selection-model.if';
-import { GetT } from '../common/get-t';
-import { FocusModelIf } from '../../focus/focus-model.if';
-import { ShortcutActionIdMapping } from '../../action/shortcut-actionid-mapping.type';
-import { HeaderGroupOptionsIf } from './header-group-options.if';
+import { DefaultRowHeightsIf } from './default-row-heights.if.js';
+import { TreeOptionsIf } from './tree-options.if.js';
+import { FilterFunction } from '../common/filter-function.js';
+import { SortState } from '../common/sort-state.type.js';
+import { SortedOptionsIf } from './sorted-options.if.js';
+import { AutoRestoreOptionsIf } from './auto-restore-options.if.js';
+import { GetEditRenderer } from '../../renderer/edit/edit-cell-renderer.type.js';
+import { SelectionModelIf } from '../../selection/selection-model.if.js';
+import { GetT } from '../common/get-t.js';
+import { FocusModelIf } from '../../focus/focus-model.if.js';
+import { ShortcutActionIdMapping } from '../../action/shortcut-actionid-mapping.type.js';
+import { HeaderGroupOptionsIf } from './header-group-options.if.js';
+import { AriaTextsIf } from '../../aria/aria-texts.if.js';
 
 /**
  * Represents the options for configuring a table.
@@ -46,6 +47,20 @@ import { HeaderGroupOptionsIf } from './header-group-options.if';
  * | getSelectionModel                | Retrieves the selection model for a specific object.                                              |
  * | getFocusModel                    | Retrieves the focus model of the component.                                                       |
  * | shortcutActionIdMapping          | Represents a mapping of shortcut action IDs.                                                     |
+ *
+ * Start from the defaults in {@link TableOptions} and change only what you need.
+ *
+ * @example
+ * const tableOptions: TableOptionsIf = {
+ *   ...new TableOptions(),
+ *   hoverColumnVisible: false,
+ *   columnsDraggable: false,
+ *   defaultRowHeights: { header: 40, body: 30, footer: 36 }
+ * };
+ *
+ * @see Training: [TableOptions: behaviour and look](https://gui.expert/training/table-options/)
+ *
+ * @category Options
  */
 export interface TableOptionsIf {
     /**
@@ -160,72 +175,130 @@ export interface TableOptionsIf {
      */
     footerVerticalSeparator: boolean;
     /**
-     * Represents the default row heights (for header, body and footer) for a given table.
-     *
-     * @typedef {number[]} DefaultRowHeightsIf
-     * @description An array of numbers representing the default height for each row in a table.
+     * Row heights of header, body and footer in px (default 34 / 34 / 34). Read by {@link TableFactory.createTableModel}
+     * when it creates the area models – pass the options there as `tableOptions`, too.
      */
     defaultRowHeights: DefaultRowHeightsIf;
+    /** Reserved – currently not evaluated (tree tables always show the expand-all / collapse-all icon in the top left header cell). */
     headerToggleExpandCollapseIcons: boolean;
+    /** Icons and behaviour of tree tables (arrows, indentation). See {@link TreeOptionsIf}. */
     treeOptions: TreeOptionsIf;
+    /** Icons of collapsible header groups ({@link AreaModelCellGroups}). */
     headerGroupOptions: HeaderGroupOptionsIf;
     /**
      * Indicates whether to show checkbox without an extra column.
      * If true and the row is checkable, a checkbox is rendered in the first column.
      * If false and the row is checkable, a checkbox is rendered in an extra column left to the first column.
      *
-     * @type {boolean}
+     * @see Training: [Tree table with checkboxes](https://gui.expert/training/tree-table/)
      */
     showCheckboxWihoutExtraColumn: boolean;
     /**
-     * Represents the external filter function that will be used to filter the table rows.
+     * Your filter: called for every row, return `true` to show it. After changing the filter criteria call
+     * {@link TableApi.externalFilterChanged} – the table filters again and keeps the sort order.
      *
-     * @typedef {FilterFunction<any> | undefined} externalFilterFunction
+     * @example
+     * const filter = { text: "" };
+     * const tableOptions: TableOptionsIf = {
+     *   ...new TableOptions(),
+     *   externalFilterFunction: (order: Order) => order.customer.toLowerCase().includes(filter.text)
+     * };
+     * searchInput.addEventListener("input", () => {
+     *   filter.text = searchInput.value.toLowerCase();
+     *   tableApi.externalFilterChanged();
+     * });
+     *
+     * @see Training: [Filtering with a live search](https://gui.expert/training/filtering/)
      */
     externalFilterFunction: FilterFunction<any> | undefined;
+    /** The sort icons shown in sortable header cells. */
+    sortedOptions: SortedOptionsIf;
     /**
-     * Represents a sorted options object.
-     *
-     * @class
-     * @classdesc The SortedOptions represents a class that defines sorted icons, which will displayed in the header (if column is sortable).
+     * The order of the sort states on repeated double-clicks on a header, default `["asc", "desc"]`.
+     * Add `""` to get "unsorted" as third state. Per column: {@link ColumnDefIf.sortStatesOrder}.
      */
-    sortedOptions: SortedOptionsIf;
+    sortOrder: SortState[];
     /**
-     * Represents the sort order of the columns.
+     * Remember sorting, scroll position and expanded tree nodes in `localStorage`. Off by default.
      *
-     * @typedef {SortState[]} sortOrder
+     * @see {@link AutoRestoreOptions}
+     * @see Training: [Remember the state](https://gui.expert/training/persist-state/)
      */
-    sortOrder: SortState[];
     autoRestoreOptions?: AutoRestoreOptionsIf<any>;
     /**
-     * Retrieves the edit renderer for a specific action.
+     * The editor for a cell, if the column has no own {@link ColumnDefIf.getEditRenderer}.
+     * Default: a text input ({@link InputCellRenderer}).
      *
-     * @function
-     * @name getEditRenderer
-     * @param {string} action - The action for which to retrieve the edit renderer.
-     * @returns {GetEditRenderer} - The edit renderer for the specified action.
+     * @see Training: [Inline editing](https://gui.expert/training/inline-editing/)
      */
     getEditRenderer?: GetEditRenderer;
     /**
-     * Retrieves the selection model for a specific object.
+     * Returns the selection model of the table. Without it every table creates its own `new SelectionModel()`
+     * of type `"none"` – nothing can be selected.
      *
-     * @param {SelectionModelIf} targetObj - The target object to retrieve the selection model from.
-     * @return {GetT<SelectionModelIf>} - The selection model for the given object.
+     * @example
+     * const selectionModel = new SelectionModel("row", "single");
+     * const tableOptions: TableOptionsIf = { ...new TableOptions(), getSelectionModel: () => selectionModel };
+     *
+     * @see Training: [Select cells, rows and ranges](https://gui.expert/training/selection-and-copy/)
      */
     getSelectionModel?: GetT<SelectionModelIf>;
+    /** Returns the focus model of the table. Default: every table creates its own {@link FocusModel}. */
+    getFocusModel?: GetT<FocusModelIf>;
     /**
-     * Retrieves the focus model of the component.
+     * Own keyboard shortcuts: maps a shortcut (e.g. `"ctrl+c"`, `"f2"`) to an {@link ActionId}.
+     * Default: {@link WindowsShortcutActionIdMapping} resp. {@link OsxShortcutActionIdMapping}.
+     */
+    shortcutActionIdMapping?: ShortcutActionIdMapping;
+    /** Switch off all keyboard shortcuts of the table (copy, select all, navigation, F2 …). */
+    shortcutActionsDisabled: boolean;
+    /**
+     * The accessible name of the table for screen readers (`aria-label` of the grid), e.g. `"Orders"`.
+     * Prefer {@link ariaLabelledBy} if the page shows a title.
      *
-     * @returns {GetT<FocusModelIf>} The focus model of the component.
+     * @example
+     * const tableOptions: TableOptionsIf = { ...new TableOptions(), ariaLabel: "Orders" };
+     *
+     * @since 1.1.91
+     * @see Training: [Accessible tables: keyboard and screen readers](https://gui.expert/training/accessibility/)
      */
-    getFocusModel?: GetT<FocusModelIf>;
+    ariaLabel?: string;
     /**
-     * Represents a mapping of shortcut action IDs.
+     * The id of the element that names the table, e.g. a heading above it (`aria-labelledby` of the grid).
+     * Takes precedence over {@link ariaLabel}.
      *
-     * @typedef {Object} ShortcutActionIdMapping
-     * @property {string} [shortcutId] - The ID of the shortcut.
-     * @property {string} [actionId] - The ID of the action associated with the shortcut.
+     * @example
+     * // <h2 id="orders-title">Orders 2026</h2> <div class="table-div"></div>
+     * const tableOptions: TableOptionsIf = { ...new TableOptions(), ariaLabelledBy: "orders-title" };
+     *
+     * @since 1.1.91
      */
-    shortcutActionIdMapping?: ShortcutActionIdMapping;
-    shortcutActionsDisabled: boolean;
+    ariaLabelledBy?: string;
+    /**
+     * The id of an element that describes the table, e.g. a hint below it (`aria-describedby` of the grid).
+     *
+     * @example
+     * // <p id="orders-hint">Double click a header to sort.</p>
+     * const tableOptions: TableOptionsIf = { ...new TableOptions(), ariaDescribedBy: "orders-hint" };
+     *
+     * @since 1.1.91
+     */
+    ariaDescribedBy?: string;
+    /**
+     * Own texts for screen readers – announcements (sorting, filter, copy, select all) and the names of the row
+     * checkboxes and header group toggles. Functions you leave out keep their English default ({@link AriaTexts}).
+     *
+     * @example
+     * const tableOptions: TableOptionsIf = {
+     *   ...new TableOptions(),
+     *   ariaTexts: {
+     *     filtered: (rowCount: number) => `${rowCount} Zeilen`,
+     *     copied: (cellCount: number) => `${cellCount} Zellen kopiert`,
+     *     selectRow: (rowNumber: number) => `Zeile ${rowNumber} auswählen`,
+     *   },
+     * };
+     *
+     * @since 1.1.91
+     */
+    ariaTexts?: Partial<AriaTextsIf>;
 }

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

@@ -1,6 +1,7 @@
-import { IconIf } from './icon.if';
-import { TreeOptionsIf } from './tree-options.if';
+import { IconIf } from './icon.if.js';
+import { TreeOptionsIf } from './tree-options.if.js';
 
+/** @category Options */
 export declare class TreeOptions implements TreeOptionsIf {
     arrowExpanded: IconIf;
     arrowCollapsed: IconIf;

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

@@ -1,4 +1,4 @@
-import { IconIf } from './icon.if';
+import { IconIf } from './icon.if.js';
 
 /**
  * This interface `TreeOptionsIf` represents the specific configuration and properties of a tree component, usually displayed in a User Interface (UI).
@@ -40,6 +40,8 @@ import { IconIf } from './icon.if';
  *     classes: ['placeholder-icon-class'],
  *   },
  * };
+ *
+ * @category Options
  */
 export interface TreeOptionsIf {
     arrowExpandCollapseAll: IconIf;

package/lib/table/data/side-ident.type.d.ts

@@ -24,5 +24,7 @@
  * @see TableModel
  * @see AreaModelIf
  * @type {("west"|"center"|"east")}
+ *
+ * @category Area models
  */
 export type SideIdent = "west" | "center" | "east";

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

@@ -1,9 +1,11 @@
-import { TableModelAndOptionsIf } from './table-model-and-options.if';
-import { TableModelIf } from './tablemodel/table-model.if';
-import { TableOptions } from './options/table-options';
+import { TableModelAndOptionsIf } from './table-model-and-options.if.js';
+import { TableModelIf } from './tablemodel/table-model.if.js';
+import { TableOptions } from './options/table-options.js';
 
 /**
  * Container object for one table model and one table options object.
+ *
+ * @category Table model
  */
 export declare class TableModelAndOptions implements TableModelAndOptionsIf {
     tableModel: TableModelIf;

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

@@ -1,8 +1,10 @@
-import { TableModelIf } from './tablemodel/table-model.if';
-import { TableOptions } from './options/table-options';
+import { TableModelIf } from './tablemodel/table-model.if.js';
+import { TableOptions } from './options/table-options.js';
 
 /**
  * Interface for a container object for one table model and one table options object.
+ *
+ * @category Table model
  */
 export interface TableModelAndOptionsIf {
     tableModel: TableModelIf;

package/lib/table/data/tablemodel/area-ident.type.d.ts

@@ -1,9 +1,13 @@
 /**
  * The AreaIdent is an identifier for the three areas : header, body, and footer.
+ *
+ * @category Area models
  */
 export type AreaIdent = "header" | "body" | "footer";
 /**
  * Converts a string to the identifier of type AreaIdent.
  * @param s should be "header"|"body"|"footer". The fallback return value is 'body'
+ *
+ * @category Area models
  */
 export declare const getAreaIdentByString: (s: string | null) => AreaIdent;

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

@@ -1,13 +1,14 @@
-import { CellRendererIf } from '../../../renderer/cell-render.if';
-import { AreaModelIf } from './area-model.if';
-import { CheckedType } from '../../common/checked-type';
-import { ColumnDefIf } from '../column/column-def.if';
-import { AreaIdent } from '../area-ident.type';
-import { CheckboxModelIf } from '../../../checkbox/checkbox-model.if';
-import { FilterFunction } from '../../common/filter-function';
-import { SortItem } from '../../common/sort-item';
-import { HasDefaultRowHeightIf } from './has-default-row-height-if';
+import { CellRendererIf } from '../../../renderer/cell-render.if.js';
+import { AreaModelIf } from './area-model.if.js';
+import { CheckedType } from '../../common/checked-type.js';
+import { ColumnDefIf } from '../column/column-def.if.js';
+import { AreaIdent } from '../area-ident.type.js';
+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';
 
+/** @category Area models */
 export declare abstract class AbstractAreaModel<T> implements AreaModelIf, HasDefaultRowHeightIf {
     areaIdent: AreaIdent;
     protected columnDefs: ColumnDefIf[];

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

@@ -1,11 +1,13 @@
-import { AbstractAreaModel } from './abstract-area-model';
-import { AreaIdent } from '../area-ident.type';
-import { ColumnDefIf } from '../column/column-def.if';
-import { FilterFunction } from '../../common/filter-function';
+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';
 
 /**
  * Represents a model for an area containing a two-dimensional array of data.
  * @template T - The type of data in the array.
+ *
+ * @category Area models
  */
 export declare class AreaModelArrayOfArrays<T> extends AbstractAreaModel<T[][]> {
     areaIdent: AreaIdent;