@active-reach/web-sdk 1.41.0 → 1.43.0

package/dist/triggers/IntentRuleEvaluator.d.ts

@@ -1,213 +0,0 @@
-/**
- * Micro-Intent Engine — compound rule evaluator (P1 Task 4).
- *
- * Pure, side-effect-free evaluation of an IntentRule predicate tree against
- * a current snapshot of Layer-1 (identity) + Layer-2 (session) signal values.
- *
- * Why a separate class from TriggerEngine
- * ----------------------------------------
- * TriggerEngine.ts owns signal CAPTURE (scroll, time-on-page, exit-intent,
- * etc.) and emits named events like `scroll_depth_50`. IntentRuleEvaluator
- * owns rule EVALUATION — given a compound predicate and the current state
- * of all known signals, return whether the rule fires now. The two
- * concerns separate cleanly: capture is global per-page (one engine
- * instance), evaluation is per-rule (the manager re-runs every armed
- * rule when a `fire_on` signal fires).
- *
- * Type strategy
- * -------------
- * Types are declared LOCALLY in this file rather than imported from
- * `@aegis/shared-types`. The SDK is published standalone on npm and
- * cannot pull in workspace packages at runtime. A drift-check test
- * (`libs/web-sdk/tests/intent-evaluator-shared-types-drift.test.ts`)
- * parses both files and asserts the local types and the canonical
- * `libs/shared-types/src/intent.ts` declare the same set of signal /
- * comparator values.
- *
- * Plan reference: docs/architecture/MICRO_INTENT_ENGINE.md §"Schemas"
- */
-export type IntentSignal = 'scroll_depth' | 'time_on_page' | 'exit_intent' | 'back_button' | 'scroll_velocity' | 'inactivity' | 'visibility_change' | 'rage_click' | 'price_hover_ms' | 'cta_hover_ms' | 'cum_dwell_sku' | 'session_count_sku' | 'cart_value' | 'converted_in_session' | 'rfm_segment' | 'rfm_score' | 'lifecycle_stage' | 'churn_risk_tier' | 'predicted_ltv' | 'predicted_ltv_tier' | 'uninstall_risk_tier' | 'engagement_level' | 'price_tier' | 'price_sensitivity_score' | 'top_category' | 'avg_cart_value' | 'scoring_tier';
-export type Comparator = 'gte' | 'lte' | 'gt' | 'lt' | 'eq' | 'neq' | 'in' | 'nin';
-export type IntentLeafValue = number | string | boolean | ReadonlyArray<number | string | boolean>;
-export interface IntentLeaf {
-    /** Canonical enum signal (Layer-1/2). Mutually exclusive with `path`. */
-    signal?: IntentSignal;
-    /** Dot-path into the updateContext namespaces (cart.total / user.tier /
-     *  session.idle_s). Mutually exclusive with `signal`. */
-    path?: string;
-    op: Comparator;
-    value: IntentLeafValue;
-}
-/** A value/node in the generic reactive context (fed via updateContext). */
-export type ContextValue = string | number | boolean | null | ContextNode | ReadonlyArray<ContextValue>;
-export interface ContextNode {
-    [key: string]: ContextValue;
-}
-/** Named namespaces: { cart: {...}, user: {...}, session: {...}, custom: {...} }. */
-export type ContextNamespaces = Record<string, ContextNode>;
-export interface IntentNode {
-    op: 'AND' | 'OR' | 'NOT';
-    operands: ReadonlyArray<IntentExpr>;
-}
-export type IntentExpr = IntentNode | IntentLeaf;
-export interface IntentRule {
-    fire_on: ReadonlyArray<IntentSignal>;
-    when: IntentExpr;
-    priority: number;
-    suppress_competing: boolean;
-}
-/** A scalar a signal can hold in the snapshot. null = signal not (yet)
- *  populated — happens for Layer-1 scores on anonymous sessions and for
- *  Layer-2 signals before the user triggers them. */
-export type SignalValue = number | string | boolean | null;
-/** Current state of every known signal. Missing keys are treated the
- *  same as `null`. */
-export type IntentSnapshot = Partial<Record<IntentSignal, SignalValue>>;
-export declare function isIntentLeaf(expr: IntentExpr): expr is IntentLeaf;
-/** Resolve a dot-path (`cart.total`) against the context namespaces.
- *  Returns undefined on any miss → tri-state null in evaluateLeaf (same as a
- *  missing signal). Never throws. */
-export declare function getValueByPath(namespaces: ContextNamespaces | undefined, path: string): ContextValue | undefined;
-export declare function isIntentNode(expr: IntentExpr): expr is IntentNode;
-/**
- * Evaluate a single leaf comparison against a snapshot.
- *
- * Missing-signal semantics (per the plan's "Graceful degradation rules"):
- *   - The CALLER (evaluateExpr) decides AND/OR semantics on missing
- *     operands; this function answers strictly for THIS leaf.
- *   - When the signal is missing from the snapshot, the leaf is
- *     "unknown" → return null so the parent node can interpret it.
- *
- * Comparator semantics:
- *   - gte/lte/gt/lt: numeric only; comparing strings/bools returns false.
- *   - eq/neq: any type; strict equality.
- *   - in/nin: leaf value must be a list; membership test on the snapshot
- *     value. `nin` returns true for missing snapshot values (the
- *     contact's RFM segment is "not in" the forbidden list if we don't
- *     know it yet — conservative).
- */
-export declare function evaluateLeaf(leaf: IntentLeaf, snapshot: IntentSnapshot, namespaces?: ContextNamespaces): boolean | null;
-/**
- * Evaluate the full predicate tree.
- *
- * AND/OR/NOT semantics with missing-value handling (per plan §"Graceful
- * degradation rules"):
- *
- *   AND(a, b, c) where any operand is null → false (conservative; the
- *     rule doesn't fire when we can't prove all conditions).
- *   OR(a, b, c) where some operands are null → if any non-null operand
- *     is true, returns true. If all operands are null OR all are
- *     false, returns false.
- *   NOT(a) where a is null → null (parent decides). When this propagates
- *     to the top-level evaluateExpr, the rule does NOT fire.
- *
- * The "AND treats missing as unmet" + "OR treats missing as inert" rule
- * from the plan maps exactly onto this implementation: AND short-circuits
- * to false on any null operand; OR ignores nulls and looks at the rest.
- *
- * Top-level: a null result from the root expression means the rule
- * cannot be evaluated yet — do NOT fire.
- */
-export declare function evaluateExpr(expr: IntentExpr, snapshot: IntentSnapshot, namespaces?: ContextNamespaces): boolean | null;
-/** Top-level "does the rule fire right now?" check. Treats a null
- *  evaluation result as "do not fire" (we can't prove the rule's
- *  conditions are met). */
-export declare function evaluateRule(rule: IntentRule, snapshot: IntentSnapshot, namespaces?: ContextNamespaces): boolean;
-/** A campaign carrying a compound rule, in the SDK's runtime shape.
- *  Mirrors the cell-plane payload at /v1/in-app/active when
- *  client_trigger.type === 'micro_intent'. */
-export interface ArmedCampaign {
-    id: string;
-    rule: IntentRule;
-}
-/** The decision the evaluator returns when a signal fires.
- *
- *  fire        : caller should display this campaign now.
- *  suppress    : caller should silence the listed competing campaign IDs
- *                for the rest of the session (the bouncing-researcher
- *                pattern — a rule whose only job is to silence others).
- *  none        : no rule matched, do nothing.
- */
-export interface EvaluationDecision {
-    kind: 'fire' | 'suppress' | 'none';
-    campaignId?: string;
-    suppressIds?: ReadonlyArray<string>;
-}
-export declare class IntentRuleEvaluator {
-    /** All campaigns currently armed on this page. Caller (the
-     *  AegisInAppManager) replaces this on every refresh. */
-    private armed;
-    /** Latest signal values. Caller pushes updates via updateSignal /
-     *  updateSnapshot whenever TriggerEngine emits a state change or
-     *  contact-scores fetch completes. */
-    private snapshot;
-    /** Generic reactive context namespaces fed via updateContext() — the SINGLE
-     *  store path-leaves resolve against (no parallel state elsewhere). */
-    private namespaces;
-    /** Campaigns that have already fired this session — never re-fire. */
-    private firedThisSession;
-    /** Campaigns silenced by a prior `suppress_competing` win. The set
-     *  resets on session boundary (new tab / new pageview after timeout).
-     *  The AegisInAppManager owns durability semantics; this set is
-     *  in-memory only. */
-    private silencedThisSession;
-    /** ONE interruptive overlay per session. Once an interruption actually fires
-     *  (signalled via markFired), further fires are blocked until reset().
-     *  OPT-IN (default off) so the evaluator's base contract is unchanged for
-     *  existing consumers (mobile, etc.); the storefront runtime turns it ON via
-     *  setGovernance() for the ACS "rich, not overwhelming" posture. */
-    private oneInterruptionPerSession;
-    private interruptiveBudgetSpent;
-    /** TTFI floor — never fire an overlay in the first `ttfiMs` of the session
-     *  ("no overlay at second 0"). Exit/leave signals are exempt. OPT-IN (default
-     *  0 = off); the storefront enables a ~4s floor via setGovernance(). */
-    private ttfiMs;
-    private sessionStartMs;
-    /** Injectable clock for deterministic tests. */
-    private nowFn;
-    private static readonly EXIT_SIGNALS;
-    /** Tune governance. `now` also (re)bases the TTFI session clock. */
-    setGovernance(opts: {
-        oneInterruptionPerSession?: boolean;
-        ttfiMs?: number;
-        now?: () => number;
-    }): void;
-    updateSignal(signal: IntentSignal, value: SignalValue): void;
-    updateSnapshot(partial: IntentSnapshot): void;
-    getSnapshot(): Readonly<IntentSnapshot>;
-    /** Merge a namespace's data (shallow). Path-leaves (`cart.total`) resolve
-     *  against this. The runtime's updateContext() delegates here so there is ONE
-     *  context store, then bridges well-known paths to enum signals. */
-    updateContext(namespace: string, data: ContextNode): void;
-    getNamespaces(): Readonly<ContextNamespaces>;
-    /** Resolve a dot-path against the live context (for previews / debugging). */
-    getValueByPath(path: string): ContextValue | undefined;
-    setArmed(campaigns: ArmedCampaign[]): void;
-    getArmed(): ReadonlyArray<ArmedCampaign>;
-    markFired(campaignId: string): void;
-    /** Clear all per-session state. Caller invokes on logout or explicit
-     *  session reset. */
-    reset(): void;
-    /**
-     * Called every time a signal value changes meaningfully (e.g. a
-     * TriggerEngine `exit_intent` event, or a `scroll_depth_50` crossing
-     * threshold, or the Layer-1 fetch finishing). Returns the decision the
-     * caller should act on.
-     *
-     * Algorithm:
-     *   1. Filter armed campaigns to those whose `fire_on` includes the
-     *      signal that just changed.
-     *   2. Drop already-fired and silenced campaigns.
-     *   3. Sort the remainder by priority DESC, tie-broken by campaign id
-     *      lexicographic (per plan §"Pattern ordering rules").
-     *   4. Walk the sorted list:
-     *      - If a suppress_competing rule matches, emit a 'suppress'
-     *        decision listing every lower-priority armed campaign id.
-     *        Mark those as silenced internally too.
-     *      - Otherwise the first matching rule emits 'fire'.
-     *   5. If nothing matches, return 'none'.
-     */
-    onSignalChanged(signal: IntentSignal): EvaluationDecision;
-}
-export declare const MAX_RULE_DEPTH: 3;
-//# sourceMappingURL=IntentRuleEvaluator.d.ts.map

