clarity-js 0.8.42 → 0.8.44

package/src/interaction/change.ts

@@ -1,38 +1,38 @@
-import { Constant, Event, Setting } from "@clarity-types/data";
-import { ChangeState } from "@clarity-types/interaction";
-import config from "@src/core/config";
-import { bind } from "@src/core/event";
-import hash from "@src/core/hash";
-import { schedule } from "@src/core/task";
-import { time } from "@src/core/time";
-import { target } from "@src/layout/target";
-import encode from "./encode";
-import { Mask } from "@clarity-types/layout";
-
-export let state: ChangeState[] = [];
-
-export function start(): void {
-    reset();
-}
-
-export function observe(root: Node): void {
-    bind(root, "change", recompute, true);
-}
-
-function recompute(evt: UIEvent): void {
-    let element = target(evt) as HTMLInputElement;
-    if (element) {
-        let value = element.value;
-        let checksum = value && value.length >= Setting.WordLength && config.fraud && Mask.Exclude.indexOf(element.type) === -1 ? hash(value, Setting.ChecksumPrecision) : Constant.Empty;
-        state.push({ time: time(evt), event: Event.Change, data: { target: target(evt), type: element.type, value, checksum } });
-        schedule(encode.bind(this, Event.Change));
-    }    
-}
-
-export function reset(): void {
-    state = [];
-}
-
-export function stop(): void {
-    reset();
-}
+import { Constant, Event, Setting } from "@clarity-types/data";
+import { ChangeState } from "@clarity-types/interaction";
+import config from "@src/core/config";
+import { bind } from "@src/core/event";
+import hash from "@src/core/hash";
+import { schedule } from "@src/core/task";
+import { time } from "@src/core/time";
+import { target } from "@src/layout/target";
+import encode from "./encode";
+import { Mask } from "@clarity-types/layout";
+
+export let state: ChangeState[] = [];
+
+export function start(): void {
+    reset();
+}
+
+export function observe(root: Node): void {
+    bind(root, "change", recompute, true);
+}
+
+function recompute(evt: UIEvent): void {
+    let element = target(evt) as HTMLInputElement;
+    if (element) {
+        let value = element.value;
+        let checksum = value && value.length >= Setting.WordLength && config.fraud && Mask.Exclude.indexOf(element.type) === -1 ? hash(value, Setting.ChecksumPrecision) : Constant.Empty;
+        state.push({ time: time(evt), event: Event.Change, data: { target: target(evt), type: element.type, value, checksum } });
+        schedule(encode.bind(this, Event.Change));
+    }    
+}
+
+export function reset(): void {
+    state = [];
+}
+
+export function stop(): void {
+    reset();
+}

package/src/interaction/click.ts

