@userflow-tech/react-native 0.1.0

package/lib/module/anchors/AutoAnchorRegistry.js

@@ -0,0 +1,309 @@
+"use strict";
+
+/**
+ * Multi-instance auto-anchor registry for Stage 3.
+ *
+ * Separate from {@link AnchorRegistry} (manual `useUserflowAnchor` / Tier 0).
+ * Each mounted host is a distinct instance indexed by registry key, template
+ * path, and developer ids so a later scored matcher can rank candidates.
+ */
+
+/** Build-time descriptor stamped by `@userflow-tech/babel-plugin` (full or expanded compact). */
+
+const PRESSABLE_KINDS = new Set(['Pressable', 'TouchableOpacity', 'TouchableHighlight', 'TouchableWithoutFeedback', 'TouchableNativeFeedback']);
+export function roleForKind(kind) {
+  if (PRESSABLE_KINDS.has(kind)) return 'Action';
+  if (kind === 'Text') return 'Text';
+  if (kind === 'Image') return 'Image';
+  if (kind === 'TextInput' || kind === 'TextField') return 'Input';
+  if (kind === 'View' || kind === 'ScrollView' || kind === 'SafeAreaView') return 'Group';
+  return 'Other';
+}
+let nextInstanceSeq = 1;
+function mintInstanceId() {
+  const id = `inst_${nextInstanceSeq.toString(36)}`;
+  nextInstanceSeq += 1;
+  return id;
+}
+
+/** Parent path for sibling grouping when `parentInstanceId` is unset (Babel stamps). */
+function siblingGroupKey(inst) {
+  const path = inst.templatePath || inst.structuralPath;
+  const idx = path.lastIndexOf(' > ');
+  return idx === -1 ? path : path.slice(0, idx);
+}
+export class AutoAnchorRegistry {
+  instances = new Map();
+  byRegistryKey = new Map();
+  byManualId = new Map();
+  byTemplatePath = new Map();
+  listeners = new Set();
+  notifyScheduled = false;
+  registerInstance(input) {
+    const instanceId = mintInstanceId();
+    const hints = input.hints ?? undefined;
+    const kind = input.kind;
+    const role = hints?.role ?? roleForKind(kind);
+    const templatePath = hints?.templatePath ?? hints?.ufid ?? input.registryKey;
+    const structuralPath = hints?.structuralPath ?? hints?.ufid ?? templatePath;
+    const runtime = input.runtime ?? {};
+    const manualId = runtime.manualId ?? runtime.userflowId ?? hints?.literalUserflowId ?? runtime.testID ?? hints?.literalTestId ?? (runtime.nativeID && !runtime.nativeID.startsWith('uf_') ? runtime.nativeID : undefined);
+    const userflowId = runtime.userflowId ?? hints?.literalUserflowId;
+    const testID = runtime.testID ?? hints?.literalTestId;
+    const nativeID = runtime.nativeID ?? hints?.nativeId;
+    const childText = runtime.childText ?? hints?.childText;
+    const accessibilityLabel = runtime.accessibilityLabel ?? hints?.literalLabel;
+    const iconName = runtime.iconName ?? hints?.iconName;
+    const imageSrc = runtime.imageSrc ?? hints?.imageSrc;
+    const instance = {
+      instanceId,
+      registryKey: input.registryKey,
+      ref: input.ref,
+      kind,
+      role,
+      isPressable: PRESSABLE_KINDS.has(kind),
+      templatePath,
+      structuralPath,
+      ...(input.instanceScope ? {
+        instanceScope: input.instanceScope
+      } : {}),
+      ...(manualId ? {
+        manualId
+      } : {}),
+      ...(userflowId ? {
+        userflowId
+      } : {}),
+      ...(testID ? {
+        testID
+      } : {}),
+      ...(nativeID ? {
+        nativeID
+      } : {}),
+      ...(childText ? {
+        childText
+      } : {}),
+      ...(accessibilityLabel ? {
+        accessibilityLabel
+      } : {}),
+      ...(hints?.childShape ? {
+        childShape: hints.childShape
+      } : {}),
+      ...(iconName ? {
+        iconName
+      } : {}),
+      ...(imageSrc ? {
+        imageSrc
+      } : {}),
+      ancestors: hints?.ancestors ? [...hints.ancestors] : [],
+      ...(hints?.ordinal !== undefined ? {
+        ordinal: hints.ordinal
+      } : {}),
+      ...(hints?.siblingIndex !== undefined ? {
+        siblingIndex: hints.siblingIndex
+      } : {}),
+      ...(input.parentInstanceId ? {
+        parentInstanceId: input.parentInstanceId
+      } : {}),
+      childInstanceIds: [],
+      ambiguous: false
+    };
+    this.instances.set(instanceId, instance);
+    this.addIndex(this.byRegistryKey, input.registryKey, instanceId);
+    this.addIndex(this.byTemplatePath, templatePath, instanceId);
+    if (manualId) this.addIndex(this.byManualId, manualId, instanceId);
+    if (instance.userflowId) this.addIndex(this.byManualId, instance.userflowId, instanceId);
+    if (instance.testID) this.addIndex(this.byManualId, instance.testID, instanceId);
+    if (input.parentInstanceId) {
+      const parent = this.instances.get(input.parentInstanceId);
+      if (parent) parent.childInstanceIds.push(instanceId);
+    }
+    this.recomputeAmbiguity(input.registryKey, templatePath, manualId);
+    this.notify();
+    return {
+      instanceId,
+      dispose: () => {
+        this.unregisterInstance(instanceId);
+      }
+    };
+  }
+  updateInstance(instanceId, patch) {
+    const inst = this.instances.get(instanceId);
+    if (!inst) return;
+    const prevIds = {
+      manualId: inst.manualId,
+      userflowId: inst.userflowId,
+      testID: inst.testID
+    };
+    Object.assign(inst, patch);
+    if (patch.manualId !== undefined || patch.userflowId !== undefined || patch.testID !== undefined) {
+      const nextManual = patch.manualId ?? inst.userflowId ?? inst.testID ?? (inst.nativeID && !inst.nativeID.startsWith('uf_') ? inst.nativeID : undefined);
+      if (nextManual) inst.manualId = nextManual;else delete inst.manualId;
+    }
+    this.refreshManualIndexes(inst, prevIds);
+    this.recomputeAmbiguity(inst.registryKey, inst.templatePath, inst.manualId);
+    this.notify();
+  }
+  getInstance(instanceId) {
+    return this.instances.get(instanceId);
+  }
+  getInstancesByRegistryKey(key) {
+    return this.idsToInstances(this.byRegistryKey.get(key));
+  }
+  getInstancesByManualId(id) {
+    return this.idsToInstances(this.byManualId.get(id));
+  }
+  getInstancesByTemplatePath(path) {
+    return this.idsToInstances(this.byTemplatePath.get(path));
+  }
+  allInstances() {
+    return Array.from(this.instances.values());
+  }
+  orderedSiblingsIncludingSelf(instanceId) {
+    const inst = this.instances.get(instanceId);
+    if (!inst) return [];
+    if (!inst.parentInstanceId) {
+      const group = siblingGroupKey(inst);
+      return this.allInstances().filter(i => !i.parentInstanceId && siblingGroupKey(i) === group).sort((a, b) => (a.siblingIndex ?? 0) - (b.siblingIndex ?? 0));
+    }
+    const parent = this.instances.get(inst.parentInstanceId);
+    if (!parent) return [inst];
+    return parent.childInstanceIds.map(id => this.instances.get(id)).filter(i => !!i).sort((a, b) => (a.siblingIndex ?? 0) - (b.siblingIndex ?? 0));
+  }
+  siblingWindow(instanceId, windowSize = 2) {
+    const ordered = this.orderedSiblingsIncludingSelf(instanceId);
+    const idx = ordered.findIndex(i => i.instanceId === instanceId);
+    if (idx < 0) return {
+      previous: [],
+      next: []
+    };
+    const toDesc = i => ({
+      kind: i.kind,
+      role: i.role,
+      ...(i.childText ? {
+        text: i.childText
+      } : {}),
+      ...(i.testID ? {
+        testID: i.testID
+      } : {}),
+      ...(i.userflowId ? {
+        userflowId: i.userflowId
+      } : {})
+    });
+    return {
+      previous: ordered.slice(Math.max(0, idx - windowSize), idx).map(toDesc),
+      next: ordered.slice(idx + 1, idx + 1 + windowSize).map(toDesc)
+    };
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  isAmbiguousKey(key) {
+    const byKey = this.getInstancesByRegistryKey(key);
+    if (byKey.length > 0) return byKey.some(i => i.ambiguous);
+    const byManual = this.getInstancesByManualId(key);
+    return byManual.length > 1 || byManual.some(i => i.ambiguous);
+  }
+
+  /** Test helper — drop every instance and reset ids. */
+  clear() {
+    this.instances.clear();
+    this.byRegistryKey.clear();
+    this.byManualId.clear();
+    this.byTemplatePath.clear();
+    this.notifyScheduled = false;
+    nextInstanceSeq = 1;
+  }
+  unregisterInstance(instanceId) {
+    const inst = this.instances.get(instanceId);
+    if (!inst) return;
+    if (inst.parentInstanceId) {
+      const parent = this.instances.get(inst.parentInstanceId);
+      if (parent) {
+        parent.childInstanceIds = parent.childInstanceIds.filter(id => id !== instanceId);
+      }
+    }
+    for (const childId of [...inst.childInstanceIds]) {
+      const child = this.instances.get(childId);
+      if (child) delete child.parentInstanceId;
+    }
+    this.instances.delete(instanceId);
+    this.removeIndex(this.byRegistryKey, inst.registryKey, instanceId);
+    this.removeIndex(this.byTemplatePath, inst.templatePath, instanceId);
+    if (inst.manualId) this.removeIndex(this.byManualId, inst.manualId, instanceId);
+    if (inst.userflowId) this.removeIndex(this.byManualId, inst.userflowId, instanceId);
+    if (inst.testID) this.removeIndex(this.byManualId, inst.testID, instanceId);
+    this.recomputeAmbiguity(inst.registryKey, inst.templatePath, inst.manualId);
+    this.notify();
+  }
+  refreshManualIndexes(inst, prev) {
+    const prevKeys = new Set([prev.manualId, prev.userflowId, prev.testID].filter(k => !!k));
+    const nextKeys = new Set([inst.manualId, inst.userflowId, inst.testID].filter(k => !!k));
+    for (const key of prevKeys) {
+      if (!nextKeys.has(key)) this.removeIndex(this.byManualId, key, inst.instanceId);
+    }
+    for (const key of nextKeys) {
+      if (!prevKeys.has(key)) this.addIndex(this.byManualId, key, inst.instanceId);
+    }
+  }
+  recomputeAmbiguity(registryKey, templatePath, manualId) {
+    const mark = list => {
+      const ambiguous = list.length > 1 && list.every(i => !i.manualId);
+      for (const i of list) {
+        i.ambiguous = ambiguous || (i.manualId ? this.getInstancesByManualId(i.manualId).length > 1 : false);
+      }
+    };
+    mark(this.getInstancesByRegistryKey(registryKey));
+    mark(this.getInstancesByTemplatePath(templatePath));
+    if (manualId) {
+      const list = this.getInstancesByManualId(manualId);
+      for (const i of list) i.ambiguous = list.length > 1;
+    }
+  }
+  addIndex(map, key, instanceId) {
+    let set = map.get(key);
+    if (!set) {
+      set = new Set();
+      map.set(key, set);
+    }
+    set.add(instanceId);
+  }
+  removeIndex(map, key, instanceId) {
+    const set = map.get(key);
+    if (!set) return;
+    set.delete(instanceId);
+    if (set.size === 0) map.delete(key);
+  }
+  idsToInstances(set) {
+    if (!set) return [];
+    const out = [];
+    for (const id of set) {
+      const inst = this.instances.get(id);
+      if (inst) out.push(inst);
+    }
+    return out;
+  }
+  notify() {
+    if (this.notifyScheduled) return;
+    this.notifyScheduled = true;
+    const flush = () => {
+      this.notifyScheduled = false;
+      for (const l of this.listeners) {
+        try {
+          l();
+        } catch {
+          // listeners are infrastructure; never propagate
+        }
+      }
+    };
+    if (typeof queueMicrotask === 'function') {
+      queueMicrotask(flush);
+    } else {
+      void Promise.resolve().then(flush);
+    }
+  }
+}
+export const autoAnchorRegistry = new AutoAnchorRegistry();
+//# sourceMappingURL=AutoAnchorRegistry.js.map

package/lib/module/anchors/AutoAnchorRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PRESSABLE_KINDS","Set","roleForKind","kind","has","nextInstanceSeq","mintInstanceId","id","toString","siblingGroupKey","inst","path","templatePath","structuralPath","idx","lastIndexOf","slice","AutoAnchorRegistry","instances","Map","byRegistryKey","byManualId","byTemplatePath","listeners","notifyScheduled","registerInstance","input","instanceId","hints","undefined","role","ufid","registryKey","runtime","manualId","userflowId","literalUserflowId","testID","literalTestId","nativeID","startsWith","nativeId","childText","accessibilityLabel","literalLabel","iconName","imageSrc","instance","ref","isPressable","instanceScope","childShape","ancestors","ordinal","siblingIndex","parentInstanceId","childInstanceIds","ambiguous","set","addIndex","parent","get","push","recomputeAmbiguity","notify","dispose","unregisterInstance","updateInstance","patch","prevIds","Object","assign","nextManual","refreshManualIndexes","getInstance","getInstancesByRegistryKey","key","idsToInstances","getInstancesByManualId","getInstancesByTemplatePath","allInstances","Array","from","values","orderedSiblingsIncludingSelf","group","filter","i","sort","a","b","map","siblingWindow","windowSize","ordered","findIndex","previous","next","toDesc","text","Math","max","subscribe","listener","add","delete","isAmbiguousKey","byKey","length","some","byManual","clear","childId","child","removeIndex","prev","prevKeys","k","nextKeys","mark","list","every","size","out","flush","l","queueMicrotask","Promise","resolve","then","autoAnchorRegistry"],"sourceRoot":"../../../src","sources":["anchors/AutoAnchorRegistry.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/anchors/ScrollContainerRegistry.js

@@ -0,0 +1,86 @@
+"use strict";
+
+/** Padding applied when scrolling a target into the visible region of a container. */
+const INTO_VIEW_PADDING = 24;
+/**
+ * Registry of host {@link ScrollView}s used as an explicit override when
+ * scrolling tooltip anchors into view. Prefer automatic fiber discovery for
+ * `testID` anchors; register here for scroll libraries the walk cannot drive.
+ */
+export class ScrollContainerRegistry {
+  containers = new Set();
+  listeners = new Set();
+  register(host) {
+    this.containers.add(host);
+    this.emit();
+  }
+  unregister(host) {
+    this.containers.delete(host);
+    this.emit();
+  }
+
+  /** Snapshot of registered containers (most recently registered last). */
+  list() {
+    return [...this.containers];
+  }
+
+  /**
+   * Scroll the first registered container that can bring `target` into its
+   * visible window region. Best-effort — no-op when nothing is registered.
+   */
+  scrollTargetIntoView(target) {
+    for (const host of this.containers) {
+      host.measureInWindow((x, y, width, height) => {
+        if (width <= 0 || height <= 0) return;
+        const offset = host.getContentOffset();
+        const targetContentY = offset.y + (target.y - y);
+        let nextY = null;
+        if (target.y < y + INTO_VIEW_PADDING) {
+          nextY = Math.max(0, targetContentY - INTO_VIEW_PADDING);
+        } else if (target.y + target.height > y + height - INTO_VIEW_PADDING) {
+          nextY = Math.max(0, targetContentY + target.height - height + INTO_VIEW_PADDING);
+        }
+        if (nextY == null || Math.abs(nextY - offset.y) < 1) return;
+        host.scrollTo({
+          y: nextY,
+          animated: true
+        });
+      });
+      // Prefer the first container for MVP; hosts typically have one root ScrollView.
+      return;
+    }
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  clear() {
+    this.containers.clear();
+    this.emit();
+  }
+  emit() {
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+}
+
+/** Module singleton used by {@link useUserflowScrollContainer} and TooltipSurface. */
+export const scrollContainerRegistry = new ScrollContainerRegistry();
+
+/** Build a host from a live ScrollView + tracked content offset. */
+export function createScrollContainerHost(node, getContentOffset) {
+  const measurable = node;
+  return {
+    measureInWindow: callback => {
+      measurable.measureInWindow(callback);
+    },
+    getContentOffset,
+    scrollTo: options => {
+      node.scrollTo(options);
+    }
+  };
+}
+//# sourceMappingURL=ScrollContainerRegistry.js.map

package/lib/module/anchors/ScrollContainerRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["INTO_VIEW_PADDING","ScrollContainerRegistry","containers","Set","listeners","register","host","add","emit","unregister","delete","list","scrollTargetIntoView","target","measureInWindow","x","y","width","height","offset","getContentOffset","targetContentY","nextY","Math","max","abs","scrollTo","animated","subscribe","listener","clear","scrollContainerRegistry","createScrollContainerHost","node","measurable","callback","options"],"sourceRoot":"../../../src","sources":["anchors/ScrollContainerRegistry.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/anchors/anchorChangeTicker.js

@@ -0,0 +1,79 @@
+"use strict";
+
+import { anchorRegistry } from "./AnchorRegistry.js";
+import { fiberScanRoot } from "./fiber/FiberScanRoot.js";
+/**
+ * Change signal for ELEMENT client conditions.
+ *
+ * Fiber-resolved anchors (testID / nativeID / accessibilityLabel) do not emit
+ * registry events, so we combine:
+ * - {@link anchorRegistry} mount/unmount
+ * - {@link fiberScanRoot} mount/unmount
+ * - screen-change notifications
+ * - a slow interval that only runs while at least one listener is subscribed
+ */
+class AnchorChangeTicker {
+  listeners = new Set();
+  intervalHandle = null;
+  unsubRegistry = null;
+  unsubScan = null;
+
+  /** Poll interval while ELEMENT conditions are tracked (ms). */
+  static INTERVAL_MS = 1000;
+  subscribe(listener) {
+    const wasEmpty = this.listeners.size === 0;
+    this.listeners.add(listener);
+    if (wasEmpty) {
+      this.start();
+    }
+    return () => {
+      this.listeners.delete(listener);
+      if (this.listeners.size === 0) {
+        this.stop();
+      }
+    };
+  }
+
+  /** Push a change from outside (e.g. screen navigation). */
+  notify() {
+    this.emit();
+  }
+
+  /** Test helper. */
+  resetForTests() {
+    this.stop();
+    this.listeners.clear();
+  }
+  start() {
+    if (!this.unsubRegistry) {
+      this.unsubRegistry = anchorRegistry.subscribe(() => this.emit());
+    }
+    if (!this.unsubScan) {
+      this.unsubScan = fiberScanRoot.subscribe(() => this.emit());
+    }
+    if (!this.intervalHandle) {
+      this.intervalHandle = setInterval(() => this.emit(), AnchorChangeTicker.INTERVAL_MS);
+    }
+  }
+  stop() {
+    if (this.intervalHandle) {
+      clearInterval(this.intervalHandle);
+      this.intervalHandle = null;
+    }
+    if (this.unsubRegistry) {
+      this.unsubRegistry();
+      this.unsubRegistry = null;
+    }
+    if (this.unsubScan) {
+      this.unsubScan();
+      this.unsubScan = null;
+    }
+  }
+  emit() {
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+}
+export const anchorChangeTicker = new AnchorChangeTicker();
+//# sourceMappingURL=anchorChangeTicker.js.map

package/lib/module/anchors/anchorChangeTicker.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["anchorRegistry","fiberScanRoot","AnchorChangeTicker","listeners","Set","intervalHandle","unsubRegistry","unsubScan","INTERVAL_MS","subscribe","listener","wasEmpty","size","add","start","delete","stop","notify","emit","resetForTests","clear","setInterval","clearInterval","anchorChangeTicker"],"sourceRoot":"../../../src","sources":["anchors/anchorChangeTicker.ts"],"mappings":";;AAAA,SAASA,cAAc,QAAQ,qBAAkB;AACjD,SAASC,aAAa,QAAQ,0BAAuB;AAIrD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,kBAAkB,CAAC;EACNC,SAAS,GAAG,IAAIC,GAAG,CAAW,CAAC;EACxCC,cAAc,GAA0C,IAAI;EAC5DC,aAAa,GAAwB,IAAI;EACzCC,SAAS,GAAwB,IAAI;;EAE7C;EACA,OAAgBC,WAAW,GAAG,IAAI;EAElCC,SAASA,CAACC,QAAkB,EAAc;IACxC,MAAMC,QAAQ,GAAG,IAAI,CAACR,SAAS,CAACS,IAAI,KAAK,CAAC;IAC1C,IAAI,CAACT,SAAS,CAACU,GAAG,CAACH,QAAQ,CAAC;IAC5B,IAAIC,QAAQ,EAAE;MACZ,IAAI,CAACG,KAAK,CAAC,CAAC;IACd;IACA,OAAO,MAAM;MACX,IAAI,CAACX,SAAS,CAACY,MAAM,CAACL,QAAQ,CAAC;MAC/B,IAAI,IAAI,CAACP,SAAS,CAACS,IAAI,KAAK,CAAC,EAAE;QAC7B,IAAI,CAACI,IAAI,CAAC,CAAC;MACb;IACF,CAAC;EACH;;EAEA;EACAC,MAAMA,CAAA,EAAS;IACb,IAAI,CAACC,IAAI,CAAC,CAAC;EACb;;EAEA;EACAC,aAAaA,CAAA,EAAS;IACpB,IAAI,CAACH,IAAI,CAAC,CAAC;IACX,IAAI,CAACb,SAAS,CAACiB,KAAK,CAAC,CAAC;EACxB;EAEQN,KAAKA,CAAA,EAAS;IACpB,IAAI,CAAC,IAAI,CAACR,aAAa,EAAE;MACvB,IAAI,CAACA,aAAa,GAAGN,cAAc,CAACS,SAAS,CAAC,MAAM,IAAI,CAACS,IAAI,CAAC,CAAC,CAAC;IAClE;IACA,IAAI,CAAC,IAAI,CAACX,SAAS,EAAE;MACnB,IAAI,CAACA,SAAS,GAAGN,aAAa,CAACQ,SAAS,CAAC,MAAM,IAAI,CAACS,IAAI,CAAC,CAAC,CAAC;IAC7D;IACA,IAAI,CAAC,IAAI,CAACb,cAAc,EAAE;MACxB,IAAI,CAACA,cAAc,GAAGgB,WAAW,CAAC,MAAM,IAAI,CAACH,IAAI,CAAC,CAAC,EAAEhB,kBAAkB,CAACM,WAAW,CAAC;IACtF;EACF;EAEQQ,IAAIA,CAAA,EAAS;IACnB,IAAI,IAAI,CAACX,cAAc,EAAE;MACvBiB,aAAa,CAAC,IAAI,CAACjB,cAAc,CAAC;MAClC,IAAI,CAACA,cAAc,GAAG,IAAI;IAC5B;IACA,IAAI,IAAI,CAACC,aAAa,EAAE;MACtB,IAAI,CAACA,aAAa,CAAC,CAAC;MACpB,IAAI,CAACA,aAAa,GAAG,IAAI;IAC3B;IACA,IAAI,IAAI,CAACC,SAAS,EAAE;MAClB,IAAI,CAACA,SAAS,CAAC,CAAC;MAChB,IAAI,CAACA,SAAS,GAAG,IAAI;IACvB;EACF;EAEQW,IAAIA,CAAA,EAAS;IACnB,KAAK,MAAMR,QAAQ,IAAI,IAAI,CAACP,SAAS,EAAE;MACrCO,QAAQ,CAAC,CAAC;IACZ;EACF;AACF;AAEA,OAAO,MAAMa,kBAAkB,GAAG,IAAIrB,kBAAkB,CAAC,CAAC","ignoreList":[]}

package/lib/module/anchors/animationFrame.js

@@ -0,0 +1,83 @@
+"use strict";
+
+/**
+ * Shared requestAnimationFrame hub so multiple surfaces never stack loops.
+ * Mirrors web userflowjs `util/animation-frame.tsx`.
+ */
+
+const callbacks = [];
+let rafHandle = null;
+let active = false;
+
+/**
+ * `callback` runs on every animation frame. Starts the shared loop when the
+ * first subscriber attaches.
+ */
+export function addAnimationFrameCallback(callback) {
+  if (callbacks.includes(callback)) return;
+  callbacks.push(callback);
+  if (callbacks.length === 1) {
+    active = true;
+    requestNext();
+  }
+}
+
+/**
+ * Remove a previously added callback. Stops the loop when the last subscriber
+ * detaches.
+ */
+export function removeAnimationFrameCallback(callback) {
+  const idx = callbacks.indexOf(callback);
+  if (idx < 0) return;
+  callbacks.splice(idx, 1);
+  if (callbacks.length === 0) {
+    active = false;
+    cancelPending();
+  }
+}
+
+/** Test helper — drop all subscribers and cancel the pending frame. */
+export function resetAnimationFrameForTests() {
+  callbacks.length = 0;
+  active = false;
+  cancelPending();
+}
+
+/** Test helper — number of active subscribers. */
+export function animationFrameSubscriberCount() {
+  return callbacks.length;
+}
+function onAnimationFrame() {
+  rafHandle = null;
+  // Snapshot so a callback that unsubscribes mid-frame is safe.
+  const snapshot = callbacks.slice();
+  for (const callback of snapshot) {
+    try {
+      callback();
+    } catch {
+      // A single subscriber must not tear down the hub.
+    }
+  }
+  requestNext();
+}
+function requestNext() {
+  if (!active) return;
+  const raf = typeof globalThis.requestAnimationFrame === 'function' ? globalThis.requestAnimationFrame.bind(globalThis) : null;
+  if (raf) {
+    rafHandle = raf(onAnimationFrame);
+  } else {
+    // Jest / environments without rAF — fall back to a short timer so tests
+    // and headless runs still drive the loop.
+    rafHandle = setTimeout(onAnimationFrame, 16);
+  }
+}
+function cancelPending() {
+  if (rafHandle == null) return;
+  if (typeof globalThis.cancelAnimationFrame === 'function' && typeof rafHandle === 'number') {
+    globalThis.cancelAnimationFrame(rafHandle);
+  } else {
+    clearTimeout(rafHandle);
+  }
+  rafHandle = null;
+}
+//# sourceMappingURL=animationFrame.js.map

package/lib/module/anchors/animationFrame.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["callbacks","rafHandle","active","addAnimationFrameCallback","callback","includes","push","length","requestNext","removeAnimationFrameCallback","idx","indexOf","splice","cancelPending","resetAnimationFrameForTests","animationFrameSubscriberCount","onAnimationFrame","snapshot","slice","raf","globalThis","requestAnimationFrame","bind","setTimeout","cancelAnimationFrame","clearTimeout"],"sourceRoot":"../../../src","sources":["anchors/animationFrame.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAIA,MAAMA,SAAqB,GAAG,EAAE;AAChC,IAAIC,SAAwD,GAAG,IAAI;AACnE,IAAIC,MAAM,GAAG,KAAK;;AAElB;AACA;AACA;AACA;AACA,OAAO,SAASC,yBAAyBA,CAACC,QAAkB,EAAQ;EAClE,IAAIJ,SAAS,CAACK,QAAQ,CAACD,QAAQ,CAAC,EAAE;EAClCJ,SAAS,CAACM,IAAI,CAACF,QAAQ,CAAC;EACxB,IAAIJ,SAAS,CAACO,MAAM,KAAK,CAAC,EAAE;IAC1BL,MAAM,GAAG,IAAI;IACbM,WAAW,CAAC,CAAC;EACf;AACF;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,4BAA4BA,CAACL,QAAkB,EAAQ;EACrE,MAAMM,GAAG,GAAGV,SAAS,CAACW,OAAO,CAACP,QAAQ,CAAC;EACvC,IAAIM,GAAG,GAAG,CAAC,EAAE;EACbV,SAAS,CAACY,MAAM,CAACF,GAAG,EAAE,CAAC,CAAC;EACxB,IAAIV,SAAS,CAACO,MAAM,KAAK,CAAC,EAAE;IAC1BL,MAAM,GAAG,KAAK;IACdW,aAAa,CAAC,CAAC;EACjB;AACF;;AAEA;AACA,OAAO,SAASC,2BAA2BA,CAAA,EAAS;EAClDd,SAAS,CAACO,MAAM,GAAG,CAAC;EACpBL,MAAM,GAAG,KAAK;EACdW,aAAa,CAAC,CAAC;AACjB;;AAEA;AACA,OAAO,SAASE,6BAA6BA,CAAA,EAAW;EACtD,OAAOf,SAAS,CAACO,MAAM;AACzB;AAEA,SAASS,gBAAgBA,CAAA,EAAS;EAChCf,SAAS,GAAG,IAAI;EAChB;EACA,MAAMgB,QAAQ,GAAGjB,SAAS,CAACkB,KAAK,CAAC,CAAC;EAClC,KAAK,MAAMd,QAAQ,IAAIa,QAAQ,EAAE;IAC/B,IAAI;MACFb,QAAQ,CAAC,CAAC;IACZ,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;EACAI,WAAW,CAAC,CAAC;AACf;AAEA,SAASA,WAAWA,CAAA,EAAS;EAC3B,IAAI,CAACN,MAAM,EAAE;EACb,MAAMiB,GAAG,GACP,OAAOC,UAAU,CAACC,qBAAqB,KAAK,UAAU,GAClDD,UAAU,CAACC,qBAAqB,CAACC,IAAI,CAACF,UAAU,CAAC,GACjD,IAAI;EACV,IAAID,GAAG,EAAE;IACPlB,SAAS,GAAGkB,GAAG,CAACH,gBAAgB,CAAC;EACnC,CAAC,MAAM;IACL;IACA;IACAf,SAAS,GAAGsB,UAAU,CAACP,gBAAgB,EAAE,EAAE,CAAC;EAC9C;AACF;AAEA,SAASH,aAAaA,CAAA,EAAS;EAC7B,IAAIZ,SAAS,IAAI,IAAI,EAAE;EACvB,IAAI,OAAOmB,UAAU,CAACI,oBAAoB,KAAK,UAAU,IAAI,OAAOvB,SAAS,KAAK,QAAQ,EAAE;IAC1FmB,UAAU,CAACI,oBAAoB,CAACvB,SAAS,CAAC;EAC5C,CAAC,MAAM;IACLwB,YAAY,CAACxB,SAA0C,CAAC;EAC1D;EACAA,SAAS,GAAG,IAAI;AAClB","ignoreList":[]}