@levi123/heatmap-react 4.0.0-dev.0

package/dist/umd/constants/index.d.ts

@@ -0,0 +1,4 @@
+export * from './selectors';
+export * from './viz-area-click';
+export * from './viz-elm-callout';
+//# sourceMappingURL=index.d.ts.map

package/dist/umd/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/umd/constants/selectors.d.ts

@@ -0,0 +1,4 @@
+export declare const CLARITY_HEATMAP_CANVAS_ID = "clarity-heatmap-canvas";
+export declare const HEATMAP_ELEMENT_ATTRIBUTE = "data-clarity-hashblpha";
+export declare function isIgnoredCanvas(element: Element): boolean;
+//# sourceMappingURL=selectors.d.ts.map

package/dist/umd/constants/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/constants/selectors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAClE,eAAO,MAAM,yBAAyB,2BAA2B,CAAC;AAElE,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQzD"}

package/dist/umd/constants/viz-area-click.d.ts

@@ -0,0 +1,16 @@
+export declare const AREA_HOVER_BOX_SHADOW = "0 0 0 1px #0078D4, 0 0 0 1px #0078D4 inset, 0 0 0 2px white inset";
+export declare const AREA_HOVER_ELEMENT_ID = "clarity-edit-hover";
+export declare const AREA_MAP_DIV_ATTRIBUTE = "data-clarity-area-map-div";
+export declare const AREA_MAP_CONTAINER_ID = "clarity-area-map";
+export declare const HEATMAP_AREA_CONTAINER_CLASS = "heatmap-area-container";
+export declare const HEATMAP_AREA_CONTAINER_SELECTOR = ".heatmap-area-container";
+export declare const AREA_CONTAINER_STYLES = "\n  position: absolute;\n  top: 0;\n  left: 0;\n  width: 100%;\n  height: 100%;\n  pointer-events: none;\n  z-index: 999999;\n";
+export declare const AREA_INNER_CONTAINER_STYLES = "\n  position: relative;\n  width: 100%;\n  height: 100%;\n";
+export declare const AREA_COLOR_GRADIENT: [number, number, number][];
+export declare const AREA_RENDERER_SELECTORS: {
+    readonly containerAttribute: "data-clarity-area-map-div";
+    readonly containerSelector: "[data-clarity-area-map-div]";
+    readonly innerContainerClass: "heatmap-area-container";
+    readonly innerContainerSelector: ".heatmap-area-container";
+};
+//# sourceMappingURL=viz-area-click.d.ts.map

package/dist/umd/constants/viz-area-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viz-area-click.d.ts","sourceRoot":"","sources":["../../src/constants/viz-area-click.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,sEAAsE,CAAC;AACzG,eAAO,MAAM,qBAAqB,uBAAuB,CAAC;AAC1D,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAClE,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AACxD,eAAO,MAAM,4BAA4B,2BAA2B,CAAC;AACrE,eAAO,MAAM,+BAA+B,4BAAqC,CAAC;AAElF,eAAO,MAAM,qBAAqB,mIAQjC,CAAC;AAEF,eAAO,MAAM,2BAA2B,+DAIvC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAMzD,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;CAK1B,CAAC"}

package/dist/umd/constants/viz-elm-callout.d.ts

@@ -0,0 +1,15 @@
+import type { ICalloutPositionMode } from '../components/VizElement/ElementCallout';
+import type { IHorizontalAlignment } from '../types';
+export declare const CALLOUT_PADDING = 0;
+export declare const CALLOUT_ARROW_SIZE = 8;
+export declare const CALLOUT_OFFSET: {
+    x: number;
+    y: number;
+};
+export declare const CALLOUT_ALIGNMENT: IHorizontalAlignment;
+export declare const CLICKED_ELEMENT_ID_BASE = "gx-hm-clicked-element";
+export declare const SECONDARY_CLICKED_ELEMENT_ID_BASE = "gx-hm-secondary-clicked-element";
+export declare const HOVERED_ELEMENT_ID_BASE = "gx-hm-hovered-element";
+export declare const SECONDARY_HOVERED_ELEMENT_ID_BASE = "gx-hm-secondary-hovered-element";
+export declare const DEFAULT_POSITION_MODE: ICalloutPositionMode;
+//# sourceMappingURL=viz-elm-callout.d.ts.map