@@ -1,173 +1,173 @@
-import { BooleanFlag, Constant, Event, Setting } from "@clarity-types/data";
-import { BrowsingContext, ClickState, TextInfo } from "@clarity-types/interaction";
-import { Box } from "@clarity-types/layout";
-import { bind } from "@src/core/event";
-import { schedule } from "@src/core/task";
-import { time } from "@src/core/time";
-import { iframe } from "@src/layout/dom";
-import { offset } from "@src/layout/offset";
-import { target } from "@src/layout/target";
-import encode from "./encode";
-
-const UserInputTags = ["input", "textarea", "radio", "button", "canvas", "select"];
-export let state: ClickState[] = [];
-
-export function start(): void {
-    reset();
-}
-
-export function observe(root: Node): void {
-    bind(root, "click", handler.bind(this, Event.Click, root), true);
-    bind(root, "contextmenu", handler.bind(this, Event.ContextMenu, root), true);
-}
-
-function handler(event: Event, root: Node, evt: MouseEvent): void {
-    let frame = iframe(root);
-    let d = frame && frame.contentDocument ? frame.contentDocument.documentElement : document.documentElement;
-    let x = "pageX" in evt ? Math.round(evt.pageX) : ("clientX" in evt ? Math.round(evt["clientX"] + d.scrollLeft) : null);
-    let y = "pageY" in evt ? Math.round(evt.pageY) : ("clientY" in evt ? Math.round(evt["clientY"] + d.scrollTop) : null);
-    // In case of iframe, we adjust (x,y) to be relative to top parent's origin
-    if (frame) {
-        let distance = offset(frame);
-        x = x ? x + Math.round(distance.x) : x;
-        y = y ? y + Math.round(distance.y) : y;
-    }
-
-    let t = target(evt);
-    // Find nearest anchor tag (<a/>) parent if current target node is part of one
-    // If present, we use the returned link element to populate text and link properties below
-    let a = link(t);
-
-    // Get layout rectangle for the target element
-    let l = layout(t as Element);
-
-    // Reference: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail
-    // This property helps differentiate between a keyboard navigation vs. pointer click
-    // In case of a keyboard navigation, we use center of target element as (x,y)
-    if (evt.detail === 0 && l) {
-        x = Math.round(l.x + (l.w / 2));
-        y = Math.round(l.y + (l.h / 2));
-    }
-
-    let eX = l ? Math.max(Math.floor(((x - l.x) / l.w) * Setting.ClickPrecision), 0) : 0;
-    let eY = l ? Math.max(Math.floor(((y - l.y) / l.h) * Setting.ClickPrecision), 0) : 0;
-
-    // Check for null values before processing this event
-    if (x !== null && y !== null) {
-        const textInfo = text(t);
-        state.push({
-            time: time(evt), event, data: {
-                target: t,
-                x,
-                y,
-                eX,
-                eY,
-                button: evt.button,
-                reaction: reaction(t),
-                context: context(a),
-                text: textInfo.text,
-                link: a ? a.href : null,
-                hash: null,
-                trust: evt.isTrusted ? BooleanFlag.True : BooleanFlag.False,
-                isFullText: textInfo.isFullText,
-                w: l ? l.w : 0,
-                h: l ? l.h : 0,
-                tag: getElementAttribute(t, "tagName").substring(0, Setting.ClickTag),
-                class: getElementAttribute(t, "className").substring(0, Setting.ClickClass),
-                id: getElementAttribute(t, "id").substring(0, Setting.ClickId),
-            }
-        });
-        schedule(encode.bind(this, event));
-    }
-}
-
-function link(node: Node): HTMLAnchorElement {
-    while (node && node !== document) {
-        if (node.nodeType === Node.ELEMENT_NODE) {
-            let element = node as HTMLElement;
-            if (element.tagName === "A") {
-                return element as HTMLAnchorElement;
-            }
-        }
-        node = node.parentNode;
-    }
-    return null;
-}
-
-function text(element: Node): TextInfo {
-    let output = null;
-    let isFullText = false;
-    if (element) {
-        // Grab text using "textContent" for most HTMLElements, however, use "value" for HTMLInputElements and "alt" for HTMLImageElement.
-        let t = element.textContent || String((element as HTMLInputElement).value || '') || (element as HTMLImageElement).alt;
-        if (t) {
-            // Replace multiple occurrence of space characters with a single white space
-            // Also, trim any spaces at the beginning or at the end of string
-            const trimmedText =  t.replace(/\s+/g, Constant.Space).trim();
-            // Finally, send only first few characters as specified by the Setting
-            output = trimmedText.substring(0, Setting.ClickText);
-            isFullText = output.length === trimmedText.length;
-        }
-    }
-
-    return { text: output, isFullText: isFullText ? BooleanFlag.True : BooleanFlag.False };
-}
-
-function reaction(element: Node): BooleanFlag {
-    const tag = getElementAttribute(element, "tagName");
-    if (UserInputTags.indexOf(tag) >= 0) {
-        return BooleanFlag.False;
-    }
-    return BooleanFlag.True;
-}
-
-function getElementAttribute(element: Node, attribute: "tagName" | "className" | "id"): string {
-    if (element.nodeType === Node.ELEMENT_NODE) {
-        const attr = (element as HTMLElement)?.[attribute];
-        const value = typeof attr === "string" ? attr?.toLowerCase() : "";
-        return value;
-    }
-    return "";
-}
-
-function layout(element: Element): Box {
-    let box: Box = null;
-    let de = document.documentElement;
-    if (typeof element.getBoundingClientRect === "function") {
-        // getBoundingClientRect returns rectangle relative positioning to viewport
-        let rect = element.getBoundingClientRect();
-
-        if (rect && rect.width > 0 && rect.height > 0) {
-            // Add viewport's scroll position to rectangle to get position relative to document origin
-            // Also: using Math.floor() instead of Math.round() because in Edge,
-            // getBoundingClientRect returns partial pixel values (e.g. 162.5px) and Chrome already
-            // floors the value (e.g. 162px). This keeps consistent behavior across browsers.
-            box = {
-                x: Math.floor(rect.left + ("pageXOffset" in window ? window.pageXOffset : de.scrollLeft)),
-                y: Math.floor(rect.top + ("pageYOffset" in window ? window.pageYOffset : de.scrollTop)),
-                w: Math.floor(rect.width),
-                h: Math.floor(rect.height)
-            };
-        }
-    }
-    return box;
-}
-
-function context(a: HTMLAnchorElement): BrowsingContext {
-    if (a && a.hasAttribute(Constant.Target)) {
-        switch (a.getAttribute(Constant.Target)) {
-            case Constant.Blank: return BrowsingContext.Blank;
-            case Constant.Parent: return BrowsingContext.Parent;
-            case Constant.Top: return BrowsingContext.Top;
-        }
-    }
-    return BrowsingContext.Self;
-}
-
-export function reset(): void {
-    state = [];
-}
-
-export function stop(): void {
-    reset();
-}
+import { BooleanFlag, Constant, Event, Setting } from "@clarity-types/data";
+import { BrowsingContext, ClickState, TextInfo } from "@clarity-types/interaction";
+import { Box } from "@clarity-types/layout";
+import { bind } from "@src/core/event";
+import { schedule } from "@src/core/task";
+import { time } from "@src/core/time";
+import { iframe } from "@src/layout/dom";
+import { offset } from "@src/layout/offset";
+import { target } from "@src/layout/target";
+import encode from "./encode";
+
+const UserInputTags = ["input", "textarea", "radio", "button", "canvas", "select"];
+export let state: ClickState[] = [];
+
+export function start(): void {
+    reset();
+}
+
+export function observe(root: Node): void {
+    bind(root, "click", handler.bind(this, Event.Click, root), true);
+    bind(root, "contextmenu", handler.bind(this, Event.ContextMenu, root), true);
+}
+
+function handler(event: Event, root: Node, evt: MouseEvent): void {
+    let frame = iframe(root);
+    let d = frame && frame.contentDocument ? frame.contentDocument.documentElement : document.documentElement;
+    let x = "pageX" in evt ? Math.round(evt.pageX) : ("clientX" in evt ? Math.round(evt["clientX"] + d.scrollLeft) : null);
+    let y = "pageY" in evt ? Math.round(evt.pageY) : ("clientY" in evt ? Math.round(evt["clientY"] + d.scrollTop) : null);
+    // In case of iframe, we adjust (x,y) to be relative to top parent's origin
+    if (frame) {
+        let distance = offset(frame);
+        x = x ? x + Math.round(distance.x) : x;
+        y = y ? y + Math.round(distance.y) : y;
+    }
+
+    let t = target(evt);
+    // Find nearest anchor tag (<a/>) parent if current target node is part of one
+    // If present, we use the returned link element to populate text and link properties below
+    let a = link(t);
+
+    // Get layout rectangle for the target element
+    let l = layout(t as Element);
+
+    // Reference: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail
+    // This property helps differentiate between a keyboard navigation vs. pointer click
+    // In case of a keyboard navigation, we use center of target element as (x,y)
+    if (evt.detail === 0 && l) {
+        x = Math.round(l.x + (l.w / 2));
+        y = Math.round(l.y + (l.h / 2));
+    }
+
+    let eX = l ? Math.max(Math.floor(((x - l.x) / l.w) * Setting.ClickPrecision), 0) : 0;
+    let eY = l ? Math.max(Math.floor(((y - l.y) / l.h) * Setting.ClickPrecision), 0) : 0;
+
+    // Check for null values before processing this event
+    if (x !== null && y !== null) {
+        const textInfo = text(t);
+        state.push({
+            time: time(evt), event, data: {
+                target: t,
+                x,
+                y,
+                eX,
+                eY,
+                button: evt.button,
+                reaction: reaction(t),
+                context: context(a),
+                text: textInfo.text,
+                link: a ? a.href : null,
+                hash: null,
+                trust: evt.isTrusted ? BooleanFlag.True : BooleanFlag.False,
+                isFullText: textInfo.isFullText,
+                w: l ? l.w : 0,
+                h: l ? l.h : 0,
+                tag: getElementAttribute(t, "tagName").substring(0, Setting.ClickTag),
+                class: getElementAttribute(t, "className").substring(0, Setting.ClickClass),
+                id: getElementAttribute(t, "id").substring(0, Setting.ClickId),
+            }
+        });
+        schedule(encode.bind(this, event));
+    }
+}
+
+function link(node: Node): HTMLAnchorElement {
+    while (node && node !== document) {
+        if (node.nodeType === Node.ELEMENT_NODE) {
+            let element = node as HTMLElement;
+            if (element.tagName === "A") {
+                return element as HTMLAnchorElement;
+            }
+        }
+        node = node.parentNode;
+    }
+    return null;
+}
+
+function text(element: Node): TextInfo {
+    let output = null;
+    let isFullText = false;
+    if (element) {
+        // Grab text using "textContent" for most HTMLElements, however, use "value" for HTMLInputElements and "alt" for HTMLImageElement.
+        let t = element.textContent || String((element as HTMLInputElement).value || '') || (element as HTMLImageElement).alt;
+        if (t) {
+            // Replace multiple occurrence of space characters with a single white space
+            // Also, trim any spaces at the beginning or at the end of string
+            const trimmedText =  t.replace(/\s+/g, Constant.Space).trim();
+            // Finally, send only first few characters as specified by the Setting
+            output = trimmedText.substring(0, Setting.ClickText);
+            isFullText = output.length === trimmedText.length;
+        }
+    }
+
+    return { text: output, isFullText: isFullText ? BooleanFlag.True : BooleanFlag.False };
+}
+
+function reaction(element: Node): BooleanFlag {
+    const tag = getElementAttribute(element, "tagName");
+    if (UserInputTags.indexOf(tag) >= 0) {
+        return BooleanFlag.False;
+    }
+    return BooleanFlag.True;
+}
+
+function getElementAttribute(element: Node, attribute: "tagName" | "className" | "id"): string {
+    if (element.nodeType === Node.ELEMENT_NODE) {
+        const attr = (element as HTMLElement)?.[attribute];
+        const value = typeof attr === "string" ? attr?.toLowerCase() : "";
+        return value;
+    }
+    return "";
+}
+
+function layout(element: Element): Box {
+    let box: Box = null;
+    let de = document.documentElement;
+    if (typeof element.getBoundingClientRect === "function") {
+        // getBoundingClientRect returns rectangle relative positioning to viewport
+        let rect = element.getBoundingClientRect();
+
+        if (rect && rect.width > 0 && rect.height > 0) {
+            // Add viewport's scroll position to rectangle to get position relative to document origin
+            // Also: using Math.floor() instead of Math.round() because in Edge,
+            // getBoundingClientRect returns partial pixel values (e.g. 162.5px) and Chrome already
+            // floors the value (e.g. 162px). This keeps consistent behavior across browsers.
+            box = {
+                x: Math.floor(rect.left + ("pageXOffset" in window ? window.pageXOffset : de.scrollLeft)),
+                y: Math.floor(rect.top + ("pageYOffset" in window ? window.pageYOffset : de.scrollTop)),
+                w: Math.floor(rect.width),
+                h: Math.floor(rect.height)
+            };
+        }
+    }
+    return box;
+}
+
+function context(a: HTMLAnchorElement): BrowsingContext {
+    if (a && a.hasAttribute(Constant.Target)) {
+        switch (a.getAttribute(Constant.Target)) {
+            case Constant.Blank: return BrowsingContext.Blank;
+            case Constant.Parent: return BrowsingContext.Parent;
+            case Constant.Top: return BrowsingContext.Top;
+        }
+    }
+    return BrowsingContext.Self;
+}
+
+export function reset(): void {
+    state = [];
+}
+
+export function stop(): void {
+    reset();
+}

