@guiexpert/preact-table 10.1.98 → 10.1.100

package/GuiexpertTable.d.ts

@@ -1,5 +1,5 @@
 import { Component } from 'preact';
-import { FocusModelIf, GeModelChangeEvent, GeBatchEditEvent, GeDetailEvent, GeMouseEvent, GeRowDragEvent, GeScrollEvent, GeStateChangeEvent, SelectionModelIf, TableApi, TableModelIf, TableOptions } from '@guiexpert/table';
+import { FocusModelIf, GeModelChangeEvent, GeBatchEditEvent, GeDetailEvent, GeEditEvent, GeUndoEvent, GeMouseEvent, GeRowDragEvent, GeScrollEvent, GeStateChangeEvent, SelectionModelIf, TableApi, TableModelIf, TableOptions } from '@guiexpert/table';
 
 export type GeMouseEventFn = (evt: GeMouseEvent) => void;
 export type GeCheckboxEventFn = (evt: any[]) => void;
@@ -12,6 +12,8 @@ export type GeStateChangeEventFn = (evt: GeStateChangeEvent) => void;
 export type GeRowDragEventFn = (evt: GeRowDragEvent) => void;
 export type GeBatchEditEventFn = (evt: GeBatchEditEvent) => void;
 export type GeDetailEventFn = (evt: GeDetailEvent) => void;