package/dist/umd/constants/viz-elm-callout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viz-elm-callout.d.ts","sourceRoot":"","sources":["../../src/constants/viz-elm-callout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,cAAc,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAoB,CAAC;AACxE,eAAO,MAAM,iBAAiB,EAAE,oBAA6B,CAAC;AAE9D,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,iCAAiC,oCAAoC,CAAC;AACnF,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAC/D,eAAO,MAAM,iCAAiC,oCAAoC,CAAC;AAEnF,eAAO,MAAM,qBAAqB,EAAE,oBAAiC,CAAC"}

package/dist/umd/contexts/ViewIdContext.d.ts

@@ -0,0 +1,4 @@
+import type { IHeatmapViewId } from '../hooks';
+export declare const ViewIdContext: import("react").Context<IHeatmapViewId | undefined>;
+export declare const useViewIdContext: () => IHeatmapViewId;
+//# sourceMappingURL=ViewIdContext.d.ts.map

package/dist/umd/contexts/ViewIdContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewIdContext.d.ts","sourceRoot":"","sources":["../../src/contexts/ViewIdContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,eAAO,MAAM,aAAa,qDAAuD,CAAC;AAElF,eAAO,MAAM,gBAAgB,QAAO,cAGnC,CAAC"}

package/dist/umd/contexts/index.d.ts

@@ -0,0 +1,2 @@
+export * from './ViewIdContext';
+//# sourceMappingURL=index.d.ts.map

package/dist/umd/contexts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contexts/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/umd/helpers/canvas-backdrop.d.ts

@@ -0,0 +1,28 @@
+interface BackdropOptions {
+    canvas: HTMLCanvasElement;
+    activeRect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+    backdropColor?: string;
+    backdropOpacity?: number;
+    /**
+     * Expand the cutout area by this amount in all directions (pixels)
+     * Positive values make the cutout larger, negative values make it smaller
+     * @default 0
+     */
+    cutoutExpansion?: number;
+}
+/**
+ * Draw a backdrop overlay on canvas with a cutout for the active element
+ * This creates a "spotlight" effect highlighting the active element
+ */
+export declare const drawBackdropWithCutout: (options: BackdropOptions) => void;
+/**
+ * Clear the entire canvas
+ */
+export declare const clearCanvas: (canvas: HTMLCanvasElement) => void;
+export {};
+//# sourceMappingURL=canvas-backdrop.d.ts.map

package/dist/umd/helpers/canvas-backdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-backdrop.d.ts","sourceRoot":"","sources":["../../src/helpers/canvas-backdrop.ts"],"names":[],"mappings":"AAAA,UAAU,eAAe;IACvB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE;QACV,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,eAAe,KAAG,IA6BjE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,iBAAiB,KAAG,IAKvD,CAAC"}

package/dist/umd/helpers/index.d.ts

@@ -0,0 +1,10 @@
+export * from './canvas-backdrop';
+export * from './viewport';
+export * from './viz-area-click';
+export * from './viz-canvas';
+export * from './viz-dom';
+export * from './viz-elm-callout';
+export * from '../utils/logger';
+export * from '../utils/observable';
+export * from '../utils/throttle';
+//# sourceMappingURL=index.d.ts.map

package/dist/umd/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAElC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/umd/helpers/viewport/element.d.ts

@@ -0,0 +1,15 @@
+import type { ElementInfo, ElementRect, IHeatmapRef, IPositionCandidate, IPositionCandidateOption } from '../../types';
+export declare function isElementInViewport(elementRect: ElementRect, visualRef: IHeatmapRef['Visual'], scale: number): boolean;
+/**
+ * Check if element + callout fit entirely within the visible viewport.
+ * Used when deciding whether to scroll to an element on click.
+ */
+export declare function isElementWithCalloutInViewport(element: ElementInfo, visualRef: IHeatmapRef['Visual'], widthScale: number): boolean;
+export declare const scrollToElementWithCallout: (visualRef: IHeatmapRef["Visual"], element: ElementInfo, widthScale: number, onScrollComplete?: () => void) => void;
+interface IElementRectInViewportParams {
+    candidate: IPositionCandidate;
+    options: IPositionCandidateOption;
+}
+export declare function isElementRectInViewport(params: IElementRectInViewportParams): boolean;
+export {};
+//# sourceMappingURL=element.d.ts.map

