handsontable 17.1.0 → 18.0.0-rc2

package/utils/samplesGenerator.d.ts

@@ -0,0 +1,127 @@
+type DataFactoryResult = false | {
+    value: unknown;
+    bundleSeed?: string;
+};
+type DataFactory = (row: number, col: number, instance: SamplesGenerator) => DataFactoryResult;
+type SampleEntry = {
+    needed: number;
+    strings: Array<{
+        value: unknown;
+        col?: number;
+        row?: number;
+    }>;
+};
+/**
+ * @class SamplesGenerator
+ */
+declare class SamplesGenerator {
+    /**
+     * Number of samples to take of each value length.
+     *
+     * @type {number}
+     */
+    static get SAMPLE_COUNT(): number;
+    /**
+     * Samples prepared for calculations.
+     *
+     * @type {Map}
+     * @default {null}
+     */
+    samples: Map<string | number, object> | null;
+    /**
+     * Function which give the data to collect samples.
+     *
+     * @type {Function}
+     */
+    dataFactory: DataFactory | null;
+    /**
+     * Custom number of samples to take of each value length.
+     *
+     * @type {number}
+     * @default {null}
+     */
+    customSampleCount: number | null;
+    /**
+     * `true` if duplicate samples collection should be allowed, `false` otherwise.
+     *
+     * @type {boolean}
+     * @default {false}
+     */
+    allowDuplicates: boolean;
+    /**
+     * `true` if hidden samples should be included, `false` otherwise.
+     *
+     * @type {boolean}
+     * @default {false}
+     */
+    includeHidden: boolean;
+    /**
+     * Initializes the samples generator with the data factory function used to retrieve cell values during sampling.
+     */
+    constructor(dataFactory: DataFactory);
+    /**
+     * Get the sample count for this instance.
+     *
+     * @returns {number}
+     */
+    getSampleCount(): number;
+    /**
+     * Set the sample count.
+     *
+     * @param {number} sampleCount Number of samples to be collected.
+     */
+    setSampleCount(sampleCount: number): void;
+    /**
+     * Set if the generator should accept duplicate values.
+     *
+     * @param {boolean} allowDuplicates `true` to allow duplicate values.
+     */
+    setAllowDuplicates(allowDuplicates: boolean): void;
+    /**
+     * Sets the sampler to the mode where it will generate samples for hidden indexes.
+     *
+     * @param {boolean} includeHidden `true` to include hidden indexes, `false` otherwise.
+     */
+    setIncludeHidden(includeHidden: boolean): void;
+    /**
+     * Generate samples for row. You can control which area should be sampled by passing `rowRange` object and `colRange` object.
+     *
+     * @param {object|number} rowRange The rows range to generate the samples.
+     * @param {object} colRange The column range to generate the samples.
+     * @returns {object}
+     */
+    generateRowSamples(rowRange: unknown, colRange: unknown): Map<any, any>;
+    /**
+     * Generate samples for column. You can control which area should be sampled by passing `colRange` object and `rowRange` object.
+     *
+     * @param {object} colRange Column index.
+     * @param {object} rowRange Column index.
+     * @returns {object}
+     */
+    generateColumnSamples(colRange: unknown, rowRange: unknown): Map<any, any>;
+    /**
+     * Generate collection of samples.
+     *
+     * @param {string} type Type to generate. Can be `col` or `row`.
+     * @param {object} range The range to generate the samples.
+     * @param {object|number} specifierRange The range to generate the samples.
+     * @returns {Map}
+     */
+    generateSamples(type: string, range: {
+        from: number;
+        to: number;
+    }, specifierRange: unknown): Map<any, any>;
+    /**
+     * Generate sample for specified type (`row` or `col`).
+     *
+     * @param {string} type Samples type `row` or `col`.
+     * @param {object} range The range to generate the samples.
+     * @param {number} specifierValue The range to generate the samples.
+     * @returns {Map}
+     */
+    generateSample(type: string, range: {
+        from: number;
+        to: number;
+    }, specifierValue: number): Map<string | undefined, SampleEntry>;
+}
+export default SamplesGenerator;

