@userflow-tech/react-native 0.1.0

package/lib/typescript/commonjs/src/surfaces/themeChrome.d.ts

@@ -0,0 +1,36 @@
+import type { ThemeFragment } from '@userflow-tech/protocol';
+import type { ViewStyle } from 'react-native';
+export type BubbleChromeKind = 'modal' | 'tooltip';
+export interface BubbleChrome {
+    backgroundColor: string;
+    borderRadius: number;
+    borderWidth: number;
+    borderColor: string;
+    notchSize: number;
+    /** Inner content padding (modal: theme `modalPadding` or 32; tooltip/bubble 24). */
+    contentPadding: number;
+    /**
+     * Outer shell — shadow + overflow. Tooltips keep overflow visible so the
+     * notch can sit outside the card bounds.
+     */
+    cardStyle: ViewStyle;
+    /**
+     * Opaque fill layer (bg + radius + optional border). Tooltip surfaces render
+     * the notch behind this so the diamond joins the card without a seam.
+     */
+    fillStyle: ViewStyle;
+    /**
+     * Web `filter: drop-shadow(…)` as RN shadow props. Only paints on a layer
+     * without `overflow: 'hidden'` — iOS clips the shadow along with the content.
+     */
+    shadowStyle: ViewStyle;
+}
+/**
+ * Web theme-driven card chrome (FlowChrome / flow-host / bubble-frame) as the
+ * interim RN visual baseline until mobile design specs land.
+ *
+ * Optional fields (`bubbleBorderRadius`, `tooltipNotchSize`, …) are read from
+ * the theme index signature so curated ThemeFragment stays small.
+ */
+export declare function resolveBubbleChrome(theme: ThemeFragment, kind?: BubbleChromeKind): BubbleChrome;
+//# sourceMappingURL=themeChrome.d.ts.map

package/lib/typescript/commonjs/src/surfaces/themeChrome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeChrome.d.ts","sourceRoot":"","sources":["../../../../../src/surfaces/themeChrome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,cAAc,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,WAAW,EAAE,SAAS,CAAC;CACxB;AAiBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,gBAA0B,GAC/B,YAAY,CAsEd"}

package/lib/typescript/commonjs/src/surfaces/tooltip/TooltipBubble.d.ts

@@ -0,0 +1,23 @@
+import * as React from 'react';
+import { type LayoutChangeEvent, type StyleProp, type ViewStyle } from 'react-native';
+import type { BubbleChrome } from '../themeChrome';
+import type { NotchPosition } from './computeTooltipPosition';
+export interface TooltipBubbleProps {
+    chrome: BubbleChrome;
+    notchPosition: NotchPosition;
+    style?: StyleProp<ViewStyle>;
+    onLayout?: (event: LayoutChangeEvent) => void;
+    children: React.ReactNode;
+}
+/**
+ * Tooltip chrome shell: diamond notch + card fill sharing one shadow family.
+ *
+ * Web draws card and notch as a single silhouette under `filter: drop-shadow`.
+ * RN has no silhouette filter, so the card uses a dedicated shadow layer and
+ * `elevation` on the fill (Android). The notch itself is not shadowed — a
+ * second blurred shadow on the rotated square leaves a gray band at the pointer
+ * base when it points up into the anchor. An inset fill diamond on top erases
+ * that seam (and bordered stroke gaps) without clipping the outer tip.
+ */
+export declare function TooltipBubble({ chrome, notchPosition, style, onLayout, children, }: TooltipBubbleProps): React.ReactElement;
+//# sourceMappingURL=TooltipBubble.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/TooltipBubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TooltipBubble.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/TooltipBubble.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,YAAY,CAAC;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC9C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,aAAa,EACb,KAAK,EACL,QAAQ,EACR,QAAQ,GACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA4DzC"}

package/lib/typescript/commonjs/src/surfaces/tooltip/TooltipCutout.d.ts

