@syntrologie/runtime-sdk 2.4.0-canary.17 → 2.4.0-canary.19

package/dist/actions/schema.js

@@ -31,8 +31,8 @@ import {
   WaitZ,
   WidgetConfigZ,
   coreActionStepSchemas
-} from "../chunk-LZLDT5DA.js";
-import "../chunk-4NYS7GAW.js";
+} from "../chunk-LR5AA5SE.js";
+import "../chunk-P5G4KT2U.js";
 export {
   AddClassZ,
   AnchorIdZ,

package/dist/actions/types.d.ts

@@ -275,6 +275,11 @@ export interface ExecutorContext {
     publishEvent: (name: string, props?: Record<string, unknown>) => void;
     /** Get the current adaptive ID (if any) */
     adaptiveId?: string;
+    /**
+     * Async anchor resolver — waits for a DOM element to appear.
+     * Returns null on timeout or route mismatch (never throws).
+     */
+    waitForAnchor?: (anchorId: AnchorId, timeoutMs?: number) => Promise<HTMLElement | null>;
     /**
      * Execute a nested action (for composite executors like tours).
      * Returns a handle that can be used to revert the action.
@@ -317,6 +322,8 @@ export interface ActionEngineOptions {
     };
     /** Function to resolve anchor IDs to elements */
     anchorResolver: (anchorId: AnchorId) => HTMLElement | null;
+    /** Async anchor resolver — waits for a DOM element to appear */
+    waitForAnchor?: (anchorId: AnchorId, timeoutMs?: number) => Promise<HTMLElement | null>;
     /** Current adaptive ID for attribution */
     adaptiveId?: string;
     /** Optional executor registry (uses default singleton if not provided) */

package/dist/anchor/AnchorResolver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AnchorResolver — Centralized DOM observation for anchor element resolution.
+ *
+ * Provides a single MutationObserver that multiple callers share to wait for
+ * DOM elements to appear. Replaces scattered observation mechanisms.
+ */
+export interface AnchorResolverOptions {
+    root?: HTMLElement;
+    defaultTimeoutMs?: number;
+}
+export interface AnchorResolver {
+    resolve(selector: string): HTMLElement | null;
+    waitFor(selector: string, timeoutMs?: number): Promise<HTMLElement>;
+    onAppear(selector: string, cb: (el: HTMLElement) => void): () => void;
+    pendingCount(): number;
+    destroy(): void;
+}
+export declare function createAnchorResolver(opts?: AnchorResolverOptions): AnchorResolver;

package/dist/anchor/index.d.ts

@@ -0,0 +1,2 @@
+export type { AnchorResolver, AnchorResolverOptions } from './AnchorResolver';
+export { createAnchorResolver } from './AnchorResolver';

package/dist/{chunk-LZLDT5DA.js → chunk-LR5AA5SE.js}

@@ -1,7 +1,7 @@
 import {
   ActivationConfigZ,
   DecisionStrategyZ
-} from "./chunk-4NYS7GAW.js";
+} from "./chunk-P5G4KT2U.js";
 
 // src/actions/schema.ts
 import { z } from "zod";
@@ -247,4 +247,4 @@ export {
   TourZ,
   coreActionStepSchemas
 };
-//# sourceMappingURL=chunk-LZLDT5DA.js.map
+//# sourceMappingURL=chunk-LR5AA5SE.js.map