@freegridjs/core 0.7.0 → 0.8.0

package/dist/locales/de.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const de: LocalePack;
 

package/dist/locales/de.js

@@ -32,6 +32,7 @@ var de = {
   pasteHint: "Der Browser hat die Zwischenablage blockiert. Dr\xFCcken Sie Ctrl+V zum Einf\xFCgen.",
   required: "Dieses Feld ist erforderlich",
   invalidValue: "Ung\xFCltiger Wert",
+  duplicate: "Dieser Wert wird bereits verwendet",
   undo: "R\xFCckg\xE4ngig",
   redo: "Wiederholen",
   deleteRows: "Ausgew\xE4hlte Zeilen l\xF6schen",
@@ -78,6 +79,7 @@ var de = {
   chartLine: "Liniendiagramm",
   chartArea: "Fl\xE4chendiagramm",
   chartPie: "Kreisdiagramm",
+  freeBadge: "Kostenlose Version",
   ops: {
     contains: "Enth\xE4lt",
     equals: "Gleich",

package/dist/locales/en.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const en: LocalePack;
 

package/dist/locales/en.js

@@ -32,6 +32,7 @@ var en = {
   pasteHint: "Clipboard access was blocked. Press Ctrl+V to paste.",
   required: "This field is required",
   invalidValue: "Invalid value",
+  duplicate: "This value is already used",
   undo: "Undo",
   redo: "Redo",
   deleteRows: "Delete selected rows",
@@ -78,6 +79,7 @@ var en = {
   chartLine: "Line chart",
   chartArea: "Area chart",
   chartPie: "Pie chart",
+  freeBadge: "Free version",
   ops: {
     contains: "Contains",
     equals: "Equals",

package/dist/locales/es.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const es: LocalePack;
 

package/dist/locales/es.js

@@ -32,6 +32,7 @@ var es = {
   pasteHint: "El navegador bloque\xF3 el portapapeles. Pulsa Ctrl+V para pegar.",
   required: "Este campo es obligatorio",
   invalidValue: "Valor no v\xE1lido",
+  duplicate: "Este valor ya est\xE1 en uso",
   undo: "Deshacer",
   redo: "Rehacer",
   deleteRows: "Eliminar filas seleccionadas",
@@ -78,6 +79,7 @@ var es = {
   chartLine: "Gr\xE1fico de l\xEDneas",
   chartArea: "Gr\xE1fico de \xE1reas",
   chartPie: "Gr\xE1fico circular",
+  freeBadge: "Versi\xF3n gratuita",
   ops: {
     contains: "Contiene",
     equals: "Igual a",

package/dist/locales/fr.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const fr: LocalePack;
 

package/dist/locales/fr.js

@@ -32,6 +32,7 @@ var fr = {
   pasteHint: "Le navigateur a bloqu\xE9 le presse-papiers. Appuyez sur Ctrl+V pour coller.",
   required: "Ce champ est obligatoire",
   invalidValue: "Valeur non valide",
+  duplicate: "Cette valeur est d\xE9j\xE0 utilis\xE9e",
   undo: "Annuler",
   redo: "R\xE9tablir",
   deleteRows: "Supprimer les lignes s\xE9lectionn\xE9es",
@@ -78,6 +79,7 @@ var fr = {
   chartLine: "Courbes",
   chartArea: "Aires",
   chartPie: "Secteurs",
+  freeBadge: "Version gratuite",
   ops: {
     contains: "Contient",
     equals: "\xC9gal \xE0",

package/dist/locales/ja.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const ja: LocalePack;
 

package/dist/locales/ja.js

@@ -32,6 +32,7 @@ var ja = {
   pasteHint: "\u30D6\u30E9\u30A6\u30B6\u30FC\u304C\u30AF\u30EA\u30C3\u30D7\u30DC\u30FC\u30C9\u3078\u306E\u30A2\u30AF\u30BB\u30B9\u3092\u30D6\u30ED\u30C3\u30AF\u3057\u307E\u3057\u305F\u3002Ctrl+V \u3067\u8CBC\u308A\u4ED8\u3051\u3066\u304F\u3060\u3055\u3044\u3002",
   required: "\u3053\u306E\u9805\u76EE\u306F\u5FC5\u9808\u3067\u3059",
   invalidValue: "\u7121\u52B9\u306A\u5024\u3067\u3059",
+  duplicate: "\u3053\u306E\u5024\u306F\u3059\u3067\u306B\u4F7F\u308F\u308C\u3066\u3044\u307E\u3059",
   undo: "\u5143\u306B\u623B\u3059",
   redo: "\u3084\u308A\u76F4\u3057",
   deleteRows: "\u9078\u629E\u3057\u305F\u884C\u3092\u524A\u9664",
@@ -78,6 +79,7 @@ var ja = {
   chartLine: "\u6298\u308C\u7DDA\u30B0\u30E9\u30D5",
   chartArea: "\u9762\u30B0\u30E9\u30D5",
   chartPie: "\u5186\u30B0\u30E9\u30D5",
+  freeBadge: "\u7121\u6599\u7248\u3092\u4F7F\u7528\u4E2D",
   ops: {
     contains: "\u542B\u3080",
     equals: "\u7B49\u3057\u3044",

package/dist/locales/ko.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const ko: LocalePack;
 

package/dist/locales/ko.js

@@ -32,6 +32,7 @@ var ko = {
   pasteHint: "\uBE0C\uB77C\uC6B0\uC800\uAC00 \uD074\uB9BD\uBCF4\uB4DC \uC811\uADFC\uC744 \uB9C9\uC558\uC2B5\uB2C8\uB2E4. Ctrl+V\uB85C \uBD99\uC5EC\uB123\uC73C\uC138\uC694.",
   required: "\uD544\uC218 \uC785\uB825 \uD56D\uBAA9\uC785\uB2C8\uB2E4",
   invalidValue: "\uC62C\uBC14\uB978 \uAC12\uC774 \uC544\uB2D9\uB2C8\uB2E4",
+  duplicate: "\uC774\uBBF8 \uC0AC\uC6A9 \uC911\uC778 \uAC12\uC785\uB2C8\uB2E4",
   undo: "\uC2E4\uD589 \uCDE8\uC18C",
   redo: "\uB2E4\uC2DC \uC2E4\uD589",
   deleteRows: "\uC120\uD0DD\uD55C \uD589 \uC0AD\uC81C",
@@ -78,6 +79,7 @@ var ko = {
   chartLine: "\uAEBE\uC740\uC120 \uCC28\uD2B8",
   chartArea: "\uC601\uC5ED \uCC28\uD2B8",
   chartPie: "\uC6D0\uD615 \uCC28\uD2B8",
+  freeBadge: "\uBB34\uB8CC \uC0AC\uC6A9 \uC911",
   ops: {
     contains: "\uD3EC\uD568",
     equals: "\uAC19\uC74C",

package/dist/locales/zh-CN.d.ts

@@ -1,4 +1,4 @@
-import { L as LocalePack } from '../types-DZ66BpLd.js';
+import { L as LocalePack } from '../types-e45suTSB.js';
 
 declare const zhCN: LocalePack;
 

package/dist/locales/zh-CN.js

@@ -32,6 +32,7 @@ var zhCN = {
   pasteHint: "\u6D4F\u89C8\u5668\u963B\u6B62\u4E86\u526A\u8D34\u677F\u8BBF\u95EE\u3002\u8BF7\u6309 Ctrl+V \u7C98\u8D34\u3002",
   required: "\u6B64\u9879\u4E3A\u5FC5\u586B\u9879",
   invalidValue: "\u503C\u65E0\u6548",
+  duplicate: "\u8BE5\u503C\u5DF2\u88AB\u4F7F\u7528",
   undo: "\u64A4\u9500",
   redo: "\u91CD\u505A",
   deleteRows: "\u5220\u9664\u6240\u9009\u884C",
@@ -78,6 +79,7 @@ var zhCN = {
   chartLine: "\u6298\u7EBF\u56FE",
   chartArea: "\u9762\u79EF\u56FE",
   chartPie: "\u997C\u56FE",
+  freeBadge: "\u514D\u8D39\u4F7F\u7528\u4E2D",
   ops: {
     contains: "\u5305\u542B",
     equals: "\u7B49\u4E8E",

package/dist/styles.css

@@ -6,7 +6,7 @@
   --fg-shadow: 0 12px 32px rgba(15, 23, 42, .16), 0 2px 6px rgba(15, 23, 42, .08);
 }
 .fg-theme-light {
-  --fg-bg: #ffffff; --fg-fg: #1f2430; --fg-muted: #6b7385;
+  --fg-bg: #ffffff; --fg-fg: #1f2430; --fg-muted: #636b7c;
   --fg-header-bg: #f6f7f9; --fg-header-fg: #39404f; --fg-border: #e3e6eb; --fg-row-border: #eef0f3;
   --fg-row-odd: #fbfbfc; --fg-row-hover: #f2f6ff; --fg-row-selected: #e3edff;
   --fg-accent: #2563eb; --fg-accent-fg: #ffffff; --fg-focus: #2563eb; --fg-popup-bg: #ffffff; --fg-input-bg: #ffffff;
@@ -29,6 +29,7 @@
 }
 .fg-root *, .fg-menu * { box-sizing: border-box; }
 .fg-main { position: relative; display: flex; flex-direction: column; flex: 1 1 auto; min-width: 0; overflow: hidden; }
+.fg-grid { display: flex; flex-direction: column; flex: 1 1 auto; min-height: 0; outline: none; }
 .fg-root [hidden], .fg-menu [hidden] { display: none !important; }
 .fg-header { display: flex; flex: none; background: var(--fg-header-bg); color: var(--fg-header-fg); border-bottom: var(--fg-header-border, 1px solid var(--fg-border)); }
 .fg-header-pane { position: relative; overflow: hidden; flex: none; }
@@ -291,7 +292,11 @@ textarea.fg-editor-control { padding-top: 8px; resize: none; }
 .fg-drag-handle.fg-drag-disabled { opacity: .35; cursor: not-allowed; }
 .fg-row-dragging, .fg-row-dragging * { cursor: grabbing !important; }
 .fg-row-drop-marker { position: absolute; left: 0; right: 0; height: 2px; background: var(--fg-accent); z-index: 6; pointer-events: none; }
+.fg-row-drop-marker.fg-row-drop-inside { background: color-mix(in srgb, var(--fg-accent) 8%, transparent); box-shadow: inset 0 0 0 2px var(--fg-accent); }
 @media (prefers-reduced-motion: reduce) { .fg-group-toggle svg, .fg-tree-toggle svg, .fg-detail-toggle svg { transition: none; } }
+.fg-tree-loading svg { animation: fg-spin .8s linear infinite; opacity: .6; }
+@keyframes fg-spin { to { transform: rotate(360deg); } }
+@media (prefers-reduced-motion: reduce) { .fg-tree-loading svg { animation: none; } }
 
 /* pagination and server rows */
 .fg-pager {
@@ -366,3 +371,51 @@ textarea.fg-editor-control { padding-top: 8px; resize: none; }
 .fg-chart-plot:hover .fg-chart-bar:not(:hover), .fg-chart:hover .fg-chart-slice:not(:hover) { opacity: .55; }
 .fg-chart-slice { stroke: var(--fg-popup-bg, #fff); stroke-width: 1.5; }
 @media (prefers-reduced-motion: reduce) { .fg-chart-bar, .fg-chart-slice, .fg-chart-point { transition: none; } }
+
+/* free-use badge (unlicensed company domains) */
+.fg-free-badge {
+  position: absolute; right: 22px; bottom: 22px; z-index: 30; display: inline-flex; align-items: center; gap: 6px;
+  padding: 4px 10px 4px 6px; border-radius: 999px; background: rgba(255, 255, 255, .92); border: 1px solid rgba(14, 23, 38, .15);
+  box-shadow: 0 2px 8px rgba(14, 23, 38, .12); color: #0E1726; font: 600 11px/1.2 var(--fg-font); text-decoration: none; opacity: .9;
+}
+.fg-free-badge:hover { opacity: 1; }
+.fg-free-badge svg { flex: none; }
+
+/* column spans */
+.fg-cell-span-hidden { visibility: hidden; }
+.fg-cell-colspan { z-index: 1; background: inherit; }
+
+/* per-cell locks */
+.fg-cell-readonly { color: var(--fg-muted); background-image: linear-gradient(rgba(14, 23, 38, .025), rgba(14, 23, 38, .025)); }
+.fg-cell-select-locked .fg-checkbox { cursor: not-allowed; opacity: .45; }
+
+/* wrapped cells (autoRowHeight grows the row to fit) */
+.fg-cell-wrap { white-space: normal; overflow-wrap: anywhere; text-overflow: clip; line-height: 1.45; padding-top: 6px; padding-bottom: 6px; }
+
+/* right-to-left: mirror the grid area, then turn every cell back so text reads normally */
+/* the root keeps dir=rtl (side bar on the left); the grid inside is laid out ltr and mirrored */
+.fg-rtl .fg-main { transform: scaleX(-1); direction: ltr; }
+.fg-rtl .fg-cell, .fg-rtl .fg-header-cell, .fg-rtl .fg-statusbar, .fg-rtl .fg-pager, .fg-rtl .fg-group-panel,
+.fg-rtl .fg-overlay, .fg-rtl .fg-find, .fg-rtl .fg-chart-panel, .fg-rtl .fg-row-detail .fg-detail { transform: scaleX(-1); direction: rtl; }
+.fg-rtl .fg-sidebar { direction: rtl; border-left: 0; border-right: 1px solid var(--fg-border); }
+
+/* touch */
+.fg-body { touch-action: pan-x pan-y; }
+@media (pointer: coarse) {
+  .fg-editor input, .fg-editor select, .fg-editor textarea { font-size: 16px; } /* no zoom-in on focus in mobile Safari */
+}
+
+/* card view for narrow screens */
+.fg-card-mode .fg-header, .fg-card-mode .fg-body, .fg-card-mode .fg-grid, .fg-card-mode .fg-summary, .fg-card-mode .fg-pinned-rows { display: none; }
+.fg-cards { flex: 1; min-height: 0; overflow: auto; padding: 10px; -webkit-overflow-scrolling: touch; }
+.fg-cards-canvas { position: relative; }
+.fg-card {
+  position: absolute; left: 0; right: 0; top: 0; box-sizing: border-box; padding: 10px 14px; overflow: hidden;
+  border: 1px solid var(--fg-border); border-radius: 10px; background: var(--fg-bg); box-shadow: 0 1px 2px rgba(14, 23, 38, .06);
+}
+.fg-card-selected { border-color: var(--fg-accent); background: var(--fg-row-selected); }
+.fg-card-other { background: var(--fg-header-bg); font-weight: 600; display: flex; align-items: center; }
+.fg-card-head { display: flex; align-items: center; gap: 8px; height: var(--fg-card-line, 27px); color: var(--fg-muted); font-size: .92em; }
+.fg-card-line { display: grid; grid-template-columns: minmax(80px, 38%) 1fr; gap: 10px; align-items: center; height: var(--fg-card-line, 27px); }
+.fg-card-label { color: var(--fg-muted); font-size: .92em; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.fg-card-value { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

package/dist/{types-DZ66BpLd.d.ts → types-e45suTSB.d.ts}

@@ -42,6 +42,11 @@ interface CellParams {
     rowIndex: number;
     column: ColumnDef;
 }
+interface SpanParams {
+    value: unknown;
+    row: Row;
+    rowIndex: number;
+}
 interface ColumnDef {
     /** Column id; defaults to `field`. Required when `field` is absent. */
     id?: string;
@@ -71,24 +76,77 @@ interface ColumnDef {
     chooser?: boolean;
     /** Users cannot hide this column from the UI (API still can). */
     lockVisible?: boolean;
-    /** Allow editing and pasting into this column (requires `field`). */
-    editable?: boolean;
+    /** Allow editing and pasting into this column (requires `field`); a function decides per cell. */
+    editable?: boolean | ((params: SpanParams & {
+        column: ColumnDef;
+    }) => boolean);
     /** Editor for editable columns; defaults by type (text, number, date, boolean toggle). */
     editor?: EditorSpec;
     /** Reject blank values on edit. */
     required?: boolean;
+    /** Cells may hold formulas like `=qty*price` (same-row fields); the result is shown, sorted and exported. */
+    formulas?: boolean;
+    /** Reject a value another row already has in this column (blank values are allowed). */
+    unique?: boolean;
+    /** Set false (or return false) to keep values out of copies: blocked cells copy as empty text. */
+    copyable?: boolean | ((params: {
+        value: unknown;
+        row: Row;
+        column: ColumnDef;
+    }) => boolean);
     /** Return true to accept, or a message to reject the edited value. */
     validate?: (value: unknown, row: Row) => true | string;
     /** Merge consecutive rows with the same value into one tall cell (or decide with a function). */
     merge?: boolean | ((a: unknown, b: unknown, rowA: Row, rowB: Row) => boolean);
     /** Let a long header label wrap onto more lines. */
     wrapHeaderText?: boolean;
+    /** Rows this cell covers downwards (1 = itself). Takes precedence over `merge`. */
+    rowSpan?: (params: SpanParams) => number;
+    /** Columns this cell covers to the right within its pinned area (1 = itself). */
+    colSpan?: (params: SpanParams) => number;
+    /** Wrap long text onto more lines (with `autoRowHeight` the row grows to fit). */
+    wrapText?: boolean;
+    /** Header content instead of the plain text (icons, buttons, links). Sorting and the menu button stay. */
+    headerRenderer?: (params: {
+        header: string;
+        column: ColumnDef;
+    }) => string | HTMLElement;
+    /** Extra class names on the header cell (also for column groups). */
+    headerClass?: string | ((column: ColumnDef) => string | undefined);
     /** Aggregate shown in group rows: 'sum' | 'avg' | 'min' | 'max' | 'count' | (values, rows) => value. */
     aggFunc?: Aggregator;
 }
+interface InvalidCell {
+    row: Row;
+    /** Displayed row index; -1 when the row is filtered out or in a collapsed group. */
+    rowIndex: number;
+    colId: string;
+    message: string;
+}
+interface ScrollPosition {
+    top: number;
+    left: number;
+}
+type RowDropPosition = 'before' | 'after' | 'inside';
+interface RowDropParams {
+    row: Row;
+    /** Row under the pointer; null = below the last row. */
+    target: Row | null;
+    /** 'inside' makes the row a child of the target (tree data only). */
+    position: RowDropPosition;
+    /** True when the row comes from another grid. */
+    fromOtherGrid: boolean;
+}
+interface RowDragOptions {
+    /** Grids with the same group accept rows dragged between them. */
+    group?: string;
+    /** Return false to refuse a drop target. */
+    canDrop?: (params: RowDropParams) => boolean;
+}
 type SelectOption = unknown | {
     value: unknown;
     label?: string;
+    disabled?: boolean;
 };
 interface EditorParams {
     value: unknown;
@@ -108,6 +166,14 @@ type EditorSpec = {
     options: SelectOption[] | ((row: Row) => SelectOption[]);
 } | {
     type: 'textarea';
+}
+/** Time of day as 'HH:mm'. */
+ | {
+    type: 'time';
+}
+/** Date and time; Date values stay Dates, otherwise 'YYYY-MM-DDTHH:mm'. Default for date columns with format 'datetime'. */
+ | {
+    type: 'datetime';
 } | ((params: EditorParams) => CustomEditor);
 type KeyAction = 'edit' | 'clear' | 'undo' | 'redo' | 'copy' | 'paste' | 'selectAll' | 'find' | 'none';
 interface ColumnState {
@@ -148,6 +214,7 @@ interface Messages {
     pasteHint: string;
     required: string;
     invalidValue: string;
+    duplicate: string;
     undo: string;
     redo: string;
     deleteRows: string;
@@ -194,6 +261,7 @@ interface Messages {
     chartLine: string;
     chartArea: string;
     chartPie: string;
+    freeBadge: string;
     ops: Record<FilterOp, string>;
 }
 interface LocalePack extends Messages {
@@ -273,6 +341,8 @@ interface ExportOptions {
     sheetName?: string;
     /** CSV separator, default ','. */
     separator?: string;
+    /** xlsx: carry column align and the text color, background and bold of `cellClass` into the file. Default true. */
+    styles?: boolean;
 }
 interface PivotConfig {
     /** Row fields; every field but the last becomes a group level. */
@@ -347,6 +417,12 @@ interface GridOptions {
     /** Nest rows under their parent. Needs `getRowId`; `getParentId` returns the parent's id or null. */
     treeData?: {
         getParentId: (row: Row) => unknown;
+        /** Store a new parent id on the row (null = top level). Needed to drag rows to another parent. */
+        setParentId?: (row: Row, parentId: unknown, parent: Row | null) => void;
+        /** Rows whose children are not loaded yet but exist (e.g. folders on a server). */
+        hasChildren?: (row: Row) => boolean;
+        /** Fetch the children of a row on its first expand; they must carry the row's id as parent id. */
+        loadChildren?: (row: Row) => Promise<Row[]> | Row[];
     };
     /** Content of the expandable panel under a master row. */
     detailRenderer?: (params: {
@@ -357,8 +433,18 @@ interface GridOptions {
     detailHeight?: number;
     /** Which rows can expand a detail panel (default: all rows). */
     isRowMaster?: (row: Row) => boolean;
-    /** Add a handle column for dragging rows into a new order. */
-    rowDrag?: boolean;
+    /** Add a handle column for dragging rows into a new order (and between grids with the same `group`). */
+    rowDrag?: boolean | RowDragOptions;
+    /** Show rows as cards (header: value lines) when the grid is narrower than this many px; true = 640. */
+    cardView?: boolean | number;
+    /** 'rtl' lays the grid out right to left (Arabic, Hebrew…): first column on the right. */
+    direction?: 'ltr' | 'rtl';
+    /** Grow each row to fit its wrapped cells (`wrapText` columns); `rowHeight` is the minimum. */
+    autoRowHeight?: boolean;
+    /** Rows that may be checked; others show a disabled checkbox and are skipped by select-all. */
+    isRowSelectable?: (row: Row) => boolean;
+    /** Show the select-all checkbox in the header (default true). */
+    headerCheckbox?: boolean;
     /** Show rows one page at a time with a pager under the grid. */
     pagination?: boolean | {
         pageSize?: number;
@@ -463,6 +549,12 @@ interface GridEvents {
         fromIndex: number;
         toIndex: number;
     };
+    /** The rows area scrolled (also from setScrollPosition). */
+    scroll: ScrollPosition;
+    /** A row was dropped on this grid (also from another grid of the same drag group). */
+    rowDrop: RowDropParams & {
+        fromGrid: GridApi | null;
+    };
     pageChange: {
         page: number;
         pageSize: number;
@@ -478,12 +570,53 @@ interface GridEvents {
         end: number;
         error: unknown;
     };
+    /** treeData.loadChildren finished for a row. */
+    childrenLoaded: {
+        row: Row;
+        rows: Row[];
+    };
+    childrenLoadFailed: {
+        row: Row;
+        error: unknown;
+    };
     pivotChange: {
         pivot: PivotConfig | null;
     };
+    /** Fired before the change; call cancel() to stop it (e.g. to sort or filter on a server instead). */
+    beforeSort: {
+        sort: SortItem[];
+        cancel(): void;
+    };
+    beforeFilter: {
+        colId: string;
+        model: FilterModel | null;
+        cancel(): void;
+    };
+    beforePageChange: {
+        page: number;
+        pageSize: number;
+        cancel(): void;
+    };
+    beforeEdit: {
+        row: Row;
+        rowIndex: number;
+        colId: string;
+        cancel(): void;
+    };
+    beforeCellChange: {
+        row: Row;
+        rowIndex: number;
+        colId: string;
+        oldValue: unknown;
+        newValue: unknown;
+        cancel(): void;
+    };
 }
 interface GridApi {
-    setData(rows: Row[]): void;
+    /** Replace all rows. The scroll position stays unless `scrollToTop` is set. */
+    setData(rows: Row[], options?: {
+        scrollToTop?: boolean;
+    }): void;
     getData(): Row[];
     setColumns(columns: ColumnDef[]): void;
     getColumnState(): ColumnState[];
@@ -498,6 +631,14 @@ interface GridApi {
     deselectAll(): void;
     getDisplayedRowCount(): number;
     scrollToRow(index: number): void;
+    /** Check every editable cell against required, unique and validate. Empty when all rows are valid. */
+    validate(): InvalidCell[];
+    /** Scroll offsets of the rows area in px. */
+    getScrollPosition(): ScrollPosition;
+    /** Scroll the rows area; omitted axes stay where they are. */
+    setScrollPosition(position: Partial<ScrollPosition>): void;
+    /** Keep this grid and `other` scrolled together; returns a function that unlinks them. */
+    syncScroll(other: GridApi, axis?: 'both' | 'vertical' | 'horizontal'): () => void;
     setTheme(theme: string): void;
     setLocale(locale: string | Partial<LocalePack>): void;
     setFont(font: {
@@ -515,6 +656,9 @@ interface GridApi {
     getSummaryValues(): Record<string, unknown>[];
     getRange(): GridRange | null;
     setRange(range: GridRange | null): void;
+    /** Every selected range (Ctrl+click adds one); the last is the active range. */
+    getRanges(): GridRange[];
+    setRanges(ranges: GridRange[]): void;
     /** Copy the range (or checked rows, or the focused cell) as Excel TSV; also writes the clipboard when allowed. */
     copySelection(options?: {
         headers?: boolean;
@@ -569,6 +713,8 @@ interface GridApi {
     isDetailExpanded(row: Row): boolean;
     /** Move a row to a new index in the source data. False while sorting, filtering or grouping is active. */
     moveRow(row: Row, toIndex: number): boolean;
+    /** Move a row before, after or (tree data) inside another row; null target = to the end. False when refused. */
+    dropRow(row: Row, target: Row | null, position?: RowDropPosition): boolean;
     /** 0-based page; clamped to the available pages. */
     setPage(page: number): void;
     getPage(): number;
@@ -600,4 +746,4 @@ interface GridApi {
     destroy(): void;
 }
 
-export type { Aggregator as A, SummaryRowDef as B, CellEvent as C, Datasource as D, EditorParams as E, FilterModel as F, GridOptions as G, TextOp as H, KeyAction as K, LocalePack as L, Messages as M, NumberFilterModel as N, PivotConfig as P, Region as R, SelectOption as S, TextFilterModel as T, GridApi as a, CellParams as b, ChartHandle as c, ChartOptions as d, ColumnDef as e, ColumnState as f, ColumnType as g, ContextMenuItem as h, ContextMenuParams as i, CustomEditor as j, DateFilterModel as k, DateOp as l, EditorSpec as m, ExportOptions as n, FilterOp as o, FilterType as p, GridEvents as q, GridRange as r, NumberOp as s, Row as t, ServerParams as u, SetFilterModel as v, SortDir as w, SortItem as x, SummaryCell as y, SummaryOptions as z };
+export type { Aggregator as A, SortDir as B, CellEvent as C, Datasource as D, EditorParams as E, FilterModel as F, GridOptions as G, SortItem as H, InvalidCell as I, SpanParams as J, KeyAction as K, LocalePack as L, Messages as M, NumberFilterModel as N, SummaryCell as O, PivotConfig as P, SummaryOptions as Q, Region as R, ScrollPosition as S, SummaryRowDef as T, TextFilterModel as U, TextOp as V, GridApi as a, CellParams as b, ChartHandle as c, ChartOptions as d, ColumnDef as e, ColumnState as f, ColumnType as g, ContextMenuItem as h, ContextMenuParams as i, CustomEditor as j, DateFilterModel as k, DateOp as l, EditorSpec as m, ExportOptions as n, FilterOp as o, FilterType as p, GridEvents as q, GridRange as r, NumberOp as s, Row as t, RowDragOptions as u, RowDropParams as v, RowDropPosition as w, SelectOption as x, ServerParams as y, SetFilterModel as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@freegridjs/core",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "FreeGrid — a fast data grid for the web (free for personal use): virtual scrolling, grouping, pivot, charts, Excel export, 7 languages.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",