@handsontable/angular-wrapper 16.2.0 → 17.0.0-rc10

package/lib/renderer/hot-cell-renderer-advanced.component.d.ts

@@ -0,0 +1,33 @@
+import Handsontable from 'handsontable/base';
+import * as i0 from "@angular/core";
+/**
+ * Abstract base component for creating advanced custom cell renderer components for Handsontable.
+ *
+ * This class provides a common interface and properties required by any custom cell renderer.
+ *
+ * @template TValue - The type of the component renderer.
+ * @template TProps - The type of additional renderer properties.
+ */
+export declare abstract class HotCellRendererAdvancedComponent<TValue extends string | number | boolean | Record<string, any> | Array<any> = string, TProps extends {} = any> {
+    static readonly RENDERER_MARKER: unique symbol;
+    value: TValue;
+    instance: Handsontable;
+    td: HTMLTableCellElement;
+    row: number;
+    col: number;
+    prop: string;
+    /**
+     * The cell properties provided by Handsontable, extended with optional renderer-specific properties.
+     */
+    cellProperties: Handsontable.CellProperties & {
+        rendererProps?: TProps;
+    };
+    /**
+     * Retrieves the renderer-specific properties from the cell properties.
+     *
+     * @returns The additional properties for the renderer.
+     */
+    getProps(): TProps;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HotCellRendererAdvancedComponent<any, any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<HotCellRendererAdvancedComponent<any, any>, "hot-cell-renderer-advanced", never, { "value": { "alias": "value"; "required": false; }; "instance": { "alias": "instance"; "required": false; }; "td": { "alias": "td"; "required": false; }; "row": { "alias": "row"; "required": false; }; "col": { "alias": "col"; "required": false; }; "prop": { "alias": "prop"; "required": false; }; "cellProperties": { "alias": "cellProperties"; "required": false; }; }, {}, never, never, false, never>;
+}

package/lib/renderer/hot-dynamic-renderer-component.service.d.ts

@@ -1,8 +1,10 @@
 import { ApplicationRef, ComponentRef, EnvironmentInjector, TemplateRef, Type } from '@angular/core';
 import Handsontable from 'handsontable/base';
 import { HotCellRendererComponent } from './hot-cell-renderer.component';
+import { HotCellRendererAdvancedComponent } from './hot-cell-renderer-advanced.component';
 import * as i0 from "@angular/core";
 export declare const INVALID_RENDERER_WARNING: string;
+export declare const INVALID_ADVANCED_RENDERER_WARNING: string;
 /**
  * Type guard that checks if the given object is a TemplateRef.
  *
@@ -17,6 +19,13 @@ export declare function isTemplateRef<T>(obj: any): obj is TemplateRef<T>;
  * @returns True if the object is a HotCellRendererComponent, false otherwise.
  */
 export declare function isHotCellRendererComponent(obj: any): obj is Type<HotCellRendererComponent>;
+/**
+ * Type guard to check if an object is an instance of HotCellRendererAdvancedComponent.
+ *
+ * @param obj - The object to check.
+ * @returns True if the object is a HotCellRendererAdvancedComponent, false otherwise.
+ */
+export declare function isAdvancedHotCellRendererComponent(obj: any): obj is Type<HotCellRendererAdvancedComponent>;
 /**
  * Service for dynamically creating Angular components or templates as custom renderers for Handsontable.
  *
@@ -41,6 +50,16 @@ export declare class DynamicComponentService {
      * @returns A renderer function that can be used in Handsontable's configuration.
      */
     createRendererFromComponent(component: Type<HotCellRendererComponent> | TemplateRef<any>, componentProps?: Record<string, any>, register?: boolean): (instance: Handsontable.Core, td: HTMLTableCellElement, row: number, col: number, prop: string | number, value: any, cellProperties: Handsontable.CellProperties) => HTMLTableCellElement;
+    /**
+     * Creates a custom renderer function using rendererFactory from Handsontable.
+     * This is an alternative implementation that uses the factory pattern.
+     *
+     * @param component - The Angular component type to use as renderer.
+     * @param componentProps - An object containing additional properties to use by the renderer.
+     * @param register - If true, registers the renderer with Handsontable using the component's name.
+     * @returns A renderer function that can be used in Handsontable's configuration.
+     */
+    createRendererWithFactory(component: Type<HotCellRendererAdvancedComponent>, componentProps?: Record<string, any>, register?: boolean): (instance: Handsontable.Core, td: HTMLTableCellElement, row: number, column: number, prop: string | number, value: any, cellProperties: Handsontable.CellProperties) => void;
     /**
      * Attaches an embedded view created from a TemplateRef to a given DOM element.
      *

package/lib/services/hot-global-config.service.d.ts

@@ -30,6 +30,11 @@ export interface HotGlobalConfig {
      * The name of the theme to be used.
      */
     themeName?: ThemeName;
