@taufik-nurrohman/text-editor.key 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright © 2024 Taufik Nurrohman <https://github.com/taufik-nurrohman>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,6 @@
+Text Editor Key
+================
+
+> Key extension for [Text Editor](https://github.com/taufik-nurrohman/text-editor).
+
+Provides a feature to easily interact with the keyboard keys.

package/index.js

@@ -0,0 +1,241 @@
+/*!
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright © 2024 Taufik Nurrohman <https://github.com/taufik-nurrohman>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the “Software”), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+(function (g, f) {
+    typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = f() : typeof define === 'function' && define.amd ? define(f) : (g = typeof globalThis !== 'undefined' ? globalThis : g || self, (g.TextEditor = g.TextEditor || {}, g.TextEditor.Key = f()));
+})(this, (function () {
+    'use strict';
+    var isArray = function isArray(x) {
+        return Array.isArray(x);
+    };
+    var isDefined = function isDefined(x) {
+        return 'undefined' !== typeof x;
+    };
+    var isFunction = function isFunction(x) {
+        return 'function' === typeof x;
+    };
+    var isInstance = function isInstance(x, of) {
+        return x && isSet(of) && x instanceof of ;
+    };
+    var isNull = function isNull(x) {
+        return null === x;
+    };
+    var isObject = function isObject(x, isPlain) {
+        if (isPlain === void 0) {
+            isPlain = true;
+        }
+        if ('object' !== typeof x) {
+            return false;
+        }
+        return isPlain ? isInstance(x, Object) : true;
+    };
+    var isSet = function isSet(x) {
+        return isDefined(x) && !isNull(x);
+    };
+    var isString = function isString(x) {
+        return 'string' === typeof x;
+    };
+    var hasValue = function hasValue(x, data) {
+        return -1 !== data.indexOf(x);
+    };
+    var fromStates = function fromStates() {
+        for (var _len = arguments.length, lot = new Array(_len), _key = 0; _key < _len; _key++) {
+            lot[_key] = arguments[_key];
+        }
+        var out = lot.shift();
+        for (var i = 0, j = toCount(lot); i < j; ++i) {
+            for (var k in lot[i]) {
+                // Assign value
+                if (!isSet(out[k])) {
+                    out[k] = lot[i][k];
+                    continue;
+                }
+                // Merge array
+                if (isArray(out[k]) && isArray(lot[i][k])) {
+                    out[k] = [ /* Clone! */ ].concat(out[k]);
+                    for (var ii = 0, jj = toCount(lot[i][k]); ii < jj; ++ii) {
+                        if (!hasValue(lot[i][k][ii], out[k])) {
+                            out[k].push(lot[i][k][ii]);
+                        }
+                    }
+                    // Merge object recursive
+                } else if (isObject(out[k]) && isObject(lot[i][k])) {
+                    out[k] = fromStates({
+                        /* Clone! */ }, out[k], lot[i][k]);
+                    // Replace value
+                } else {
+                    out[k] = lot[i][k];
+                }
+            }
+        }
+        return out;
+    };
+    var toCount = function toCount(x) {
+        return x.length;
+    };
+    var toObjectKeys = function toObjectKeys(x) {
+        return Object.keys(x);
+    };
+
+    function Key(self) {
+        var $ = this;
+        var queue = {};
+        $.command = function (v) {
+            if (isString(v)) {
+                return v === $.toString();
+            }
+            var command = $.keys[$.toString()];
+            return isSet(command) ? command : false;
+        };
+        $.commands = {};
+        $.fire = function (command) {
+            var self = $.self || $,
+                value,
+                exist;
+            if (isFunction(command)) {
+                value = command.call(self);
+                exist = true;
+            } else if (isString(command) && (command = $.commands[command])) {
+                value = command.call(self);
+                exist = true;
+            } else if (isArray(command)) {
+                var data = command[1] || [];
+                if (command = $.commands[command[0]]) {
+                    value = command.apply(self, data);
+                    exist = true;
+                }
+            }
+            return exist ? isSet(value) ? value : true : null;
+        };
+        $.key = null;
+        $.keys = {};
+        $.pull = function (key) {
+            $.key = null;
+            if (!isSet(key)) {
+                return queue = {}, $;
+            }
+            return delete queue[key], $;
+        };
+        $.push = function (key) {
+            return queue[$.key = key] = 1, $;
+        };
+        $.self = self;
+        $.toString = function () {
+            return toObjectKeys(queue).join('-');
+        };
+        return $;
+    }
+    var debounce = function debounce(then, time) {
+        var timer;
+        return function () {
+            var _arguments = arguments,
+                _this = this;
+            timer && clearTimeout(timer);
+            timer = setTimeout(function () {
+                return then.apply(_this, _arguments);
+            }, time);
+        };
+    };
+    var offEvent = function offEvent(name, node, then) {
+        node.removeEventListener(name, then);
+    };
+    var offEventDefault = function offEventDefault(e) {
+        return e && e.preventDefault();
+    };
+    var onEvent = function onEvent(name, node, then, options) {
+        if (options === void 0) {
+            options = false;
+        }
+        node.addEventListener(name, then, options);
+    };
+    var bounce = debounce(function (map) {
+        return map.pull();
+    }, 1000);
+
+    function onBlur(e) {
+        this.Key.pull(); // Reset all key(s)
+    }
+
+    function onInput(e) {
+        this.Key.pull(); // Reset all key(s)
+    }
+
+    function onKeyDown(e) {
+        var command,
+            map = this.Key,
+            v;
+        map.push(e.key); // Add current key to the queue
+        if (command = map.command()) {
+            v = map.fire(command);
+            if (false === v) {
+                offEventDefault(e);
+            } else if (null === v) {
+                console.warn('Unknown command: `' + command + '`');
+            }
+        }
+        bounce(map); // Reset all key(s) after 1 second idle
+    }
+
+    function onKeyUp(e) {
+        this.Key.pull(e.key); // Reset current key
+    }
+
+    function attach(self) {
+        var $ = this;
+        var map = new Key($);
+        $.command = function (command, of) {
+            return $.commands[command] = of, $;
+        };
+        $.commands = fromStates(map.commands, $.state.commands || {});
+        $.k = function () {
+            return map + "";
+        };
+        $.key = function (key, of) {
+            return $.keys[key] = of, $;
+        };
+        $.keys = fromStates(map.keys, $.state.keys || {});
+        onEvent('blur', self, onBlur);
+        onEvent('input', self, onInput);
+        onEvent('keydown', self, onKeyDown);
+        onEvent('keyup', self, onKeyUp);
+        self.Key = map;
+    }
+
+    function detach(self) {
+        var $ = this;
+        delete $.commands;
+        delete $.keys;
+        delete self.Key;
+        offEvent('blur', self, onBlur);
+        offEvent('input', self, onInput);
+        offEvent('keydown', self, onKeyDown);
+        offEvent('keyup', self, onKeyUp);
+    }
+    var index_js = {
+        attach: attach,
+        detach: detach
+    };
+    return index_js;
+}));