@@ -0,0 +1,31 @@
+import * as React from 'react';
+export interface HighlightRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface TooltipCutoutProps {
+    targetRect: HighlightRect;
+    backdropColor: string;
+    backdropOpacity: number;
+    /**
+     * When true, a transparent capture layer covers only the highlight hole so
+     * the tooltip target cannot be pressed. Dim bands stay visual-only either way.
+     */
+    targetBlocked: boolean;
+}
+/**
+ * Four-block dimmed cutout around the padded target (web tooltip backdrop).
+ *
+ * Dim bands use `pointerEvents="none"` so touches reach the app — React Native
+ * cannot block taps while allowing scroll the way web's `mousedown`-only
+ * swallow does. When `targetBlocked`, only the hole (target) is covered with a
+ * transparent `pointerEvents="auto"` layer.
+ *
+ * MVP note: each block uses its own translucent opacity. That matches non-overlapping
+ * tiles well, but can look slightly uneven vs web’s single shadow-hole when other
+ * translucent overlays stack. Acceptable for Phase 3; a single masked layer can come later.
+ */
+export declare function TooltipCutout({ targetRect, backdropColor, backdropOpacity, targetBlocked, }: TooltipCutoutProps): React.ReactElement;
+//# sourceMappingURL=TooltipCutout.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/TooltipCutout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TooltipCutout.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/TooltipCutout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,aAAa,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,UAAU,EACV,aAAa,EACb,eAAe,EACf,aAAa,GACd,EAAE,kBAAkB,GAAG,KAAK,CAAC,YAAY,CA+DzC"}

package/lib/typescript/commonjs/src/surfaces/tooltip/TooltipNotch.d.ts

@@ -0,0 +1,29 @@
+import * as React from 'react';
+import { type StyleProp, type ViewStyle } from 'react-native';
+import { tooltipNotchDiamondSide } from './computeTooltipPosition';
+export interface TooltipNotchProps {
+    notchSize: number;
+    notchColor: string;
+    /**
+     * Shrink the diamond by this much on every edge, keeping the same center.
+     * Bordered themes stamp an inset fill diamond so the stroke stays even.
+     */
+    inset?: number;
+    style?: StyleProp<ViewStyle>;
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+    testID?: string;
+}
+export { tooltipNotchDiamondSide };
+/**
+ * Tooltip arrow as a rotated square half-hidden under the opaque card fill.
+ *
+ * Web uses a CSS border-triangle under `filter: drop-shadow`, so the notch and
+ * card share one silhouette. RN box-shadow can't follow alpha, and border
+ * triangles render poorly — a diamond behind the card reads as a real tooltip
+ * pointer and joins the fill without a seam.
+ */
+export declare function TooltipNotch({ notchSize, notchColor, inset, style, top, bottom, left, right, testID, }: TooltipNotchProps): React.ReactElement;
+//# sourceMappingURL=TooltipNotch.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/TooltipNotch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TooltipNotch.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/TooltipNotch.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC;AAEnC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,SAAS,EACT,UAAU,EACV,KAAS,EACT,KAAK,EACL,GAAG,EACH,MAAM,EACN,IAAI,EACJ,KAAK,EACL,MAAiC,GAClC,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAkBxC"}

package/lib/typescript/commonjs/src/surfaces/tooltip/computeTooltipPosition.d.ts

