@repere/core 0.1.1 → 0.2.0

package/dist/constants/beacon.d.ts

@@ -1,3 +1,3 @@
-import { Position } from '../types/position';
-export declare const DEFAULT_POSITION: Position;
+import { AnchorPoint } from '../types/anchors';
+export declare const DEFAULT_ANCHOR_POINT: AnchorPoint;
 //# sourceMappingURL=beacon.d.ts.map

package/dist/constants/beacon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../src/constants/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,QAA4B,CAAC"}
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../src/constants/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,eAAO,MAAM,oBAAoB,EAAE,WAAkC,CAAC"}

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-export { DEFAULT_POSITION } from './constants/beacon';
+export { DEFAULT_ANCHOR_POINT } from './constants/beacon';
 export { MemoryStore } from './store/memory-store';
+export { AnchorPoint } from './types/anchors';
 export { Animation, type ResolvedAnimationConfig } from './types/animations';
 export type { BasePopoverProps, BaseTriggerProps } from './types/base';
-export type { Beacon, CalculatedBeaconPosition, Offset, PopoverConfig, TriggerConfig, } from './types/beacon';
+export { type Beacon, type CalculatedBeaconAnchorPoint, type Offset, type PopoverConfig, PositioningStrategy, type TriggerConfig, } from './types/beacon';
 export type { Page, RepereConfig } from './types/config';
-export { Position } from './types/position';
 export type { BeaconState, BeaconStore } from './types/store';
+export { AnchorPointTracker } from './utils/AnchorPointTracker';
 export { calculateDismissDuration, combineTranslateWithAnimation, getAnimationConfig, getPopoverAnimationStyles, mergeAnimationConfigs, waitForAnimations, } from './utils/animations';
 export { BeaconManager } from './utils/BeaconManager';
