handsontable 17.1.0 → 18.0.0-rc2

package/themes/types.d.ts

@@ -0,0 +1,43 @@
+export type ThemeLightDarkValue = [string, string];
+export type SizingKey = 'size_0' | 'size_0_25' | 'size_0_5' | 'size_1' | 'size_1_5' | 'size_2' | 'size_3' | 'size_4' | 'size_5' | 'size_6' | 'size_7' | 'size_8' | 'size_9' | 'size_10';
+export type ThemeSizingConfig = Partial<Record<SizingKey, string>> & Record<string, string>;
+export type DensityType = 'default' | 'compact' | 'comfortable';
+export type DensitySizeKey = 'cellVertical' | 'cellHorizontal' | 'barsHorizontal' | 'barsVertical' | 'gap' | 'buttonHorizontal' | 'buttonVertical' | 'dialogHorizontal' | 'dialogVertical' | 'inputHorizontal' | 'inputVertical' | 'menuVertical' | 'menuHorizontal' | 'menuItemVertical' | 'menuItemHorizontal';
+export type DensitySizeValues = Partial<Record<DensitySizeKey, string>> & Record<string, string>;
+export type ThemeDensitySizes = {
+    [K in DensityType]?: DensitySizeValues;
+} & {
+    [key: string]: DensitySizeValues;
+};
+export interface ThemeDensityConfig {
+    type: DensityType;
+    sizes: ThemeDensitySizes;
+}
+export type IconKey = 'arrowRight' | 'arrowRightWithBar' | 'arrowLeft' | 'arrowLeftWithBar' | 'arrowDown' | 'menu' | 'selectArrow' | 'arrowNarrowUp' | 'arrowNarrowDown' | 'check' | 'checkbox' | 'caretHiddenLeft' | 'caretHiddenRight' | 'caretHiddenUp' | 'caretHiddenDown' | 'collapseOff' | 'collapseOn' | 'radio';
+export type ThemeIconsConfig = Partial<Record<IconKey, string>> & Record<string, string>;
+export interface ThemeColorsConfig {
+    [key: string]: string | Record<string, string>;
+}
+export type TokenKey = 'fontFamily' | 'fontSize' | 'fontSizeSmall' | 'lineHeight' | 'lineHeightSmall' | 'fontWeight' | 'letterSpacing' | 'gapSize' | 'iconSize' | 'iconButtonHitAreaSize' | 'tableTransition' | 'borderRadius' | 'borderColor' | 'accentColor' | 'foregroundColor' | 'foregroundSecondaryColor' | 'backgroundColor' | 'backgroundSecondaryColor' | 'placeholderColor' | 'readOnlyColor' | 'disabledColor' | 'shadowColor' | 'shadowX' | 'shadowY' | 'shadowBlur' | 'shadowOpacity' | 'barForegroundColor' | 'barBackgroundColor' | 'barHorizontalPadding' | 'barVerticalPadding' | 'cellHorizontalBorderColor' | 'cellVerticalBorderColor' | 'cellHorizontalPadding' | 'cellVerticalPadding' | 'rowHeaderOddBackgroundColor' | 'rowHeaderEvenBackgroundColor' | 'rowCellOddBackgroundColor' | 'rowCellEvenBackgroundColor' | 'cellEditorBorderWidth' | 'cellEditorBorderColor' | 'cellEditorForegroundColor' | 'cellEditorBackgroundColor' | 'cellEditorShadowBlurRadius' | 'cellEditorShadowColor' | 'cellSuccessBackgroundColor' | 'cellErrorBackgroundColor' | 'cellReadOnlyBackgroundColor' | 'cellSelectionBorderColor' | 'cellSelectionBackgroundColor' | 'cellAutofillSize' | 'cellAutofillHitAreaSize' | 'cellAutofillBorderWidth' | 'cellAutofillBorderRadius' | 'cellAutofillBorderColor' | 'cellAutofillBackgroundColor' | 'cellAutofillFillBorderColor' | 'cellMobileHandleSize' | 'cellMobileHandleBorderWidth' | 'cellMobileHandleBorderRadius' | 'cellMobileHandleBorderColor' | 'cellMobileHandleBackgroundColor' | 'cellMobileHandleBackgroundOpacity' | 'resizeIndicatorColor' | 'moveBacklightColor' | 'moveBacklightOpacity' | 'moveIndicatorColor' | 'hiddenIndicatorColor' | 'scrollbarBorderRadius' | 'scrollbarTrackColor' | 'scrollbarThumbColor' | 'headerFontWeight' | 'headerForegroundColor' | 'headerBackgroundColor' | 'headerHighlightedShadowSize' | 'headerHighlightedForegroundColor' | 'headerHighlightedBackgroundColor' | 'headerActiveBorderColor' | 'headerActiveForegroundColor' | 'headerActiveBackgroundColor' | 'headerFilterBackgroundColor' | 'headerRowForegroundColor' | 'headerRowBackgroundColor' | 'headerRowHighlightedForegroundColor' | 'headerRowHighlightedBackgroundColor' | 'headerRowActiveForegroundColor' | 'headerRowActiveBackgroundColor' | 'checkboxSize' | 'checkboxBorderRadius' | 'checkboxBorderColor' | 'checkboxBackgroundColor' | 'checkboxIconColor' | 'checkboxFocusBorderColor' | 'checkboxFocusBackgroundColor' | 'checkboxFocusIconColor' | 'checkboxFocusRingColor' | 'checkboxDisabledBorderColor' | 'checkboxDisabledBackgroundColor' | 'checkboxDisabledIconColor' | 'checkboxCheckedBorderColor' | 'checkboxCheckedBackgroundColor' | 'checkboxCheckedIconColor' | 'checkboxCheckedFocusBorderColor' | 'checkboxCheckedFocusBackgroundColor' | 'checkboxCheckedFocusIconColor' | 'checkboxCheckedDisabledBorderColor' | 'checkboxCheckedDisabledBackgroundColor' | 'checkboxCheckedDisabledIconColor' | 'checkboxIndeterminateBorderColor' | 'checkboxIndeterminateBackgroundColor' | 'checkboxIndeterminateIconColor' | 'checkboxIndeterminateFocusBorderColor' | 'checkboxIndeterminateFocusBackgroundColor' | 'checkboxIndeterminateFocusIconColor' | 'checkboxIndeterminateDisabledBorderColor' | 'checkboxIndeterminateDisabledBackgroundColor' | 'checkboxIndeterminateDisabledIconColor' | 'radioSize' | 'radioBorderColor' | 'radioBackgroundColor' | 'radioIconColor' | 'radioFocusBorderColor' | 'radioFocusBackgroundColor' | 'radioFocusIconColor' | 'radioFocusRingColor' | 'radioDisabledBorderColor' | 'radioDisabledBackgroundColor' | 'radioDisabledIconColor' | 'radioCheckedBorderColor' | 'radioCheckedBackgroundColor' | 'radioCheckedIconColor' | 'radioCheckedFocusBorderColor' | 'radioCheckedFocusBackgroundColor' | 'radioCheckedFocusIconColor' | 'radioCheckedDisabledBorderColor' | 'radioCheckedDisabledBackgroundColor' | 'radioCheckedDisabledIconColor' | 'iconButtonBorderRadius' | 'iconButtonLargeBorderRadius' | 'iconButtonLargePadding' | 'iconButtonBorderColor' | 'iconButtonBackgroundColor' | 'iconButtonIconColor' | 'iconButtonHoverBorderColor' | 'iconButtonHoverBackgroundColor' | 'iconButtonHoverIconColor' | 'iconButtonActiveBorderColor' | 'iconButtonActiveBackgroundColor' | 'iconButtonActiveIconColor' | 'iconButtonActiveHoverBorderColor' | 'iconButtonActiveHoverBackgroundColor' | 'iconButtonActiveHoverIconColor' | 'collapseButtonBorderRadius' | 'collapseButtonOpenBorderColor' | 'collapseButtonOpenBackgroundColor' | 'collapseButtonOpenIconColor' | 'collapseButtonOpenIconActiveColor' | 'collapseButtonOpenHoverBorderColor' | 'collapseButtonOpenHoverBackgroundColor' | 'collapseButtonOpenHoverIconColor' | 'collapseButtonOpenHoverIconActiveColor' | 'collapseButtonCloseBorderColor' | 'collapseButtonCloseBackgroundColor' | 'collapseButtonCloseIconColor' | 'collapseButtonCloseIconActiveColor' | 'collapseButtonCloseHoverBorderColor' | 'collapseButtonCloseHoverBackgroundColor' | 'collapseButtonCloseHoverIconColor' | 'collapseButtonCloseHoverIconActiveColor' | 'buttonBorderRadius' | 'buttonHorizontalPadding' | 'buttonVerticalPadding' | 'primaryButtonBorderColor' | 'primaryButtonForegroundColor' | 'primaryButtonBackgroundColor' | 'primaryButtonDisabledBorderColor' | 'primaryButtonDisabledForegroundColor' | 'primaryButtonDisabledBackgroundColor' | 'primaryButtonHoverBorderColor' | 'primaryButtonHoverForegroundColor' | 'primaryButtonHoverBackgroundColor' | 'primaryButtonFocusBorderColor' | 'primaryButtonFocusForegroundColor' | 'primaryButtonFocusBackgroundColor' | 'secondaryButtonBorderColor' | 'secondaryButtonForegroundColor' | 'secondaryButtonBackgroundColor' | 'secondaryButtonDisabledBorderColor' | 'secondaryButtonDisabledForegroundColor' | 'secondaryButtonDisabledBackgroundColor' | 'secondaryButtonHoverBorderColor' | 'secondaryButtonHoverForegroundColor' | 'secondaryButtonHoverBackgroundColor' | 'secondaryButtonFocusBorderColor' | 'secondaryButtonFocusForegroundColor' | 'secondaryButtonFocusBackgroundColor' | 'commentsTextareaHorizontalPadding' | 'commentsTextareaVerticalPadding' | 'commentsTextareaBorderWidth' | 'commentsTextareaBorderColor' | 'commentsTextareaForegroundColor' | 'commentsTextareaBackgroundColor' | 'commentsTextareaFocusBorderWidth' | 'commentsTextareaFocusBorderColor' | 'commentsTextareaFocusForegroundColor' | 'commentsTextareaFocusBackgroundColor' | 'commentsIndicatorSize' | 'commentsIndicatorColor' | 'licenseHorizontalPadding' | 'licenseVerticalPadding' | 'licenseForegroundColor' | 'licenseBackgroundColor' | 'linkColor' | 'linkHoverColor' | 'inputBorderWidth' | 'inputBorderRadius' | 'inputHorizontalPadding' | 'inputVerticalPadding' | 'inputBorderColor' | 'inputForegroundColor' | 'inputBackgroundColor' | 'inputHoverBorderColor' | 'inputHoverForegroundColor' | 'inputHoverBackgroundColor' | 'inputDisabledBorderColor' | 'inputDisabledForegroundColor' | 'inputDisabledBackgroundColor' | 'inputFocusBorderColor' | 'inputFocusForegroundColor' | 'inputFocusBackgroundColor' | 'menuBorderWidth' | 'menuBorderRadius' | 'menuHorizontalPadding' | 'menuVerticalPadding' | 'menuItemHorizontalPadding' | 'menuItemVerticalPadding' | 'menuBorderColor' | 'menuShadowX' | 'menuShadowY' | 'menuShadowBlur' | 'menuShadowColor' | 'menuShadowOpacity' | 'menuItemHoverColor' | 'menuItemHoverColorOpacity' | 'menuItemActiveColor' | 'menuItemActiveColorOpacity' | 'dialogSemiTransparentBackgroundColor' | 'dialogSemiTransparentBackgroundOpacity' | 'dialogSolidBackgroundColor' | 'dialogContentPaddingHorizontal' | 'dialogContentPaddingVertical' | 'dialogContentBorderRadius' | 'dialogContentBackgroundColor' | 'notificationForegroundColor' | 'notificationBackgroundColor' | 'notificationBorderColor' | 'notificationSuccessAccent' | 'notificationWarningAccent' | 'notificationErrorAccent' | 'paginationBarForegroundColor' | 'paginationBarBackgroundColor' | 'paginationBarHorizontalPadding' | 'paginationBarVerticalPadding' | 'paginationButtonBorderColor' | 'paginationButtonForegroundColor' | 'paginationButtonBackgroundColor' | 'paginationButtonHoverBorderColor' | 'paginationButtonHoverForegroundColor' | 'paginationButtonHoverBackgroundColor' | 'paginationButtonDisabledForegroundColor' | 'paginationButtonDisabledBackgroundColor' | 'paginationButtonDisabledBorderColor' | 'paginationButtonFocusBorderColor' | 'paginationButtonFocusForegroundColor' | 'paginationButtonFocusBackgroundColor' | 'chipBackground' | 'chipBorderRadius' | 'chipVerticalPadding' | 'chipHorizontalPadding' | 'chipGap';
+export type ThemeTokenValue = string | ThemeLightDarkValue;
+export type ThemeTokensConfig = Partial<Record<TokenKey, ThemeTokenValue>>;
+export type ThemeColorScheme = 'light' | 'dark' | 'auto';
+export interface ThemeConfig {
+    name: string | undefined;
+    sizing: ThemeSizingConfig;
+    density: ThemeDensityConfig;
+    icons: ThemeIconsConfig;
+    colors: ThemeColorsConfig;
+    tokens: ThemeTokensConfig;
+    colorScheme: ThemeColorScheme;
+}
+export interface ThemeParams {
+    name?: string;
+    sizing?: Partial<ThemeSizingConfig>;
+    density?: DensityType | Partial<ThemeDensityConfig>;
+    icons?: Partial<ThemeIconsConfig>;
+    colors?: Partial<ThemeColorsConfig>;
+    tokens?: Partial<ThemeTokensConfig>;
+    colorScheme?: ThemeColorScheme;
+}
+export type BaseTheme = ThemeParams;