@@ -0,0 +1,43 @@
+import type { Position, Rect, Size, TooltipPlacementSide, WindowSize } from './inferTooltipPlacement';
+export interface NotchPosition {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+}
+export interface TooltipLayout {
+    cardPosition: Position;
+    notchPosition: NotchPosition;
+    /** Padded target rect used for the cutout hole. */
+    targetHighlightRect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Side length of the axis-aligned square that, when rotated 45°, yields a
+ * tip that protrudes `notchSize` beyond the card edge (half-diagonal = N).
+ */
+export declare function tooltipNotchDiamondSide(notchSize: number): number;
+/**
+ * TOOLTIP card + notch layout. Port of FlowChrome.tsx placement/clamp.
+ *
+ * The notch is a square of side `N√2` rotated 45° whose center sits on the card
+ * edge, so a tip of length `N` points at the target. When the card has a border,
+ * pull the diamond toward the card by `borderWidth` so the tip still clears the
+ * stroke without leaving a seam.
+ */
+export declare function computeTooltipPosition(opts: {
+    target: Rect;
+    bubbleSize: Size;
+    placement: TooltipPlacementSide;
+    notchSize: number;
+    backdropPadding?: number;
+    windowSize: WindowSize;
+    bubbleBorderRadius: number;
+    bubbleBorderWidth?: number;
+    viewportPadding?: number;
+}): TooltipLayout;
+//# sourceMappingURL=computeTooltipPosition.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/computeTooltipPosition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeTooltipPosition.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/computeTooltipPosition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,oBAAoB,EACpB,UAAU,EACX,MAAM,yBAAyB,CAAC;AAGjC,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,QAAQ,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,mDAAmD;IACnD,mBAAmB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACnF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,IAAI,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,oBAAoB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,aAAa,CA2EhB"}

package/lib/typescript/commonjs/src/surfaces/tooltip/inferTooltipPlacement.d.ts

@@ -0,0 +1,34 @@
+/** Placement sides — string union so Jest protocol mocks stay empty. */
+export type TooltipPlacementSide = 'ABOVE' | 'BELOW' | 'LEFT' | 'RIGHT';
+export interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface Size {
+    width: number;
+    height: number;
+}
+export interface Position {
+    x: number;
+    y: number;
+}
+export interface WindowSize {
+    width: number;
+    height: number;
+}
+export declare const VIEWPORT_PADDING = 24;
+/**
+ * Port of web FlowChrome `inferTooltipPlacement` with distance-sorted flip
+ * (not the prototype's fixed BELOW→ABOVE→RIGHT→LEFT priority).
+ */
+export declare function inferTooltipPlacement({ target, bubbleSize, notchSize, windowSize, currentPlacement, desiredPlacement, }: {
+    target: Rect;
+    bubbleSize: Size;
+    notchSize: number;
+    windowSize: WindowSize;
+    currentPlacement: TooltipPlacementSide | null;
+    desiredPlacement: TooltipPlacementSide | null;
+}): TooltipPlacementSide;
+//# sourceMappingURL=inferTooltipPlacement.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/inferTooltipPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferTooltipPlacement.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/inferTooltipPlacement.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAExE,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,eAAO,MAAM,gBAAgB,KAA2B,CAAC;AAEzD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,EACN,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,EAAE;IACD,MAAM,EAAE,IAAI,CAAC;IACb,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC/C,GAAG,oBAAoB,CA6DvB"}

package/lib/typescript/commonjs/src/surfaces/tooltip/parseBackdropPadding.d.ts

@@ -0,0 +1,3 @@
+/** Parse step `backdropPadding` (px). Web accepts CSS shorthand; MVP: first number. */
+export declare function parseBackdropPadding(value: string | null | undefined): number;
+//# sourceMappingURL=parseBackdropPadding.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/parseBackdropPadding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBackdropPadding.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/parseBackdropPadding.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAM7E"}

package/lib/typescript/commonjs/src/surfaces/tooltip/rect.d.ts

@@ -0,0 +1,29 @@
+import type { Rect, WindowSize } from './inferTooltipPlacement';
+/** True when two rects are identical (used to avoid redundant setState). */
+export declare function rectsEqual(a: Rect | null, b: Rect | null): boolean;
+/** Fully outside the window (no intersection). Kept for callers that need it. */
+export declare function isRectOffScreen(rect: Rect, windowSize: WindowSize): boolean;
+/**
+ * Viewport used for scroll-into-view / visibility checks. May be smaller than
+ * the raw window (keyboard, safe-area, sticky chrome via scroll padding).
+ */
+export interface EffectiveViewport {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * True when every edge of `rect` lies inside `viewport` (inclusive).
+ * Partially clipped targets return false — matching web `block: 'nearest'`
+ * scroll-into-view gating.
+ */
+export declare function isRectFullyVisible(rect: Rect, viewport: EffectiveViewport): boolean;
+/** Build an effective viewport from window size + optional insets. */
+export declare function buildEffectiveViewport(windowSize: WindowSize, insets?: {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}): EffectiveViewport;
+//# sourceMappingURL=rect.d.ts.map

package/lib/typescript/commonjs/src/surfaces/tooltip/rect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rect.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/rect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEhE,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAIlE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,OAAO,CAO3E;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CASnF;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,UAAU,EACtB,MAAM,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,iBAAiB,CAWnB"}

package/lib/typescript/commonjs/src/useUserflowScreen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reports the active React Navigation (or manual) screen name to Userflow when
+ * it changes. Sent to the backend as `clientContext.screen`.
+ *
+ * Prefer {@link UserflowProvider} + {@link WithUserflowReactNavigation} when
+ * using React Navigation. For Expo Router pathnames, prefer
+ * {@link UserflowProvider} (it wires pathname tracking automatically).
+ */
+export declare function useUserflowScreen(screenName: string | undefined): void;
+//# sourceMappingURL=useUserflowScreen.d.ts.map

package/lib/typescript/commonjs/src/useUserflowScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUserflowScreen.d.ts","sourceRoot":"","sources":["../../../../src/useUserflowScreen.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAItE"}

package/lib/typescript/commonjs/src/version.d.ts

@@ -0,0 +1,3 @@
+/** Generated by scripts/write-version.mjs — do not edit. */
+export declare const SDK_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/typescript/commonjs/src/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/version.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/lib/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/module/src/anchors/AnchorRegistry.d.ts

@@ -0,0 +1,32 @@
+/** Host view that can be measured in window coordinates. */
+export interface AnchorHost {
+    measureInWindow: (callback: (x: number, y: number, width: number, height: number) => void) => void;
+    /**
+     * Optional best-effort: scroll ancestors so this host enters the viewport.
+     * Called when the measured rect is not fully visible (bounded retries per step).
+     */
+    scrollIntoView?: () => void;
+}
+type Listener = () => void;
+/**
+ * Manual-anchor registry for Phase 3 (WS6). Codeless resolution is Phase 4.
+ * Multiple mounts of the same id keep a set; {@link get} returns the most
+ * recently registered host.
+ */
+export declare class AnchorRegistry {
+    private readonly anchors;
+    private readonly listeners;
+    register(id: string, host: AnchorHost): void;
+    unregister(id: string, host: AnchorHost): void;
+    get(id: string): AnchorHost | null;
+    /** True when more than one host is registered for the same id. */
+    isAmbiguous(id: string): boolean;
+    subscribe(listener: Listener): () => void;
+    /** Test helper — clear all anchors. */
+    clear(): void;
+    private emit;
+}
+/** Module singleton used by {@link useUserflowAnchor} and TooltipSurface. */
+export declare const anchorRegistry: AnchorRegistry;
+export {};
+//# sourceMappingURL=AnchorRegistry.d.ts.map

package/lib/typescript/module/src/anchors/AnchorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnchorRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/AnchorRegistry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,CACf,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,KACpE,IAAI,CAAC;IACV;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAW5C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAU9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUlC,kEAAkE;IAClE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;CAKb;AAED,6EAA6E;AAC7E,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/lib/typescript/module/src/anchors/AutoAnchorRegistry.d.ts

@@ -0,0 +1,113 @@
+import type { SemanticRole, SemanticSegment, SiblingDescriptor } from '@userflow-tech/protocol';
+import type { MutableRefObject, RefObject } from 'react';
+/**
+ * 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.
+ */
+export type AutoAnchorRef = RefObject<unknown> | MutableRefObject<unknown>;
+export type AutoAnchorListener = () => void;
+/** Build-time descriptor stamped by `@userflow-tech/babel-plugin` (full or expanded compact). */
+export interface BuildTimeHints {
+    /** Canonical structural path (IDs replace ordinals when present). */
+    ufid: string;
+    /** Build-local alias key (`uf_<hash>` of templatePath). */
+    nativeId: string;
+    structuralPath?: string;
+    templatePath?: string;
+    childText?: string;
+    childShape?: string;
+    iconName?: string;
+    imageSrc?: string;
+    literalTestId?: string;
+    literalLabel?: string;
+    literalUserflowId?: string;
+    ordinal?: number;
+    siblingIndex?: number;
+    role?: SemanticRole;
+    ancestors?: SemanticSegment[];
+}
+export interface AutoAnchorInstance {
+    instanceId: string;
+    registryKey: string;
+    ref: AutoAnchorRef;
+    kind: string;
+    role: SemanticRole;
+    isPressable: boolean;
+    templatePath: string;
+    structuralPath: string;
+    instanceScope?: string;
+    manualId?: string;
+    userflowId?: string;
+    testID?: string;
+    nativeID?: string;
+    childText?: string;
+    accessibilityLabel?: string;
+    childShape?: string;
+    iconName?: string;
+    imageSrc?: string;
+    ancestors: SemanticSegment[];
+    ordinal?: number;
+    siblingIndex?: number;
+    parentInstanceId?: string;
+    childInstanceIds: string[];
+    ambiguous: boolean;
+}
+export interface RegisterInstanceInput {
+    registryKey: string;
+    ref: AutoAnchorRef;
+    kind: string;
+    hints?: BuildTimeHints | null;
+    instanceScope?: string | null;
+    runtime?: {
+        manualId?: string;
+        userflowId?: string;
+        testID?: string;
+        nativeID?: string;
+        childText?: string;
+        accessibilityLabel?: string;
+        iconName?: string;
+        imageSrc?: string;
+        reactKey?: string;
+    };
+    parentInstanceId?: string;
+}
+export declare function roleForKind(kind: string): SemanticRole;
+export declare class AutoAnchorRegistry {
+    private readonly instances;
+    private readonly byRegistryKey;
+    private readonly byManualId;
+    private readonly byTemplatePath;
+    private readonly listeners;
+    private notifyScheduled;
+    registerInstance(input: RegisterInstanceInput): {
+        instanceId: string;
+        dispose: () => void;
+    };
+    updateInstance(instanceId: string, patch: Partial<Pick<AutoAnchorInstance, 'childText' | 'accessibilityLabel' | 'childShape' | 'manualId' | 'userflowId' | 'testID' | 'nativeID' | 'instanceScope' | 'structuralPath' | 'ancestors' | 'ordinal' | 'siblingIndex' | 'parentInstanceId'>>): void;
+    getInstance(instanceId: string): AutoAnchorInstance | undefined;
+    getInstancesByRegistryKey(key: string): AutoAnchorInstance[];
+    getInstancesByManualId(id: string): AutoAnchorInstance[];
+    getInstancesByTemplatePath(path: string): AutoAnchorInstance[];
+    allInstances(): AutoAnchorInstance[];
+    orderedSiblingsIncludingSelf(instanceId: string): AutoAnchorInstance[];
+    siblingWindow(instanceId: string, windowSize?: number): {
+        previous: SiblingDescriptor[];
+        next: SiblingDescriptor[];
+    };
+    subscribe(listener: AutoAnchorListener): () => void;
+    isAmbiguousKey(key: string): boolean;
+    /** Test helper — drop every instance and reset ids. */
+    clear(): void;
+    private unregisterInstance;
+    private refreshManualIndexes;
+    private recomputeAmbiguity;
+    private addIndex;
+    private removeIndex;
+    private idsToInstances;
+    private notify;
+}
+export declare const autoAnchorRegistry: AutoAnchorRegistry;
+//# sourceMappingURL=AutoAnchorRegistry.d.ts.map

package/lib/typescript/module/src/anchors/AutoAnchorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoAnchorRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/AutoAnchorRegistry.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/src/anchors/ScrollContainerRegistry.d.ts

@@ -0,0 +1,46 @@
+import type { NativeScrollEvent, NativeSyntheticEvent, ScrollView } from 'react-native';
+import type { Rect } from '../surfaces/tooltip/inferTooltipPlacement';
+export interface ScrollContainerHost {
+    measureInWindow: (callback: (x: number, y: number, width: number, height: number) => void) => void;
+    getContentOffset: () => {
+        x: number;
+        y: number;
+    };
+    scrollTo: (options: {
+        x?: number;
+        y?: number;
+        animated?: boolean;
+    }) => void;
+}
+type Listener = () => void;
+/**
+ * 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 declare class ScrollContainerRegistry {
+    private readonly containers;
+    private readonly listeners;
+    register(host: ScrollContainerHost): void;
+    unregister(host: ScrollContainerHost): void;
+    /** Snapshot of registered containers (most recently registered last). */
+    list(): ScrollContainerHost[];
+    /**
+     * Scroll the first registered container that can bring `target` into its
+     * visible window region. Best-effort — no-op when nothing is registered.
+     */
+    scrollTargetIntoView(target: Rect): void;
+    subscribe(listener: Listener): () => void;
+    clear(): void;
+    private emit;
+}
+/** Module singleton used by {@link useUserflowScrollContainer} and TooltipSurface. */
+export declare const scrollContainerRegistry: ScrollContainerRegistry;
+/** Build a host from a live ScrollView + tracked content offset. */
+export declare function createScrollContainerHost(node: ScrollView, getContentOffset: () => {
+    x: number;
+    y: number;
+}): ScrollContainerHost;
+export type ScrollContainerScrollHandler = (event: NativeSyntheticEvent<NativeScrollEvent>) => void;
+export {};
+//# sourceMappingURL=ScrollContainerRegistry.d.ts.map

package/lib/typescript/module/src/anchors/ScrollContainerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollContainerRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/ScrollContainerRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,UAAU,EAAQ,MAAM,cAAc,CAAC;AAE9F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,2CAA2C,CAAC;AAKtE,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,CACf,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,KACpE,IAAI,CAAC;IACV,gBAAgB,EAAE,MAAM;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;;GAIG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAKzC,UAAU,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAK3C,yEAAyE;IACzE,IAAI,IAAI,mBAAmB,EAAE;IAI7B;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAuBxC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;CAKb;AAED,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,yBAAgC,CAAC;AAErE,oEAAoE;AACpE,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,gBAAgB,EAAE,MAAM;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,mBAAmB,CAWrB;AAED,MAAM,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,oBAAoB,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC"}

package/lib/typescript/module/src/anchors/anchorChangeTicker.d.ts

@@ -0,0 +1,30 @@
+type Listener = () => void;
+/**
+ * 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
+ */
+declare class AnchorChangeTicker {
+    private readonly listeners;
+    private intervalHandle;
+    private unsubRegistry;
+    private unsubScan;
+    /** Poll interval while ELEMENT conditions are tracked (ms). */
+    static readonly INTERVAL_MS = 1000;
+    subscribe(listener: Listener): () => void;
+    /** Push a change from outside (e.g. screen navigation). */
+    notify(): void;
+    /** Test helper. */
+    resetForTests(): void;
+    private start;
+    private stop;
+    private emit;
+}
+export declare const anchorChangeTicker: AnchorChangeTicker;
+export {};
+//# sourceMappingURL=anchorChangeTicker.d.ts.map

package/lib/typescript/module/src/anchors/anchorChangeTicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchorChangeTicker.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/anchorChangeTicker.ts"],"names":[],"mappings":"AAGA,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;GASG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IACjD,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,SAAS,CAA6B;IAE9C,+DAA+D;IAC/D,MAAM,CAAC,QAAQ,CAAC,WAAW,QAAQ;IAEnC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAczC,2DAA2D;IAC3D,MAAM,IAAI,IAAI;IAId,mBAAmB;IACnB,aAAa,IAAI,IAAI;IAKrB,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,IAAI;IAeZ,OAAO,CAAC,IAAI;CAKb;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/lib/typescript/module/src/anchors/animationFrame.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared requestAnimationFrame hub so multiple surfaces never stack loops.
+ * Mirrors web userflowjs `util/animation-frame.tsx`.
+ */
+type Callback = () => void;
+/**
+ * `callback` runs on every animation frame. Starts the shared loop when the
+ * first subscriber attaches.
+ */
+export declare function addAnimationFrameCallback(callback: Callback): void;
+/**
+ * Remove a previously added callback. Stops the loop when the last subscriber
+ * detaches.
+ */
+export declare function removeAnimationFrameCallback(callback: Callback): void;
+/** Test helper — drop all subscribers and cancel the pending frame. */
+export declare function resetAnimationFrameForTests(): void;
+/** Test helper — number of active subscribers. */
+export declare function animationFrameSubscriberCount(): number;
+export {};
+//# sourceMappingURL=animationFrame.d.ts.map

package/lib/typescript/module/src/anchors/animationFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationFrame.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/animationFrame.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAM3B;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAOlE;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAQrE;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,IAAI,IAAI,CAIlD;AAED,kDAAkD;AAClD,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD"}

package/lib/typescript/module/src/anchors/autoAnchor.d.ts

@@ -0,0 +1,31 @@
+import type { Ref } from 'react';
+import { type HintsInput } from './hintsCodec';
+/**
+ * Runtime half of build-time auto-anchoring (see `@userflow-tech/babel-plugin`).
+ *
+ * Each mount creates a distinct AutoAnchorRegistry instance. Shared templates
+ * (design-system / list rows) register separately and are marked ambiguous
+ * when they lack a unique manual id or call-site scope.
+ *
+ * Canonical signature (what Babel emits via `__ufRef`):
+ *   __userflowAutoAnchor(id, hints, userRef, kind, runtime?)
+ */
+type HostInstance = unknown;
+type UserRef = Ref<HostInstance> | string | null | undefined;
+export interface AutoAnchorRuntime {
+    userflowId?: string;
+    testID?: string;
+    nativeID?: string;
+    childText?: string;
+    accessibilityLabel?: string;
+    iconName?: string;
+    imageSrc?: string;
+    scope?: string;
+    reactKey?: string;
+    manualId?: string;
+}
+export declare function __userflowAutoAnchor(id: string, hintsOrUserRef?: HintsInput | Ref<HostInstance> | null, userRefOrKind?: UserRef | string, kindOrRuntime?: string | AutoAnchorRuntime, maybeRuntime?: AutoAnchorRuntime): (instance: HostInstance) => void | (() => void);
+/** Test helper — drop factory cache and registry instances. */
+export declare function __resetAutoAnchorForTests(): void;
+export {};
+//# sourceMappingURL=autoAnchor.d.ts.map

package/lib/typescript/module/src/anchors/autoAnchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoAnchor.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/autoAnchor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAQjC,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAEnF;;;;;;;;;GASG;AAEH,KAAK,YAAY,GAAG,OAAO,CAAC;AAE5B,KAAK,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyHD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,EACV,cAAc,CAAC,EAAE,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,IAAI,EACtD,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,EAChC,aAAa,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAC1C,YAAY,CAAC,EAAE,iBAAiB,GAC/B,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,CAwIjD;AAED,+DAA+D;AAC/D,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD"}

package/lib/typescript/module/src/anchors/elementConditionEvaluator.d.ts

@@ -0,0 +1,21 @@
+import type { ConditionEvaluator } from '@userflow-tech/core';
+/**
+ * Evaluate ELEMENT client conditions against manual anchors and fiber-resolved
+ * `testID` / `nativeID` / `accessibilityLabel` targets.
+ *
+ * Supports PRESENT / NOT_PRESENT for MANUAL selectors (`css` → anchor id).
+ * AUTO / codeless selectors and web-interaction states (CLICK, DISABLED, …)
+ * report unknown (`null`) so gated flows stay blocked rather than inventing
+ * a truth value.
+ *
+ * "Present" means `resolveAnchorHost` finds a unique host. That already skips
+ * screens covered by another navigator screen, so an id on a pushed-under
+ * screen counts as absent. Pixel visibility (off-screen inside a ScrollView,
+ * opacity 0, etc.) would need async `measureInWindow` and is out of scope.
+ *
+ * Note: compares string literals rather than importing protocol enums so Jest
+ * (which cannot resolve the ESM-only `@userflow-tech/protocol` package) stays
+ * hermetic. Wire values match `FlowConditionElementState` / `FlowSelectorType`.
+ */
+export declare function createElementConditionEvaluator(warn?: (message: string) => void): ConditionEvaluator;
+//# sourceMappingURL=elementConditionEvaluator.d.ts.map

package/lib/typescript/module/src/anchors/elementConditionEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elementConditionEvaluator.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/elementConditionEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAU9D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAK1B,GACA,kBAAkB,CAkBpB"}