+export type GeEditEventFn = (evt: GeEditEvent) => void;
+export type GeUndoEventFn = (evt: GeUndoEvent) => void;
 export interface GuiexpertTableProps {
     tableModel: TableModelIf;
     tableOptions?: TableOptions;
@@ -41,6 +43,10 @@ export interface GuiexpertTableProps {
     batchEditChanged?: GeBatchEditEventFn;
     /** Master/detail: a detail row was expanded or collapsed (since 1.1.97). */
     detailExpandedChanged?: GeDetailEventFn;
+    /** The cell editor opened, its text changed, it committed or it was cancelled (since 1.1.99). */
+    editingChanged?: GeEditEventFn;
+    /** The undo history changed (since 1.1.99). */
+    undoStackChanged?: GeUndoEventFn;
     /**
      * `true` shows the loading overlay ("Loading…" with a CSS spinner) over the body, `false` hides it.
      * Changing it does **not** re-create the table. Texts: `tableOptions.overlayOptions`. @since 1.1.92

package/README.md

@@ -37,6 +37,25 @@ This is the UI-agnostic table component for your next web app. 😊
 - Full control over the HTML structure and style
 
 
+### New in October 2026 (1.1.91 – 1.1.99) – all MIT-licensed
+
+- Screen readers and keyboard: WAI-ARIA grid, announcements, full keyboard navigation (1.1.91)
+- “Loading…” and “No rows” overlays with a CSS spinner, `loading` prop (1.1.92)
+- Save and restore the state: column layout, sorting, scroll position, selection – localStorage or your server (1.1.92)
+- Row numbers like in a spreadsheet: `rowNumbersVisible: true` (1.1.93)
+- Total rows that follow the filter, sums of the selection: `footerAggregates` (1.1.94)
+- Row grouping with subtotals: `RowGroupFactory` (1.1.94)
+- Pivot tables: `PivotFactory` (1.1.94)
+- Calculated columns, “Show values as” and formulas without `eval`: `valueGetter`, `showValuesAs`, `formula` (1.1.95)
+- Drag rows into order – mouse, touch, keyboard: `rowDrag: true` (1.1.95)
+- Fill handle and batch edit: `fillHandle`, `batchEdit` (1.1.96)
+- Master/detail with nested tables or components: `masterDetail` (1.1.97)
+- Right-to-left for Arabic, Hebrew, Persian: `direction: "rtl"` (1.1.98)
+- A spreadsheet: A1 cell formulas, copy & paste with Excel, undo/redo, formula bar – `SpreadsheetFactory`, or `spreadsheet: true` for your table (1.1.99)
+
+All of them with code and live demos: [gui.expert/whats-new](https://gui.expert/whats-new/) ·
+training: [gui.expert/training](https://gui.expert/training/)
+
 ## Links
 
 - [Demos](https://gui.expert/demos)

package/index.cjs

@@ -1 +1 @@
-"use strict";var u=Object.defineProperty;var b=(s,a,o)=>a in s?u(s,a,{enumerable:!0,configurable:!0,writable:!0,value:o}):s[a]=o;var h=(s,a,o)=>b(s,typeof a!="symbol"?a+"":a,o);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const C=require("preact/jsx-runtime"),l=require("preact"),c=require("@guiexpert/table");class m extends l.Component{constructor(o){super(o);h(this,"ref",l.createRef());h(this,"tableScope");h(this,"shownByProp",!1)}componentDidMount(){const o=this.ref.current;o&&this.initTable(o,this.props)}componentDidUpdate(o){const i=this.ref.current;i&&(o.tableModel!==this.props.tableModel||o.tableOptions!==this.props.tableOptions)&&this.initTable(i,this.props),!!o.loading!=!!this.props.loading&&this.applyLoading(),this.props.licenseKey&&this.props.licenseKey!==o.licenseKey&&c.LicenseManager.getInstance().setLicenseKey(this.props.licenseKey)}componentWillUnmount(){this.destroyTable()}initTable(o,i){var g;this.destroyTable();const r=()=>this.props,p={onSelectionChanged:t=>{var e,n;return(n=(e=r()).selectionChanged)==null?void 0:n.call(e,t)},onFocusChanged:t=>{var e,n;return(n=(e=r()).focusChanged)==null?void 0:n.call(e,t)},onScroll:t=>{var e,n;return(n=(e=r()).scroll)==null?void 0:n.call(e,t)},onCheckboxChanged:t=>{var e,n;return(n=(e=r()).checkboxChanged)==null?void 0:n.call(e,t)},onContextmenu:t=>{var e,n;return(n=(e=r()).contextmenu)==null?void 0:n.call(e,t)},onModelChanged:t=>{var e,n;return(n=(e=r()).modelChanged)==null?void 0:n.call(e,t)},onMouseClicked:t=>{var e,n;return(n=(e=r()).mouseClicked)==null?void 0:n.call(e,t)},onMouseDragging:t=>{var e,n;return(n=(e=r()).mouseDragging)==null?void 0:n.call(e,t)},onMouseDraggingEnd:t=>{var e,n;return(n=(e=r()).mouseDraggingEnd)==null?void 0:n.call(e,t)},onMouseMoved:t=>{var e,n;return(n=(e=r()).mouseMoved)==null?void 0:n.call(e,t)},onStateChanged:t=>{var e,n;return(n=(e=r()).stateChanged)==null?void 0:n.call(e,t)},onRowDragStart:t=>{var e,n;return(n=(e=r()).rowDragStart)==null?void 0:n.call(e,t)},onRowDragMove:t=>{var e,n;return(n=(e=r()).rowDragMove)==null?void 0:n.call(e,t)},onRowDragEnd:t=>{var e,n;return(n=(e=r()).rowDragEnd)==null?void 0:n.call(e,t)},onBatchEditChanged:t=>{var e,n;return(n=(e=r()).batchEditChanged)==null?void 0:n.call(e,t)},onDetailExpandedChanged:t=>{var e,n;return(n=(e=r()).detailExpandedChanged)==null?void 0:n.call(e,t)}},d=new c.TableScope(o,i.tableModel,new c.SimpleDomService,i.tableOptions??new c.TableOptions,p);this.tableScope=d,d.firstInit(),this.shownByProp=!1,this.applyLoading(),(g=i.tableReady)==null||g.call(i,d.getApi()),i.licenseKey&&c.LicenseManager.getInstance().setLicenseKey(i.licenseKey)}applyLoading(){var o,i;this.props.loading?((o=this.tableScope)==null||o.showLoadingOverlay(),this.shownByProp=!0):this.shownByProp&&((i=this.tableScope)==null||i.hideOverlay(),this.shownByProp=!1)}destroyTable(){var o;(o=this.tableScope)==null||o.destroy(),this.tableScope=void 0}render(){return C.jsx("div",{ref:this.ref,className:"container-div",style:{width:"100%",height:"100%",backgroundColor:"transparent",padding:"0",margin:"0"}})}}class y{constructor(a){this.Component=a}render(a,o,i,r,p,d,g){const t={cellDiv:a,rowIndex:o,columnIndex:i,areaIdent:r,areaModel:p,cellValue:d};return l.render(l.h(this.Component,t),a),()=>{l.render(null,a)}}}class f{constructor(a){this.Component=a}render(a,o,i){const r={row:o,rowIndex:i.rowIndex,tableApi:i.tableApi,context:i};return l.render(l.h(this.Component,r),a),()=>l.render(null,a)}}exports.ComponentRendererWrapper=y;exports.DetailComponentRendererWrapper=f;exports.GuiexpertTable=m;
+"use strict";var u=Object.defineProperty;var C=(s,i,o)=>i in s?u(s,i,{enumerable:!0,configurable:!0,writable:!0,value:o}):s[i]=o;var c=(s,i,o)=>C(s,typeof i!="symbol"?i+"":i,o);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("preact/jsx-runtime"),d=require("preact"),h=require("@guiexpert/table");class m extends d.Component{constructor(o){super(o);c(this,"ref",d.createRef());c(this,"tableScope");c(this,"shownByProp",!1)}componentDidMount(){const o=this.ref.current;o&&this.initTable(o,this.props)}componentDidUpdate(o){const r=this.ref.current;r&&(o.tableModel!==this.props.tableModel||o.tableOptions!==this.props.tableOptions)&&this.initTable(r,this.props),!!o.loading!=!!this.props.loading&&this.applyLoading(),this.props.licenseKey&&this.props.licenseKey!==o.licenseKey&&h.LicenseManager.getInstance().setLicenseKey(this.props.licenseKey)}componentWillUnmount(){this.destroyTable()}initTable(o,r){var g;this.destroyTable();const a=()=>this.props,p={onSelectionChanged:t=>{var e,n;return(n=(e=a()).selectionChanged)==null?void 0:n.call(e,t)},onFocusChanged:t=>{var e,n;return(n=(e=a()).focusChanged)==null?void 0:n.call(e,t)},onScroll:t=>{var e,n;return(n=(e=a()).scroll)==null?void 0:n.call(e,t)},onCheckboxChanged:t=>{var e,n;return(n=(e=a()).checkboxChanged)==null?void 0:n.call(e,t)},onContextmenu:t=>{var e,n;return(n=(e=a()).contextmenu)==null?void 0:n.call(e,t)},onModelChanged:t=>{var e,n;return(n=(e=a()).modelChanged)==null?void 0:n.call(e,t)},onMouseClicked:t=>{var e,n;return(n=(e=a()).mouseClicked)==null?void 0:n.call(e,t)},onMouseDragging:t=>{var e,n;return(n=(e=a()).mouseDragging)==null?void 0:n.call(e,t)},onMouseDraggingEnd:t=>{var e,n;return(n=(e=a()).mouseDraggingEnd)==null?void 0:n.call(e,t)},onMouseMoved:t=>{var e,n;return(n=(e=a()).mouseMoved)==null?void 0:n.call(e,t)},onStateChanged:t=>{var e,n;return(n=(e=a()).stateChanged)==null?void 0:n.call(e,t)},onRowDragStart:t=>{var e,n;return(n=(e=a()).rowDragStart)==null?void 0:n.call(e,t)},onRowDragMove:t=>{var e,n;return(n=(e=a()).rowDragMove)==null?void 0:n.call(e,t)},onRowDragEnd:t=>{var e,n;return(n=(e=a()).rowDragEnd)==null?void 0:n.call(e,t)},onBatchEditChanged:t=>{var e,n;return(n=(e=a()).batchEditChanged)==null?void 0:n.call(e,t)},onDetailExpandedChanged:t=>{var e,n;return(n=(e=a()).detailExpandedChanged)==null?void 0:n.call(e,t)},onEditingChanged:t=>{var e,n;return(n=(e=a()).editingChanged)==null?void 0:n.call(e,t)},onUndoStackChanged:t=>{var e,n;return(n=(e=a()).undoStackChanged)==null?void 0:n.call(e,t)}},l=new h.TableScope(o,r.tableModel,new h.SimpleDomService,r.tableOptions??new h.TableOptions,p);this.tableScope=l,l.firstInit(),this.shownByProp=!1,this.applyLoading(),(g=r.tableReady)==null||g.call(r,l.getApi()),r.licenseKey&&h.LicenseManager.getInstance().setLicenseKey(r.licenseKey)}applyLoading(){var o,r;this.props.loading?((o=this.tableScope)==null||o.showLoadingOverlay(),this.shownByProp=!0):this.shownByProp&&((r=this.tableScope)==null||r.hideOverlay(),this.shownByProp=!1)}destroyTable(){var o;(o=this.tableScope)==null||o.destroy(),this.tableScope=void 0}render(){return b.jsx("div",{ref:this.ref,className:"container-div",style:{width:"100%",height:"100%",backgroundColor:"transparent",padding:"0",margin:"0"}})}}class y{constructor(i){this.Component=i}render(i,o,r,a,p,l,g){const t={cellDiv:i,rowIndex:o,columnIndex:r,areaIdent:a,areaModel:p,cellValue:l};return d.render(d.h(this.Component,t),i),()=>{d.render(null,i)}}}class S{constructor(i){this.Component=i}render(i,o,r){const a={row:o,rowIndex:r.rowIndex,tableApi:r.tableApi,context:r};return d.render(d.h(this.Component,a),i),()=>d.render(null,i)}}exports.ComponentRendererWrapper=y;exports.DetailComponentRendererWrapper=S;exports.GuiexpertTable=m;

package/index.js

@@ -1,24 +1,24 @@
-var b = Object.defineProperty;
-var C = (r, s, o) => s in r ? b(r, s, { enumerable: !0, configurable: !0, writable: !0, value: o }) : r[s] = o;
-var d = (r, s, o) => C(r, typeof s != "symbol" ? s + "" : s, o);
+var m = Object.defineProperty;
+var b = (r, a, o) => a in r ? m(r, a, { enumerable: !0, configurable: !0, writable: !0, value: o }) : r[a] = o;
+var l = (r, a, o) => b(r, typeof a != "symbol" ? a + "" : a, o);
 import { jsx as u } from "preact/jsx-runtime";
-import { Component as y, createRef as f, render as h, h as m } from "preact";
+import { Component as y, createRef as f, render as h, h as C } from "preact";
 import { LicenseManager as g, TableScope as w, SimpleDomService as S, TableOptions as M } from "@guiexpert/table";
 class K extends y {
   constructor(o) {
     super(o);
-    d(this, "ref", f());
-    d(this, "tableScope");
+    l(this, "ref", f());
+    l(this, "tableScope");
     /** the overlay was shown by the loading prop: loading={false} hides only that one */
-    d(this, "shownByProp", !1);
+    l(this, "shownByProp", !1);
   }
   componentDidMount() {
     const o = this.ref.current;
     o && this.initTable(o, this.props);
   }
   componentDidUpdate(o) {
-    const a = this.ref.current;
-    a && (o.tableModel !== this.props.tableModel || o.tableOptions !== this.props.tableOptions) && this.initTable(a, this.props), !!o.loading != !!this.props.loading && this.applyLoading(), this.props.licenseKey && this.props.licenseKey !== o.licenseKey && g.getInstance().setLicenseKey(this.props.licenseKey);
+    const s = this.ref.current;
+    s && (o.tableModel !== this.props.tableModel || o.tableOptions !== this.props.tableOptions) && this.initTable(s, this.props), !!o.loading != !!this.props.loading && this.applyLoading(), this.props.licenseKey && this.props.licenseKey !== o.licenseKey && g.getInstance().setLicenseKey(this.props.licenseKey);
   }
   componentWillUnmount() {
     this.destroyTable();
@@ -27,7 +27,7 @@ class K extends y {
    * Creates the table in `ele` (a table created before is destroyed first) and calls `tableReady`.
    * The event callbacks are always taken from the current props.
    */
-  initTable(o, a) {
+  initTable(o, s) {
     var p;
     this.destroyTable();
     const i = () => this.props, c = {
@@ -94,20 +94,28 @@ class K extends y {
       onDetailExpandedChanged: (t) => {
         var e, n;
         return (n = (e = i()).detailExpandedChanged) == null ? void 0 : n.call(e, t);
+      },
+      onEditingChanged: (t) => {
+        var e, n;
+        return (n = (e = i()).editingChanged) == null ? void 0 : n.call(e, t);
+      },
+      onUndoStackChanged: (t) => {
+        var e, n;
+        return (n = (e = i()).undoStackChanged) == null ? void 0 : n.call(e, t);
       }
-    }, l = new w(
+    }, d = new w(
       o,
-      a.tableModel,
+      s.tableModel,
       new S(),
-      a.tableOptions ?? new M(),
+      s.tableOptions ?? new M(),
       c
     );
-    this.tableScope = l, l.firstInit(), this.shownByProp = !1, this.applyLoading(), (p = a.tableReady) == null || p.call(a, l.getApi()), a.licenseKey && g.getInstance().setLicenseKey(a.licenseKey);
+    this.tableScope = d, d.firstInit(), this.shownByProp = !1, this.applyLoading(), (p = s.tableReady) == null || p.call(s, d.getApi()), s.licenseKey && g.getInstance().setLicenseKey(s.licenseKey);
   }
   /** Shows or hides the loading overlay according to the `loading` prop. */
   applyLoading() {
-    var o, a;
-    this.props.loading ? ((o = this.tableScope) == null || o.showLoadingOverlay(), this.shownByProp = !0) : this.shownByProp && ((a = this.tableScope) == null || a.hideOverlay(), this.shownByProp = !1);
+    var o, s;
+    this.props.loading ? ((o = this.tableScope) == null || o.showLoadingOverlay(), this.shownByProp = !0) : this.shownByProp && ((s = this.tableScope) == null || s.hideOverlay(), this.shownByProp = !1);
   }
   /** Releases the table (listeners, resize observer, cell renderers). */
   destroyTable() {
@@ -131,21 +139,21 @@ class K extends y {
     );
   }
 }
-class L {
-  constructor(s) {
-    this.Component = s;
+class k {
+  constructor(a) {
+    this.Component = a;
   }
-  render(s, o, a, i, c, l, p) {
+  render(a, o, s, i, c, d, p) {
     const t = {
-      cellDiv: s,
+      cellDiv: a,
       rowIndex: o,
-      columnIndex: a,
+      columnIndex: s,
       areaIdent: i,
       areaModel: c,
-      cellValue: l
+      cellValue: d
     };
-    return h(m(this.Component, t), s), () => {
-      h(null, s);
+    return h(C(this.Component, t), a), () => {
+      h(null, a);
     };
   }
   // private mount(
@@ -168,17 +176,17 @@ class L {
   //   return cleanupFn;
   // }
 }
-class R {
-  constructor(s) {
-    this.Component = s;
+class L {
+  constructor(a) {
+    this.Component = a;
   }
-  render(s, o, a) {
-    const i = { row: o, rowIndex: a.rowIndex, tableApi: a.tableApi, context: a };
-    return h(m(this.Component, i), s), () => h(null, s);
+  render(a, o, s) {
+    const i = { row: o, rowIndex: s.rowIndex, tableApi: s.tableApi, context: s };
+    return h(C(this.Component, i), a), () => h(null, a);
   }
 }
 export {
-  L as ComponentRendererWrapper,
-  R as DetailComponentRendererWrapper,
+  k as ComponentRendererWrapper,
+  L as DetailComponentRendererWrapper,
   K as GuiexpertTable
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guiexpert/preact-table",
-  "version": "10.1.98",
+  "version": "10.1.100",
   "license": "MIT",
   "author": "Dr. Marc Kronberg <info@gui.expert> (https://gui.expert)",
   "repository": {
@@ -31,7 +31,7 @@
   },
   "dependencies": {
     "tslib": "^2.3.0",
-    "@guiexpert/table": "^1.1.98"
+    "@guiexpert/table": "^1.1.100"
   },
   "peerDependencies": {
     "preact": "^10.0.0"