package/themes/types.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});

package/themes/types.mjs

@@ -0,0 +1 @@
+export { };

package/translations/changesObservable/observable.d.mts

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

package/translations/changesObservable/observable.d.ts

@@ -0,0 +1,49 @@
+import { ChangesObserver } from './observer';
+/**
+ * The ChangesObservable module is an object that represents a resource that provides
+ * the ability to observe the changes that happened in the index map indexes during
+ * the code running.
+ *
+ * @private
+ * @class ChangesObservable
+ */
+export declare class ChangesObservable {
+    #private;
+    /**
+     * Initializes the observable with an optional initial index value used as the baseline for generating first-time change events.
+     */
+    constructor({ initialIndexValue }?: {
+        initialIndexValue?: unknown;
+    });
+    /**
+     * Creates and returns a new instance of the ChangesObserver object. The resource
+     * allows subscribing to the index changes that during the code running may change.
+     * Changes are emitted as an array of the index change. Each change is represented
+     * separately as an object with `op`, `index`, `oldValue`, and `newValue` props.
+     *
+     * For example:
+     * ```
+     * [
+     *   { op: 'replace', index: 1, oldValue: false, newValue: true },
+     *   { op: 'replace', index: 3, oldValue: false, newValue: true },
+     *   { op: 'insert', index: 4, oldValue: false, newValue: true },
+     * ]
+     * // or when the new index map changes have less indexes
+     * [
+     *   { op: 'replace', index: 1, oldValue: false, newValue: true },
+     *   { op: 'remove', index: 4, oldValue: false, newValue: true },
+     * ]
+     * ```
+     *
+     * @returns {ChangesObserver}
+     */
+    createObserver(): ChangesObserver;
+    /**
+     * The method is an entry point for triggering new index map changes. Emitting the
+     * changes triggers comparing algorithm which compares last saved state with a new
+     * state. When there are some differences, the changes are sent to all subscribers.
+     *
+     * @param {Array} indexesState An array with index map state.
+     */
+    emit(indexesState: unknown[]): void;
+}