package/dist/umd/helpers/viewport/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../src/helpers/viewport/element.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAOvH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,EAChC,KAAK,EAAE,MAAM,GACZ,OAAO,CAYT;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,WAAW,CAAC,QAAQ,CAAC,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAaT;AA0BD,eAAO,MAAM,0BAA0B,GACrC,WAAW,WAAW,CAAC,QAAQ,CAAC,EAChC,SAAS,WAAW,EACpB,YAAY,MAAM,EAClB,mBAAmB,MAAM,IAAI,KAC5B,IAcF,CAAC;AAEF,UAAU,4BAA4B;IACpC,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAsCrF"}

package/dist/umd/helpers/viewport/iframe.d.ts

@@ -0,0 +1,8 @@
+export declare const convertViewportToIframeCoords: (event: {
+    clientX: number;
+    clientY: number;
+}, iframe: HTMLIFrameElement, scale: number) => {
+    x: number;
+    y: number;
+};
+//# sourceMappingURL=iframe.d.ts.map

package/dist/umd/helpers/viewport/iframe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe.d.ts","sourceRoot":"","sources":["../../../src/helpers/viewport/iframe.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,GACxC,OAAO;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC3C,QAAQ,iBAAiB,EACzB,OAAO,MAAM,KACZ;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAaxB,CAAC"}

package/dist/umd/helpers/viewport/index.d.ts

@@ -0,0 +1,3 @@
+export * from './element';
+export * from './iframe';
+//# sourceMappingURL=index.d.ts.map

package/dist/umd/helpers/viewport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/viewport/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/umd/helpers/viz-area-click/area-builder.d.ts

@@ -0,0 +1,8 @@
+import type { IAreaNode, IClickMapMetric, IHeatmapInfo, IPersistedAreaData } from '../../types';
+export declare function buildAreaNode(element: HTMLElement, hash: string, heatmapInfo: IHeatmapInfo, shadowRoot?: HTMLElement, persistedData?: IPersistedAreaData): IAreaNode | undefined;
+export declare function getTopElementsByClicks(clickMapMetrics: IClickMapMetric, topN?: number): Array<{
+    hash: string;
+    totalclicks: number;
+    selector: string;
+}>;
+//# sourceMappingURL=area-builder.d.ts.map

package/dist/umd/helpers/viz-area-click/area-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-builder.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAiD3G,wBAAgB,aAAa,CAC3B,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,YAAY,EACzB,UAAU,CAAC,EAAE,WAAW,EACxB,aAAa,CAAC,EAAE,kBAAkB,GACjC,SAAS,GAAG,SAAS,CAmDvB;AAED,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,eAAe,EAChC,IAAI,GAAE,MAAW,GAChB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAWhE"}

package/dist/umd/helpers/viz-area-click/area-color.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get color from click distribution percentage (0-100)
+ */
+export declare function getColorFromClickDist(clickDist: number): string;
+/**
+ * Get hover color (slightly lighter) from click distribution
+ */
+export declare function getHoverColorFromClickDist(clickDist: number): string;
+/**
+ * Calculate click distribution percentage from total clicks
+ */
+export declare function calculateClickDistribution(elementClicks: number, totalClicks: number): number;
+//# sourceMappingURL=area-color.d.ts.map

package/dist/umd/helpers/viz-area-click/area-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-color.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-color.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAa/D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG7F"}

package/dist/umd/helpers/viz-area-click/area-graph.d.ts

