2.0.15

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@designestate/dees-domtools",
-  "version": "2.0.9",
+  "version": "2.0.15",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "@designestate/dees-domtools",
-      "version": "2.0.9",
+      "version": "2.0.15",
       "license": "MIT",
       "dependencies": {
         "@apiglobal/typedrequest": "^2.0.3",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@designestate/dees-domtools",
-  "version": "2.0.9",
+  "version": "2.0.15",
   "private": false,
   "description": "tools to simplify complex css structures",
   "main": "dist_ts/index.js",

ts/domtools.classes.domtools.ts

@@ -6,13 +6,17 @@ import { TViewport } from './domtools.css.breakpoints.js';
 import { Scroller } from './domtools.classes.scroller.js';
 import { WebSetup } from '@pushrocks/websetup';
 import { ThemeManager } from './domtools.classes.thememanager.js';
-import { Keyboard, Key } from './domtools.classes.keyboard.js';
+import { Keyboard } from './domtools.classes.keyboard.js';
 
 export interface IDomToolsState {
   virtualViewport: TViewport;
   jwt: string;
 }
 
+export interface IDomToolsContructorOptions {
+  ignoreGlobal?: boolean;
+}
+
 export class DomTools {
   // ======
   // STATIC
@@ -20,10 +24,10 @@ export class DomTools {
   /**
    * setups domtools
    */
-  public static async setupDomTools() {
+  public static async setupDomTools(optionsArg: IDomToolsContructorOptions = {}) {
     let domToolsInstance: DomTools;
-    if (!globalThis.deesDomTools) {
-      globalThis.deesDomTools = new DomTools();
+    if (!globalThis.deesDomTools && !optionsArg.ignoreGlobal) {
+      globalThis.deesDomTools = new DomTools(optionsArg);
       domToolsInstance = globalThis.deesDomTools;
 
       // lets make sure the dom is ready
@@ -36,6 +40,8 @@ export class DomTools {
       };
       document.addEventListener('readystatechange', readyStateChangedFunc);
       domToolsInstance.domToolsReady.resolve();
+    } else if (optionsArg.ignoreGlobal) {
+      domToolsInstance = new DomTools(optionsArg);
     } else {
       domToolsInstance = globalThis.deesDomTools;
     }
@@ -75,7 +81,7 @@ export class DomTools {
   public smartstate = new plugins.smartstate.Smartstate();
   public domToolsStatePart = this.smartstate.getStatePart<IDomToolsState>('domtools', {
     virtualViewport: 'native',
-    jwt: null
+    jwt: null,
   });
 
   public router = new plugins.smartrouter.SmartRouter({
@@ -94,12 +100,11 @@ export class DomTools {
   public themeManager = new ThemeManager(this);
   public keyboard = new Keyboard(document.body);
 
-
   public domToolsReady = plugins.smartpromise.defer();
   public domReady = plugins.smartpromise.defer();
   public globalStylesReady = plugins.smartpromise.defer();
 
-  constructor() {}
+  constructor(optionsArg: IDomToolsContructorOptions) {}
 
   private runOnceTrackerStringMap = new Stringmap();
   private runOnceResultMap = new FastMap();

ts/domtools.classes.keyboard.ts

@@ -1,3 +1,5 @@
+import * as plugins from './domtools.plugins.js';
+
 export enum Key {
   Backspace = 8,
   Tab = 9,
@@ -123,102 +125,78 @@ export enum Key {
 
   OpenBracket = 219,
   ClosedBracket = 221,
-  Quote = 222
+  Quote = 222,
 }
 
-type KeyCombo = Array<Key>
-
-/**
- * @param {KeyboardEvent} event - pressed key event, in case of multi-key combos
- *  the last pressed key event is passed to this handler
- */
-type Handler = (event: KeyboardEvent) => void
+type KeyCombo = Array<Key>;
 
 export class Keyboard {
-  private mapCombosToHandlers = new Map<number[], Handler[]>();
+  private mapCombosToHandlers = new Map<number[], plugins.smartrx.rxjs.Subject<KeyboardEvent>>();
   private pressedKeys = new Set<Key>();
 
-  constructor(
-      private domNode: Element | Document
-  ) {
-      this.startListening()
+  constructor(private domNode: Element | Document) {
+    this.startListening();
   }
 
-  on(keys: Key[] | KeyCombo[], callback: Handler) {
-      const combos = this.toCombos(keys)
+  public keyEnum = Key;
 
-      combos.forEach(combo => {
-          this.registerComboCallback(combo, callback)
-      })
+  public on(keys: Key[]) {
+    const subject = new plugins.smartrx.rxjs.Subject<KeyboardEvent>();
+    this.registerKeys(keys, subject);
+    return subject;
   }
 
-  startListening() {
-      this.domNode.addEventListener('keydown', this.handleKeyDown)
-      this.domNode.addEventListener('keyup', this.handleKeyUp)
+  public startListening() {
+    this.domNode.addEventListener('keydown', this.handleKeyDown);
+    this.domNode.addEventListener('keyup', this.handleKeyUp);
   }
 
-  stopListening() {
-      this.domNode.removeEventListener('keydown', this.handleKeyDown)
-      this.domNode.removeEventListener('keyup', this.handleKeyUp)
+  public stopListening() {
+    this.domNode.removeEventListener('keydown', this.handleKeyDown);
+    this.domNode.removeEventListener('keyup', this.handleKeyUp);
   }
 
-  clear() {
-      this.stopListening()
-      this.mapCombosToHandlers.clear()
-      this.pressedKeys.clear()
+  public clear() {
+    this.stopListening();
+    this.mapCombosToHandlers.clear();
+    this.pressedKeys.clear();
   }
 
   private handleKeyDown = (event: KeyboardEvent) => {
-      this.pressedKeys.add(event.keyCode)
+    this.pressedKeys.add(event.keyCode);
 
-      this.mapCombosToHandlers.forEach((handlers, combo) => {
-          if (this.isComboPressed(combo)) {
-              handlers.forEach(handler => handler(event))
-          }
-      })
+    this.mapCombosToHandlers.forEach((subjectArg, keysArg) => {
+      if (this.areAllKeysPressed(keysArg)) {
+        subjectArg.next(event);
       }
+    });
+  };
 
   private handleKeyUp = (event: KeyboardEvent) => {
-      this.pressedKeys.delete(event.keyCode)
-  }
+    this.pressedKeys.delete(event.keyCode);
+  };
 
-  private isComboPressed(combo: number[]) {
-      let result = true
+  private areAllKeysPressed(combo: number[]) {
+    let result = true;
 
-      combo.forEach(key => {
+    combo.forEach((key) => {
       if (!this.pressedKeys.has(key)) {
-              result = false
+        result = false;
       }
-      })
+    });
 
-      return result
+    return result;
   }
 
-  private registerComboCallback(combo: Array<Key>, callback: Handler) {
-      if (!this.mapCombosToHandlers.has(combo)) {
-          this.mapCombosToHandlers.set(combo, [])
-      }
-
-      const handlers = this.mapCombosToHandlers.get(combo)
-
-      handlers!.push(callback)
-  }
-
-  private toCombos(keys: KeyCombo[] | Key[]) {
-      if (keys.length === 0) {
-          return []
-      }
-
-      const isKeys = !Array.isArray(keys[0])
-      let combos: KeyCombo[] = []
-
-      if (isKeys) {
-          combos = (keys as Key[]).map(key => [key])
+  private registerKeys(
+    keysArg: Array<Key>,
+    subjectArg: plugins.smartrx.rxjs.Subject<KeyboardEvent>
+  ) {
+    if (!this.mapCombosToHandlers.has(keysArg)) {
+      this.mapCombosToHandlers.set(keysArg, subjectArg);
     } else {
-          combos = keys as KeyCombo[]
-          combos = combos.filter(combo => combo.length > 0)
-      }
-
-      return combos
+      const subject = this.mapCombosToHandlers.get(keysArg);
+      return subject;
+    }
   }
 }

ts/domtools.elementbasic.ts

@@ -1,5 +1,5 @@
 import * as plugins from './domtools.plugins.js';
-import { DomTools } from './domtools.classes.domtools.js';
+import { DomTools, IDomToolsContructorOptions } from './domtools.classes.domtools.js';
 import { scrollBarStyles, globalBaseStyles } from './domtools.css.basestyles.js';
 
 import { html, LitElement, css, unsafeCSS } from 'lit';
@@ -40,8 +40,8 @@ export const styles = html`
  * a basic setup for elements
  * makes sure everything is in check
  */
-export const setup = async (elementArg?: LitElement): Promise<DomTools> => {
-  const domTools = await DomTools.setupDomTools();
+export const setup = async (elementArg?: LitElement, optionsArg: IDomToolsContructorOptions = {}): Promise<DomTools> => {
+  const domTools = await DomTools.setupDomTools(optionsArg);
 
   if (elementArg) {
     // lets do something with the element

ts/index.ts

@@ -5,7 +5,7 @@ import * as breakpoints from './domtools.css.breakpoints.js';
 import * as css from './domtools.css.js';
 
 export { css, breakpoints, elementBasic };
-export { DomTools } from './domtools.classes.domtools.js';
+export { DomTools, IDomToolsContructorOptions } from './domtools.classes.domtools.js';
 export { TypedRequest } from '@apiglobal/typedrequest';
 export { IWebSetupConstructorOptions } from '@pushrocks/websetup';
 export { rxjs } from '@pushrocks/smartrx';