@freegridjs/core 1.6.0 → 1.7.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { default as en } from './locales/en.js';
 declare function createGrid(host: HTMLElement, options: GridOptions): GridApi;
 
 /** FreeGrid version (kept in sync with releases.json by scripts/release.mjs). */
-declare const version = "1.6.0";
+declare const version = "1.7.0";
 
 interface LicenseInfo {
     /** Licensed domains (plus their www. host); `*.example.com` also covers every subdomain. */
@@ -14,19 +14,22 @@ interface LicenseInfo {
     /** Last valid day, YYYY-MM-DD. */
     expires: string;
     issued: string;
+    /** Perpetual keys: the major version they cover (bought on 1.x → every 1.x release). Absent: every version while valid. */
+    major?: number;
 }
 type LicenseResult = {
     ok: true;
     info: LicenseInfo;
 } | {
     ok: false;
-    reason: 'format' | 'signature' | 'expired' | 'domain' | 'unsupported';
+    reason: 'format' | 'signature' | 'expired' | 'domain' | 'version' | 'unsupported';
     info?: LicenseInfo;
 };
-/** Check a key's signature, expiry and domain. */
+/** Check a key's signature, expiry, domain and (perpetual keys) the major version. */
 declare function verifyLicense(key: string, host: string, opts?: {
     publicKey?: JsonWebKey;
     now?: Date;
+    version?: string;
 }): Promise<LicenseResult>;
 /** Set the license key once for every grid on the page. */
 declare function setLicenseKey(key: string): void;
@@ -132,6 +135,12 @@ declare function messageToTransaction(message: unknown): RowTransaction | {
  */
 declare function connectLive(api: GridApi, options: LiveOptions): LiveConnection;
 
+/**
+ * Remembers the last value given for an option. Framework wrappers use it so that a parent writing
+ * `groupBy={['country']}` inline (a new array on every render) applies it only when its content changes.
+ */
+declare function changeTracker(initial: unknown): (next: unknown) => boolean;
+
 /** Add a function formulas can call, e.g. registerFormulaFunction('VAT', ([n]) => Number(n) * 0.1). */
 declare function registerFormulaFunction(name: string, fn: (args: unknown[]) => unknown): void;
 /** Names of every function formulas can call. */
@@ -170,4 +179,4 @@ declare function renderChart(el: HTMLElement, spec: ChartSpec): void;
 declare function registerLocale(pack: LocalePack): void;
 declare function resolveLocale(input?: string | Partial<LocalePack>, navLangs?: readonly string[]): LocalePack;
 
-export { type ChartSpec, type ChartType, Datasource, ExportOptions, GridApi, GridOptions, type LicenseInfo, type LiveConnection, type LiveOptions, type LiveStatus, LocalePack, type RestOptions, Row, RowTransaction, type WorkbookSheet, buildWorkbook, connectLive, createGrid, csrfHeaders, evaluateFormula, exportWorkbook, formulaFunctions, loadData, messageToTransaction, parseCsv, registerFormulaFunction, registerLocale, renderChart, resolveLocale, restDatasource, saveChanges, setLicenseKey, verifyLicense, version };
+export { type ChartSpec, type ChartType, Datasource, ExportOptions, GridApi, GridOptions, type LicenseInfo, type LiveConnection, type LiveOptions, type LiveStatus, LocalePack, type RestOptions, Row, RowTransaction, type WorkbookSheet, buildWorkbook, changeTracker, connectLive, createGrid, csrfHeaders, evaluateFormula, exportWorkbook, formulaFunctions, loadData, messageToTransaction, parseCsv, registerFormulaFunction, registerLocale, renderChart, resolveLocale, restDatasource, saveChanges, setLicenseKey, verifyLicense, version };