package/dist/triggers/IntentRuleEvaluator.d.ts.map

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

package/dist/triggers/IntentSnapshotCollector.d.ts

@@ -1,83 +0,0 @@
-/**
- * Micro-Intent Engine — pipeline integration (P2 Task 5).
- *
- * Wires the three signal-capture surfaces (SelectorBinder, TriggerEngine,
- * IntentLedger) together and projects their current state onto the
- * IntentRuleEvaluator's `IntentSnapshot`. The collector is the single
- * place every Layer-2 signal flows through on its way into rule
- * evaluation — adding a new signal means touching exactly one file.
- *
- * Wiring summary
- * --------------
- *   SelectorBinder.hover_start  →  TriggerEngine.noteHoverStart
- *                               →  evaluator.updateSignal(price/cta_hover_ms, 0)
- *   SelectorBinder.hover_end    →  TriggerEngine.noteHoverEnd
- *                               →  evaluator.updateSignal(price/cta_hover_ms, getHoverMs)
- *   SelectorBinder.click        →  TriggerEngine.noteClick
- *                               →  evaluator.updateSignal(rage_click, getRageClickCount)
- *   SelectorBinder.sku_change   →  IntentLedger.noteSession
- *                               →  evaluator.updateSignal(cum_dwell_sku, session_count_sku)
- *
- *   window.mousemove (≤100ms)   →  TriggerEngine.noteMousePosition
- *                               →  evaluator.updateSignal(mouse_velocity_to_top)
- *
- *   pagehide / beforeunload     →  ledger.flush()
- *
- * Why a separate class instead of putting this in AegisInAppManager:
- * the manager already owns delivery + display rules + suppression.
- * Adding "snapshot wrangling" on top would make it the SDK's
- * everything-shaped object. The collector keeps signal flow isolated
- * and unit-testable without spinning up the full manager.
- *
- * The collector is signal-name-agnostic in its core flow — the only
- * place IntentSignal names appear is the `signalForIntent()` helper
- * that maps the `price` intent to the `price_hover_ms` signal etc.
- * If we add a new intent (e.g. `coupon_hover_ms`) the helper grows;
- * everything else is reused.
- */
-import type { SelectorBinder } from './SelectorBinder';
-import type { IntentRuleEvaluator, IntentSignal, EvaluationDecision } from './IntentRuleEvaluator';
-import type { IntentLedger } from '../state/intent_ledger';
-import { TriggerEngine } from './TriggerEngine';
-export interface IntentSnapshotCollectorConfig {
-    triggerEngine: TriggerEngine;
-    selectorBinder: SelectorBinder;
-    intentRuleEvaluator: IntentRuleEvaluator;
-    intentLedger?: IntentLedger;
-    /** Throttle floor for mousemove sampling, in ms. Plan default = 100. */
-    mouseSampleMs?: number;
-    /** Forwarded decisions from `evaluator.onSignalChanged` — the
-     *  AegisInAppManager subscribes here to drive the actual campaign
-     *  display / suppress side-effects. */
-    onDecision?: (decision: EvaluationDecision) => void;
-}
-export declare class IntentSnapshotCollector {
-    private readonly triggerEngine;
-    private readonly selectorBinder;
-    private readonly evaluator;
-    private readonly ledger;
-    private readonly mouseSampleMs;
-    private onDecision?;
-    private started;
-    private unsubscribeBinder?;
-    private lastMouseSampleAt;
-    private mouseMoveHandler?;
-    private flushHandler?;
-    constructor(cfg: IntentSnapshotCollectorConfig);
-    start(): void;
-    stop(): void;
-    /** Override the decision callback after construction — used by the
-     *  AegisInAppManager when it lazily wires up. */
-    setDecisionHandler(handler: (d: EvaluationDecision) => void): void;
-    /**
-     * Caller signals that a known trigger event happened (exit_intent,
-     * back_button, scroll_depth_50, etc.). The collector forwards to the
-     * evaluator and pushes any resulting decision through `onDecision`.
-     *
-     * The signal-name here must be a real IntentSignal — anything else is
-     * silently ignored (no-throw, the SDK can't crash a host page).
-     */
-    notifyTrigger(signal: IntentSignal): void;
-    private handleBinderEvent;
-}
-//# sourceMappingURL=IntentSnapshotCollector.d.ts.map