-export { PositionTracker } from './utils/PositionTracker';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEvE,YAAY,EACV,MAAM,EACN,wBAAwB,EACxB,MAAM,EACN,aAAa,EACb,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EACL,KAAK,MAAM,EACX,KAAK,2BAA2B,EAChC,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,cAAc,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
-var c = /* @__PURE__ */ ((e) => (e.TopLeft = "top-left", e.TopCenter = "top-center", e.TopRight = "top-right", e.RightCenter = "right-center", e.BottomRight = "bottom-right", e.BottomCenter = "bottom-center", e.BottomLeft = "bottom-left", e.LeftCenter = "left-center", e))(c || {});
-const m = c.TopRight;
-class y {
+var h = /* @__PURE__ */ ((e) => (e.TopLeft = "top-left", e.TopCenter = "top-center", e.TopRight = "top-right", e.RightCenter = "right-center", e.BottomRight = "bottom-right", e.BottomCenter = "bottom-center", e.BottomLeft = "bottom-left", e.LeftCenter = "left-center", e))(h || {});
+const k = h.TopRight;
+class v {
   state = /* @__PURE__ */ new Map();
   isDismissed(t) {
     return this.state.get(t)?.isDismissed ?? !1;
@@ -21,70 +21,296 @@ class y {
     return Array.from(this.state.values());
   }
 }
-var d = /* @__PURE__ */ ((e) => (e.Fade = "fade", e.Scale = "scale", e.Grow = "grow", e.Shrink = "shrink", e.SlideUp = "slide-up", e.SlideDown = "slide-down", e.SlideLeft = "slide-left", e.SlideRight = "slide-right", e.None = "none", e))(d || {});
-const h = {
-  [d.SlideDown]: {
+var f = /* @__PURE__ */ ((e) => (e.Fade = "fade", e.Scale = "scale", e.Grow = "grow", e.Shrink = "shrink", e.SlideUp = "slide-up", e.SlideDown = "slide-down", e.SlideLeft = "slide-left", e.SlideRight = "slide-right", e.None = "none", e))(f || {}), g = /* @__PURE__ */ ((e) => (e.Fixed = "fixed", e.Absolute = "absolute", e))(g || {});
+function p(e, t, i, n = g.Absolute) {
+  const o = i?.x ?? 0, l = i?.y ?? 0, a = n === g.Absolute ? window.scrollY : 0, s = n === g.Absolute ? window.scrollX : 0;
+  let r = 0, c = 0, d = "0%", u = "0%";
+  switch (t) {
+    case h.TopLeft:
+      r = e.top + a, c = e.left + s, d = "0%", u = "-100%";
+      break;
+    case h.TopCenter:
+      r = e.top + a, c = e.left + s + e.width / 2, d = "-50%", u = "-100%";
+      break;
+    case h.TopRight:
+      r = e.top + a, c = e.right + s, d = "-100%", u = "-100%";
+      break;
+    case h.RightCenter:
+      r = e.top + a + e.height / 2, c = e.right + s, d = "0%", u = "-50%";
+      break;
+    case h.BottomRight:
+      r = e.bottom + a, c = e.right + s, d = "-100%", u = "0%";
+      break;
+    case h.BottomCenter:
+      r = e.bottom + a, c = e.left + s + e.width / 2, d = "-50%", u = "0%";
+      break;
+    case h.BottomLeft:
+      r = e.bottom + a, c = e.left + s, d = "0%", u = "0%";
+      break;
+    case h.LeftCenter:
+      r = e.top + a + e.height / 2, c = e.left + s, d = "-100%", u = "-50%";
+      break;
+    default:
+      r = e.top + a, c = e.right + s, d = "-100%", u = "-100%";
+      break;
+  }
+  return r += l, c += o, {
+    top: r,
+    left: c,
+    translate: { x: d, y: u }
+  };
+}
+class T {
+  tracked = /* @__PURE__ */ new Map();
+  scrollListener = null;
+  resizeListener = null;
+  resizeObserver = null;
+  mutationObserver = null;
+  updateScheduled = !1;
+  debug = !1;
+  constructor(t = !1) {
+    this.debug = t;
+  }
+  /**
+   * Subscribe to anchor point updates for an element
+   */
+  subscribe(t, i, n, o = {}) {
+    return (o.positioningStrategy ?? g.Absolute) === g.Absolute ? this.subscribeAbsolute(t, i, n, o) : this.subscribeFixed(t, i, n, o);
+  }
+  /**
+   * Subscribe with absolute positioning strategy (no tracking)
+   */
+  subscribeAbsolute(t, i, n, o) {
+    const { offset: l, zIndex: a = 9999, delay: s = 0 } = o, r = () => {
+      const c = document.querySelector(t);
+      if (!c) {
+        this.debug && console.log(
+          `[AnchorPointTracker:Absolute] Element not found: ${t}`
+        ), n(null);
+        return;
+      }
+      const d = c.getBoundingClientRect(), y = {
+        ...p(d, i, l),
+        position: "absolute",
+        zIndex: a
+      };
+      this.debug && console.log(
+        `[AnchorPointTracker:Absolute] Calculated anchor point for ${t}:`,
+        y
+      ), n(y);
+    };
+    if (s > 0) {
+      this.debug && console.log(
+        `[AnchorPointTracker:Absolute] Delaying calculation for ${t} by ${s}ms`
+      );
+      const c = setTimeout(r, s);
+      return () => clearTimeout(c);
+    } else
+      return r(), () => {
+      };
+  }
+  /**
+   * Subscribe with fixed positioning strategy (with tracking)
+   */
+  subscribeFixed(t, i, n, o) {
+    const l = t;
+    this.tracked.has(l) || this.tracked.set(l, {
+      selector: t,
+      anchorPoint: i,
+      offset: o.offset,
+      zIndex: o.zIndex ?? 9999,
+      delay: o.delay,
+      positioningStrategy: g.Fixed,
+      callbacks: /* @__PURE__ */ new Map(),
+      element: null,
+      delayTimeoutIds: /* @__PURE__ */ new Map()
+    });
+    const a = this.tracked.get(l);
+    return a ? (a.callbacks.set(n, {
+      callback: n,
+      needsInitialDelay: (o.delay ?? 0) > 0
+    }), this.tracked.size === 1 && this.startListening(), this.scheduleInitialUpdate(l, n), () => {
+      const s = this.tracked.get(l);
+      if (s) {
+        const r = s.delayTimeoutIds.get(n);
+        if (r !== void 0 && (clearTimeout(r), s.delayTimeoutIds.delete(n)), s.callbacks.delete(n), s.callbacks.size === 0) {
+          for (const [, c] of s.delayTimeoutIds)
+            clearTimeout(c);
+          s.delayTimeoutIds.clear(), this.tracked.delete(l), this.tracked.size === 0 && this.stopListening();
+        }
+      }
+    }) : () => {
+    };
+  }
+  scheduleInitialUpdate(t, i) {
+    const n = this.tracked.get(t);
+    if (!n) return;
+    const o = n.callbacks.get(i);
+    if (o)
+      if (o.needsInitialDelay && n.delay && n.delay > 0) {
+        this.debug && console.log(
+          `[AnchorPointTracker:Fixed] Delaying initial anchor point calculation for ${t} by ${n.delay}ms`
+        );
+        const l = setTimeout(() => {
+          this.debug && console.log(
+            `[AnchorPointTracker:Fixed] Calculating anchor point for ${t} after delay`
+          );
+          const a = n.callbacks.get(i);
+          a && (a.needsInitialDelay = !1), n.delayTimeoutIds.delete(i), this.updateAnchorPointForCallback(t, i);
+        }, n.delay);
+        n.delayTimeoutIds.set(i, l);
+      } else
+        this.updateAnchorPointForCallback(t, i);
+  }
+  updateAnchorPointForCallback(t, i) {
+    const n = this.tracked.get(t);
+    if (!n) return;
+    const o = document.querySelector(n.selector);
+    if (!o) {
+      this.debug && console.log(
+        `[AnchorPointTracker:Fixed] Element not found: ${n.selector}`
+      ), n.element = null, i(null);
+      return;
+    }
+    n.element = o;
+    const l = o.getBoundingClientRect(), s = {
+      ...p(
+        l,
+        n.anchorPoint,
+        n.offset
+      ),
+      position: "fixed",
+      zIndex: n.zIndex
+    };
+    this.debug && console.log(
+      `[AnchorPointTracker:Fixed] Updated anchor point for ${n.selector}:`,
+      s
+    ), i(s);
+  }
+  updateAnchorPoint(t) {
+    const i = this.tracked.get(t);
+    if (!i) return;
+    const n = document.querySelector(i.selector);
+    if (!n) {
+      this.debug && console.log(
+        `[AnchorPointTracker:Fixed] Element not found: ${i.selector}`
+      ), i.element = null;
+      for (const [s, r] of i.callbacks)
+        r.needsInitialDelay || s(null);
+      return;
+    }
+    i.element = n;
+    const o = n.getBoundingClientRect(), a = {
+      ...p(
+        o,
+        i.anchorPoint,
+        i.offset
+      ),
+      position: "fixed",
+      zIndex: i.zIndex
+    };
+    this.debug && console.log(
+      `[AnchorPointTracker:Fixed] Updated anchor point for ${i.selector}:`,
+      a
+    );
+    for (const [s, r] of i.callbacks)
+      r.needsInitialDelay || s(a);
+  }
+  scheduleUpdate = () => {
+    this.updateScheduled || (this.updateScheduled = !0, requestAnimationFrame(() => {
+      this.updateAllAnchorPointsSync(), this.updateScheduled = !1;
+    }));
+  };
+  updateAllAnchorPointsSync = () => {
+    for (const [t] of this.tracked)
+      this.updateAnchorPoint(t);
+  };
+  startListening() {
+    this.scrollListener = this.scheduleUpdate, window.addEventListener("scroll", this.scrollListener, !0), this.resizeListener = this.scheduleUpdate, window.addEventListener("resize", this.resizeListener), "ResizeObserver" in window && (this.resizeObserver = new ResizeObserver(this.scheduleUpdate)), this.mutationObserver = new MutationObserver(() => {
+      this.scheduleUpdate();
+    }), this.mutationObserver.observe(document.body, {
+      childList: !0,
+      subtree: !0
+    });
+  }
+  stopListening() {
+    this.scrollListener && (window.removeEventListener("scroll", this.scrollListener, !0), this.scrollListener = null), this.resizeListener && (window.removeEventListener("resize", this.resizeListener), this.resizeListener = null), this.resizeObserver?.disconnect(), this.resizeObserver = null, this.mutationObserver?.disconnect(), this.mutationObserver = null;
+  }
+  /**
+   * Clean up all listeners and subscriptions
+   */
+  destroy() {
+    for (const [, t] of this.tracked) {
+      for (const [, i] of t.delayTimeoutIds)
+        clearTimeout(i);
+      t.delayTimeoutIds.clear();
+    }
+    this.stopListening(), this.tracked.clear();
+  }
+}
+const b = {
+  [f.SlideDown]: {
     initial: { y: -20, opacity: 0 },
     animate: { y: 0, opacity: 1 },
     exit: { y: -20, opacity: 0 }
   },
-  [d.SlideUp]: {
+  [f.SlideUp]: {
     initial: { y: 20, opacity: 0 },
     animate: { y: 0, opacity: 1 },
     exit: { y: 20, opacity: 0 }
   },
-  [d.SlideLeft]: {
+  [f.SlideLeft]: {
     initial: { x: 20, opacity: 0 },
     animate: { x: 0, opacity: 1 },
     exit: { x: 20, opacity: 0 }
   },
-  [d.SlideRight]: {
+  [f.SlideRight]: {
     initial: { x: -20, opacity: 0 },
     animate: { x: 0, opacity: 1 },
     exit: { x: -20, opacity: 0 }
   },
-  [d.Fade]: {
+  [f.Fade]: {
     initial: { opacity: 0 },
     animate: { opacity: 1 },
     exit: { opacity: 0 }
   },
-  [d.Shrink]: {
+  [f.Shrink]: {
     initial: { scale: 1.1, opacity: 0 },
     animate: { scale: 1, opacity: 1 },
     exit: { scale: 0.9, opacity: 0 }
   },
-  [d.Grow]: {
+  [f.Grow]: {
     initial: { scale: 0.9, opacity: 0 },
     animate: { scale: 1, opacity: 1 },
     exit: { scale: 1.1, opacity: 0 }
   },
-  [d.Scale]: {
+  [f.Scale]: {
     initial: { scale: 0, opacity: 0 },
     animate: { scale: 1, opacity: 1 },
     exit: { scale: 0, opacity: 0 }
   },
-  [d.None]: {
+  [f.None]: {
     initial: {},
     animate: {},
     exit: {}
   }
 };
-function u(e) {
+function m(e) {
   return e ? typeof e == "string" ? { variant: e } : e : null;
 }
 function w(e, t) {
-  const i = u(e), s = u(t);
-  return !i && !s ? null : i ? s ? {
-    variant: s.variant ?? i.variant,
-    duration: s.duration ?? i.duration,
-    delay: s.delay ?? i.delay,
-    ease: s.ease ?? i.ease
-  } : i : s;
+  const i = m(e), n = m(t);
+  return !i && !n ? null : i ? n ? {
+    variant: n.variant ?? i.variant,
+    duration: n.duration ?? i.duration,
+    delay: n.delay ?? i.delay,
+    ease: n.ease ?? i.ease
+  } : i : n;
 }
-function b(e) {
-  const t = u(e);
+function A(e) {
+  const t = m(e);
   if (!t) return null;
-  const i = h[t.variant];
+  const i = b[t.variant];
   return i ? {
     variants: i,
     transition: {
@@ -96,29 +322,29 @@ function b(e) {
     }
   } : (console.warn(`[Repere] Unknown animation variant: ${t.variant}`), null);
 }
-function x(e, t) {
-  const i = (o) => {
-    const n = o.match(/(-?\d+)%/);
-    return n ? parseFloat(n[1]) : 0;
-  }, s = i(e.x), r = i(e.y), a = (o = 0) => r === 0 && o === 0 ? `translate(${s}%, 0)` : o === 0 ? `translate(${s}%, ${r}%)` : `translate(${s}%, calc(${r}% + ${o}px))`;
+function I(e, t) {
+  const i = (a) => {
+    const s = a.match(/(-?\d+)%/);
+    return s ? parseFloat(s[1]) : 0;
+  }, n = i(e.x), o = i(e.y), l = (a = 0) => o === 0 && a === 0 ? `translate(${n}%, 0)` : a === 0 ? `translate(${n}%, ${o}%)` : `translate(${n}%, calc(${o}% + ${a}px))`;
   return {
     initial: {
       ...t.initial,
-      transform: a(t.initial.y || 0)
+      transform: l(t.initial.y || 0)
     },
     animate: {
       ...t.animate,
-      transform: a(t.animate.y || 0)
+      transform: l(t.animate.y || 0)
     },
     exit: {
       ...t.exit,
-      transform: a(t.exit.y || 0)
+      transform: l(t.exit.y || 0)
     }
   };
 }
-function k(e, t) {
+function $(e, t) {
   if (!e && !t) return {};
-  const i = e?.variants, s = e?.transition, r = t?.variants, a = t?.transition, o = a?.ease ?? s?.ease ?? [0.4, 0, 0.2, 1], n = Array.isArray(o) ? `cubic-bezier(${o.join(", ")})` : o;
+  const i = e?.variants, n = e?.transition, o = t?.variants, l = t?.transition, a = l?.ease ?? n?.ease ?? [0.4, 0, 0.2, 1], s = Array.isArray(a) ? `cubic-bezier(${a.join(", ")})` : a;
   return {
     // Initial state (when opening starts) - from onOpen animation
     "--repere-initial-opacity": i?.initial.opacity ?? 0,
@@ -131,23 +357,23 @@ function k(e, t) {
     "--repere-animate-y": `${i?.animate.y ?? 0}px`,
     "--repere-animate-scale": i?.animate.scale ?? 1,
     // Exit state (when closing) - from onClose animation
-    "--repere-exit-opacity": r?.exit.opacity ?? 0,
-    "--repere-exit-x": `${r?.exit.x ?? 0}px`,
-    "--repere-exit-y": `${r?.exit.y ?? 0}px`,
-    "--repere-exit-scale": r?.exit.scale ?? 1,
+    "--repere-exit-opacity": o?.exit.opacity ?? 0,
+    "--repere-exit-x": `${o?.exit.x ?? 0}px`,
+    "--repere-exit-y": `${o?.exit.y ?? 0}px`,
+    "--repere-exit-scale": o?.exit.scale ?? 1,
     // Transition timing
-    "--repere-transition-duration": `${a?.duration ?? s?.duration ?? 0.3}s`,
-    "--repere-transition-timing": n
+    "--repere-transition-duration": `${l?.duration ?? n?.duration ?? 0.3}s`,
+    "--repere-transition-timing": s
   };
 }
-function v(e, t) {
-  const i = e?.transition.duration ?? 0, s = t?.transition.duration ?? 0;
-  return Math.max(i, s) * 1e3;
+function L(e, t) {
+  const i = e?.transition.duration ?? 0, n = t?.transition.duration ?? 0;
+  return Math.max(i, n) * 1e3;
 }
-function T(e) {
+function S(e) {
   return new Promise((t) => setTimeout(t, e));
 }
-function g(e, t) {
+function x(e, t) {
   if (t instanceof RegExp)
     return t.test(e);
   if (t === e)
@@ -158,7 +384,7 @@ function g(e, t) {
   }
   return !1;
 }
-class I {
+class z {
   store;
   debug;
   constructor(t, i = {}) {
@@ -169,45 +395,45 @@ class I {
    * This supports wildcards - e.g., path="*" will match all pages
    */
   findMatchingPages(t, i) {
-    const s = t.filter((r) => typeof r.path == "function" ? r.path(i) : g(i, r.path));
+    const n = t.filter((o) => typeof o.path == "function" ? o.path(i) : x(i, o.path));
     return this.debug && console.log(
       "[BeaconManager] Path:",
       i,
       "Matched pages:",
-      s.map((r) => r.id).join(", ") || "none"
-    ), s;
+      n.map((o) => o.id).join(", ") || "none"
+    ), n;
   }
   /**
    * Get all active (non-dismissed) beacons for the current path
    * Includes beacons from all matching pages (supports wildcards)
    */
   async getActiveBeacons(t, i) {
-    const s = this.findMatchingPages(t, i);
-    if (s.length === 0)
+    const n = this.findMatchingPages(t, i);
+    if (n.length === 0)
       return this.debug && console.log("[BeaconManager] No matching pages found"), [];
     this.debug && console.log(
       "[BeaconManager] Found",
-      s.length,
+      n.length,
       "matching page(s):",
-      s.map((n) => n.id).join(", ")
+      n.map((s) => s.id).join(", ")
     );
-    const r = [], a = /* @__PURE__ */ new Set();
-    for (const n of s)
-      for (const l of n.beacons) {
-        if (a.has(l.id)) {
+    const o = [], l = /* @__PURE__ */ new Set();
+    for (const s of n)
+      for (const r of s.beacons) {
+        if (l.has(r.id)) {
           this.debug && console.warn(
-            `[BeaconManager] Duplicate beacon ID "${l.id}" in page "${n.id}", skipping`
+            `[BeaconManager] Duplicate beacon ID "${r.id}" in page "${s.id}", skipping`
           );
           continue;
         }
-        a.add(l.id), r.push(l);
+        l.add(r.id), o.push(r);
       }
-    const o = [];
-    for (const n of r)
+    const a = [];
+    for (const s of o)
       await Promise.resolve(
-        this.store.isDismissed(n.id)
-      ) ? this.debug && console.log("[BeaconManager] Beacon", n.id, "is dismissed") : o.push(n);
-    return this.debug && console.log("[BeaconManager] Active beacons:", o.length), o;
+        this.store.isDismissed(s.id)
+      ) ? this.debug && console.log("[BeaconManager] Beacon", s.id, "is dismissed") : a.push(s);
+    return this.debug && console.log("[BeaconManager] Active beacons:", a.length), a;
   }
   /**
    * Get the store instance
@@ -216,195 +442,18 @@ class I {
     return this.store;
   }
 }
-function f(e, t = c.TopRight, i = { x: 0, y: 0 }) {
-  const { x: s = 0, y: r = 0 } = i;
-  let a = 0, o = 0, n = "0", l = "0";
-  switch (t) {
-    // Top positions
-    case c.TopLeft:
-      a = e.top + window.scrollY, o = e.left + window.scrollX, n = "-50%", l = "-100%";
-      break;
-    case c.TopCenter:
-      a = e.top + window.scrollY, o = e.left + window.scrollX + e.width / 2, n = "-50%", l = "-100%";
-      break;
-    case c.TopRight:
-      a = e.top + window.scrollY, o = e.right + window.scrollX, n = "-50%", l = "-100%";
-      break;
-    // Right positions
-    case c.RightCenter:
-      a = e.top + window.scrollY + e.height / 2, o = e.right + window.scrollX, n = "0", l = "-50%";
-      break;
-    // Bottom positions
-    case c.BottomLeft:
-      a = e.bottom + window.scrollY, o = e.left + window.scrollX, n = "-50%", l = "0";
-      break;
-    case c.BottomCenter:
-      a = e.bottom + window.scrollY, o = e.left + window.scrollX + e.width / 2, n = "-50%", l = "0";
-      break;
-    case c.BottomRight:
-      a = e.bottom + window.scrollY, o = e.right + window.scrollX, n = "-50%", l = "0";
-      break;
-    // Left positions
-    case c.LeftCenter:
-      a = e.top + window.scrollY + e.height / 2, o = e.left + window.scrollX, n = "-100%", l = "-50%";
-      break;
-  }
-  return a += r, o += s, {
-    top: a,
-    left: o,
-    translate: { x: n, y: l }
-  };
-}
-class L {
-  tracked = /* @__PURE__ */ new Map();
-  scrollListener = null;
-  resizeListener = null;
-  resizeObserver = null;
-  mutationObserver = null;
-  debug = !1;
-  constructor(t = !1) {
-    this.debug = t;
-  }
-  /**
-   * Subscribe to position updates for an element
-   */
-  subscribe(t, i, s, r = {}) {
-    const a = t;
-    this.tracked.has(a) || this.tracked.set(a, {
-      selector: t,
-      position: i,
-      offset: r.offset,
-      zIndex: r.zIndex ?? 9999,
-      delay: r.delay,
-      callbacks: /* @__PURE__ */ new Map(),
-      element: null,
-      delayTimeoutIds: /* @__PURE__ */ new Map()
-    });
-    const o = this.tracked.get(a);
-    return o ? (o.callbacks.set(s, {
-      callback: s,
-      needsInitialDelay: (r.delay ?? 0) > 0
-    }), this.tracked.size === 1 && this.startListening(), this.scheduleInitialUpdate(a, s), () => {
-      const n = this.tracked.get(a);
-      if (n) {
-        const l = n.delayTimeoutIds.get(s);
-        if (l !== void 0 && (clearTimeout(l), n.delayTimeoutIds.delete(s)), n.callbacks.delete(s), n.callbacks.size === 0) {
-          for (const [, p] of n.delayTimeoutIds)
-            clearTimeout(p);
-          n.delayTimeoutIds.clear(), this.tracked.delete(a), this.tracked.size === 0 && this.stopListening();
-        }
-      }
-    }) : () => {
-    };
-  }
-  scheduleInitialUpdate(t, i) {
-    const s = this.tracked.get(t);
-    if (!s) return;
-    const r = s.callbacks.get(i);
-    if (r)
-      if (r.needsInitialDelay && s.delay && s.delay > 0) {
-        this.debug && console.log(
-          `[PositionTracker] Delaying initial position calculation for ${t} by ${s.delay}ms`
-        );
-        const a = setTimeout(() => {
-          this.debug && console.log(
-            `[PositionTracker] Calculating position for ${t} after delay`
-          );
-          const o = s.callbacks.get(i);
-          o && (o.needsInitialDelay = !1), s.delayTimeoutIds.delete(i), this.updatePositionForCallback(t, i);
-        }, s.delay);
-        s.delayTimeoutIds.set(i, a);
-      } else
-        this.updatePositionForCallback(t, i);
-  }
-  updatePositionForCallback(t, i) {
-    const s = this.tracked.get(t);
-    if (!s) return;
-    const r = document.querySelector(s.selector);
-    if (!r) {
-      this.debug && console.log(`[PositionTracker] Element not found: ${s.selector}`), s.element = null, i(null);
-      return;
-    }
-    s.element = r;
-    const a = r.getBoundingClientRect(), n = {
-      ...f(
-        a,
-        s.position,
-        s.offset
-      ),
-      position: "fixed",
-      zIndex: s.zIndex
-    };
-    this.debug && console.log(
-      `[PositionTracker] Updated position for ${s.selector}:`,
-      n
-    ), i(n);
-  }
-  updatePosition(t) {
-    const i = this.tracked.get(t);
-    if (!i) return;
-    const s = document.querySelector(i.selector);
-    if (!s) {
-      this.debug && console.log(`[PositionTracker] Element not found: ${i.selector}`), i.element = null;
-      for (const [n] of i.callbacks)
-        n(null);
-      return;
-    }
-    i.element = s;
-    const r = s.getBoundingClientRect(), o = {
-      ...f(
-        r,
-        i.position,
-        i.offset
-      ),
-      position: "fixed",
-      zIndex: i.zIndex
-    };
-    this.debug && console.log(
-      `[PositionTracker] Updated position for ${i.selector}:`,
-      o
-    );
-    for (const [n] of i.callbacks)
-      n(o);
-  }
-  updateAllPositions = () => {
-    for (const [t] of this.tracked)
-      this.updatePosition(t);
-  };
-  startListening() {
-    this.scrollListener = this.updateAllPositions, window.addEventListener("scroll", this.scrollListener, !0), this.resizeListener = this.updateAllPositions, window.addEventListener("resize", this.resizeListener), "ResizeObserver" in window && (this.resizeObserver = new ResizeObserver(this.updateAllPositions)), this.mutationObserver = new MutationObserver(() => {
-      this.updateAllPositions();
-    }), this.mutationObserver.observe(document.body, {
-      childList: !0,
-      subtree: !0
-    });
-  }
-  stopListening() {
-    this.scrollListener && (window.removeEventListener("scroll", this.scrollListener, !0), this.scrollListener = null), this.resizeListener && (window.removeEventListener("resize", this.resizeListener), this.resizeListener = null), this.resizeObserver?.disconnect(), this.resizeObserver = null, this.mutationObserver?.disconnect(), this.mutationObserver = null;
-  }
-  /**
-   * Clean up all listeners and subscriptions
-   */
-  destroy() {
-    for (const [, t] of this.tracked) {
-      for (const [, i] of t.delayTimeoutIds)
-        clearTimeout(i);
-      t.delayTimeoutIds.clear();
-    }
-    this.stopListening(), this.tracked.clear();
-  }
-}
 export {
-  d as Animation,
-  I as BeaconManager,
-  m as DEFAULT_POSITION,
-  y as MemoryStore,
-  c as Position,
-  L as PositionTracker,
-  v as calculateDismissDuration,
-  x as combineTranslateWithAnimation,
-  b as getAnimationConfig,
-  k as getPopoverAnimationStyles,
+  h as AnchorPoint,
+  T as AnchorPointTracker,
+  f as Animation,
+  z as BeaconManager,
+  k as DEFAULT_ANCHOR_POINT,
+  v as MemoryStore,
+  g as PositioningStrategy,
+  L as calculateDismissDuration,
+  I as combineTranslateWithAnimation,
+  A as getAnimationConfig,
+  $ as getPopoverAnimationStyles,
   w as mergeAnimationConfigs,
-  T as waitForAnimations
+  S as waitForAnimations
 };

package/dist/styles.css

@@ -1 +1 @@
-[data-repere-popover]{position:absolute;position-anchor:var(--repere-anchor);inset:unset;margin:0;opacity:var(--repere-exit-opacity, 0);transform:translate(var(--repere-exit-x, 0)) translateY(var(--repere-exit-y, -20px)) scale(var(--repere-exit-scale, 1));transition-property:opacity,transform,overlay,display;transition-duration:var(--repere-transition-duration, .3s);transition-timing-function:var( --repere-transition-timing, cubic-bezier(.4, 0, .2, 1) );transition-behavior:allow-discrete}[data-repere-popover]:popover-open{opacity:var(--repere-animate-opacity, 1);transform:translate(var(--repere-animate-x, 0)) translateY(var(--repere-animate-y, 0)) scale(var(--repere-animate-scale, 1))}@starting-style{[data-repere-popover]:popover-open{opacity:var(--repere-initial-opacity, 0);transform:translate(var(--repere-initial-x, 0)) translateY(var(--repere-initial-y, -20px)) scale(var(--repere-initial-scale, 1))}}[data-repere-popover][data-position=bottom-left]{top:anchor(bottom);left:anchor(left);position-try-fallbacks:--bottom-right,--top-left,--top-right}[data-repere-popover][data-position=bottom-center]{top:anchor(bottom);left:anchor(center);translate:-50% 0;position-try-fallbacks:--bottom-left,--bottom-right,--top-center}[data-repere-popover][data-position=bottom-right]{top:anchor(bottom);right:anchor(right);position-try-fallbacks:--bottom-left,--top-right,--top-left}[data-repere-popover][data-position=top-left]{bottom:anchor(top);left:anchor(left);position-try-fallbacks:--top-right,--bottom-left,--bottom-right}[data-repere-popover][data-position=top-center]{bottom:anchor(top);left:anchor(center);translate:-50% 0;position-try-fallbacks:--top-left,--top-right,--bottom-center}[data-repere-popover][data-position=top-right]{bottom:anchor(top);right:anchor(right);position-try-fallbacks:--top-left,--bottom-right,--bottom-left}[data-repere-popover][data-position=left-center]:popover-open{top:anchor(center);right:anchor(left);translate:0 -50%;position-try-fallbacks:--right-center,--bottom-center,--top-center}[data-repere-popover][data-position=right-center]:popover-open{top:anchor(center);left:anchor(right);translate:0 -50%;position-try-fallbacks:--left-center,--bottom-center,--top-center}[data-repere-trigger]{anchor-name:var(--repere-anchor)}@position-try --bottom-left{top:anchor(bottom);left:anchor(left);right:auto;bottom:auto;translate:0 0}@position-try --bottom-right{top:anchor(bottom);right:anchor(right);left:auto;bottom:auto;translate:0 0}@position-try --bottom-center{top:anchor(bottom);left:anchor(center);right:auto;bottom:auto;translate:-50% 0}@position-try --top-left{bottom:anchor(top);left:anchor(left);right:auto;top:auto;translate:0 0}@position-try --top-right{bottom:anchor(top);right:anchor(right);left:auto;top:auto;translate:0 0}@position-try --top-center{bottom:anchor(top);left:anchor(center);right:auto;top:auto;translate:-50% 0}@position-try --left-center{top:anchor(center);right:anchor(left);left:auto;bottom:auto;translate:0 -50%}@position-try --right-center{top:anchor(center);left:anchor(right);right:auto;bottom:auto;translate:0 -50%}
+[data-repere-popover]{position:absolute;position-anchor:var(--repere-anchor);inset:unset;margin:0;opacity:var(--repere-exit-opacity, 0);transform:translate(var(--repere-exit-x, 0)) translateY(var(--repere-exit-y, -20px)) scale(var(--repere-exit-scale, 1));transition-property:opacity,transform,overlay,display;transition-duration:var(--repere-transition-duration, .3s);transition-timing-function:var( --repere-transition-timing, cubic-bezier(.4, 0, .2, 1) );transition-behavior:allow-discrete}[data-repere-popover]:popover-open{opacity:var(--repere-animate-opacity, 1);transform:translate(var(--repere-animate-x, 0)) translateY(var(--repere-animate-y, 0)) scale(var(--repere-animate-scale, 1))}@starting-style{[data-repere-popover]:popover-open{opacity:var(--repere-initial-opacity, 0);transform:translate(var(--repere-initial-x, 0)) translateY(var(--repere-initial-y, -20px)) scale(var(--repere-initial-scale, 1))}}[data-repere-popover][data-anchor-point=bottom-left]{top:anchor(bottom);left:anchor(left);position-try-fallbacks:--bottom-right,--top-left,--top-right}[data-repere-popover][data-anchor-point=bottom-center]{top:anchor(bottom);left:anchor(center);translate:-50% 0;position-try-fallbacks:--bottom-left,--bottom-right,--top-center}[data-repere-popover][data-anchor-point=bottom-right]{top:anchor(bottom);right:anchor(right);position-try-fallbacks:--bottom-left,--top-right,--top-left}[data-repere-popover][data-anchor-point=top-left]{bottom:anchor(top);left:anchor(left);position-try-fallbacks:--top-right,--bottom-left,--bottom-right}[data-repere-popover][data-anchor-point=top-center]{bottom:anchor(top);left:anchor(center);translate:-50% 0;position-try-fallbacks:--top-left,--top-right,--bottom-center}[data-repere-popover][data-anchor-point=top-right]{bottom:anchor(top);right:anchor(right);position-try-fallbacks:--top-left,--bottom-right,--bottom-left}[data-repere-popover][data-anchor-point=left-center]:popover-open{top:anchor(center);right:anchor(left);translate:0 -50%;position-try-fallbacks:--right-center,--bottom-center,--top-center}[data-repere-popover][data-anchor-point=right-center]:popover-open{top:anchor(center);left:anchor(right);translate:0 -50%;position-try-fallbacks:--left-center,--bottom-center,--top-center}[data-repere-trigger]{anchor-name:var(--repere-anchor)}@position-try --bottom-left{top:anchor(bottom);left:anchor(left);right:auto;bottom:auto;translate:0 0}@position-try --bottom-right{top:anchor(bottom);right:anchor(right);left:auto;bottom:auto;translate:0 0}@position-try --bottom-center{top:anchor(bottom);left:anchor(center);right:auto;bottom:auto;translate:-50% 0}@position-try --top-left{bottom:anchor(top);left:anchor(left);right:auto;top:auto;translate:0 0}@position-try --top-right{bottom:anchor(top);right:anchor(right);left:auto;top:auto;translate:0 0}@position-try --top-center{bottom:anchor(top);left:anchor(center);right:auto;top:auto;translate:-50% 0}@position-try --left-center{top:anchor(center);right:anchor(left);left:auto;bottom:auto;translate:0 -50%}@position-try --right-center{top:anchor(center);left:anchor(right);right:auto;bottom:auto;translate:0 -50%}

package/dist/types/anchors.d.ts

@@ -0,0 +1,11 @@
+export declare enum AnchorPoint {
+    TopLeft = "top-left",
+    TopCenter = "top-center",
+    TopRight = "top-right",
+    RightCenter = "right-center",
+    BottomRight = "bottom-right",
+    BottomCenter = "bottom-center",
+    BottomLeft = "bottom-left",
+    LeftCenter = "left-center"
+}
+//# sourceMappingURL=anchors.d.ts.map

package/dist/types/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/types/anchors.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,aAAa;IACpB,SAAS,eAAe;IACxB,QAAQ,cAAc;IACtB,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,YAAY,kBAAkB;IAC9B,UAAU,gBAAgB;IAC1B,UAAU,gBAAgB;CAC3B"}

package/dist/types/base.d.ts

@@ -1,12 +1,12 @@
-import { CalculatedBeaconPosition } from './beacon';
-import { Position } from './position';
+import { AnchorPoint } from './anchors';
+import { CalculatedBeaconAnchorPoint } from './beacon';
 /**
  * Base props that trigger components receive (framework-agnostic)
  */
 export interface BaseTriggerProps {
     beaconId: string;
-    position: Position;
-    calculatedPosition: CalculatedBeaconPosition;
+    anchorPoint: AnchorPoint;
+    calculatedAnchor: CalculatedBeaconAnchorPoint;
     isOpen: boolean;
     isDismissing: boolean;
     popoverId?: string;
@@ -16,7 +16,7 @@ export interface BaseTriggerProps {
  */
 export interface BasePopoverProps {
     beaconId: string;
-    position: Position;
+    anchorPoint: AnchorPoint;
     isOpen: boolean;
     isDismissing?: boolean;
     popoverId?: string;

package/dist/types/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,kBAAkB,EAAE,wBAAwB,CAAC;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/types/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,2BAA2B,CAAC;IAC9C,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB"}

package/dist/types/beacon.d.ts

@@ -1,24 +1,35 @@
+import { AnchorPoint } from './anchors';
 import { PopoverAnimations, TriggerAnimations } from './animations';
-import { Position } from './position';
 export interface Offset {
     x?: number;
     y?: number;
 }
+/**
+ * Positioning strategy for the beacon.
+ * - 'fixed': Position fixed to viewport with tracking (for dynamic content - scrolling, resizing, avoiding overflow boundaries)
+ * - 'absolute': Attach directly to element (better performance, for static content)
+ * @default 'absolute'
+ */
+export declare enum PositioningStrategy {
+    Fixed = "fixed",
+    Absolute = "absolute"
+}
 export interface TriggerConfig<TNode = unknown> {
-    position?: Position;
+    anchorPoint?: AnchorPoint;
     offset?: Offset;
     zIndex?: number;
     animations?: TriggerAnimations;
     component?: TNode;
     /**
-     * Delay in milliseconds before calculating the beacon position.
+     * Delay in milliseconds before calculating the beacon anchor point.
      * Useful when the target element has entrance animations that affect its position.
      * @default 0
      */
     delay?: number;
+    positioningStrategy?: PositioningStrategy;
 }
 export interface PopoverConfig<TNode = unknown> {
-    position?: Position;
+    anchorPoint?: AnchorPoint;
     offset?: Offset;
     animations?: PopoverAnimations;
     component?: TNode;
@@ -29,14 +40,14 @@ export interface Beacon<TNode = unknown> {
     trigger?: TriggerConfig<TNode>;
     popover: PopoverConfig<TNode>;
 }
-export interface CalculatedBeaconPosition {
+export interface CalculatedBeaconAnchorPoint {
     top: number;
     left: number;
     translate: {
         x: string;
         y: string;
     };
-    position: "fixed";
+    position: "fixed" | "absolute";
     zIndex: number;
 }
 //# sourceMappingURL=beacon.d.ts.map

package/dist/types/beacon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../src/types/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,MAAM,CAAC,KAAK,GAAG,OAAO;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"beacon.d.ts","sourceRoot":"","sources":["../../src/types/beacon.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEzE,MAAM,WAAW,MAAM;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,oBAAY,mBAAmB;IAC7B,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,MAAM,CAAC,KAAK,GAAG,OAAO;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;IACF,QAAQ,EAAE,OAAO,GAAG,UAAU,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/utils/AnchorPointTracker.d.ts

@@ -0,0 +1,46 @@
+import { AnchorPoint } from '../types/anchors';
+import { CalculatedBeaconAnchorPoint, Offset, PositioningStrategy } from '../types/beacon';
+export type AnchorPointCallback = (anchorPoint: CalculatedBeaconAnchorPoint | null) => void;
+/**
+ * Framework-agnostic anchor point tracker for beacon elements
+ * Tracks element anchor points and notifies subscribers of changes
+ */
+export declare class AnchorPointTracker {
+    private tracked;
+    private scrollListener;
+    private resizeListener;
+    private resizeObserver;
+    private mutationObserver;
+    private updateScheduled;
+    private debug;
+    constructor(debug?: boolean);
+    /**
+     * Subscribe to anchor point updates for an element
+     */
+    subscribe(selector: string, anchorPoint: AnchorPoint, callback: AnchorPointCallback, options?: {
+        offset?: Offset;
+        zIndex?: number;
+        delay?: number;
+        positioningStrategy?: PositioningStrategy;
+    }): () => void;
+    /**
+     * Subscribe with absolute positioning strategy (no tracking)
+     */
+    private subscribeAbsolute;
+    /**
+     * Subscribe with fixed positioning strategy (with tracking)
+     */
+    private subscribeFixed;
+    private scheduleInitialUpdate;
+    private updateAnchorPointForCallback;
+    private updateAnchorPoint;
+    private scheduleUpdate;
+    private updateAllAnchorPointsSync;
+    private startListening;
+    private stopListening;
+    /**
+     * Clean up all listeners and subscriptions
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=AnchorPointTracker.d.ts.map

package/dist/utils/AnchorPointTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnchorPointTracker.d.ts","sourceRoot":"","sources":["../../src/utils/AnchorPointTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EACV,2BAA2B,EAC3B,MAAM,EACN,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,MAAM,mBAAmB,GAAG,CAChC,WAAW,EAAE,2BAA2B,GAAG,IAAI,KAC5C,IAAI,CAAC;AAmBV;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,UAAQ;IAIzB;;OAEG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;KACtC,GACL,MAAM,IAAI;IAWb;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2DzB;;OAEG;IACH,OAAO,CAAC,cAAc;IA2EtB,OAAO,CAAC,qBAAqB;IA0C7B,OAAO,CAAC,4BAA4B;IA4CpC,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,cAAc,CAQpB;IAEF,OAAO,CAAC,yBAAyB,CAI/B;IAEF,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO;CAYR"}

package/dist/utils/positioning.d.ts

@@ -1,6 +1,6 @@
-import { Offset } from '../types/beacon';
-import { Position } from '../types/position';
-export interface PositionCoordinates {
+import { AnchorPoint } from '../types/anchors';
+import { Offset, PositioningStrategy } from '../types/beacon';
+export interface BeaconAnchor {
     top: number;
     left: number;
     translate: {
@@ -9,7 +9,7 @@ export interface PositionCoordinates {
     };
 }
 /**
- * Calculate beacon position relative to target element
+ * Calculate beacon anchor coordinates based on element rect and desired anchor point
  */
-export declare function calculateBeaconPosition(targetRect: DOMRect, position?: Position, offset?: Offset): PositionCoordinates;
+export declare function calculateAnchorPointCoords(rect: DOMRect, anchorPoint: AnchorPoint, offset?: Offset, strategy?: PositioningStrategy): BeaconAnchor;
 //# sourceMappingURL=positioning.d.ts.map

package/dist/utils/positioning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"positioning.d.ts","sourceRoot":"","sources":["../../src/utils/positioning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,OAAO,EACnB,QAAQ,GAAE,QAA4B,EACtC,MAAM,GAAE,MAAuB,GAC9B,mBAAmB,CA0ErB"}
+{"version":3,"file":"positioning.d.ts","sourceRoot":"","sources":["../../src/utils/positioning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE;QACT,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;KACX,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,GAAE,mBAAiC,GAC1C,YAAY,CAyFd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@repere/core",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "exports": {

package/dist/utils/PositionTracker.d.ts

@@ -1,35 +0,0 @@
-import { CalculatedBeaconPosition, Offset } from '../types/beacon';
-import { Position } from '../types/position';
-export type PositionCallback = (position: CalculatedBeaconPosition | null) => void;
-/**
- * Framework-agnostic position tracker for beacon elements
- * Tracks element positions and notifies subscribers of changes
- */
-export declare class PositionTracker {
-    private tracked;
-    private scrollListener;
-    private resizeListener;
-    private resizeObserver;
-    private mutationObserver;
-    private debug;
-    constructor(debug?: boolean);
-    /**
-     * Subscribe to position updates for an element
-     */
-    subscribe(selector: string, position: Position, callback: PositionCallback, options?: {
-        offset?: Offset;
-        zIndex?: number;
-        delay?: number;
-    }): () => void;
-    private scheduleInitialUpdate;
-    private updatePositionForCallback;
-    private updatePosition;
-    private updateAllPositions;
-    private startListening;
-    private stopListening;
-    /**
-     * Clean up all listeners and subscriptions
-     */
-    destroy(): void;
-}
-//# sourceMappingURL=PositionTracker.d.ts.map

package/dist/utils/PositionTracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PositionTracker.d.ts","sourceRoot":"","sources":["../../src/utils/PositionTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,wBAAwB,GAAG,IAAI,KACtC,IAAI,CAAC;AAkBV;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,KAAK,CAAS;gBAEV,KAAK,UAAQ;IAIzB;;OAEG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KACX,GACL,MAAM,IAAI;IAiEb,OAAO,CAAC,qBAAqB;IA0C7B,OAAO,CAAC,yBAAyB;IAuCjC,OAAO,CAAC,cAAc;IA2CtB,OAAO,CAAC,kBAAkB,CAIxB;IAEF,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO;CAYR"}