package/index.min.js

@@ -0,0 +1,26 @@
+/*!
+ *
+ * The MIT License (MIT)
+ *
+ * Copyright © 2024 Taufik Nurrohman <https://github.com/taufik-nurrohman>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the “Software”), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ */
+!function(n,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define(e):((n="undefined"!=typeof globalThis?globalThis:n||self).TextEditor=n.TextEditor||{},n.TextEditor.Key=e())}(this,(function(){"use strict";var n=function(n){return Array.isArray(n)},e=function(n){return"function"==typeof n},t=function(n,e){return void 0===e&&(e=!0),"object"==typeof n&&(!e||function(n,e){return n&&r(e)&&n instanceof e}(n,Object))},r=function(n){return function(n){return void 0!==n}(n)&&!function(n){return null===n}(n)},u=function(n){return"string"==typeof n},o=function e(){for(var u=arguments.length,o=Array(u),f=0;f<u;f++)o[f]=arguments[f];for(var c,s=o.shift(),l=0,a=i(o);l<a;++l)for(var d in o[l])if(r(s[d]))if(n(s[d])&&n(o[l][d])){s[d]=[].concat(s[d]);for(var y=0,m=i(o[l][d]);y<m;++y)c=o[l][d][y],-1===s[d].indexOf(c)&&s[d].push(o[l][d][y])}else t(s[d])&&t(o[l][d])?s[d]=e({},s[d],o[l][d]):s[d]=o[l][d];else s[d]=o[l][d];return s},i=function(n){return n.length},f=function(n){return Object.keys(n)};function c(t){var o=this,i={};return o.command=function(n){if(u(n))return n===o.toString();var e=o.keys[o.toString()];return!!r(e)&&e},o.commands={},o.fire=function(t){var i,f,c=o.self||o;if(e(t))i=t.call(c),f=!0;else if(u(t)&&(t=o.commands[t]))i=t.call(c),f=!0;else if(n(t)){var s=t[1]||[];(t=o.commands[t[0]])&&(i=t.apply(c,s),f=!0)}return f?!r(i)||i:null},o.key=null,o.keys={},o.pull=function(n){return o.key=null,r(n)?(delete i[n],o):(i={},o)},o.push=function(n){return i[o.key=n]=1,o},o.self=t,o.toString=function(){return f(i).join("-")},o}var s,l,a,d=function(n,e,t){e.removeEventListener(n,t)},y=function(n){return n&&n.preventDefault()},m=function(n,e,t,r){void 0===r&&(r=!1),e.addEventListener(n,t,r)},p=(s=function(n){return n.pull()},l=1e3,function(){var n=arguments,e=this;a&&clearTimeout(a),a=setTimeout((function(){return s.apply(e,n)}),l)});function h(n){this.Key.pull()}function k(n){this.Key.pull()}function v(n){var e,t,r=this.Key;r.push(n.key),(e=r.command())&&(!1===(t=r.fire(e))?y(n):null===t&&console.warn("Unknown command: `"+e+"`")),p(r)}function b(n){this.Key.pull(n.key)}return{attach:function(n){var e=this,t=new c(e);e.command=function(n,t){return e.commands[n]=t,e},e.commands=o(t.commands,e.state.commands||{}),e.k=function(){return t+""},e.key=function(n,t){return e.keys[n]=t,e},e.keys=o(t.keys,e.state.keys||{}),m("blur",n,h),m("input",n,k),m("keydown",n,v),m("keyup",n,b),n.Key=t},detach:function(n){delete this.commands,delete this.keys,delete n.Key,d("blur",n,h),d("input",n,k),d("keydown",n,v),d("keyup",n,b)}}}));