@@ -0,0 +1,63 @@
+import type { IAreaNode } from '../../types';
+/**
+ * Build parent-child relationships between areas based on DOM hierarchy
+ * @param areas - Array of area nodes to build relationships for
+ */
+export declare function buildAreaGraph(areas: IAreaNode[]): void;
+/**
+ * Get all ancestors of an area (parent, grandparent, etc.)
+ * @param area - The area node to get ancestors for
+ * @returns Array of ancestor area nodes, ordered from closest to farthest
+ */
+export declare function getAreaAncestors(area: IAreaNode): IAreaNode[];
+/**
+ * Get all descendants of an area (children, grandchildren, etc.)
+ * @param area - The area node to get descendants for
+ * @returns Array of descendant area nodes
+ */
+export declare function getAreaDescendants(area: IAreaNode): IAreaNode[];
+/**
+ * Get all sibling areas (areas with the same parent)
+ * @param area - The area node to get siblings for
+ * @returns Array of sibling area nodes (excluding the area itself)
+ */
+export declare function getAreaSiblings(area: IAreaNode): IAreaNode[];
+/**
+ * Check if one area is an ancestor of another
+ * @param ancestor - The potential ancestor area
+ * @param descendant - The potential descendant area
+ * @returns True if ancestor contains descendant in the hierarchy
+ */
+export declare function isAreaAncestorOf(ancestor: IAreaNode, descendant: IAreaNode): boolean;
+/**
+ * Get root areas (areas with no parent)
+ * @param areas - Array of area nodes
+ * @returns Array of root area nodes
+ */
+export declare function getRootAreas(areas: IAreaNode[]): IAreaNode[];
+/**
+ * Get leaf areas (areas with no children)
+ * @param areas - Array of area nodes
+ * @returns Array of leaf area nodes
+ */
+export declare function getLeafAreas(areas: IAreaNode[]): IAreaNode[];
+/**
+ * Get the depth of an area in the hierarchy (0 for root, 1 for children, etc.)
+ * @param area - The area node
+ * @returns Depth level in the hierarchy
+ */
+export declare function getAreaDepth(area: IAreaNode): number;
+/**
+ * Sort areas by their hierarchy depth (roots first, then children, etc.)
+ * @param areas - Array of area nodes to sort
+ * @returns Sorted array with roots first, deepest areas last
+ */
+export declare function sortAreasByDepth(areas: IAreaNode[]): IAreaNode[];
+/**
+ * Get areas at a specific depth level
+ * @param areas - Array of area nodes
+ * @param depth - The depth level (0 for roots, 1 for first level children, etc.)
+ * @returns Array of areas at the specified depth
+ */
+export declare function getAreasAtDepth(areas: IAreaNode[], depth: number): IAreaNode[];
+//# sourceMappingURL=area-graph.d.ts.map

package/dist/umd/helpers/viz-area-click/area-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-graph.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAgCvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,CAU7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,CAM5D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,GAAG,OAAO,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAUpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAE9E"}

package/dist/umd/helpers/viz-area-click/area-hydration.d.ts

@@ -0,0 +1,36 @@
+import type { Visualizer } from '@gem-sdk/clarity-visualize';
+import type { IAreaNode, IPersistedAreaData, IHeatmapInfo } from '../../types';
+/**
+ * Hydrates persisted area data into full area node
+ * Finds element in DOM and calculates all runtime values
+ *
+ * @param persistedData - Minimal data from database
+ * @param iframeDocument - Document to find element in
+ * @param heatmapInfo - Heatmap data for click calculations
+ * @param vizRef - Map of hash to elements
+ * @param shadowRoot - Optional shadow root for rect calculation
+ * @returns Full area node or null if element not found
+ */
+export declare function hydrateAreaNode(props: {
+    persistedData: IPersistedAreaData;
+    heatmapInfo: IHeatmapInfo;
+    vizRef: Visualizer | null;
+    shadowRoot?: HTMLElement;
+    iframeDocument?: Document | null;
+}): IAreaNode | null;
+export declare function hydrateAreas(props: {
+    clickAreas: IPersistedAreaData[];
+    heatmapInfo: IHeatmapInfo;
+    vizRef: Visualizer | null;
+    shadowRoot?: HTMLElement;
+    iframeDocument?: Document | null;
+}): IAreaNode[];
+/**
+ * Serializes area node to persisted data for database storage
+ */
+export declare function serializeAreaNode(area: IAreaNode): IPersistedAreaData;
+/**
+ * Serializes multiple areas for database storage
+ */
+export declare function serializeAreas(areas: IAreaNode[]): IPersistedAreaData[];
+//# sourceMappingURL=area-hydration.d.ts.map

package/dist/umd/helpers/viz-area-click/area-hydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-hydration.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-hydration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK/E;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,aAAa,EAAE,kBAAkB,CAAC;IAClC,WAAW,EAAE,YAAY,CAAC;IAC1B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,cAAc,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAClC,GAAG,SAAS,GAAG,IAAI,CAcnB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,WAAW,EAAE,YAAY,CAAC;IAC1B,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,cAAc,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;CAClC,GAAG,SAAS,EAAE,CAkBd;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,kBAAkB,CAOrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,kBAAkB,EAAE,CAEvE"}