package/src/interaction/clipboard.ts

@@ -1,32 +1,32 @@
-import { Event } from "@clarity-types/data";
-import { Clipboard, ClipboardState } from "@clarity-types/interaction";
-import { bind } from "@src/core/event";
-import { schedule } from "@src/core/task";
-import { time } from "@src/core/time";
-import encode from "./encode";
-import { target } from "@src/layout/target";
-
-export let state: ClipboardState[] = [];
-
-export function start(): void {
-    reset();
-}
-
-export function observe(root: Node): void {
-    bind(root, "cut", recompute.bind(this, Clipboard.Cut), true);
-    bind(root, "copy", recompute.bind(this, Clipboard.Copy), true);
-    bind(root, "paste", recompute.bind(this, Clipboard.Paste), true);
-}
-
-function recompute(action: Clipboard, evt: UIEvent): void {
-    state.push({ time: time(evt), event: Event.Clipboard, data: { target: target(evt), action } });
-    schedule(encode.bind(this, Event.Clipboard));
-}
-
-export function reset(): void {
-    state = [];
-}
-
-export function stop(): void {
-    reset();
-}
+import { Event } from "@clarity-types/data";
+import { Clipboard, ClipboardState } from "@clarity-types/interaction";
+import { bind } from "@src/core/event";
+import { schedule } from "@src/core/task";
+import { time } from "@src/core/time";
+import encode from "./encode";
+import { target } from "@src/layout/target";
+
+export let state: ClipboardState[] = [];
+
+export function start(): void {
+    reset();
+}
+
+export function observe(root: Node): void {
+    bind(root, "cut", recompute.bind(this, Clipboard.Cut), true);
+    bind(root, "copy", recompute.bind(this, Clipboard.Copy), true);
+    bind(root, "paste", recompute.bind(this, Clipboard.Paste), true);
+}
+
+function recompute(action: Clipboard, evt: UIEvent): void {
+    state.push({ time: time(evt), event: Event.Clipboard, data: { target: target(evt), action } });
+    schedule(encode.bind(this, Event.Clipboard));
+}
+
+export function reset(): void {
+    state = [];
+}
+
+export function stop(): void {
+    reset();
+}