@userflow-tech/react-native 0.2.0 → 0.3.0

package/vendor/core/dist/engine/BannerSessionEngine.js

@@ -0,0 +1,236 @@
+import { handleActions } from './handleActions.js';
+/** Cap for in-memory client-message retry after transport failure. */
+const MAX_PENDING_SENDS = 20;
+function isValidBannerSession(session) {
+    if (session == null || typeof session !== 'object')
+        return false;
+    const candidate = session;
+    if (typeof candidate.id !== 'string' || candidate.id.length === 0)
+        return false;
+    if (candidate.flow == null || typeof candidate.flow.id !== 'string')
+        return false;
+    if (candidate.kind != null && candidate.kind !== 'banner')
+        return false;
+    const banner = candidate.version?.banner;
+    if (banner == null || typeof banner !== 'object')
+        return false;
+    if (typeof banner.embedMode !== 'string')
+        return false;
+    if (!Array.isArray(banner.buttons))
+        return false;
+    return true;
+}
+function normalize(session) {
+    return {
+        ...session,
+        kind: 'banner',
+        draftMode: session.draftMode === true,
+        data: Array.isArray(session.data) ? session.data : [],
+        version: {
+            ...session.version,
+            steps: Array.isArray(session.version.steps) ? session.version.steps : [],
+        },
+    };
+}
+/**
+ * One banner session, independent of the tour. Web banners have no session
+ * clock: a later Set replaces the current bar, and Unset clears only a
+ * matching id.
+ */
+export class BannerSessionEngine {
+    constructor(deps) {
+        this.listeners = new Set();
+        this.pendingSends = [];
+        this.session = null;
+        this.unsubscribe = null;
+        this.flushingPending = false;
+        this.transport = deps.transport;
+        this.flowActions = deps.flowActions;
+        this.onOpenExternalUrl = deps.onOpenExternalUrl;
+        this.onEvalJs = deps.onEvalJs;
+        this.updateUserImpl = deps.updateUser;
+        this.updateGroupImpl = deps.updateGroup;
+        this.warn = deps.warn ?? ((message) => console.warn(message));
+    }
+    attach() {
+        if (this.unsubscribe)
+            return;
+        this.unsubscribe = this.transport.onServerMessage((message) => {
+            this.handleServerMessage(message);
+        });
+    }
+    detach() {
+        this.unsubscribe?.();
+        this.unsubscribe = null;
+    }
+    on(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    getBannerSession() {
+        return this.session;
+    }
+    handleServerMessage(message) {
+        switch (message.kind) {
+            case 'SetBannerSession': {
+                if (!isValidBannerSession(message.session)) {
+                    this.warn('Userflow: ignoring malformed SetBannerSession (missing version.banner)');
+                    return;
+                }
+                this.setSession(normalize(message.session));
+                return;
+            }
+            case 'UnsetBannerSession': {
+                if (this.session?.id === message.sessionId) {
+                    this.setSession(null);
+                }
+                return;
+            }
+            default:
+                return;
+        }
+    }
+    /** Dismiss the banner. Does not touch a tour session held elsewhere. */
+    async endBanner(endReason) {
+        const current = this.session;
+        if (!current)
+            return;
+        const sessionId = current.id;
+        this.setSession(null);
+        await this.sendTracked({
+            kind: 'EndFlow',
+            sessionId,
+            endReason,
+        });
+    }
+    endFlow(endReason) {
+        return this.endBanner(endReason);
+    }
+    handleActions(actions) {
+        const session = this.session;
+        if (!session || actions.length === 0)
+            return Promise.resolve();
+        return handleActions(session, actions, this.actionDeps()).catch((error) => {
+            const detail = error instanceof Error ? error.message : String(error);
+            this.warn(`Userflow: banner actions failed: ${detail}`);
+        });
+    }
+    /** Drop the local banner without detaching from transport (preview / user switch). */
+    clearLocalSession() {
+        this.setSession(null);
+    }
+    reset() {
+        this.detach();
+        this.pendingSends.length = 0;
+        this.setSession(null);
+    }
+    async flushPendingSends() {
+        if (this.flushingPending || this.pendingSends.length === 0)
+            return;
+        this.flushingPending = true;
+        try {
+            while (this.pendingSends.length > 0) {
+                const message = this.pendingSends[0];
+                try {
+                    await this.transport.send(message);
+                    this.pendingSends.shift();
+                }
+                catch {
+                    return;
+                }
+            }
+        }
+        finally {
+            this.flushingPending = false;
+        }
+    }
+    actionDeps() {
+        return {
+            engine: this.actionRunner(),
+            ...(this.onOpenExternalUrl !== undefined
+                ? { onOpenExternalUrl: this.onOpenExternalUrl }
+                : {}),
+            ...(this.onEvalJs !== undefined ? { onEvalJs: this.onEvalJs } : {}),
+            warn: this.warn,
+        };
+    }
+    setSession(session) {
+        this.session = session;
+        this.transport.setBannerSessionId(session?.id ?? null);
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    /**
+     * Banner `CLOSE_FLOW` ends this session. Other actions delegate to the tour
+     * engine when one was provided, so `START_FLOW` replaces the tour.
+     */
+    actionRunner() {
+        const delegated = this.flowActions?.();
+        return {
+            goToStep: async () => {
+                // Banners have no steps. handleActions already no-ops GO_TO_STEP.
+            },
+            endFlow: (endReason) => this.endBanner(endReason),
+            trackButtonEvent: (eventName, token, stepCvid, sessionId) => delegated
+                ? delegated.trackButtonEvent(eventName, token, stepCvid, sessionId)
+                : this.trackButtonEvent(eventName, token, stepCvid, sessionId),
+            startFlow: (options) => (delegated ? delegated.startFlow(options) : this.startFlow(options)),
+            updateUser: (attributes) => delegated ? delegated.updateUser(attributes) : this.updateUser(attributes),
+            updateGroup: (attributes, options) => delegated
+                ? delegated.updateGroup(attributes, options)
+                : this.updateGroup(attributes, options),
+            beginBatch: () => (delegated ? delegated.beginBatch() : this.beginBatch()),
+            endBatch: () => (delegated ? delegated.endBatch() : this.endBatch()),
+        };
+    }
+    async trackButtonEvent(eventName, token, stepCvid, sessionId) {
+        await this.sendTracked({
+            kind: 'TrackButtonEvent',
+            eventName,
+            token,
+            stepCvid,
+            sessionId,
+        });
+    }
+    async startFlow(options) {
+        await this.sendTracked({
+            kind: 'StartFlow',
+            flowId: options.flowId,
+            stepCvid: options.stepCvid,
+            startReason: options.startReason,
+            once: false,
+        });
+    }
+    async updateUser(attributes) {
+        await this.updateUserImpl?.(attributes);
+    }
+    async updateGroup(attributes, options) {
+        await this.updateGroupImpl?.(attributes, options);
+    }
+    async beginBatch() {
+        await this.sendTracked({ kind: 'BeginBatch' });
+    }
+    async endBatch() {
+        await this.sendTracked({ kind: 'EndBatch' });
+    }
+    enqueuePendingSend(message) {
+        if (this.pendingSends.length >= MAX_PENDING_SENDS) {
+            this.pendingSends.shift();
+        }
+        this.pendingSends.push(message);
+    }
+    async sendTracked(message) {
+        try {
+            await this.transport.send(message);
+            void this.flushPendingSends();
+        }
+        catch {
+            this.enqueuePendingSend(message);
+            this.warn(`Userflow: failed to send ${message.kind}; queued for retry on reconnect`);
+        }
+    }
+}
+//# sourceMappingURL=BannerSessionEngine.js.map

package/vendor/core/dist/engine/BannerSessionEngine.js.map

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

package/vendor/core/dist/engine/FlowSessionEngine.d.ts

@@ -2,6 +2,7 @@ import type { ClientMessage, FlowActionFragment, FlowSessionFragment, FlowStepFr
 import { EndFlowReasonInput } from '@userflow-tech/protocol';
 import { type Scheduler } from '../transport/scheduler.js';
 import type { PublicAttributes } from '../types.js';
+import { type HandleActionsDeps } from './handleActions.js';
 /** Narrow transport surface the flow session engine depends on. */
 export interface FlowTransport {
     send(message: ClientMessage): Promise<void>;
@@ -25,6 +26,8 @@ export interface FlowSessionEngineDeps {
     transport: FlowTransport;
     /** Open a URL for NAVIGATE actions (both SAME_TAB and NEW_TAB on mobile). */
     onOpenExternalUrl?: (url: string) => void;
+    /** Run Evaluate JavaScript (React Native WebView). Omitted until the host wires it. */
+    onEvalJs?: HandleActionsDeps['onEvalJs'];
     /** Persist user attributes (SET_ATTRIBUTE on the user scope). */
     updateUser?: (attributes: PublicAttributes) => Promise<void>;
     /** Persist group / membership attributes (SET_ATTRIBUTE on group scopes). */
@@ -33,6 +36,8 @@ export interface FlowSessionEngineDeps {
     }) => Promise<void>;
     warn?: (message: string) => void;
     scheduler?: Scheduler;
+    /** Clock for Temporarily Hide TIME conditions. Tests inject a controllable now. */
+    now?: () => number;
 }
 /**
  * Framework-agnostic flow session state machine (Phase 3 WS2).
@@ -43,10 +48,12 @@ export interface FlowSessionEngineDeps {
 export declare class FlowSessionEngine {
     private readonly transport;
     private readonly onOpenExternalUrl;
+    private readonly onEvalJs;
     private readonly updateUserImpl;
     private readonly updateGroupImpl;
     private readonly warn;
     private readonly scheduler;
+    private readonly now;
     private clientClock;
     private serverClock;
     private flowSessionClock;
@@ -64,7 +71,9 @@ export declare class FlowSessionEngine {
     /** Step whose triggers are currently tracked (may differ from currentStep on ForceGoToStep). */
     private displayedStepId;
     private triggerTrackingKey;
-    private triggerUntrack;
+    private triggerSubscription;
+    /** While true, step triggers stay tracked but do not run or mark themselves fired. */
+    private triggersPaused;
     private applyingTriggers;
     private triggersDirty;
     private triggerSessionData;
@@ -72,6 +81,13 @@ export declare class FlowSessionEngine {
     private triggerCycleVisited;
     /** >0 while a step trigger's handleActions is in flight (including awaits). */
     private triggerActionDepth;
+    /** True while a Temporarily Hide condition matches. The session is kept. */
+    private hiddenByCondition;
+    private hiddenUntrack;
+    private hiddenTrackingKey;
+    private hiddenSessionData;
+    /** >0 while {@link setFlowSession} is applying, so a sync hide callback does not emit early. */
+    private sessionApplyDepth;
     constructor(deps: FlowSessionEngineDeps);
     /** Subscribe to inbound server messages. Must be called after identify. */
     attach(): () => void;
@@ -83,12 +99,26 @@ export declare class FlowSessionEngine {
     detach(): void;
     on(listener: FlowSessionEngineListener): () => void;
     getFlowSession(): FlowSessionFragment | null;
+    /**
+     * The session held for join and idle, including one Temporarily Hide is
+     * suppressing. {@link getFlowSession} is null in that case; callers that
+     * end or resume the session need this one.
+     */
+    getHeldFlowSession(): FlowSessionFragment | null;
+    /**
+     * True while a flow session is held for join and idle, including one that
+     * Temporarily Hide is suppressing. The overlay uses {@link getFlowSession},
+     * which is null in that case, so foreground idle must not use it or it will
+     * suspend the socket that attribute-driven unhide depends on.
+     */
+    hasHeldFlowSession(): boolean;
     getCurrentStep(): FlowStepFragment | null;
     /** Visible for tests / advanced callers; prefer {@link attach}. */
     handleServerMessage(message: ServerMessage): void;
     goToStep(step: FlowStepFragment): Promise<void>;
     endFlow(endReason: EndFlowReasonInput): Promise<void>;
     reportTooltipTargetMissing(stepId: string): Promise<void>;
+    private actionDeps;
     handleActions(actions: FlowActionFragment[]): Promise<void>;
     trackButtonEvent(eventName: string, token: string, stepCvid: string | null, sessionId: string | null): Promise<void>;
     updateUser(attributes: PublicAttributes): Promise<void>;
@@ -134,6 +164,16 @@ export declare class FlowSessionEngine {
      */
     private syncStepTriggers;
     private untrackStepTriggers;
+    /**
+     * Track the version's Temporarily Hide condition. A match suppresses the
+     * visible session only — the held session and join id stay so the same
+     * session can be shown again, matching server UnsetFlowSession / SetFlowSession.
+     */
+    private syncHiddenCondition;
+    private applyHiddenCondition;
+    private untrackHiddenCondition;
+    /** Keep the resumed step when a hide ends after ForceGoToStep. */
+    private alignDisplayedStep;
     /**
      * Open a server batch. Nested / overlapping callers share one BeginBatch;
      * `check_sessions` stays deferred until the matching {@link endBatch} at

package/vendor/core/dist/engine/FlowSessionEngine.d.ts.map

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

package/vendor/core/dist/engine/FlowSessionEngine.js

@@ -3,6 +3,7 @@ import { UserflowAuthError, UserflowRateLimitError } from '../errors.js';
 import { defaultScheduler } from '../transport/scheduler.js';
 import { handleActions } from './handleActions.js';
 import { SimpleObservable } from './simpleObservable.js';
+import { trackCondition } from './trackCondition.js';
 import { trackStepTriggers } from './trackStepTriggers.js';
 /** Cap for in-memory client-message retry after transport failure. */
 const MAX_PENDING_SENDS = 20;
@@ -48,7 +49,9 @@ export class FlowSessionEngine {
         /** Step whose triggers are currently tracked (may differ from currentStep on ForceGoToStep). */
         this.displayedStepId = null;
         this.triggerTrackingKey = null;
-        this.triggerUntrack = null;
+        this.triggerSubscription = null;
+        /** While true, step triggers stay tracked but do not run or mark themselves fired. */
+        this.triggersPaused = false;
         this.applyingTriggers = false;
         this.triggersDirty = false;
         this.triggerSessionData = null;
@@ -56,12 +59,21 @@ export class FlowSessionEngine {
         this.triggerCycleVisited = new Set();
         /** >0 while a step trigger's handleActions is in flight (including awaits). */
         this.triggerActionDepth = 0;
+        /** True while a Temporarily Hide condition matches. The session is kept. */
+        this.hiddenByCondition = false;
+        this.hiddenUntrack = null;
+        this.hiddenTrackingKey = null;
+        this.hiddenSessionData = null;
+        /** >0 while {@link setFlowSession} is applying, so a sync hide callback does not emit early. */
+        this.sessionApplyDepth = 0;
         this.transport = deps.transport;
         this.onOpenExternalUrl = deps.onOpenExternalUrl;
+        this.onEvalJs = deps.onEvalJs;
         this.updateUserImpl = deps.updateUser;
         this.updateGroupImpl = deps.updateGroup;
         this.warn = deps.warn ?? ((message) => console.warn(message));
         this.scheduler = deps.scheduler ?? defaultScheduler;
+        this.now = deps.now ?? Date.now;
     }
     /** Subscribe to inbound server messages. Must be called after identify. */
     attach() {
@@ -89,9 +101,30 @@ export class FlowSessionEngine {
         };
     }
     getFlowSession() {
+        if (this.hiddenByCondition)
+            return null;
         return this.flowSession;
     }
+    /**
+     * The session held for join and idle, including one Temporarily Hide is
+     * suppressing. {@link getFlowSession} is null in that case; callers that
+     * end or resume the session need this one.
+     */
+    getHeldFlowSession() {
+        return this.flowSession;
+    }
+    /**
+     * True while a flow session is held for join and idle, including one that
+     * Temporarily Hide is suppressing. The overlay uses {@link getFlowSession},
+     * which is null in that case, so foreground idle must not use it or it will
+     * suspend the socket that attribute-driven unhide depends on.
+     */
+    hasHeldFlowSession() {
+        return this.flowSession != null;
+    }
     getCurrentStep() {
+        if (this.hiddenByCondition)
+            return null;
         const session = this.flowSession;
         if (!session)
             return null;
@@ -130,6 +163,12 @@ export class FlowSessionEngine {
                     return;
                 if (this.flowSession?.id === message.sessionId) {
                     this.displayedStepId = message.stepId;
+                    if (this.hiddenByCondition) {
+                        // Rebind triggers to this step, but keep them paused so they do not
+                        // run for a step the overlay is not showing.
+                        this.syncStepTriggers();
+                        return;
+                    }
                     this.emit({
                         type: 'goToStep',
                         sessionId: message.sessionId,
@@ -151,6 +190,10 @@ export class FlowSessionEngine {
             case 'UntrackClientCondition':
                 // Handled by ClientConditionEngine (separate subscriber).
                 return;
+            case 'SetBannerSession':
+            case 'UnsetBannerSession':
+                // Handled by BannerSessionEngine (separate subscriber).
+                return;
         }
     }
     async goToStep(step) {
@@ -198,15 +241,19 @@ export class FlowSessionEngine {
             await this.endFlow(EndFlowReasonInput.TOOLTIP_TARGET_MISSING);
         }
     }
-    handleActions(actions) {
-        const session = this.requireFlowSession();
-        return handleActions(session, actions, {
+    actionDeps() {
+        return {
             engine: this,
             ...(this.onOpenExternalUrl !== undefined
                 ? { onOpenExternalUrl: this.onOpenExternalUrl }
                 : {}),
+            ...(this.onEvalJs !== undefined ? { onEvalJs: this.onEvalJs } : {}),
             warn: this.warn,
-        }).catch((error) => {
+        };
+    }
+    handleActions(actions) {
+        const session = this.requireFlowSession();
+        return handleActions(session, actions, this.actionDeps()).catch((error) => {
             const detail = error instanceof Error ? error.message : String(error);
             this.warn(`Userflow: flow actions failed: ${detail}`);
         });
@@ -287,14 +334,15 @@ export class FlowSessionEngine {
         this.clearConditionWaitTimers();
         this.displayedStepId = null;
         this.untrackStepTriggers();
-        if (this.flowSession !== null) {
-            this.flowSession = null;
-            this.transport.setFlowSessionId(null);
+        this.triggersPaused = false;
+        this.untrackHiddenCondition();
+        const hadSession = this.flowSession !== null;
+        this.flowSession = null;
+        this.hiddenByCondition = false;
+        this.transport.setFlowSessionId(null);
+        if (hadSession) {
             this.emit({ type: 'sessionChange', session: null });
         }
-        else {
-            this.transport.setFlowSessionId(null);
-        }
     }
     /** Clear session, clocks, timers, pending sends, and join resume id; detach from transport. */
     reset() {
@@ -341,15 +389,39 @@ export class FlowSessionEngine {
         return this.pendingSends.length + (this.pendingEndBatch ? 1 : 0);
     }
     setFlowSession(session, clock) {
-        const applied = this.applyLocalStepToSession(session);
-        this.flowSession = applied;
-        this.flowSessionClock = clock;
-        this.transport.setFlowSessionId(applied?.id ?? null);
-        this.displayedStepId = applied?.currentStep?.id ?? null;
-        // Track triggers before sessionChange so ALWAYS_TRUE go-to-next can
-        // advance currentStep before the first UI paint (web useLayoutEffect).
-        this.syncStepTriggers();
-        this.emit({ type: 'sessionChange', session: this.flowSession });
+        this.sessionApplyDepth += 1;
+        try {
+            const applied = this.applyLocalStepToSession(session);
+            this.flowSession = applied;
+            this.flowSessionClock = clock;
+            this.transport.setFlowSessionId(applied?.id ?? null);
+            this.displayedStepId = applied?.currentStep?.id ?? null;
+            // Evaluate Temporarily Hide before the first sessionChange so a condition
+            // that is already true does not paint a frame. A match keeps the session
+            // and the join id; it does not end the flow.
+            this.syncHiddenCondition();
+            if (this.hiddenByCondition) {
+                // Rebind when the session or step changed. Stay paused so a one-shot
+                // trigger does not run until the overlay is shown again, and so untrack
+                // during that rebind cannot mark the new step as live.
+                this.triggersPaused = true;
+                this.syncStepTriggers();
+            }
+            else {
+                this.triggersPaused = false;
+                // Track triggers before sessionChange so ALWAYS_TRUE go-to-next can
+                // advance currentStep before the first UI paint (web useLayoutEffect).
+                this.syncStepTriggers();
+                this.triggerSubscription?.flushPaused();
+            }
+            this.emit({
+                type: 'sessionChange',
+                session: this.hiddenByCondition ? null : this.flowSession,
+            });
+        }
+        finally {
+            this.sessionApplyDepth -= 1;
+        }
     }
     /**
      * Same-session SetFlowSession must not wipe a local goToStep. Tracking a
@@ -426,21 +498,18 @@ export class FlowSessionEngine {
                     break;
                 }
                 this.triggerSessionData = new SimpleObservable(session.data);
-                this.triggerUntrack = trackStepTriggers(step.triggers ?? [], session, {
-                    engine: this,
+                this.triggerSubscription = trackStepTriggers(step.triggers ?? [], session, {
+                    ...this.actionDeps(),
                     scheduler: this.scheduler,
                     sessionData: this.triggerSessionData,
                     getSession: () => this.flowSession,
+                    isPaused: () => this.triggersPaused,
                     enterTriggerActions: () => {
                         this.triggerActionDepth += 1;
                     },
                     leaveTriggerActions: () => {
                         this.triggerActionDepth = Math.max(0, this.triggerActionDepth - 1);
                     },
-                    ...(this.onOpenExternalUrl !== undefined
-                        ? { onOpenExternalUrl: this.onOpenExternalUrl }
-                        : {}),
-                    warn: this.warn,
                 });
             } while (this.triggersDirty);
         }
@@ -449,11 +518,81 @@ export class FlowSessionEngine {
         }
     }
     untrackStepTriggers() {
-        this.triggerUntrack?.();
-        this.triggerUntrack = null;
+        this.triggerSubscription?.untrack();
+        this.triggerSubscription = null;
         this.triggerTrackingKey = null;
         this.triggerSessionData = null;
     }
+    /**
+     * Track the version's Temporarily Hide condition. A match suppresses the
+     * visible session only — the held session and join id stay so the same
+     * session can be shown again, matching server UnsetFlowSession / SetFlowSession.
+     */
+    syncHiddenCondition() {
+        const session = this.flowSession;
+        const condition = session?.version.hiddenCondition ?? null;
+        if (!session || condition == null) {
+            this.untrackHiddenCondition();
+            this.hiddenByCondition = false;
+            return;
+        }
+        const key = `${session.id}:${JSON.stringify(condition)}`;
+        if (key === this.hiddenTrackingKey) {
+            this.hiddenSessionData?.update(session.data);
+            return;
+        }
+        this.untrackHiddenCondition();
+        this.hiddenTrackingKey = key;
+        this.hiddenSessionData = new SimpleObservable(session.data);
+        this.hiddenUntrack = trackCondition({
+            condition,
+            scheduler: this.scheduler,
+            now: this.now,
+            sessionData: this.hiddenSessionData,
+            warn: this.warn,
+            context: 'temporarily hide conditions',
+            callback: (isTrue) => {
+                this.applyHiddenCondition(isTrue);
+            },
+        });
+    }
+    applyHiddenCondition(isTrue) {
+        if (isTrue === this.hiddenByCondition)
+            return;
+        this.hiddenByCondition = isTrue;
+        if (this.sessionApplyDepth > 0)
+            return;
+        if (isTrue) {
+            this.triggersPaused = true;
+        }
+        else {
+            this.triggersPaused = false;
+            this.alignDisplayedStep();
+            this.syncStepTriggers();
+            this.triggerSubscription?.flushPaused();
+        }
+        this.emit({
+            type: 'sessionChange',
+            session: this.hiddenByCondition ? null : this.flowSession,
+        });
+    }
+    untrackHiddenCondition() {
+        this.hiddenUntrack?.();
+        this.hiddenUntrack = null;
+        this.hiddenTrackingKey = null;
+        this.hiddenSessionData = null;
+    }
+    /** Keep the resumed step when a hide ends after ForceGoToStep. */
+    alignDisplayedStep() {
+        const session = this.flowSession;
+        const stepId = this.displayedStepId;
+        if (!session || !stepId || session.currentStep?.id === stepId)
+            return;
+        const step = session.version.steps.find((candidate) => candidate.id === stepId);
+        if (!step)
+            return;
+        session.currentStep = { id: step.id, crossVersionId: step.crossVersionId };
+    }
     /**
      * Open a server batch. Nested / overlapping callers share one BeginBatch;
      * `check_sessions` stays deferred until the matching {@link endBatch} at