@progress/kendo-angular-common 21.2.0-develop.9 → 21.3.0-develop.1

package/esm2022/index.mjs

@@ -11,7 +11,7 @@ export * from './utils';
 export * from './enums';
 export * from './utils/focusable-selectors';
 export * from './utils/ng-class-parser';
-export * from './utils/numpad-keys-normalizer';
+export * from './utils/keys-normalizer';
 export * from './utils/getter';
 export * from './utils/setter';
 export * from './watermark';

package/esm2022/toggle-button-tab-stop/toggle-button-tab-stop.directive.mjs

@@ -8,7 +8,7 @@ import { MultiTabStop } from "./toggle-button-tab-stop";
 import { Subscription } from "rxjs";
 import { take } from "rxjs/operators";
 import { Keys } from "../enums";
-import { normalizeNumpadKeys } from "../utils/numpad-keys-normalizer";
+import { normalizeKeys } from "../utils/keys-normalizer";
 import * as i0 from "@angular/core";
 import * as i1 from "./toggle-button-tab-stop";
 const tags = ['kendo-splitbutton', 'kendo-combobox', 'kendo-multicolumncombobox', 'kendo-datepicker', 'kendo-timepicker', 'kendo-datetimepicker'];
@@ -158,7 +158,7 @@ export class ToggleButtonTabStopDirective {
         this.renderer.removeStyle(this.button, 'box-shadow');
     };
     onClick = (e) => {
-        const code = normalizeNumpadKeys(e);
+        const code = normalizeKeys(e);
         const splitButtonToggleEnter = e instanceof KeyboardEvent && code === Keys.Enter;
         const isClick = e instanceof PointerEvent;
         if (splitButtonToggleEnter || isClick) {
@@ -166,7 +166,7 @@ export class ToggleButtonTabStopDirective {
         }
     };
     onKeyDown = (e) => {
-        const code = normalizeNumpadKeys(e);
+        const code = normalizeKeys(e);
         if (code === Keys.ArrowDown && e.altKey) {
             e.stopImmediatePropagation();
             this.focusButton = true;

package/esm2022/utils/keys-normalizer.mjs

@@ -0,0 +1,95 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import { Keys } from "../enums";
+/**
+ * @hidden
+ *
+ * Maps keyCode values (65-90) to Keys enum values (KeyA-KeyZ).
+ * Used to handle letter keys correctly across different keyboard layouts.
+ */
+const keyCodeToKeysMap = {
+    65: Keys.KeyA,
+    66: Keys.KeyB,
+    67: Keys.KeyC,
+    68: Keys.KeyD,
+    69: Keys.KeyE,
+    70: Keys.KeyF,
+    71: Keys.KeyG,
+    72: Keys.KeyH,
+    73: Keys.KeyI,
+    74: Keys.KeyJ,
+    75: Keys.KeyK,
+    76: Keys.KeyL,
+    77: Keys.KeyM,
+    78: Keys.KeyN,
+    79: Keys.KeyO,
+    80: Keys.KeyP,
+    81: Keys.KeyQ,
+    82: Keys.KeyR,
+    83: Keys.KeyS,
+    84: Keys.KeyT,
+    85: Keys.KeyU,
+    86: Keys.KeyV,
+    87: Keys.KeyW,
+    88: Keys.KeyX,
+    89: Keys.KeyY,
+    90: Keys.KeyZ
+};
+/**
+ * @hidden
+ *
+ * Normalizes keyboard events to ensure consistent key handling across different keyboard layouts.
+ *
+ * This function addresses the following scenarios:
+ * 1. On some keyboards, PageUp/Down, Home/End, and arrow keys are mapped to Numpad keys
+ * 2. For letter keys (KeyA-KeyZ), checks the deprecated keyCode property to handle non-QWERTY layouts
+ *    (e.g., AZERTY, QWERTZ) where event.code may not match the expected letter
+ *
+ * @param event - The keyboard event to normalize
+ * @returns The normalized key code string (e.g., 'KeyA', 'ArrowDown', 'Enter')
+ *
+ * @example
+ * // On an AZERTY layout, pressing Ctrl+A (where 'A' is physically at 'Q' position)
+ * // event.code = 'KeyQ', event.keyCode = 65
+ * const code = normalizeKeys(event); // Returns 'KeyA'
+ */
+export const normalizeKeys = (event) => {
+    const keyCode = event.keyCode;
+    if (keyCode >= 65 && keyCode <= 90) {
+        const normalizedKey = keyCodeToKeysMap[keyCode];
+        if (normalizedKey) {
+            return normalizedKey;
+        }
+    }
+    // Handle numpad keys that may be mapped to navigation keys
+    if (event.code === Keys.Numpad1 && event.key === Keys.End) {
+        return Keys.End;
+    }
+    if (event.code === Keys.Numpad2 && event.key === Keys.ArrowDown) {
+        return Keys.ArrowDown;
+    }
+    if (event.code === Keys.Numpad3 && event.key === Keys.PageDown) {
+        return Keys.PageDown;
+    }
+    if (event.code === Keys.Numpad4 && event.key === Keys.ArrowLeft) {
+        return Keys.ArrowLeft;
+    }
+    if (event.code === Keys.Numpad6 && event.key === Keys.ArrowRight) {
+        return Keys.ArrowRight;
+    }
+    if (event.code === Keys.Numpad7 && event.key === Keys.Home) {
+        return Keys.Home;
+    }
+    if (event.code === Keys.Numpad8 && event.key === Keys.ArrowUp) {
+        return Keys.ArrowUp;
+    }
+    if (event.code === Keys.Numpad9 && event.key === Keys.PageUp) {
+        return Keys.PageUp;
+    }
+    if (event.code === Keys.NumpadEnter) {
+        return Keys.Enter;
+    }
+    return event.code;
+};

package/fesm2022/progress-kendo-angular-common.mjs

@@ -891,9 +891,64 @@ const focusableSelector = [
 /**
  * @hidden
  *
- * On some keyboards, PageUp/Down, Home/End, and arrow keys are mapped to Numpad keys
+ * Maps keyCode values (65-90) to Keys enum values (KeyA-KeyZ).
+ * Used to handle letter keys correctly across different keyboard layouts.
  */
-const normalizeNumpadKeys = (event) => {
+const keyCodeToKeysMap = {
+    65: Keys.KeyA,
+    66: Keys.KeyB,
+    67: Keys.KeyC,
+    68: Keys.KeyD,
+    69: Keys.KeyE,
+    70: Keys.KeyF,
+    71: Keys.KeyG,
+    72: Keys.KeyH,
+    73: Keys.KeyI,
+    74: Keys.KeyJ,
+    75: Keys.KeyK,
+    76: Keys.KeyL,
+    77: Keys.KeyM,
+    78: Keys.KeyN,
+    79: Keys.KeyO,
+    80: Keys.KeyP,
+    81: Keys.KeyQ,
+    82: Keys.KeyR,
+    83: Keys.KeyS,
+    84: Keys.KeyT,
+    85: Keys.KeyU,
+    86: Keys.KeyV,
+    87: Keys.KeyW,
+    88: Keys.KeyX,
+    89: Keys.KeyY,
+    90: Keys.KeyZ
+};
+/**
+ * @hidden
+ *
+ * Normalizes keyboard events to ensure consistent key handling across different keyboard layouts.
+ *
+ * This function addresses the following scenarios:
+ * 1. On some keyboards, PageUp/Down, Home/End, and arrow keys are mapped to Numpad keys
+ * 2. For letter keys (KeyA-KeyZ), checks the deprecated keyCode property to handle non-QWERTY layouts
+ *    (e.g., AZERTY, QWERTZ) where event.code may not match the expected letter
+ *
+ * @param event - The keyboard event to normalize
+ * @returns The normalized key code string (e.g., 'KeyA', 'ArrowDown', 'Enter')
+ *
+ * @example
+ * // On an AZERTY layout, pressing Ctrl+A (where 'A' is physically at 'Q' position)
+ * // event.code = 'KeyQ', event.keyCode = 65
+ * const code = normalizeKeys(event); // Returns 'KeyA'
+ */
+const normalizeKeys = (event) => {
+    const keyCode = event.keyCode;
+    if (keyCode >= 65 && keyCode <= 90) {
+        const normalizedKey = keyCodeToKeysMap[keyCode];
+        if (normalizedKey) {
+            return normalizedKey;
+        }
+    }
+    // Handle numpad keys that may be mapped to navigation keys
     if (event.code === Keys.Numpad1 && event.key === Keys.End) {
         return Keys.End;
     }
@@ -1531,7 +1586,7 @@ class ToggleButtonTabStopDirective {
         this.renderer.removeStyle(this.button, 'box-shadow');
     };
     onClick = (e) => {
-        const code = normalizeNumpadKeys(e);
+        const code = normalizeKeys(e);
         const splitButtonToggleEnter = e instanceof KeyboardEvent && code === Keys.Enter;
         const isClick = e instanceof PointerEvent;
         if (splitButtonToggleEnter || isClick) {
@@ -1539,7 +1594,7 @@ class ToggleButtonTabStopDirective {
         }
     };
     onKeyDown = (e) => {
-        const code = normalizeNumpadKeys(e);
+        const code = normalizeKeys(e);
         if (code === Keys.ArrowDown && e.altKey) {
             e.stopImmediatePropagation();
             this.focusButton = true;
@@ -1731,5 +1786,5 @@ const replaceMessagePlaceholder = (message, name, value) => (message ?? '').repl
  * Generated bundle index. Do not edit.
  */
 
-export { DraggableDirective, EventsOutsideAngularDirective, KENDO_ADORNMENTS, KENDO_COMMON, KENDO_DRAGGABLE, KENDO_EVENTS, KENDO_RESIZESENSOR, KENDO_TEMPLATE_CONTEXT, KENDO_TOGGLEBUTTONTABSTOP, KENDO_WATERMARK, KendoInput, Keys, MultiTabStop, PrefixTemplateDirective, PreventableEvent, ResizeBatchService, ResizeCompatService, ResizeObserverService, ResizeSensorComponent, ScrollbarWidthService, SeparatorComponent, SuffixTemplateDirective, TemplateContextDirective, ToggleButtonTabStopDirective, WatermarkOverlayComponent, anyChanged, applyAttributes, areObjectsEqual, closest, closestBySelector, closestInScope, contains, findElement, findFocusable, findFocusableChild, firefoxMaxHeight, focusableSelector, getLicenseMessage, getter, guid, hasClasses, hasObservers, isChanged, isControlRequired, isDocumentAvailable, isFirefox, isFocusable, isFocusableWithTabKey, isObject, isObjectPresent, isPresent, isSafari, isString, isVisible, matchesClasses, matchesNodeName, normalizeNumpadKeys, parseAttributes, parseCSSClassNames, processCssValue, removeHTMLAttributes, replaceMessagePlaceholder, rtlScrollPosition, scrollbarWidth, setHTMLAttributes, setter, shouldShowValidationUI, splitStringToArray };
+export { DraggableDirective, EventsOutsideAngularDirective, KENDO_ADORNMENTS, KENDO_COMMON, KENDO_DRAGGABLE, KENDO_EVENTS, KENDO_RESIZESENSOR, KENDO_TEMPLATE_CONTEXT, KENDO_TOGGLEBUTTONTABSTOP, KENDO_WATERMARK, KendoInput, Keys, MultiTabStop, PrefixTemplateDirective, PreventableEvent, ResizeBatchService, ResizeCompatService, ResizeObserverService, ResizeSensorComponent, ScrollbarWidthService, SeparatorComponent, SuffixTemplateDirective, TemplateContextDirective, ToggleButtonTabStopDirective, WatermarkOverlayComponent, anyChanged, applyAttributes, areObjectsEqual, closest, closestBySelector, closestInScope, contains, findElement, findFocusable, findFocusableChild, firefoxMaxHeight, focusableSelector, getLicenseMessage, getter, guid, hasClasses, hasObservers, isChanged, isControlRequired, isDocumentAvailable, isFirefox, isFocusable, isFocusableWithTabKey, isObject, isObjectPresent, isPresent, isSafari, isString, isVisible, matchesClasses, matchesNodeName, normalizeKeys, parseAttributes, parseCSSClassNames, processCssValue, removeHTMLAttributes, replaceMessagePlaceholder, rtlScrollPosition, scrollbarWidth, setHTMLAttributes, setter, shouldShowValidationUI, splitStringToArray };
 

package/index.d.ts

@@ -11,7 +11,7 @@ export * from './utils';
 export * from './enums';
 export * from './utils/focusable-selectors';
 export * from './utils/ng-class-parser';
-export * from './utils/numpad-keys-normalizer';
+export * from './utils/keys-normalizer';
 export * from './utils/getter';
 export * from './utils/setter';
 export * from './watermark';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-common",
-  "version": "21.2.0-develop.9",
+  "version": "21.3.0-develop.1",
   "description": "Kendo UI for Angular - Utility Package",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -23,7 +23,7 @@
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-draggable": "^3.0.2",
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "21.2.0-develop.9"
+    "@progress/kendo-angular-schematics": "21.3.0-develop.1"
   },
   "publishConfig": {
     "access": "public"

package/utils/keys-normalizer.d.ts

@@ -0,0 +1,23 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+/**
+ * @hidden
+ *
+ * Normalizes keyboard events to ensure consistent key handling across different keyboard layouts.
+ *
+ * This function addresses the following scenarios:
+ * 1. On some keyboards, PageUp/Down, Home/End, and arrow keys are mapped to Numpad keys
+ * 2. For letter keys (KeyA-KeyZ), checks the deprecated keyCode property to handle non-QWERTY layouts
+ *    (e.g., AZERTY, QWERTZ) where event.code may not match the expected letter
+ *
+ * @param event - The keyboard event to normalize
+ * @returns The normalized key code string (e.g., 'KeyA', 'ArrowDown', 'Enter')
+ *
+ * @example
+ * // On an AZERTY layout, pressing Ctrl+A (where 'A' is physically at 'Q' position)
+ * // event.code = 'KeyQ', event.keyCode = 65
+ * const code = normalizeKeys(event); // Returns 'KeyA'
+ */
+export declare const normalizeKeys: (event: KeyboardEvent) => string;

package/esm2022/utils/numpad-keys-normalizer.mjs

@@ -1,40 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2025 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-import { Keys } from "../enums";
-/**
- * @hidden
- *
- * On some keyboards, PageUp/Down, Home/End, and arrow keys are mapped to Numpad keys
- */
-export const normalizeNumpadKeys = (event) => {
-    if (event.code === Keys.Numpad1 && event.key === Keys.End) {
-        return Keys.End;
-    }
-    if (event.code === Keys.Numpad2 && event.key === Keys.ArrowDown) {
-        return Keys.ArrowDown;
-    }
-    if (event.code === Keys.Numpad3 && event.key === Keys.PageDown) {
-        return Keys.PageDown;
-    }
-    if (event.code === Keys.Numpad4 && event.key === Keys.ArrowLeft) {
-        return Keys.ArrowLeft;
-    }
-    if (event.code === Keys.Numpad6 && event.key === Keys.ArrowRight) {
-        return Keys.ArrowRight;
-    }
-    if (event.code === Keys.Numpad7 && event.key === Keys.Home) {
-        return Keys.Home;
-    }
-    if (event.code === Keys.Numpad8 && event.key === Keys.ArrowUp) {
-        return Keys.ArrowUp;
-    }
-    if (event.code === Keys.Numpad9 && event.key === Keys.PageUp) {
-        return Keys.PageUp;
-    }
-    if (event.code === Keys.NumpadEnter) {
-        return Keys.Enter;
-    }
-    return event.code;
-};

package/utils/numpad-keys-normalizer.d.ts

@@ -1,10 +0,0 @@
-/**-----------------------------------------------------------------------------------------
-* Copyright © 2025 Progress Software Corporation. All rights reserved.
-* Licensed under commercial license. See LICENSE.md in the project root for more information
-*-------------------------------------------------------------------------------------------*/
-/**
- * @hidden
- *
- * On some keyboards, PageUp/Down, Home/End, and arrow keys are mapped to Numpad keys
- */
-export declare const normalizeNumpadKeys: (event: KeyboardEvent) => string;