@userflow-tech/react-native 0.1.0 → 0.2.0

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

@@ -0,0 +1,76 @@
+import type { Rect } from './inferTooltipPlacement';
+/**
+ * Narrowest a side card may get: the width it spends on its own chrome, so
+ * content padding on both edges plus the border. Below this there is nothing
+ * left to lay text out in, and React Native overflows the card instead of
+ * shrinking it — the preview would stop showing the author what ships.
+ *
+ * Deliberately structural, not a readability judgment. How narrow is *too*
+ * narrow to read is the author's call, made against the device preview.
+ */
+export declare function tooltipMinSideCardWidth(opts: {
+    contentPadding: number;
+    borderWidth?: number;
+    cardMaxWidth: number;
+}): number;
+/**
+ * Horizontal room beside an expanded target for a LEFT/RIGHT tooltip.
+ *
+ * Reserves `viewportPadding` on the screen edge the card grows toward, matching
+ * the LEFT/RIGHT clamp in `computeTooltipPosition`. Web clamps side placements
+ * to the raw edge instead; RN keeps the screen margin because an edge-to-edge
+ * card reads as broken on a phone-width viewport.
+ */
+export declare function tooltipSideGap(opts: {
+    placement: 'LEFT' | 'RIGHT';
+    target: Rect;
+    windowWidth: number;
+    notchSize: number;
+    viewportPadding?: number;
+}): number;
+/**
+ * Width a LEFT/RIGHT tooltip may use: the room beside the target, capped at the
+ * theme width. The card takes whatever is left and grows taller to compensate.
+ * Null when not even {@link tooltipMinSideCardWidth} fits, so placement falls
+ * back to the vertical flip.
+ *
+ * `target` must already be expanded by backdrop padding and outside highlight
+ * spread — the same rect passed to `inferTooltipPlacement`.
+ */
+export declare function resolveTooltipSideCardWidth(opts: {
+    placement: 'LEFT' | 'RIGHT';
+    target: Rect;
+    windowWidth: number;
+    notchSize: number;
+    cardMaxWidth: number;
+    minWidth: number;
+    viewportPadding?: number;
+}): number | null;
+/**
+ * Shortest a card may get: the height it spends on its own chrome, so
+ * content padding on both edges plus the border. Mirrors
+ * {@link tooltipMinSideCardWidth} on the vertical axis.
+ */
+export declare function tooltipMinCardHeight(opts: {
+    contentPadding: number;
+    borderWidth?: number;
+    cardMaxHeight: number;
+}): number;
+/**
+ * Vertical room above or below an expanded target for an ABOVE/BELOW tooltip.
+ *
+ * Reserves the matching viewport inset on the edge the card grows toward,
+ * matching the ABOVE/BELOW clamp in `computeTooltipPosition`.
+ */
+export declare function tooltipVerticalGap(opts: {
+    placement: 'ABOVE' | 'BELOW';
+    target: Rect;
+    windowHeight: number;
+    notchSize: number;
+    viewportPadding?: number;
+    viewportInsets?: {
+        top?: number;
+        bottom?: number;
+    };
+}): number;
+//# sourceMappingURL=resolveSideCardWidth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveSideCardWidth.d.ts","sourceRoot":"","sources":["../../../../../../src/surfaces/tooltip/resolveSideCardWidth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAGpD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAaT;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAMT;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,GAAG,IAAI,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,GAAG,MAAM,CAWT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,MAAM,EAAE,IAAI,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD,GAAG,MAAM,CAQT"}

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

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

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

@@ -9,7 +9,7 @@ import type { MutableRefObject, RefObject } from 'react';
  */
 export type AutoAnchorRef = RefObject<unknown> | MutableRefObject<unknown>;
 export type AutoAnchorListener = () => void;