package/dist/umd/helpers/viz-area-click/area-overlap.d.ts

@@ -0,0 +1,44 @@
+import type { IAreaNode } from '../../types';
+export interface IOverlapGroup {
+    /**
+     * All areas that overlap with each other
+     */
+    areas: IAreaNode[];
+    /**
+     * The winning area with highest priority
+     */
+    winner: IAreaNode;
+    /**
+     * Areas that should be hidden due to overlap
+     */
+    hidden: IAreaNode[];
+}
+/**
+ * Resolve overlapping areas by priority rules
+ *
+ * Priority Rules (in order):
+ * 1. Priority flag (manually set areas win)
+ * 2. Click distribution (higher % wins)
+ * 3. Total clicks (more clicks wins)
+ * 4. DOM containment (parent contains child, parent wins)
+ * 5. Size (smaller areas win - more specific)
+ */
+export declare function resolveOverlaps(areas: IAreaNode[], iframeDocument?: Document): IAreaNode[];
+/**
+ * Filter out areas that are completely contained within others
+ * and have lower priority
+ */
+export declare function filterContainedAreas(areas: IAreaNode[]): IAreaNode[];
+/**
+ * Get visible areas after resolving overlaps
+ */
+export declare function getVisibleAreas(areas: IAreaNode[], iframeDocument?: Document): IAreaNode[];
+/**
+ * Calculate overlap percentage between two areas
+ */
+export declare function calculateOverlapPercentage(area1: IAreaNode, area2: IAreaNode): number;
+/**
+ * Check if overlap is significant (> 30%)
+ */
+export declare function isSignificantOverlap(area1: IAreaNode, area2: IAreaNode): boolean;
+//# sourceMappingURL=area-overlap.d.ts.map

package/dist/umd/helpers/viz-area-click/area-overlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-overlap.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-overlap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,KAAK,EAAE,SAAS,EAAE,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,CAuB1F;AAmFD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CA6BpE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,CAS1F;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAqBrF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAGhF"}

package/dist/umd/helpers/viz-area-click/area-renderer-setup.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Helper functions for setting up area renderer
+ */
+/**
+ * Create the outer container for area rendering
+ */
+export declare function createAreaContainer(iframeDocument: Document): HTMLDivElement;
+/**
+ * Create the inner container for React portal
+ */
+export declare function createInnerContainer(iframeDocument: Document): HTMLDivElement;
+/**
+ * Get or create the outer container element
+ */
+export declare function getOrCreateAreaContainer(iframeDocument: Document, customShadowRoot?: HTMLElement): HTMLDivElement;
+export declare function getOrCreateContainerShadowRoot(container: HTMLDivElement): ShadowRoot;
+export declare function getOrCreateInnerContainer(shadowRoot: ShadowRoot, iframeDocument: Document): HTMLDivElement;
+export declare function setupAreaRenderingContainer(iframeDocument: Document, customShadowRoot?: HTMLElement): HTMLDivElement;
+export declare function cleanupAreaRenderingContainer(container: HTMLDivElement | null): void;
+//# sourceMappingURL=area-renderer-setup.d.ts.map

package/dist/umd/helpers/viz-area-click/area-renderer-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-renderer-setup.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-renderer-setup.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,QAAQ,GAAG,cAAc,CAK5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,QAAQ,GAAG,cAAc,CAM7E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EAAE,WAAW,GAAG,cAAc,CAajH;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,CAMpF;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,EAAE,cAAc,EAAE,QAAQ,GAAG,cAAc,CAS1G;AAED,wBAAgB,2BAA2B,CAAC,cAAc,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EAAE,WAAW,GAAG,cAAc,CAMpH;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAIpF"}

package/dist/umd/helpers/viz-area-click/area-utils.d.ts

