@openreplay/tracker 18.1.4 → 18.1.5

package/dist/lib/main/modules/mouse.d.ts

@@ -1,4 +1,10 @@
 import type App from '../app/index.js';
+export declare function isDeepClickable(element: Element): boolean;
+/**
+ * cursor is inherited, so every child of a clickable div reports a pointer too;
+ * climb to the outermost element that still owns the pointer
+ * */
+export declare function resolvePointerRoot(element: Element): Element;
 export interface MouseHandlerOptions {
     disableClickmaps?: boolean;
     /**
@@ -11,4 +17,4 @@ export interface MouseHandlerOptions {
     customAttributes?: string[];
 }
 export default function (app: App, options?: MouseHandlerOptions): void;
-export declare function getCSSPath(el: any): string | false;
+export declare function getCSSPath(el: any, customAttributes?: string[]): string | false;

package/dist/lib/main/utils.d.ts

@@ -11,6 +11,15 @@ export declare const DOCS_HOST = "https://docs.openreplay.com";
 export declare function deprecationWarn(nameOfFeature: string, useInstead: string, docsPath?: string): void;
 export declare function getCustomAttributeLabel(e: Element, customAttributes?: string[]): string;
 export declare function getClassSelector(e: Element): string;
+export declare const cssEscape: (str: string) => string;
+/** escape a value that goes inside a quoted css attribute selector */
+export declare function cssAttrValue(value: string): string;
+export declare function getCustomAttributeSelector(e: Element, customAttributes?: string[]): string;
+/**
+ * human readable label of a clicked element: its own text/description,
+ * then the same for a few ancestors (a click on an icon inside a card)
+ * */
+export declare function getTextualLabel(e: Element, getInnerText: (el: HTMLElement) => string, maxAncestors?: number): string;
 export declare function getLabelAttribute(e: Element): string | null;
 export declare function hasOpenreplayAttribute(e: Element, attr: string): boolean;
 /**

package/dist/types/main/modules/mouse.d.ts

@@ -1,4 +1,10 @@
 import type App from '../app/index.js';
+export declare function isDeepClickable(element: Element): boolean;
+/**
+ * cursor is inherited, so every child of a clickable div reports a pointer too;
+ * climb to the outermost element that still owns the pointer
+ * */
+export declare function resolvePointerRoot(element: Element): Element;
 export interface MouseHandlerOptions {
     disableClickmaps?: boolean;
     /**
@@ -11,4 +17,4 @@ export interface MouseHandlerOptions {
     customAttributes?: string[];
 }
 export default function (app: App, options?: MouseHandlerOptions): void;
-export declare function getCSSPath(el: any): string | false;
+export declare function getCSSPath(el: any, customAttributes?: string[]): string | false;

package/dist/types/main/utils.d.ts

@@ -11,6 +11,15 @@ export declare const DOCS_HOST = "https://docs.openreplay.com";
 export declare function deprecationWarn(nameOfFeature: string, useInstead: string, docsPath?: string): void;
 export declare function getCustomAttributeLabel(e: Element, customAttributes?: string[]): string;
 export declare function getClassSelector(e: Element): string;
+export declare const cssEscape: (str: string) => string;
+/** escape a value that goes inside a quoted css attribute selector */
+export declare function cssAttrValue(value: string): string;
+export declare function getCustomAttributeSelector(e: Element, customAttributes?: string[]): string;
+/**
+ * human readable label of a clicked element: its own text/description,
+ * then the same for a few ancestors (a click on an icon inside a card)
+ * */
+export declare function getTextualLabel(e: Element, getInnerText: (el: HTMLElement) => string, maxAncestors?: number): string;
 export declare function getLabelAttribute(e: Element): string | null;
 export declare function hasOpenreplayAttribute(e: Element, attr: string): boolean;
 /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openreplay/tracker",
   "description": "The OpenReplay tracker main package",
-  "version": "18.1.4",
+  "version": "18.1.5",
   "keywords": [
     "logging",
     "replay"
@@ -62,6 +62,7 @@
     "@rollup/plugin-typescript": "^12.3.0",
     "@typescript-eslint/eslint-plugin": "^8.65.0",
     "@typescript-eslint/parser": "^8.65.0",
+    "babel-jest": "^30.4.2",
     "eslint": "^9.39.5",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.6",