Angular Wrapper Dev

NgZone.runOutsideAngular() wraps the Handsontable constructor and most grid operations. This prevents Angular change detection from running on every internal grid event (scroll, render, mouse move), which is critical for performance with large datasets.

Services

• HotSettingsResolver - resolves and merges settings from component inputs, handling priority between individual inputs and the aggregate settings object.
• HotGlobalConfig - provides global default settings that apply to all HotTable instances in the application.

Module system

HotTableModule is the Angular module that declares and exports the component. Consumers add it to their imports array.

Build and test

• Build system: ng-packagr 16.
• Tests: Jest with jest-preset-angular.
• Gotcha: Tests require NODE_OPTIONS=--openssl-legacy-provider (already configured in the test script).
• Run tests: npm run test --prefix wrappers/angular-wrapper
• Important: Build core first with npm run build --prefix handsontable. Wrappers consume handsontable/tmp/, not dist/.

Key files

Rules

• No business logic in wrappers. All data transformation and validation belongs in handsontable/src/.
• Cross-platform npm scripts: use Node.js .mjs helpers instead of bash-only constructs. Never use bash-specific syntax (if [ ], mv, && with ||) directly in package.json script entries.