@@ -0,0 +1,19 @@
+import type { IAreaNode, IAreaRect } from '../../types';
+export declare function getElementRect(element: HTMLElement, _shadowRoot?: HTMLElement): IAreaRect;
+export declare function isElementFixed(element: HTMLElement): boolean;
+export declare function doAreasOverlap(area1: IAreaNode, area2: IAreaNode): boolean;
+export declare function isAreaContainedIn(area1: IAreaNode, area2: IAreaNode): boolean;
+export declare function isElementAncestorOf(ancestor: HTMLElement, descendant: HTMLElement, doc: Document): boolean;
+export declare function isElementSelectable(element: Element, index: number, elements: Element[]): boolean;
+/**
+ * Find the smallest selectable element that contains the given point.
+ * Uses elementsFromPoint to get candidates, then applies the same
+ * filtering logic (ignored canvas, area-map divs, bounding rect check).
+ */
+export declare function getSmallestElementAtPoint(doc: Document, x: number, y: number): HTMLElement | null;
+export declare function sortAreasByClickDist(areas: IAreaNode[]): IAreaNode[];
+export declare function getOrCreateShadowRoot(element: HTMLElement): ShadowRoot;
+export declare function getDocumentScrollHeight(doc: Document): number;
+export declare function getIframeHeight(window: Window, doc: Document): number;
+export declare function isRectTooSmallForLabel(rect: IAreaRect): boolean;
+//# sourceMappingURL=area-utils.d.ts.map

package/dist/umd/helpers/viz-area-click/area-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-utils.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/area-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAMxD,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CA6BzF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAW5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAgB1E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAY7E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAE1G;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAcjG;AAYD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAuBjG;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAOpE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAMtE;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAY7D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAQrE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAE/D"}

package/dist/umd/helpers/viz-area-click/index.d.ts

@@ -0,0 +1,8 @@
+export * from './area-builder';
+export * from './area-color';
+export * from './area-graph';
+export * from './area-hydration';
+export * from './area-overlap';
+export * from './area-renderer-setup';
+export * from './area-utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/umd/helpers/viz-area-click/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-area-click/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/dist/umd/helpers/viz-canvas/area-clustering.d.ts

@@ -0,0 +1,44 @@
+import type { ClickMapPoint, IClusterArea } from '../../types';
+export declare class AreaClusteringEngine {
+    /**
+     * Cluster click elements thành các vùng
+     */
+    clusterAreas(clickData: ClickMapPoint[], iframeDoc: Document, totalClicks: number): IClusterArea[];
+    /**
+     * Get click elements with their rects
+     */
+    private getClickElements;
+    /**
+     * Get element rect
+     */
+    private getElementRect;
+    /**
+     * Perform clustering using distance-based algorithm
+     */
+    private performClustering;
+    /**
+     * Calculate distance between two rects (edge-to-edge)
+     */
+    private getDistance;
+    /**
+     * Create area objects from clusters
+     */
+    private createAreasFromClusters;
+    /**
+     * Calculate bounding rect for multiple rects
+     */
+    private calculateBoundingRect;
+    /**
+     * Calculate centroid (center point) of cluster
+     */
+    private calculateCentroid;
+    /**
+     * Get heatmap color based on percentage (0-1)
+     */
+    private getHeatmapColor;
+    /**
+     * Get hover color
+     */
+    private getHoverColor;
+}
+//# sourceMappingURL=area-clustering.d.ts.map

package/dist/umd/helpers/viz-canvas/area-clustering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-clustering.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-canvas/area-clustering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AA0BjF,qBAAa,oBAAoB;IAC/B;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE;IAmBzG;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAyB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAKtB"}

package/dist/umd/helpers/viz-canvas/area-overlay-manager-v2.d.ts

@@ -0,0 +1,17 @@
+import type { AreaMapData } from './area-overlay-manager';
+import type { HierarchicalCluster } from './hierarchical-area-clustering';
+export declare class AreaOverlayManagerV2 {
+    private iframe;
+    private overlayContainer;
+    private areas;
+    private clusteringEngine;
+    private overlayElements;
+    constructor(iframe: HTMLIFrameElement);
+    init(): void;
+    render(data: AreaMapData): void;
+    private createOverlay;
+    clear(): void;
+    destroy(): void;
+    getAreas(): HierarchicalCluster[];
+}
+//# sourceMappingURL=area-overlay-manager-v2.d.ts.map

package/dist/umd/helpers/viz-canvas/area-overlay-manager-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-overlay-manager-v2.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-canvas/area-overlay-manager-v2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAO1E,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,gBAAgB,CAA0C;IAClE,OAAO,CAAC,eAAe,CAAqC;gBAEhD,MAAM,EAAE,iBAAiB;IAI9B,IAAI,IAAI,IAAI;IA8BZ,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAoBtC,OAAO,CAAC,aAAa;IAiFd,KAAK,IAAI,IAAI;IAQb,OAAO,IAAI,IAAI;IAQf,QAAQ,IAAI,mBAAmB,EAAE;CAGzC"}