package/dist/triggers/IntentSnapshotCollector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"IntentSnapshotCollector.d.ts","sourceRoot":"","sources":["../../src/triggers/IntentSnapshotCollector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAGV,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQhD,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;2CAEuC;IACvC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACrD;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,UAAU,CAAC,CAAkC;IAErD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAA0B;IACnD,OAAO,CAAC,YAAY,CAAC,CAAa;gBAEtB,GAAG,EAAE,6BAA6B;IAe9C,KAAK,IAAI,IAAI;IAyCb,IAAI,IAAI,IAAI;IAkBZ;qDACiD;IACjD,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAMlE;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAOzC,OAAO,CAAC,iBAAiB;CA6C1B"}

package/dist/triggers/SelectorBinder.d.ts

@@ -1,118 +0,0 @@
-/**
- * Micro-Intent Engine — delegated event listeners (P1 Task 5, robustness #1).
- *
- * The problem
- * -----------
- * Static `document.querySelector('.price').addEventListener(...)` on SDK
- * init detaches the moment Shopify themes, React/Next.js storefronts, or
- * any SPA re-renders the price node. Element-scoped signals
- * (price_hover_ms, cta_hover_ms, rage-click-on-coupon) then fail
- * silently — the worst possible failure mode because nothing logs.
- *
- * The fix
- * -------
- * Bind ONCE to `document.body` (capture phase) and dispatch via
- * `event.target.closest(selector)`. The handler runs globally; the
- * configured intent selectors are evaluated per-event. Survives any
- * framework re-render — there's never a stale reference because we
- * never held one.
- *
- *   document.body.addEventListener('mouseenter', this.handleHover, true);
- *   document.body.addEventListener('mouseleave', this.handleHover, true);
- *   document.body.addEventListener('pointerdown', this.handleClick, true);
- *
- * Plus a `MutationObserver` that watches for changes to the configured
- * SKU selector so a SPA navigating between PDPs without a full page
- * load still updates the engine's `cum_dwell_sku` / `session_count_sku`
- * context. The observer is NOT used to re-attach event listeners
- * (delegation makes that unnecessary).
- *
- * What this file does NOT do
- * --------------------------
- * Compute `price_hover_ms` / `cta_hover_ms` dwell totals, or count
- * rage-clicks. That arithmetic lives in TriggerEngine.ts (P2 Tasks
- * 1-3) which subscribes to this binder via `onIntent(handler)` and
- * accumulates into snapshot values. SelectorBinder is the I/O layer;
- * the timing logic is downstream.
- *
- * Plan reference: docs/architecture/MICRO_INTENT_ENGINE.md §"Robustness
- * 1 — DOM brittleness".
- */
-/** Named element role the storefront marks. The selector config maps
- *  each name to one or more CSS selectors; on every match, the binder
- *  emits an IntentDomEvent with this name as `intent`. */
-export type IntentElementName = 'price' | 'cta' | 'coupon' | 'checkout' | 'sku';
-/** Event types the binder forwards. Keep narrow on purpose — every
- *  type carried downstream is a real signal someone derives from. */
-export type IntentDomEventType = 'hover_start' | 'hover_end' | 'click' | 'sku_change';
-export interface IntentDomEvent {
-    type: IntentDomEventType;
-    intent: IntentElementName;
-    /** Best-effort: the matched element. Consumers shouldn't hold strong
-     *  references — the SPA may unmount it before the next event fires. */
-    target: Element | null;
-    /** For `sku_change`: the new SKU id (read from `data-aegis-sku` or the
-     *  matched element's `data-product-id` / `data-sku` attribute). For
-     *  other events: undefined. */
-    sku?: string;
-    timestamp: number;
-}
-export type IntentDomHandler = (evt: IntentDomEvent) => void;
-/** Map from intent name to a list of CSS selectors that mark elements
- *  playing that role on the storefront. Multiple selectors per intent
- *  so a single plugin config can cover all the themes / DOM variants
- *  it knows about. */
-export type IntentSelectors = Partial<Record<IntentElementName, ReadonlyArray<string>>>;
-export interface SelectorBinderConfig {
-    /** Caller-supplied selectors, highest priority. */
-    intentSelectors?: IntentSelectors;
-    /** Server-pushed selectors from /v1/sdk/config (dashboard-managed).
-     *  Falls behind explicit init but ahead of platform defaults. */
-    serverSelectors?: IntentSelectors;
-    /** Platform-default map bundled with the plugin (Shopify / Woo /
-     *  Magento). Lowest non-fallback priority. */
-    platformDefaults?: IntentSelectors;
-}
-export declare class SelectorBinder {
-    private readonly selectors;
-    private readonly listeners;
-    private observer;
-    private boundRoot;
-    private currentSku;
-    /** Element-keyed memory of which intent is currently hovered, so we
-     *  can fire `hover_end` even if the matched DOM node unmounts in
-     *  between (the unmount path is `hover_start` → unmount → no
-     *  `hover_end`; we rely on `mouseleave` capture which fires on the
-     *  original target before unmount in most browsers). */
-    private hoverActive;
-    constructor(config?: SelectorBinderConfig);
-    /** Subscribe to delegated DOM events. Returns an unsubscribe fn. */
-    onIntent(handler: IntentDomHandler): () => void;
-    /** Attach listeners + MutationObserver. Idempotent — calling twice
-     *  is a no-op so a manager that re-initializes doesn't double-bind. */
-    start(doc?: Document): void;
-    /** Detach listeners and observer. Idempotent. The manager calls this
-     *  on `destroy()`. */
-    stop(): void;
-    /** Snapshot of the currently-active SKU on the page. Used by
-     *  TriggerEngine to attribute hover/click events to a product context.
-     *  Undefined when the page has no SKU element or it's been unmounted. */
-    getCurrentSku(): string | undefined;
-    /** Current selector resolution — useful for tests + editor "preview"
-     *  to show which selectors would match. */
-    getResolvedSelectors(): Readonly<Required<IntentSelectors>>;
-    /** Find the intent name a given event target belongs to (if any).
-     *  Walks the configured selectors in order; first match wins. Returns
-     *  null if none match (the event is for unrelated DOM and should be
-     *  ignored). */
-    private matchIntent;
-    private emit;
-    private handleHoverStart;
-    private handleHoverEnd;
-    private handleClick;
-    private handleMutation;
-    /** Re-resolve the current SKU from the page. Emits `sku_change` if
-     *  the value differs from the prior snapshot. */
-    private refreshCurrentSku;
-}
-//# sourceMappingURL=SelectorBinder.d.ts.map