package/index.mjs

@@ -0,0 +1,60 @@
+import Key from '@taufik-nurrohman/key';
+import {debounce} from '@taufik-nurrohman/tick';
+import {fromStates} from '@taufik-nurrohman/from';
+import {onEvent, offEvent, offEventDefault} from '@taufik-nurrohman/event';
+
+const bounce = debounce(map => map.pull(), 1000);
+
+function onBlur(e) {
+    this.Key.pull(); // Reset all key(s)
+}
+
+function onInput(e) {
+    this.Key.pull(); // Reset all key(s)
+}
+
+function onKeyDown(e) {
+    let command, map = this.Key, v;
+    map.push(e.key); // Add current key to the queue
+    if (command = map.command()) {
+        v = map.fire(command);
+        if (false === v) {
+            offEventDefault(e);
+        } else if (null === v) {
+            console.warn('Unknown command: `' + command + '`');
+        }
+    }
+    bounce(map); // Reset all key(s) after 1 second idle
+}
+
+function onKeyUp(e) {
+    this.Key.pull(e.key); // Reset current key
+}
+
+function attach(self) {
+    let $ = this;
+    let map = new Key($);
+    $.command = (command, of) => (($.commands[command] = of), $);
+    $.commands = fromStates(map.commands, $.state.commands || {});
+    $.k = () => map + "";
+    $.key = (key, of) => (($.keys[key] = of), $);
+    $.keys = fromStates(map.keys, $.state.keys || {});
+    onEvent('blur', self, onBlur);
+    onEvent('input', self, onInput);
+    onEvent('keydown', self, onKeyDown);
+    onEvent('keyup', self, onKeyUp);
+    self.Key = map;
+}
+
+function detach(self) {
+    let $ = this;
+    delete $.commands;
+    delete $.keys;
+    delete self.Key;
+    offEvent('blur', self, onBlur);
+    offEvent('input', self, onInput);
+    offEvent('keydown', self, onKeyDown);
+    offEvent('keyup', self, onKeyUp);
+}
+
+export default {attach, detach};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "author": "Taufik Nurrohman",
+  "browser": "index.min.js",
+  "bugs": "https://github.com/taufik-nurrohman/text-editor.key/issues",
+  "dependencies": {
+    "@taufik-nurrohman/event": "*",
+    "@taufik-nurrohman/from": "*",
+    "@taufik-nurrohman/key": "*",
+    "@taufik-nurrohman/text-editor": "*",
+    "@taufik-nurrohman/tick": "*"
+  },
+  "description": "Provides a feature to easily interact with the keyboard keys.",
+  "devDependencies": {
+    "@taufik-nurrohman/factory": "*"
+  },
+  "exports": {
+    "import": "./index.mjs",
+    "require": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "index.min.js",
+    "index.mjs"
+  ],
+  "funding": {
+    "url": "https://paypal.me/tatautaufik"
+  },
+  "homepage": "https://taufik-nurrohman.js.org/text-editor.key",
+  "keywords": [
+    "command",
+    "editor",
+    "extension",
+    "key",
+    "keyboard",
+    "text"
+  ],
+  "license": "MIT",
+  "main": "index.js",
+  "module": "index.mjs",
+  "name": "@taufik-nurrohman/text-editor.key",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/taufik-nurrohman/text-editor.key.git"
+  },
+  "scripts": {
+    "pack": "pack --clean=false --from=.factory --js-format=umd --js-name=TextEditor.Key --js-top='%(js.license)' --mjs=true --to=."
+  },
+  "version": "1.0.0"
+}