@softheon/armature 21.17.0 → 21.18.1

package/fesm2022/softheon-armature.mjs

@@ -3661,6 +3661,32 @@ var States;
     States["WY"] = "Wyoming";
 })(States || (States = {}));
 
+/**
+ * Helpers shared by the input filtering directives.
+ */
+/**
+ * Keys that never insert a character and must always reach the input:
+ * delete, backspace, tab, escape, enter, decimal point (numpad and keyboard).
+ */
+const NON_PRINTABLE_KEY_CODES = [46, 8, 9, 27, 13, 110, 190];
+/**
+ * Determines whether a keydown is a modifier driven editing shortcut.
+ *
+ * Copy, cut, paste, select all, undo and redo are triggered with `Ctrl` on
+ * Windows/Linux and with `Cmd` on macOS. macOS reports `Cmd` through
+ * `metaKey`, not `ctrlKey`, so both must be accepted or the filtering
+ * directives end up calling `preventDefault()` on those shortcuts.
+ *
+ * `altKey` is excluded on purpose: `AltGr` is reported as `Ctrl + Alt` on some
+ * layouts and is used to type characters that these directives still filter.
+ *
+ * @param event The keyboard event raised by the input.
+ * @returns True when the event is a non destructive modifier shortcut that must be allowed.
+ */
+function isEditingShortcut(event) {
+    return (event.ctrlKey || event.metaKey) && !event.altKey;
+}
+
 /**
  * Numbers only directive
  */
@@ -3679,15 +3705,11 @@ class NumbersOnlyDirective {
     onKeyDown(event) {
         const e = event;
         if (this.sofArNumbersOnly) {
-            if ([46, 8, 9, 27, 13, 110, 190].indexOf(e.keyCode) !== -1 ||
-                // Allow: Ctrl+A
-                (e.keyCode === 65 && e.ctrlKey) ||
-                // Allow: Ctrl+C
-                (e.keyCode === 67 && e.ctrlKey) ||
-                // Allow: Ctrl+X
-                (e.keyCode === 88 && e.ctrlKey) ||
-                // Allow: Ctrl+V
-                (e.keyCode === 86 && e.ctrlKey) ||
+            // Allow Ctrl/Cmd shortcuts (copy, cut, paste, select all, undo, redo).
+            if (isEditingShortcut(e)) {
+                return;
+            }
+            if (NON_PRINTABLE_KEY_CODES.indexOf(e.keyCode) !== -1 ||
                 // Allow: home, end, left, right
                 (e.keyCode >= 35 && e.keyCode <= 39)) {
                 // let it happen, don't do anything
@@ -3838,13 +3860,11 @@ class AlphaNumericDirective {
         // Reset values each time
         this.isNumber = false;
         this.isLetter = false;
-        if (this.allowedKeys.indexOf(e.code.toLowerCase()) !== -1 ||
-            // Allow: Ctrl+A
-            (e.code.toLowerCase() === 'keya' && e.ctrlKey) ||
-            // Allow: Ctrl+C
-            (e.code.toLowerCase() === 'keyc' && e.ctrlKey) ||
-            // Allow: Ctrl+X
-            (e.code.toLowerCase() === 'keyx' && e.ctrlKey)) {
+        // Allow Ctrl/Cmd shortcuts (copy, cut, paste, select all, undo, redo).
+        if (isEditingShortcut(e)) {
+            return;
+        }
+        if (this.allowedKeys.indexOf(e.code.toLowerCase()) !== -1) {
             // let it happen, don't do anything
             return;
         }
@@ -4021,13 +4041,11 @@ class LettersCharactersDirective {
     onKeyDown(event) {
         const e = event;
         if (this.sofArLettersAndSpecialCharacters) {
-            if ([46, 8, 9, 27, 13, 110, 190].indexOf(e.keyCode) !== -1 ||
-                // Allow: Ctrl+A
-                (e.keyCode === 65 && e.ctrlKey) ||
-                // Allow: Ctrl+C
-                (e.keyCode === 67 && e.ctrlKey) ||
-                // Allow: Ctrl+X
-                (e.keyCode === 88 && e.ctrlKey) ||
+            // Allow Ctrl/Cmd shortcuts (copy, cut, paste, select all, undo, redo).
+            if (isEditingShortcut(e)) {
+                return;
+            }
+            if (NON_PRINTABLE_KEY_CODES.indexOf(e.keyCode) !== -1 ||
                 // Allow: spaces
                 (e.keyCode === 32) ||
                 // Allow: - (minus sign) on numpad or alphabet keyboard key
@@ -4107,13 +4125,11 @@ class LettersOnlyDirective {
     onKeyDown(event) {
         const e = event;
         if (this.sofArLettersOnly) {
-            if ([46, 8, 9, 27, 13, 110, 190].indexOf(e.keyCode) !== -1 ||
-                // Allow: Ctrl+A
-                (e.keyCode === 65 && e.ctrlKey) ||
-                // Allow: Ctrl+C
-                (e.keyCode === 67 && e.ctrlKey) ||
-                // Allow: Ctrl+X
-                (e.keyCode === 88 && e.ctrlKey) ||
+            // Allow Ctrl/Cmd shortcuts (copy, cut, paste, select all, undo, redo).
+            if (isEditingShortcut(e)) {
+                return;
+            }
+            if (NON_PRINTABLE_KEY_CODES.indexOf(e.keyCode) !== -1 ||
                 // Allow: spaces
                 (e.keyCode === 32) ||
                 // Allow: - (minus sign) on numpad or alphabet keyboard key