package/utils/samplesGenerator.js

@@ -114,7 +114,7 @@ const _mixed = require("./../helpers/mixed");
             let seed;
             if (hasCustomBundleSeed) {
                 seed = bundleSeed;
-            } else if ((0, _object.isObject)(value)) {
+            } else if ((0, _object.isPlainObject)(value)) {
                 seed = `${Object.keys(value).length}`;
             } else if (Array.isArray(value)) {
                 seed = `${value.length}`;
@@ -128,7 +128,7 @@ const _mixed = require("./../helpers/mixed");
                 });
             }
             const sample = samples.get(seed);
-            if (sample.needed) {
+            if (sample && sample.needed) {
                 const duplicate = sampledValues.indexOf(value) > -1;
                 if (!duplicate || this.allowDuplicates || hasCustomBundleSeed) {
                     sample.strings.push({
@@ -142,7 +142,9 @@ const _mixed = require("./../helpers/mixed");
         });
         return samples;
     }
-    constructor(dataFactory){
+    /**
+   * Initializes the samples generator with the data factory function used to retrieve cell values during sampling.
+   */ constructor(dataFactory){
         /**
    * Samples prepared for calculations.
    *

package/utils/samplesGenerator.mjs

@@ -1,4 +1,4 @@
-import { isObject } from './../helpers/object.mjs';
+import { isPlainObject } from './../helpers/object.mjs';
 import { throwWithCause } from '../helpers/errors.mjs';
 import { rangeEach } from './../helpers/number.mjs';
 import { stringify } from './../helpers/mixed.mjs';
@@ -104,7 +104,7 @@ import { stringify } from './../helpers/mixed.mjs';
             let seed;
             if (hasCustomBundleSeed) {
                 seed = bundleSeed;
-            } else if (isObject(value)) {
+            } else if (isPlainObject(value)) {
                 seed = `${Object.keys(value).length}`;
             } else if (Array.isArray(value)) {
                 seed = `${value.length}`;
@@ -118,7 +118,7 @@ import { stringify } from './../helpers/mixed.mjs';
                 });
             }
             const sample = samples.get(seed);
-            if (sample.needed) {
+            if (sample && sample.needed) {
                 const duplicate = sampledValues.indexOf(value) > -1;
                 if (!duplicate || this.allowDuplicates || hasCustomBundleSeed) {
                     sample.strings.push({
@@ -132,7 +132,9 @@ import { stringify } from './../helpers/mixed.mjs';
         });
         return samples;
     }
-    constructor(dataFactory){
+    /**
+   * Initializes the samples generator with the data factory function used to retrieve cell values during sampling.
+   */ constructor(dataFactory){
         /**
    * Samples prepared for calculations.
    *

package/utils/staticRegister.d.mts

@@ -0,0 +1 @@
+export * from './staticRegister.js';

package/utils/staticRegister.d.ts

@@ -0,0 +1,21 @@
+export declare const collection: Map<string, Map<string, unknown>>;
+/**
+ * @param {string} namespace The namespace for the storage.
+ * @returns {object}
+ */
+export declare function staticRegister(namespace?: string): {
+    register: (name: string, item: unknown) => void;
+    getItem: (name: string) => unknown;
+    hasItem: (name: string) => boolean;
+    getNames: () => string[];
+    getValues: () => unknown[];
+    clear: () => void;
+};
+/**
+ * Resolves item from the collection that is strictly connected with the Handsontable instance.
+ *
+ * @param {Core} hotInstance The Handsontable instance.
+ * @param {string} name The name of the item to retrieve.
+ * @returns {*}
+ */
+export declare function resolveWithInstance(hotInstance: Record<string, unknown>, name: string): unknown;

package/utils/stylesHandler.d.mts

@@ -0,0 +1 @@
+export * from './stylesHandler.js';

package/utils/stylesHandler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Handles the theme-related style operations.
+ */
+export declare class StylesHandler {
+    #private;
+    /**
+     * Initializes a new instance of the `StylesHandler` class.
+     *
+     * @param {object} options The options for the `StylesHandler` instance.
+     * @param {Core} options.hot The instance of the Handsontable.
+     * @param {HTMLElement} options.rootElement The root element of the instance.
+     * @param {Document} options.rootDocument The root document of the instance.
+     * @param {function(string)} options.onThemeChange The callback function to be called when the theme changes.
+     * @param {boolean} options.injectCoreCss Whether to inject the core styles into the document head.
+     */
+    constructor({ hot, rootElement, rootDocument, onThemeChange, injectCoreCss }: {
+        hot: unknown;
+        rootElement: HTMLElement;
+        rootDocument: Document;
+        onThemeChange?: Function;
+        injectCoreCss?: boolean;
+    });
+    /**
+     * Retrieves the value of a specified CSS variable.
+     *
+     * @param {string} variableName - The name of the CSS variable to retrieve.
+     * @returns {number|null|undefined} The value of the specified CSS variable, or `undefined` if not found.
+     */
+    getCSSVariableValue(variableName: string): unknown;
+    /**
+     * Retrieves the computed style value for a specified CSS property of a `td` element.
+     *
+     * @param {string} cssProperty - The CSS property to retrieve the value for.
+     * @returns {number|string|undefined} The value of the specified CSS property, or `undefined` if not found.
+     */
+    getStyleForTD(cssProperty: string): string;
+    /**
+     * Calculates the row height based on the current theme and CSS variables.
+     *
+     * @param {number} [visualRowIndex] The visual row index.
+     * @returns {number} The calculated row height.
+     */
+    getDefaultRowHeight(visualRowIndex?: number): number | null;
+    /**
+     * Checks if the cells are using the `border-box` box-sizing model.
+     *
+     * @returns {boolean}
+     */
+    areCellsBorderBox(): boolean;
+    /**
+     * Applies the specified theme to the instance.
+     *
+     * @param {string|undefined|boolean} [themeName] - The name of the theme to apply.
+     */
+    useTheme(themeName: string | undefined | boolean): void;
+    /**
+     * Gets the name of the theme.
+     *
+     * @returns {string|undefined}
+     */
+    getThemeName(): string | undefined;
+    /**
+     * Clears all cached CSS variable values and computed styles.
+     * This should be called when theme CSS variables are dynamically updated.
+     */
+    clearCache(): void;
+}

package/utils/stylesHandler.js

@@ -70,28 +70,16 @@ function _interop_require_default(obj) {
  *
  * @type {string}
  */ const CORE_STYLES_ID = 'handsontable-core-styles';
-var /**
-   * The instance of the Handsontable.
-   *
-   * @type {Core}
-   */ _hot = /*#__PURE__*/ new WeakMap(), /**
+var _hot = /*#__PURE__*/ new WeakMap(), /**
    * The name of the theme.
    *
    * @type {string|undefined}
-   */ _themeName = /*#__PURE__*/ new WeakMap(), /**
-   * The instance's root element.
-   *
-   * @type {HTMLElement}
-   */ _rootElement = /*#__PURE__*/ new WeakMap(), /**
+   */ _themeName = /*#__PURE__*/ new WeakMap(), _rootElement = /*#__PURE__*/ new WeakMap(), /**
    * The computed style of the root element.
    *
    * @type {CSSStyleDeclaration}
    * @private
-   */ _rootComputedStyle = /*#__PURE__*/ new WeakMap(), /**
-   * The root document of the instance.
-   *
-   * @type {Document}
-   */ _rootDocument = /*#__PURE__*/ new WeakMap(), /**
+   */ _rootComputedStyle = /*#__PURE__*/ new WeakMap(), _rootDocument = /*#__PURE__*/ new WeakMap(), /**
    * An object to store CSS variable values.
    *
    * @type {object}
@@ -99,11 +87,9 @@ var /**
    * Stores the computed styles for various elements.
    *
    * @type {object} - An object containing the computed styles if a nested structure of `element: { [element type]: {property: value} }`.
-   */ _computedStyles = /*#__PURE__*/ new WeakMap(), /**
-   * The callback function to be called when the theme changes.
-   *
-   * @type {function(string)}
-   */ _onThemeChange = /*#__PURE__*/ new WeakMap(), _injectCoreStyles = /*#__PURE__*/ new WeakSet(), /**
+   */ _computedStyles = /*#__PURE__*/ new WeakMap(), _onThemeChange = /*#__PURE__*/ new WeakMap(), /**
+   * Injects the core Handsontable stylesheet into the document head, skipping injection if it is already present.
+   */ _injectCoreStyles = /*#__PURE__*/ new WeakSet(), /**
    * Calculates the row height based on the current theme and CSS variables.
    *
    * @returns {number|null} The calculated row height, or `null` if any required CSS variable is not found.
@@ -165,7 +151,7 @@ class StylesHandler {
         const rowHeight = _class_private_method_get(this, _calculateRowHeight, calculateRowHeight).call(this);
         if (visualRowIndex !== undefined && visualRowIndex === _class_private_field_get(this, _hot).view.getFirstRenderedVisibleRow()) {
             // add 1px border-top-width compensation for the first rendered row
-            return rowHeight + 1;
+            return (rowHeight ?? 0) + 1;
         }
         return rowHeight;
     }
@@ -181,12 +167,12 @@ class StylesHandler {
    *
    * @param {string|undefined|boolean} [themeName] - The name of the theme to apply.
    */ useTheme(themeName) {
-        if (!/ht-theme-.*/.test(themeName)) {
+        if (typeof themeName !== 'string' || !/ht-theme-.*/.test(themeName)) {
             (0, _console.warn)(`${themeName} isn't a valid theme name. Please ensure it follows the format ht-theme-<theme-name>.`);
             return;
         }
         _class_private_method_get(this, _clearCachedValues, clearCachedValues).call(this);
-        if (themeName && themeName !== _class_private_field_get(this, _themeName)) {
+        if (themeName !== _class_private_field_get(this, _themeName)) {
             _class_private_field_set(this, _themeName, themeName);
         }
         _class_private_field_get(this, _onThemeChange).call(this, _class_private_field_get(this, _themeName));
@@ -215,7 +201,7 @@ class StylesHandler {
    * @param {Document} options.rootDocument The root document of the instance.
    * @param {function(string)} options.onThemeChange The callback function to be called when the theme changes.
    * @param {boolean} options.injectCoreCss Whether to inject the core styles into the document head.
-   */ constructor({ hot, rootElement, rootDocument, onThemeChange = ()=>{}, injectCoreCss = true }){
+   */ constructor({ hot, rootElement, rootDocument, onThemeChange = (_)=>{}, injectCoreCss = true }){
         _class_private_method_init(this, _injectCoreStyles);
         _class_private_method_init(this, _calculateRowHeight);
         _class_private_method_init(this, _cacheStylesheetValues);
@@ -223,7 +209,11 @@ class StylesHandler {
         _class_private_method_init(this, _getParsedNumericCSSValue);
         _class_private_method_init(this, _getCSSValue);
         _class_private_method_init(this, _clearCachedValues);
-        _class_private_field_init(this, _hot, {
+        /**
+   * The instance of the Handsontable.
+   *
+   * @type {Core}
+   */ _class_private_field_init(this, _hot, {
             writable: true,
             value: void 0
         });
@@ -231,7 +221,11 @@ class StylesHandler {
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _rootElement, {
+        /**
+   * The instance's root element.
+   *
+   * @type {HTMLElement}
+   */ _class_private_field_init(this, _rootElement, {
             writable: true,
             value: void 0
         });
@@ -239,7 +233,11 @@ class StylesHandler {
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _rootDocument, {
+        /**
+   * The root document of the instance.
+   *
+   * @type {Document}
+   */ _class_private_field_init(this, _rootDocument, {
             writable: true,
             value: void 0
         });
@@ -251,10 +249,15 @@ class StylesHandler {
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _onThemeChange, {
+        /**
+   * The callback function to be called when the theme changes.
+   *
+   * @type {function(string)}
+   */ _class_private_field_init(this, _onThemeChange, {
             writable: true,
             value: void 0
         });
+        _class_private_field_set(this, _rootComputedStyle, null);
         _class_private_field_set(this, _cssVars, {});
         _class_private_field_set(this, _computedStyles, {});
         _class_private_field_set(this, _hot, hot);
@@ -282,7 +285,10 @@ function injectCoreStyles() {
 function calculateRowHeight() {
     const lineHeightVarValue = this.getCSSVariableValue('line-height');
     const verticalPaddingVarValue = this.getCSSVariableValue('cell-vertical-padding');
-    const bottomBorderWidth = Math.ceil(parseFloat(this.getStyleForTD('border-bottom-width')));
+    // Math.round (not Math.ceil) so that fractional computed values from sub-100% browser zoom
+    // (e.g. "1.111px" at 90%) round to the correct 1px rather than overshooting to 2px, which
+    // would make the hider taller than the actual table content and leave a visible gap.
+    const bottomBorderWidth = Math.round(Number.parseFloat(this.getStyleForTD('border-bottom-width') ?? ''));
     if (lineHeightVarValue === null || verticalPaddingVarValue === null || isNaN(bottomBorderWidth)) {
         return null;
     }
@@ -325,11 +331,11 @@ function getStylesForTD(cssProps) {
     return returnObject;
 }
 function getParsedNumericCSSValue(property) {
-    const parsedValue = Math.ceil(parseFloat(_class_private_method_get(this, _getCSSValue, getCSSValue).call(this, property)));
+    const parsedValue = Math.ceil(Number.parseFloat(_class_private_method_get(this, _getCSSValue, getCSSValue).call(this, property) ?? ''));
     return Number.isNaN(parsedValue) ? null : parsedValue;
 }
 function getCSSValue(property) {
-    const acquiredValue = _class_private_field_get(this, _rootComputedStyle)?.getPropertyValue(property);
+    const acquiredValue = _class_private_field_get(this, _rootComputedStyle)?.getPropertyValue(property) ?? null;
     return acquiredValue === '' ? null : acquiredValue;
 }
 function clearCachedValues() {

package/utils/stylesHandler.mjs

@@ -55,28 +55,16 @@ import handsontableStyles from '../styles/handsontableStyles.mjs';
  *
  * @type {string}
  */ const CORE_STYLES_ID = 'handsontable-core-styles';
-var /**
-   * The instance of the Handsontable.
-   *
-   * @type {Core}
-   */ _hot = /*#__PURE__*/ new WeakMap(), /**
+var _hot = /*#__PURE__*/ new WeakMap(), /**
    * The name of the theme.
    *
    * @type {string|undefined}
-   */ _themeName = /*#__PURE__*/ new WeakMap(), /**
-   * The instance's root element.
-   *
-   * @type {HTMLElement}
-   */ _rootElement = /*#__PURE__*/ new WeakMap(), /**
+   */ _themeName = /*#__PURE__*/ new WeakMap(), _rootElement = /*#__PURE__*/ new WeakMap(), /**
    * The computed style of the root element.
    *
    * @type {CSSStyleDeclaration}
    * @private
-   */ _rootComputedStyle = /*#__PURE__*/ new WeakMap(), /**
-   * The root document of the instance.
-   *
-   * @type {Document}
-   */ _rootDocument = /*#__PURE__*/ new WeakMap(), /**
+   */ _rootComputedStyle = /*#__PURE__*/ new WeakMap(), _rootDocument = /*#__PURE__*/ new WeakMap(), /**
    * An object to store CSS variable values.
    *
    * @type {object}
@@ -84,11 +72,9 @@ var /**
    * Stores the computed styles for various elements.
    *
    * @type {object} - An object containing the computed styles if a nested structure of `element: { [element type]: {property: value} }`.
-   */ _computedStyles = /*#__PURE__*/ new WeakMap(), /**
-   * The callback function to be called when the theme changes.
-   *
-   * @type {function(string)}
-   */ _onThemeChange = /*#__PURE__*/ new WeakMap(), _injectCoreStyles = /*#__PURE__*/ new WeakSet(), /**
+   */ _computedStyles = /*#__PURE__*/ new WeakMap(), _onThemeChange = /*#__PURE__*/ new WeakMap(), /**
+   * Injects the core Handsontable stylesheet into the document head, skipping injection if it is already present.
+   */ _injectCoreStyles = /*#__PURE__*/ new WeakSet(), /**
    * Calculates the row height based on the current theme and CSS variables.
    *
    * @returns {number|null} The calculated row height, or `null` if any required CSS variable is not found.
@@ -152,7 +138,7 @@ var /**
         const rowHeight = _class_private_method_get(this, _calculateRowHeight, calculateRowHeight).call(this);
         if (visualRowIndex !== undefined && visualRowIndex === _class_private_field_get(this, _hot).view.getFirstRenderedVisibleRow()) {
             // add 1px border-top-width compensation for the first rendered row
-            return rowHeight + 1;
+            return (rowHeight ?? 0) + 1;
         }
         return rowHeight;
     }
@@ -168,12 +154,12 @@ var /**
    *
    * @param {string|undefined|boolean} [themeName] - The name of the theme to apply.
    */ useTheme(themeName) {
-        if (!/ht-theme-.*/.test(themeName)) {
+        if (typeof themeName !== 'string' || !/ht-theme-.*/.test(themeName)) {
             warn(`${themeName} isn't a valid theme name. Please ensure it follows the format ht-theme-<theme-name>.`);
             return;
         }
         _class_private_method_get(this, _clearCachedValues, clearCachedValues).call(this);
-        if (themeName && themeName !== _class_private_field_get(this, _themeName)) {
+        if (themeName !== _class_private_field_get(this, _themeName)) {
             _class_private_field_set(this, _themeName, themeName);
         }
         _class_private_field_get(this, _onThemeChange).call(this, _class_private_field_get(this, _themeName));
@@ -202,7 +188,7 @@ var /**
    * @param {Document} options.rootDocument The root document of the instance.
    * @param {function(string)} options.onThemeChange The callback function to be called when the theme changes.
    * @param {boolean} options.injectCoreCss Whether to inject the core styles into the document head.
-   */ constructor({ hot, rootElement, rootDocument, onThemeChange = ()=>{}, injectCoreCss = true }){
+   */ constructor({ hot, rootElement, rootDocument, onThemeChange = (_)=>{}, injectCoreCss = true }){
         _class_private_method_init(this, _injectCoreStyles);
         _class_private_method_init(this, _calculateRowHeight);
         _class_private_method_init(this, _cacheStylesheetValues);
@@ -210,7 +196,11 @@ var /**
         _class_private_method_init(this, _getParsedNumericCSSValue);
         _class_private_method_init(this, _getCSSValue);
         _class_private_method_init(this, _clearCachedValues);
-        _class_private_field_init(this, _hot, {
+        /**
+   * The instance of the Handsontable.
+   *
+   * @type {Core}
+   */ _class_private_field_init(this, _hot, {
             writable: true,
             value: void 0
         });
@@ -218,7 +208,11 @@ var /**
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _rootElement, {
+        /**
+   * The instance's root element.
+   *
+   * @type {HTMLElement}
+   */ _class_private_field_init(this, _rootElement, {
             writable: true,
             value: void 0
         });
@@ -226,7 +220,11 @@ var /**
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _rootDocument, {
+        /**
+   * The root document of the instance.
+   *
+   * @type {Document}
+   */ _class_private_field_init(this, _rootDocument, {
             writable: true,
             value: void 0
         });
@@ -238,10 +236,15 @@ var /**
             writable: true,
             value: void 0
         });
-        _class_private_field_init(this, _onThemeChange, {
+        /**
+   * The callback function to be called when the theme changes.
+   *
+   * @type {function(string)}
+   */ _class_private_field_init(this, _onThemeChange, {
             writable: true,
             value: void 0
         });
+        _class_private_field_set(this, _rootComputedStyle, null);
         _class_private_field_set(this, _cssVars, {});
         _class_private_field_set(this, _computedStyles, {});
         _class_private_field_set(this, _hot, hot);
@@ -269,7 +272,10 @@ function injectCoreStyles() {
 function calculateRowHeight() {
     const lineHeightVarValue = this.getCSSVariableValue('line-height');
     const verticalPaddingVarValue = this.getCSSVariableValue('cell-vertical-padding');
-    const bottomBorderWidth = Math.ceil(parseFloat(this.getStyleForTD('border-bottom-width')));
+    // Math.round (not Math.ceil) so that fractional computed values from sub-100% browser zoom
+    // (e.g. "1.111px" at 90%) round to the correct 1px rather than overshooting to 2px, which
+    // would make the hider taller than the actual table content and leave a visible gap.
+    const bottomBorderWidth = Math.round(Number.parseFloat(this.getStyleForTD('border-bottom-width') ?? ''));
     if (lineHeightVarValue === null || verticalPaddingVarValue === null || isNaN(bottomBorderWidth)) {
         return null;
     }
@@ -312,11 +318,11 @@ function getStylesForTD(cssProps) {
     return returnObject;
 }
 function getParsedNumericCSSValue(property) {
-    const parsedValue = Math.ceil(parseFloat(_class_private_method_get(this, _getCSSValue, getCSSValue).call(this, property)));
+    const parsedValue = Math.ceil(Number.parseFloat(_class_private_method_get(this, _getCSSValue, getCSSValue).call(this, property) ?? ''));
     return Number.isNaN(parsedValue) ? null : parsedValue;
 }
 function getCSSValue(property) {
-    const acquiredValue = _class_private_field_get(this, _rootComputedStyle)?.getPropertyValue(property);
+    const acquiredValue = _class_private_field_get(this, _rootComputedStyle)?.getPropertyValue(property) ?? null;
     return acquiredValue === '' ? null : acquiredValue;
 }
 function clearCachedValues() {

package/utils/valueAccessors.d.mts

@@ -0,0 +1 @@
+export * from './valueAccessors.js';

package/utils/valueAccessors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Get the value to be set in the cell.
+ *
+ * @param {*} value Initial value.
+ * @param {object} cellMeta The cell meta object.
+ * @returns {*} The value to be set in the cell.
+ */
+export declare function getValueSetterValue(value: unknown, cellMeta: Record<string, unknown>): unknown;
+/**
+ * Get the value to be displayed in the cell.
+ *
+ * @param {*} value Initial value.
+ * @param {object} cellMeta The cell meta object.
+ * @returns {*} The value to be displayed in the cell.
+ */
+export declare function getValueGetterValue(value: unknown, cellMeta: Record<string, unknown>): unknown;

package/validators/autocompleteValidator/autocompleteValidator.d.mts

@@ -0,0 +1 @@
+export * from './autocompleteValidator.js';

package/validators/autocompleteValidator/autocompleteValidator.d.ts

@@ -1,5 +1,13 @@
-import { CellProperties } from '../../settings';
-import { CellValue } from '../../common';
-
-export const VALIDATOR_TYPE: 'autocomplete';
-export function autocompleteValidator(this: CellProperties, value: CellValue, callback: (valid: boolean) => void): void;
+import type { CellProperties } from '../../settings';
+export declare const VALIDATOR_TYPE: 'autocomplete';
+/**
+ * The Autocomplete cell validator.
+ *
+ * @private
+ * @param {*} value Value of edited cell.
+ * @param {Function} callback Callback called with validation result.
+ */
+export declare function autocompleteValidator(this: CellProperties, value: unknown, callback: (valid: boolean) => void): void;
+export declare namespace autocompleteValidator {
+    var VALIDATOR_TYPE: "autocomplete";
+}