package/dist/triggers/SelectorBinder.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SelectorBinder.d.ts","sourceRoot":"","sources":["../../src/triggers/SelectorBinder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH;;0DAE0D;AAC1D,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AAEhF;qEACqE;AACrE,MAAM,MAAM,kBAAkB,GAC1B,aAAa,GACb,WAAW,GACX,OAAO,GACP,YAAY,CAAC;AAEjB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;IAC1B;2EACuE;IACvE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB;;mCAE+B;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;AAE7D;;;sBAGsB;AACtB,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAmDxF,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;qEACiE;IACjE,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC;kDAC8C;IAC9C,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4B;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,UAAU,CAAqB;IACvC;;;;4DAIwD;IACxD,OAAO,CAAC,WAAW,CAA6C;gBAEpD,MAAM,GAAE,oBAAyB;IAS7C,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAO/C;2EACuE;IACvE,KAAK,CAAC,GAAG,GAAE,QAAqF,GAAG,IAAI;IAgCvG;0BACsB;IACtB,IAAI,IAAI,IAAI;IAcZ;;6EAEyE;IACzE,aAAa,IAAI,MAAM,GAAG,SAAS;IAInC;+CAC2C;IAC3C,oBAAoB,IAAI,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAM3D;;;oBAGgB;IAChB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,IAAI;IAYZ,OAAO,CAAC,gBAAgB,CActB;IAEF,OAAO,CAAC,cAAc,CAapB;IAEF,OAAO,CAAC,WAAW,CAWjB;IAEF,OAAO,CAAC,cAAc,CAMpB;IAEF;qDACiD;IACjD,OAAO,CAAC,iBAAiB;CAyB1B"}