package/dist/umd/helpers/viz-canvas/area-overlay-manager.d.ts

@@ -0,0 +1,51 @@
+import type { ClickMapPoint, IClusterArea } from '../../types';
+export interface AreaMapData {
+    clickData: ClickMapPoint[];
+    totalClicks: number;
+}
+export declare class AreaOverlayManager {
+    private iframe;
+    private overlayContainer;
+    private areas;
+    private clusteringEngine;
+    private overlayElements;
+    constructor(iframe: HTMLIFrameElement);
+    /**
+     * Initialize overlay container
+     */
+    init(): void;
+    /**
+     * Render clustered areas
+     */
+    render(data: AreaMapData): void;
+    /**
+     * Create overlay for a cluster area
+     */
+    private createOverlay;
+    /**
+     * Create label
+     */
+    private createLabel;
+    /**
+     * Handle area click
+     */
+    private handleAreaClick;
+    /**
+     * Update positions when iframe resizes
+     */
+    updatePositions(): void;
+    private calculateBoundingRect;
+    /**
+     * Clear all overlays
+     */
+    clear(): void;
+    /**
+     * Destroy
+     */
+    destroy(): void;
+    /**
+     * Get all areas
+     */
+    getAreas(): IClusterArea[];
+}
+//# sourceMappingURL=area-overlay-manager.d.ts.map

package/dist/umd/helpers/viz-canvas/area-overlay-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-overlay-manager.d.ts","sourceRoot":"","sources":["../../../src/helpers/viz-canvas/area-overlay-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI/D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAKD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,eAAe,CAAqC;gBAEhD,MAAM,EAAE,iBAAiB;IAIrC;;OAEG;IACI,IAAI,IAAI,IAAI;IA8BnB;;OAEG;IACI,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAwBtC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqDrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAuBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAwBvB;;OAEG;IACI,eAAe,IAAI,IAAI;IA+B9B,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACI,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACI,OAAO,IAAI,IAAI;IAUtB;;OAEG;IACI,QAAQ,IAAI,YAAY,EAAE;CAGlC"}

package/dist/umd/helpers/viz-canvas/hierarchical-area-clustering.d.ts

@@ -0,0 +1,73 @@
+import type { ClickMapPoint, IClusterArea } from '../../types';
+export interface HierarchicalCluster extends IClusterArea {
+    parentHash: string | null;
+    level: number;
+    children: Set<string>;
+}
+export declare class HierarchicalAreaClusteringEngine {
+    /**
+     * Cluster areas với hierarchical logic
+     */
+    clusterAreas(clickData: ClickMapPoint[], iframeDoc: Document, totalClicks: number): HierarchicalCluster[];
+    /**
+     * Build click elements với hierarchy info
+     */
+    private buildClickElements;
+    /**
+     * Get DOM level (depth from body)
+     */
+    private getDOMLevel;
+    /**
+     * Get all parent hashes của element
+     */
+    private getParentHashes;
+    /**
+     * Group elements by common parent
+     */
+    private groupByCommonParent;
+    /**
+     * Check if two elements have common parent
+     */
+    private hasCommonParent;
+    /**
+     * Get best parent hash (closest specific parent)
+     */
+    private getBestParentHash;
+    /**
+     * Create clusters from parent groups
+     */
+    private createClustersFromGroups;
+    /**
+     * Calculate smart bounding rect - không bao trọn toàn bộ parent
+     */
+    private calculateSmartBoundingRect;
+    /**
+     * Remove nested clusters - Loại bỏ cluster con nếu nằm trong cluster cha
+     */
+    private removeNestedClusters;
+    /**
+     * Check if cluster1 is nested inside cluster2
+     */
+    private isClusterNested;
+    /**
+     * Calculate overlap area between two rects
+     */
+    private calculateOverlapArea;
+    /**
+     * Filter out too large clusters (không bao trọn body hoặc quá lớn)
+     */
+    private filterLargeClusters;
+    private getElementRect;
+    private getDistance;
+    private getHeatmapColor;
+    private getHoverColor;
+}
+export interface Rect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+    right: number;
+    bottom: number;
+}
+//# sourceMappingURL=hierarchical-area-clustering.d.ts.map