package/translations/changesObservable/observable.js

@@ -50,11 +50,7 @@ function _class_private_field_set(receiver, privateMap, value) {
     _class_apply_descriptor_set(receiver, descriptor, value);
     return value;
 }
-var /**
-   * The list of registered ChangesObserver instances.
-   *
-   * @type {ChangesObserver[]}
-   */ _observers = /*#__PURE__*/ new WeakMap(), /**
+var _observers = /*#__PURE__*/ new WeakMap(), /**
    * An array with default values that act as a base array that will be compared with
    * the last saved index state. The changes are generated and immediately send through
    * the newly created ChangesObserver object. Thanks to that, the observer initially has
@@ -83,7 +79,7 @@ var /**
    * @type {boolean}
    */ _initialIndexValue = /*#__PURE__*/ new WeakMap();
 class ChangesObservable {
-    /* eslint-disable jsdoc/require-description-complete-sentence */ /**
+    /**
    * Creates and returns a new instance of the ChangesObserver object. The resource
    * allows subscribing to the index changes that during the code running may change.
    * Changes are emitted as an array of the index change. Each change is represented
@@ -104,7 +100,7 @@ class ChangesObservable {
    * ```
    *
    * @returns {ChangesObserver}
-   */ /* eslint-enable jsdoc/require-description-complete-sentence */ createObserver() {
+   */ createObserver() {
         const observer = new _observer.ChangesObserver();
         _class_private_field_get(this, _observers).add(observer);
         observer.addLocalHook('unsubscribe', ()=>{
@@ -136,8 +132,14 @@ class ChangesObservable {
         _class_private_field_get(this, _observers).forEach((observer)=>observer._write(changes));
         _class_private_field_set(this, _currentIndexState, indexesState);
     }
-    constructor({ initialIndexValue } = {}){
-        _class_private_field_init(this, _observers, {
+    /**
+   * Initializes the observable with an optional initial index value used as the baseline for generating first-time change events.
+   */ constructor({ initialIndexValue } = {}){
+        /**
+   * The list of registered ChangesObserver instances.
+   *
+   * @type {ChangesObserver[]}
+   */ _class_private_field_init(this, _observers, {
             writable: true,
             value: void 0
         });

package/translations/changesObservable/observable.mjs

@@ -40,11 +40,7 @@ function _class_private_field_set(receiver, privateMap, value) {
 }
 import { ChangesObserver } from './observer.mjs';
 import { arrayDiff } from './utils.mjs';
-var /**
-   * The list of registered ChangesObserver instances.
-   *
-   * @type {ChangesObserver[]}
-   */ _observers = /*#__PURE__*/ new WeakMap(), /**
+var _observers = /*#__PURE__*/ new WeakMap(), /**
    * An array with default values that act as a base array that will be compared with
    * the last saved index state. The changes are generated and immediately send through
    * the newly created ChangesObserver object. Thanks to that, the observer initially has
@@ -80,7 +76,7 @@ var /**
  * @private
  * @class ChangesObservable
  */ export class ChangesObservable {
-    /* eslint-disable jsdoc/require-description-complete-sentence */ /**
+    /**
    * Creates and returns a new instance of the ChangesObserver object. The resource
    * allows subscribing to the index changes that during the code running may change.
    * Changes are emitted as an array of the index change. Each change is represented
@@ -101,7 +97,7 @@ var /**
    * ```
    *
    * @returns {ChangesObserver}
-   */ /* eslint-enable jsdoc/require-description-complete-sentence */ createObserver() {
+   */ createObserver() {
         const observer = new ChangesObserver();
         _class_private_field_get(this, _observers).add(observer);
         observer.addLocalHook('unsubscribe', ()=>{
@@ -133,8 +129,14 @@ var /**
         _class_private_field_get(this, _observers).forEach((observer)=>observer._write(changes));
         _class_private_field_set(this, _currentIndexState, indexesState);
     }
-    constructor({ initialIndexValue } = {}){
-        _class_private_field_init(this, _observers, {
+    /**
+   * Initializes the observable with an optional initial index value used as the baseline for generating first-time change events.
+   */ constructor({ initialIndexValue } = {}){
+        /**
+   * The list of registered ChangesObserver instances.
+   *
+   * @type {ChangesObserver[]}
+   */ _class_private_field_init(this, _observers, {
             writable: true,
             value: void 0
         });

package/translations/changesObservable/observer.d.mts

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

package/translations/changesObservable/observer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * The ChangesObserver module is an object that represents a disposable resource
+ * provided by the ChangesObservable module.
+ *
+ * @class ChangesObserver
+ */
+export declare class ChangesObserver {
+    #private;
+    /**
+     * Internal storage map for local hook callbacks, keyed by hook name.
+     */
+    _localHooks: Record<string, Function[]>;
+    /**
+     * Registers a callback function for the given local hook name.
+     */
+    addLocalHook: (key: string, callback: Function) => this;
+    /**
+     * Triggers all callbacks registered under the given local hook name.
+     */
+    runLocalHooks: (key: string, ...args: unknown[]) => void;
+    /**
+     * Removes all locally registered hook callbacks from this observer instance.
+     */
+    clearLocalHooks: () => this;
+    /**
+     * Subscribes to the observer.
+     *
+     * @param {Function} callback A function that will be called when the new changes will appear.
+     * @returns {ChangesObserver}
+     */
+    subscribe(callback: Function): this;
+    /**
+     * Unsubscribes all subscriptions. After the method call, the observer would not produce
+     * any new events.
+     *
+     * @returns {ChangesObserver}
+     */
+    unsubscribe(): this;
+    /**
+     * The write method is executed by the ChangesObservable module. The module produces all
+     * changes events that are distributed further by the observer.
+     *
+     * @private
+     * @param {object} changes The chunk of changes produced by the ChangesObservable module.
+     * @returns {ChangesObserver}
+     */
+    _write(changes: unknown[]): this;
+    /**
+     * The write method is executed by the ChangesObservable module. The module produces initial
+     * changes that will be used to notify new subscribers.
+     *
+     * @private
+     * @param {object} initialChanges The chunk of changes produced by the ChangesObservable module.
+     */
+    _writeInitialChanges(initialChanges: unknown[]): void;
+}

package/translations/changesObservable/utils.d.mts

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

package/translations/changesObservable/utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * An array diff implementation. The function iterates through the arrays and depends
+ * on the diff results, collect the changes as a list of the objects.
+ *
+ * Each object contains information about the differences in the indexes of the arrays.
+ * The changes also contain data about the new and previous array values.
+ *
+ * @private
+ * @param {Array} baseArray The base array to diff from.
+ * @param {Array} newArray The new array to compare with.
+ * @returns {Array}
+ */
+export declare function arrayDiff(baseArray: unknown[], newArray: unknown[]): {
+    op: string;
+    index: number;
+    oldValue: unknown;
+    newValue: unknown;
+}[];

package/translations/index.d.mts

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

package/translations/index.d.ts

@@ -1 +1,4 @@
-export * from './indexMapper';
+export { IndexMapper } from './indexMapper';
+export { getRegisteredMapsCounter } from './mapCollections/mapCollection';
+export { getIncreasedIndexes, getDecreasedIndexes, alterUtilsFactory } from './maps/utils';
+export * from './maps';

package/translations/indexMapper.d.mts

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