+    /**
+     * The theme to be used (ThemeBuilder instance or theme name string).
+     * When set, takes precedence over `themeName` for Handsontable 17+.
+     */
+    theme?: object | string;
     /**
      * The language code to be used for localization.
      * For example, 'en-US', 'pl-PL', etc.

package/lib/services/hot-settings-resolver.service.d.ts

@@ -40,8 +40,11 @@ export declare class HotSettingsResolver {
     private updateColumnValidatorForGivenCustomValidator;
     private isCustomValidatorFn;
     private isEditorComponentRefType;
+    private isAdvancedEditorComponentRefType;
     private isRendererComponentRefType;
+    private isAdvancedRendererComponentRefType;
     private isTemplateRef;
+    private isCustomRenderer;
     static ɵfac: i0.ɵɵFactoryDeclaration<HotSettingsResolver, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<HotSettingsResolver>;
 }

package/package.json

@@ -1 +1 @@
-{"name":"@handsontable/angular-wrapper","version":"16.2.0","description":"Best Data Grid for Angular with Spreadsheet Look and Feel.","author":"Handsoncode <hello@handsoncode.net> (https://handsoncode.net)","license":"SEE LICENSE IN LICENSE.txt","homepage":"https://handsontable.com","keywords":["handsontable","component","data","table","grid","data table","data grid","spreadsheet","sheet","excel","angular","angular component","angular grid","wrapper","pro","enterprise","sort","formulas","filter","search","conditional formatting","csv"],"repository":{"type":"git","url":"https://github.com/handsontable/handsontable.git"},"bugs":{"url":"https://github.com/handsontable/handsontable/issues"},"peerDependencies":{"@angular/animations":">=16.0.0","@angular/common":">=16.0.0","@angular/compiler":">=16.0.0","@angular/core":">=16.0.0","@angular/forms":">=16.0.0","@angular/platform-browser":">=16.0.0","@angular/platform-browser-dynamic":">=16.0.0","@angular/router":">=16.0.0","handsontable":"^16.0.0"},"publishConfig":{"directory":"dist/hot-table","linkDirectory":true},"module":"fesm2022/handsontable-angular-wrapper.mjs","typings":"index.d.ts","exports":{"./package.json":{"default":"./package.json"},".":{"types":"./index.d.ts","esm2022":"./esm2022/handsontable-angular-wrapper.mjs","esm":"./esm2022/handsontable-angular-wrapper.mjs","default":"./fesm2022/handsontable-angular-wrapper.mjs"}},"sideEffects":false,"optionalDependencies":{"tslib":"^2.3.0"}}
+{"name":"@handsontable/angular-wrapper","version":"17.0.0-rc10","description":"Best Data Grid for Angular with Spreadsheet Look and Feel.","author":"Handsoncode <hello@handsoncode.net> (https://handsoncode.net)","license":"SEE LICENSE IN LICENSE.txt","homepage":"https://handsontable.com","keywords":["handsontable","component","data","table","grid","data table","data grid","spreadsheet","sheet","excel","angular","angular component","angular grid","wrapper","pro","enterprise","sort","formulas","filter","search","conditional formatting","csv"],"repository":{"type":"git","url":"https://github.com/handsontable/handsontable.git"},"bugs":{"url":"https://github.com/handsontable/handsontable/issues"},"peerDependencies":{"@angular/animations":">=16.0.0","@angular/common":">=16.0.0","@angular/compiler":">=16.0.0","@angular/core":">=16.0.0","@angular/forms":">=16.0.0","@angular/platform-browser":">=16.0.0","@angular/platform-browser-dynamic":">=16.0.0","@angular/router":">=16.0.0","handsontable":"^17.0.0"},"publishConfig":{"directory":"dist/hot-table","linkDirectory":true},"module":"fesm2022/handsontable-angular-wrapper.mjs","typings":"index.d.ts","exports":{"./package.json":{"default":"./package.json"},".":{"types":"./index.d.ts","esm2022":"./esm2022/handsontable-angular-wrapper.mjs","esm":"./esm2022/handsontable-angular-wrapper.mjs","default":"./fesm2022/handsontable-angular-wrapper.mjs"}},"sideEffects":false,"optionalDependencies":{"tslib":"^2.3.0"}}

package/public-api.d.ts

@@ -5,5 +5,8 @@ export * from './lib/services/hot-global-config.service';
 export * from './lib/renderer/hot-dynamic-renderer-component.service';
 export * from './lib/renderer/hot-cell-renderer.component';
 export * from './lib/editor/hot-cell-editor.component';
+export * from './lib/renderer/hot-cell-renderer-advanced.component';
+export * from './lib/editor/hot-cell-editor-advanced.component';
+export * from './lib/editor/models/keyboard-shortcut-config';
 export { GridSettings } from './lib/models/grid-settings';
 export { ColumnSettings, CustomValidatorFn } from './lib/models/column-settings';