-/** Build-time descriptor stamped by `@userflow-tech/babel-plugin` (full or expanded compact). */
+/** Build-time descriptor stamped by `@userflow-tech/react-native/babel-plugin` (full or expanded compact). */
 export interface BuildTimeHints {
     /** Canonical structural path (IDs replace ordinals when present). */
     ufid: string;
@@ -80,6 +80,7 @@ export declare class AutoAnchorRegistry {
     private readonly byRegistryKey;
     private readonly byManualId;
     private readonly byTemplatePath;
+    private readonly liveContent;
     private readonly listeners;
     private notifyScheduled;
     registerInstance(input: RegisterInstanceInput): {
@@ -97,12 +98,37 @@ export declare class AutoAnchorRegistry {
         previous: SiblingDescriptor[];
         next: SiblingDescriptor[];
     };
+    /**
+     * Fill `childText` (and live `testID`) from the host fiber. Live content
+     * wins when readable; the build-time hint is the fallback.
+     *
+     * Direct fiber pointers are preferred; the scan-root index is built lazily
+     * and only if some instance cannot reach its fiber that way (Paper release
+     * builds, mainly), then reused for the rest of the pass.
+     *
+     * Silent — does not notify listeners.
+     */
+    refreshLiveContent(instances?: AutoAnchorInstance[]): void;
+    private refreshOneLiveContent;
+    /**
+     * Copy `testID` off the live host so a shared `__userflowAutoAnchor` callback
+     * (helper-rendered rows) cannot pin every instance to the last render's bag.
+     * Silent — no listener notify.
+     */
+    private applyLiveIdentity;
     subscribe(listener: AutoAnchorListener): () => void;
     isAmbiguousKey(key: string): boolean;
     /** Test helper — drop every instance and reset ids. */
     clear(): void;
     private unregisterInstance;
     private refreshManualIndexes;
+    /**
+     * Instances sharing a template path are only twins while they look alike.
+     * Four rows from one `field()` helper are indistinguishable at register time
+     * and separate once their labels are read, so ambiguity is decided on
+     * content, not on the shared path alone. An instance stays ambiguous when it
+     * carries no content of its own, or when a peer carries the same content.
+     */
     private recomputeAmbiguity;
     private addIndex;
     private removeIndex;

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

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

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

@@ -5,6 +5,7 @@ type Listener = () => void;
  * Fiber-resolved anchors (testID / nativeID / accessibilityLabel) do not emit
  * registry events, so we combine:
  * - {@link anchorRegistry} mount/unmount
+ * - {@link autoAnchorRegistry} mount/unmount
  * - {@link fiberScanRoot} mount/unmount
  * - screen-change notifications
  * - a slow interval that only runs while at least one listener is subscribed
@@ -13,6 +14,7 @@ declare class AnchorChangeTicker {
     private readonly listeners;
     private intervalHandle;
     private unsubRegistry;
+    private unsubAuto;
     private unsubScan;
     /** Poll interval while ELEMENT conditions are tracked (ms). */
     static readonly INTERVAL_MS = 1000;

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

@@ -1 +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"}
+{"version":3,"file":"anchorChangeTicker.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/anchorChangeTicker.ts"],"names":[],"mappings":"AAIA,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;;;;;;;;GAUG;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;IAC9C,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;IAeb,OAAO,CAAC,IAAI;IAmBZ,OAAO,CAAC,IAAI;CAKb;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

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

@@ -1,7 +1,7 @@
 import type { Ref } from 'react';
 import { type HintsInput } from './hintsCodec';
 /**
- * Runtime half of build-time auto-anchoring (see `@userflow-tech/babel-plugin`).
+ * Runtime half of build-time auto-anchoring (see `@userflow-tech/react-native/babel-plugin`).
  *
  * Each mount creates a distinct AutoAnchorRegistry instance. Shared templates
  * (design-system / list rows) register separately and are marked ambiguous

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

@@ -1,17 +1,21 @@
 import type { ConditionEvaluator } from '@userflow-tech/core';
 /**
- * Evaluate ELEMENT client conditions against manual anchors and fiber-resolved
- * `testID` / `nativeID` / `accessibilityLabel` targets.
+ * Evaluate ELEMENT client conditions against manual anchors, fiber-resolved
+ * `testID` / `nativeID` / `accessibilityLabel` targets, and AUTO (codeless)
+ * selectors.
  *
- * 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.
+ * Supports PRESENT / NOT_PRESENT for MANUAL selectors (`css` → anchor id) and
+ * AUTO selectors (`autoData` → {@link resolveAutoAnchorHost}). AUTO fails
+ * closed: `unknown` / `ambiguous` stay `null` so a gated flow never starts
+ * just because the auto-anchor registry is empty. Web-interaction states
+ * (CLICK, DISABLED, …) still report unknown.
  *
- * "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.
+ * "Present" means a unique host on a **visible** navigator screen. MANUAL
+ * goes through `resolveAnchorHost`; AUTO through `resolveAutoAnchorHost`.
+ * Both skip 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

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

@@ -1 +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"}
+{"version":3,"file":"elementConditionEvaluator.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/elementConditionEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAW9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAK1B,GACA,kBAAkB,CAkBpB"}

package/lib/typescript/module/src/anchors/fiber/FiberScanRoot.d.ts

@@ -1,23 +1,5 @@
 import * as React from 'react';
-import { type AnyFiber } from './fiberInternals';
-type Listener = () => void;
-/**
- * Module singleton holding the fiber under which testID / nativeID /
- * accessibilityLabel scans run. Seeded by {@link FiberScanRoot}.
- */
-declare class FiberScanRootStore {
-    private instance;
-    private readonly listeners;
-    set(instance: unknown): void;
-    clear(): void;
-    /** Current (resolved) fiber under the scan root, or null when unmounted. */
-    getFiber(): AnyFiber | null;
-    subscribe(listener: Listener): () => void;
-    /** Test helper. */
-    resetForTests(): void;
-    private emit;
-}
-export declare const fiberScanRoot: FiberScanRootStore;
+export { fiberScanRoot } from './FiberScanRootStore';
 export interface FiberScanRootProps {
     children: React.ReactNode;
 }
@@ -37,5 +19,4 @@ export declare class FiberScanRoot extends React.Component<FiberScanRootProps> {
     componentWillUnmount(): void;
     render(): React.ReactElement;
 }
-export {};
 //# sourceMappingURL=FiberScanRoot.d.ts.map

package/lib/typescript/module/src/anchors/fiber/FiberScanRoot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FiberScanRoot.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/FiberScanRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,KAAK,QAAQ,EAAgD,MAAM,kBAAkB,CAAC;AAE/F,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;GAGG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK5B,KAAK,IAAI,IAAI;IAKb,4EAA4E;IAC5E,QAAQ,IAAI,QAAQ,GAAG,IAAI;IAO3B,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,mBAAmB;IACnB,aAAa,IAAI,IAAI;IAKrB,OAAO,CAAC,IAAI;CAKb;AAED,eAAO,MAAM,aAAa,oBAA2B,CAAC;AAEtD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC;IAC3D,iBAAiB,IAAI,IAAI;IAIzB,kBAAkB,IAAI,IAAI;IAM1B,oBAAoB,IAAI,IAAI;IAI5B,MAAM,IAAI,KAAK,CAAC,YAAY;CAOtC"}
+{"version":3,"file":"FiberScanRoot.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/FiberScanRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,KAAK,CAAC,SAAS,CAAC,kBAAkB,CAAC;IAC3D,iBAAiB,IAAI,IAAI;IAIzB,kBAAkB,IAAI,IAAI;IAM1B,oBAAoB,IAAI,IAAI;IAI5B,MAAM,IAAI,KAAK,CAAC,YAAY;CAOtC"}

package/lib/typescript/module/src/anchors/fiber/FiberScanRootStore.d.ts

@@ -0,0 +1,21 @@
+import { type AnyFiber } from './fiberInternals';
+type Listener = () => void;
+/**
+ * Module singleton holding the fiber under which testID / nativeID /
+ * accessibilityLabel scans run. Seeded by {@link FiberScanRoot}.
+ */
+declare class FiberScanRootStore {
+    private instance;
+    private readonly listeners;
+    set(instance: unknown): void;
+    clear(): void;
+    /** Current (resolved) fiber under the scan root, or null when unmounted. */
+    getFiber(): AnyFiber | null;
+    subscribe(listener: Listener): () => void;
+    /** Test helper. */
+    resetForTests(): void;
+    private emit;
+}
+export declare const fiberScanRoot: FiberScanRootStore;
+export {};
+//# sourceMappingURL=FiberScanRootStore.d.ts.map

package/lib/typescript/module/src/anchors/fiber/FiberScanRootStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FiberScanRootStore.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/FiberScanRootStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAgD,MAAM,kBAAkB,CAAC;AAE/F,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;GAGG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK5B,KAAK,IAAI,IAAI;IAKb,4EAA4E;IAC5E,QAAQ,IAAI,QAAQ,GAAG,IAAI;IAO3B,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,mBAAmB;IACnB,aAAa,IAAI,IAAI;IAKrB,OAAO,CAAC,IAAI;CAKb;AAED,eAAO,MAAM,aAAa,oBAA2B,CAAC"}

package/lib/typescript/module/src/anchors/fiber/fiberInternals.d.ts

@@ -21,6 +21,43 @@ export declare function getSibling(fiber: AnyFiber): AnyFiber | null;
 export declare function getReturn(fiber: AnyFiber): AnyFiber | null;
 export declare function getAlternate(fiber: AnyFiber): AnyFiber | null;
 export declare function getMemoizedProps(fiber: AnyFiber): Record<string, unknown> | undefined;
+/**
+ * True when `value` looks like a JS React fiber, and not a Fabric shadow node,
+ * `stateNode`, or public instance. Never throws.
+ *
+ * Fabric on current RN stores the real fiber on `__internalInstanceHandle`, so
+ * this normally passes on the first try. It exists so a renderer that stores
+ * something else there degrades to the native-tag lookup instead of silently
+ * walking a non-fiber object and reading nothing.
+ */
+export declare function isReactFiber(value: unknown): value is AnyFiber;
+/**
+ * If `value` is a fiber, return it. If it is a host `stateNode` that carries a
+ * fiber (Fabric `{ node, canonical: { internalInstanceHandle } }`, or the older
+ * `canonical._internalInstanceHandle`), unwrap to the fiber.
+ */
+export declare function coerceToFiber(value: unknown): AnyFiber | null;
+/**
+ * Native view tag on a public instance or host `stateNode`, across renderers:
+ *
+ * - `__nativeTag` — Fabric `ReactNativeElement` (RN 0.74+)
+ * - `_nativeTag` — Paper `ReactNativeFiberHostComponent`, older Fabric canonical
+ * - `canonical.nativeTag` / `canonical._nativeTag` — Fabric `stateNode`
+ */
+export declare function nativeTagFromNode(value: unknown): number | undefined;
+export declare function nativeTagFromHostFiber(fiber: AnyFiber): number | undefined;
+/**
+ * Public host instance for a host fiber, if one exists. Covers, in order:
+ * materialized Fabric `canonical.publicInstance`, the older Fabric
+ * `canonical` host component, and the Paper `stateNode` itself (which *is*
+ * the object an app `ref` receives).
+ */
+export declare function publicInstanceFromHostFiber(fiber: AnyFiber): object | null;
+/**
+ * Host props for content reads. Prefers `memoizedProps`; Fabric also keeps the
+ * last committed props on `stateNode.canonical.currentProps`.
+ */
+export declare function getLiveHostProps(fiber: AnyFiber): Record<string, unknown> | undefined;
 export declare function getStateNode(fiber: AnyFiber): unknown;
 export declare function getFiberTag(fiber: AnyFiber): number | undefined;
 /** Native component name for a host fiber (e.g. `RNSScreen`), else undefined. */
@@ -31,7 +68,11 @@ export declare function getHostTypeName(fiber: AnyFiber): string | undefined;
  * have `tag === 5` without native keys).
  */
 export declare function isHostFiber(fiber: AnyFiber): boolean;
-/** Resolve a fiber from a class or host public instance. Returns null when unavailable. */
+/**
+ * Resolve a fiber from a class or host public instance. Returns null when
+ * unavailable, and also when the stored handle is a Fabric shadow node rather
+ * than a JS fiber (callers then look up by native tag under FiberScanRoot).
+ */
 export declare function fiberFromPublicInstance(instance: unknown): AnyFiber | null;
 /**
  * Pick the "current" tree fiber between `fiber` and its alternate by walking

package/lib/typescript/module/src/anchors/fiber/fiberInternals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fiberInternals.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/fiberInternals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAQ3B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAaxC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAEzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAE3D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAE1D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAG/D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAiBpD;AAaD,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAa1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAuB7D;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CASvD"}
+{"version":3,"file":"fiberInternals.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/fiberInternals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC;AAQ3B;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAaxC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAEzD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAE3D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAE1D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrF;AAkCD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAY9D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAkB7D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBpE;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAE1E;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAuB1E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAWrF;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAG/D;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAiBpD;AAaD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAe1E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAuB7D;AAWD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CASvD"}

package/lib/typescript/module/src/anchors/fiber/indexHostFibers.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Reverse index: public instance / native tag → host fiber.
+ *
+ * Renderers disagree on whether a host ref can reach its fiber at all:
+ *
+ * - Fabric (RN 0.74+) stores the fiber on `__internalInstanceHandle`, and
+ *   older Fabric on `_internalInstanceHandle` — the direct pointer works.
+ * - Paper **release** builds null out `_internalFiberInstanceHandleDEV`, so a
+ *   host ref has no route to its fiber at all.
+ *
+ * The index closes that gap: `FiberScanRoot` is a class component, and
+ * `_reactInternals` is present on class instances in every renderer and build
+ * type, so we can always walk down from there and match on native tag or
+ * instance identity. This is the version-independent path; the direct pointer
+ * is the fast path.
+ */
+import { type AnyFiber } from './fiberInternals';
+export interface HostFiberIndex {
+    byNativeTag: Map<number, AnyFiber>;
+    byInstance: WeakMap<object, AnyFiber>;
+}
+export declare function emptyHostFiberIndex(): HostFiberIndex;
+/**
+ * Walk `root`'s descendants (not `root.sibling`, so the Userflow overlay stays
+ * out of the index). First host fiber per native tag wins.
+ */
+export declare function createHostFiberIndex(root: AnyFiber | null | undefined): HostFiberIndex;
+export declare function indexLiveHostFibers(): HostFiberIndex;
+/** An index, or a thunk that builds one on first use. */
+export type HostFiberIndexSource = HostFiberIndex | (() => HostFiberIndex);
+/**
+ * Defers the tree walk until something actually misses the direct pointer, and
+ * reuses the result for the rest of the pass. On renderers where refs reach
+ * their fiber (Fabric, Paper DEV) the walk never happens.
+ */
+export declare function createLazyHostFiberIndex(build?: () => HostFiberIndex): () => HostFiberIndex;
+/**
+ * Fiber for a public instance: direct pointer first, then the scan-root index
+ * by identity / native tag.
+ */
+export declare function lookupHostFiber(index: HostFiberIndexSource, instance: unknown): AnyFiber | null;
+//# sourceMappingURL=indexHostFibers.d.ts.map

package/lib/typescript/module/src/anchors/fiber/indexHostFibers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexHostFibers.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/indexHostFibers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EACL,KAAK,QAAQ,EASd,MAAM,kBAAkB,CAAC;AAK1B,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnC,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACvC;AAED,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,CAmCtF;AAED,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAED,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,CAAC,MAAM,cAAc,CAAC,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,GAAE,MAAM,cAAoC,GAChD,MAAM,cAAc,CAYtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,IAAI,CAoB/F"}

package/lib/typescript/module/src/anchors/fiber/readHostContent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Live host-content reads from a public instance's fiber. Used at AUTO capture
+ * and match time so dynamic `{label}` / `{t(...)}` / `placeholder={…}` show up
+ * as `childText` even though Babel only stamps static literals.
+ *
+ * Same never-throws contract as the rest of the fiber layer.
+ */
+import { type AnyFiber } from './fiberInternals';
+/**
+ * First visible text under `fiber`, bounded by depth and node count. Reads a
+ * string/number `children` prop, the joined fragments of a split label, a
+ * native `text` prop, or the string a HostText fiber holds as its props.
+ */
+export declare function readHostText(fiber: AnyFiber, maxDepth?: number): string | undefined;
+/** `placeholder` on this fiber (TextInput). Does not walk descendants. */
+export declare function readHostPlaceholder(fiber: AnyFiber): string | undefined;
+//# sourceMappingURL=readHostContent.d.ts.map

package/lib/typescript/module/src/anchors/fiber/readHostContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readHostContent.d.ts","sourceRoot":"","sources":["../../../../../../src/anchors/fiber/readHostContent.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,QAAQ,EAOd,MAAM,kBAAkB,CAAC;AAmE1B;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,SAAoB,GAAG,MAAM,GAAG,SAAS,CAO9F;AA0CD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAOvE"}

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

@@ -0,0 +1,20 @@
+import type { AnyFiber } from './fiber/fiberInternals';
+interface FiberCacheEntry {
+    fiber: AnyFiber;
+    screenKey: string | null;
+}
+export declare function getFiberAnchorScreenKey(): string | null;
+/** Invalidate fiber-resolved anchors when the active screen changes. */
+export declare function notifyAnchorScreenChange(screenKey: string | null): void;
+/** Drop the fiber cache (preview restart / tests). */
+export declare function clearFiberAnchorCache(): void;
+export declare function getCachedFiberAnchor(id: string): FiberCacheEntry | undefined;
+export declare function setCachedFiberAnchor(id: string, fiber: AnyFiber): void;
+export declare function deleteCachedFiberAnchor(id: string): void;
+/**
+ * Drop a cached fiber entry after a zero-size measure so the next resolve
+ * re-scans (the host may have remounted under a new fiber).
+ */
+export declare function invalidateFiberAnchor(id: string): void;
+export {};
+//# sourceMappingURL=fiberAnchorCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fiberAnchorCache.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/fiberAnchorCache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,UAAU,eAAe;IACvB,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAKD,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIvE;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE5E;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEtE;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAExD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtD"}

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

@@ -1,7 +1,7 @@
 import type { SemanticSegment } from '@userflow-tech/protocol';
 import { type BuildTimeHints } from './AutoAnchorRegistry';
 /**
- * Compact build-time hints wire format (v1) emitted by `@userflow-tech/babel-plugin`.
+ * Compact build-time hints wire format (v1) emitted by `@userflow-tech/react-native/babel-plugin`.
  * Expanded once at register time so the auto-anchor registry still sees full paths.
  */
 export declare const COMPACT_HINTS_VERSION: 1;

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

@@ -13,6 +13,11 @@ export type AnchorResolution = {
 export declare function notifyAnchorScreenChange(screenKey: string | null): void;
 /** Test helper — drop the fiber cache. */
 export declare function clearFiberAnchorCache(): void;
+/**
+ * Drop a cached fiber entry after a zero-size measure so the next resolve
+ * re-scans (the host may have remounted under a new fiber).
+ */
+export declare function invalidateFiberAnchor(id: string): void;
 /**
  * Resolve a MANUAL anchor id to a measurable host.
  *
@@ -24,9 +29,4 @@ export declare function clearFiberAnchorCache(): void;
  * host). Caches the resolved fiber per id and revalidates cheaply before reuse.
  */
 export declare function resolveAnchorHost(id: string): AnchorResolution;
-/**
- * Drop a cached fiber entry after a zero-size measure so the next resolve
- * re-scans (the host may have remounted under a new fiber).
- */
-export declare function invalidateFiberAnchor(id: string): void;
 //# sourceMappingURL=resolveAnchorHost.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resolveAnchorHost.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/resolveAnchorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMvD,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAU1B,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAIvE;AAED,0CAA0C;AAC1C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAkD9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtD"}
+{"version":3,"file":"resolveAnchorHost.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/resolveAnchorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAkB,MAAM,kBAAkB,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAevD,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,QAAQ,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B,wEAAwE;AACxE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEvE;AAED,0CAA0C;AAC1C,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAmD9D"}

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

@@ -0,0 +1,38 @@
+import { type MobileAutoData } from '@userflow-tech/protocol';
+import type { AnchorHost } from './AnchorRegistry';
+import type { AnyFiber } from './fiber/fiberInternals';
+import { type MatchResult } from './semanticMatcher';
+export type AutoAnchorResolution = {
+    status: 'found';
+    host: AnchorHost;
+    fiber?: AnyFiber;
+    /**
+     * Id to pass to `invalidateFiberAnchor` after a zero-size measure.
+     * Set on the exact-id fast path, where the host came from the fiber cache.
+     */
+    fiberCacheId?: string;
+    match?: MatchResult;
+} | {
+    status: 'ambiguous';
+    match?: MatchResult;
+} | {
+    status: 'absent';
+    match?: MatchResult;
+} | {
+    status: 'unknown';
+    match?: MatchResult;
+};
+/**
+ * Resolve an AUTO (codeless) selector against the live UI.
+ *
+ * Exact-id fast path reuses {@link resolveAnchorHost} so a fingerprint that
+ * carries a real `testID` / `userflowId` / non-`uf_` `nativeID` still resolves
+ * under Babel `stampOnly: true` (no auto-registry population).
+ *
+ * Scored matches run over `autoAnchorRegistry` and fail closed: weak or
+ * non-unique evidence is `unknown`, not `absent`, so ELEMENT gates stay blocked
+ * rather than inventing a truth value. Hosts on a covered navigator screen
+ * are skipped the same way the fiber scan skips them.
+ */
+export declare function resolveAutoAnchorHost(autoData: string | MobileAutoData | null | undefined): AutoAnchorResolution;
+//# sourceMappingURL=resolveAutoAnchorHost.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveAutoAnchorHost.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/resolveAutoAnchorHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAKvD,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,MAAM,oBAAoB,GAC5B;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GACD;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC;AAkH/C;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,GACnD,oBAAoB,CAsBtB"}

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

@@ -0,0 +1,48 @@
+import { type IdentityStrength, type MobileAutoData, type MobileFingerprint } from '@userflow-tech/protocol';
+import { type AutoAnchorInstance } from './AutoAnchorRegistry';
+/**
+ * Scored semantic matcher (rn-v3).
+ *
+ * Ranks live {@link autoAnchorRegistry} instances against a recorded
+ * fingerprint. Explicit IDs are authoritative. Absolute ordinals are not
+ * scored. Accepts only when the best score clears a threshold and beats the
+ * runner-up by a margin.
+ *
+ * Play-time AUTO resolution goes through `resolveAutoAnchorHost`, which
+ * maps a hit into a measurable host.
+ */
+export type MatchMissReason = 'no-candidates' | 'all-contradicted' | 'below-threshold' | 'not-unique' | 'ambiguous-explicit-id' | 'no-fingerprint';
+export interface MatchResult {
+    instance: AutoAnchorInstance | null;
+    score: number;
+    secondScore: number;
+    reason?: MatchMissReason;
+    /** Strongest signal the recorded fingerprint rests on (telemetry / author guidance). */
+    identityStrength?: IdentityStrength;
+    /**
+     * True when the match was won even though the live text is not byte-identical
+     * to the recorded `childText`. Covers both a benign counter tick
+     * (`Count: 0` → `Count: 1`, which normalization forgives) and a real rename
+     * that an icon/shape/structure vouched for. Raw inequality, not the fatal
+     * check — a fatal mismatch never reaches a won match.
+     */
+    textDisagreed?: boolean;
+}
+export declare const MATCH_MIN_SCORE = 40;
+export declare const MATCH_UNIQUENESS_MARGIN = 12;
+type InstanceFilter = (inst: AutoAnchorInstance) => boolean;
+/**
+ * Resolve a recorded fingerprint against the live auto-anchor registry.
+ * Surfaces the recorded `identityStrength` on every result so callers/telemetry
+ * can flag weak (`structural`) targets.
+ */
+export declare function matchFingerprint(fp: MobileFingerprint, opts?: {
+    instanceFilter?: InstanceFilter;
+}): MatchResult;
+/**
+ * Decode an `autoData` envelope (or accept an already-decoded one) and score
+ * its fingerprint. Missing / malformed envelopes fail closed.
+ */
+export declare function matchAutoData(input: MobileAutoData | string): MatchResult;
+export {};
+//# sourceMappingURL=semanticMatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semanticMatcher.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/semanticMatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EAGvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnF;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,kBAAkB,GAClB,iBAAiB,GACjB,YAAY,GACZ,uBAAuB,GACvB,gBAAgB,CAAC;AAErB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AA+L1C,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC;AAgG5D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,iBAAiB,EACrB,IAAI,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE,GACzC,WAAW,CAIb;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,WAAW,CAMzE"}

package/lib/typescript/module/src/authoring/ElementPickerOverlay.d.ts

@@ -0,0 +1,7 @@
+import * as React from 'react';
+/**
+ * Overlay chrome for in-app element picking. Mounted by UserflowProvider;
+ * renders nothing until {@link elementPickerController.beginSelection}.
+ */
+export declare function ElementPickerOverlay(): React.ReactElement | null;
+//# sourceMappingURL=ElementPickerOverlay.d.ts.map

package/lib/typescript/module/src/authoring/ElementPickerOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElementPickerOverlay.d.ts","sourceRoot":"","sources":["../../../../../src/authoring/ElementPickerOverlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAmE/B;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC,YAAY,GAAG,IAAI,CAgchE"}

package/lib/typescript/module/src/authoring/capturePickerScreenshot.d.ts

@@ -0,0 +1,11 @@
+import type { ElementPickerScreenshot } from './elementPickerController';
+import type { HitRect } from './hitTest';
+/**
+ * Capture a downscaled JPEG of the current screen and map `rect` (window DIP)
+ * onto the captured pixel grid. Returns null when the native module is missing
+ * or capture fails.
+ */
+export declare function capturePickerScreenshot(rect: HitRect): Promise<ElementPickerScreenshot | null>;
+/** @internal */
+export declare function resetViewShotWarningForTests(): void;
+//# sourceMappingURL=capturePickerScreenshot.d.ts.map