veo-sdk 0.5.32 → 0.5.34

package/dist/builder.d.cts

@@ -1,5 +1,5 @@
-import { P as PreviewGuideInput } from './guide-preview-XUnTmzUO.cjs';
-export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-XUnTmzUO.cjs';
+import { P as PreviewGuideInput } from './guide-preview-DbEZdGBV.cjs';
+export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-DbEZdGBV.cjs';
 
 /** Dónde soltó el autor un bloque nuevo. */
 interface BlockDropPayload {
@@ -81,8 +81,10 @@ interface ElementPickerOptions {
     onCancel?: () => void;
     /** Niveles de ancestros del selector. Default 5 (igual que autocapture). */
     maxAncestors?: number;
-    /** Texto del banner superior. Default en español. */
+    /** Título del banner superior. Default en español. */
     hint?: string;
+    /** Subtítulo del banner (default: cómo abrir menús con Alt + clic). */
+    subhint?: string;
 }
 interface ElementPickerHandle {
     /** Cierra el picker sin elegir nada. Idempotente. */
@@ -119,9 +121,87 @@ declare function stopElementPicker(): void;
  *   4. La app responde con eventos (`picked`, `pick-cancelled`, …).
  */
 
+/**
+ * Estado que el panel (editor) publica para que el SDK pinte el "chrome" del
+ * editor (topbar + fila de pasos) ENCIMA de la app. El panel es la única fuente
+ * de verdad; el chrome solo lo refleja y devuelve `chrome-action`s.
+ */
+interface EditorChromeState {
+    guideName: string;
+    /** ISO de creación (null = guía nueva sin guardar). */
+    createdAt: string | null;
+    steps: Array<{
+        id: string;
+        label: string;
+        presentation: 'floating' | 'inline';
+    }>;
+    activeStep: number;
+    /** Qué muestra el panel: ajustes de activación o el paso activo. */
+    section: 'activation' | 'step' | 'badge' | 'target';
+    saving: boolean;
+    dirty: boolean;
+    /**
+     * Estado de publicación de la guía, para que el autor vea en la barra si lo
+     * que edita está Activa/Borrador/etc. (sin esto, guardar una guía en borrador
+     * y no verla en la app era un misterio). `tone` elige el color del chip.
+     */
+    status?: {
+        label: string;
+        tone: 'live' | 'testing' | 'review' | 'draft' | 'paused';
+    } | null;
+}
+/**
+ * Qué está haciendo la preview en la app. El SDK lo publica cada vez que
+ * evalúa un comando `preview` con `honorTrigger`, para que el panel explique
+ * por qué la guía no se ve (retraso, elemento objetivo, otra página, otro
+ * dispositivo) en vez de parecer rota.
+ */
+type PreviewStatus = {
+    state: 'shown';
+} | {
+    state: 'waiting-delay';
+    delayMs: number;
+} | {
+    state: 'waiting-trigger';
+    trigger: 'on_click' | 'on_hover';
+    selector: string;
+} | {
+    state: 'page-mismatch';
+    pattern: string;
+} | {
+    state: 'device-mismatch';
+    devices: 'desktop' | 'mobile';
+};
+/** Acciones que el usuario dispara en el chrome (barras) y el panel ejecuta. */
+type ChromeAction = {
+    action: 'select-activation';
+} | {
+    action: 'select-step';
+    index: number;
+} | {
+    action: 'add-step';
+} | {
+    action: 'save';
+    exit: boolean;
+} | {
+    action: 'exit';
+} | {
+    action: 'dock';
+    position: 'top' | 'bottom';
+} | {
+    action: 'show-panel';
+} | {
+    action: 'preview';
+} | {
+    action: 'exit-preview';
+};
 /** Eventos que la app del cliente envía al dashboard. */
 type BuilderEvent = {
     type: 'ready';
+    chrome?: boolean;
+} | {
+    type: 'chrome-action';
+    payload: ChromeAction;
 } | {
     type: 'picked';
     payload: PickedElement;
@@ -133,6 +213,9 @@ type BuilderEvent = {
 } | {
     type: 'block-dropped';
     payload: BlockDropPayload;
+} | {
+    type: 'preview-status';
+    payload: PreviewStatus;
 } | {
     type: 'closed';
 };
@@ -147,6 +230,7 @@ type BuilderCommand = {
     type: 'preview';
     guide: PreviewGuideInput;
     editable?: boolean;
+    honorTrigger?: boolean;
 } | {
     type: 'block-drag';
     phase: 'move' | 'drop' | 'cancel';
@@ -158,6 +242,12 @@ type BuilderCommand = {
     type: 'close-preview';
 } | {
     type: 'teardown';
+} | {
+    type: 'editor-state';
+    state: EditorChromeState;
+} | {
+    type: 'panel-visibility';
+    visible: boolean;
 } | {
     type: 'panel-ready';
 };

package/dist/builder.d.ts

@@ -1,5 +1,5 @@
-import { P as PreviewGuideInput } from './guide-preview-XUnTmzUO.js';
-export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-XUnTmzUO.js';
+import { P as PreviewGuideInput } from './guide-preview-DbEZdGBV.js';
+export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-DbEZdGBV.js';
 
 /** Dónde soltó el autor un bloque nuevo. */
 interface BlockDropPayload {
@@ -81,8 +81,10 @@ interface ElementPickerOptions {
     onCancel?: () => void;
     /** Niveles de ancestros del selector. Default 5 (igual que autocapture). */
     maxAncestors?: number;
-    /** Texto del banner superior. Default en español. */
+    /** Título del banner superior. Default en español. */
     hint?: string;
+    /** Subtítulo del banner (default: cómo abrir menús con Alt + clic). */
+    subhint?: string;
 }
 interface ElementPickerHandle {
     /** Cierra el picker sin elegir nada. Idempotente. */
@@ -119,9 +121,87 @@ declare function stopElementPicker(): void;
  *   4. La app responde con eventos (`picked`, `pick-cancelled`, …).
  */
 
+/**
+ * Estado que el panel (editor) publica para que el SDK pinte el "chrome" del
+ * editor (topbar + fila de pasos) ENCIMA de la app. El panel es la única fuente
+ * de verdad; el chrome solo lo refleja y devuelve `chrome-action`s.
+ */
+interface EditorChromeState {
+    guideName: string;
+    /** ISO de creación (null = guía nueva sin guardar). */
+    createdAt: string | null;
+    steps: Array<{
+        id: string;
+        label: string;
+        presentation: 'floating' | 'inline';
+    }>;
+    activeStep: number;
+    /** Qué muestra el panel: ajustes de activación o el paso activo. */
+    section: 'activation' | 'step' | 'badge' | 'target';
+    saving: boolean;
+    dirty: boolean;
+    /**
+     * Estado de publicación de la guía, para que el autor vea en la barra si lo
+     * que edita está Activa/Borrador/etc. (sin esto, guardar una guía en borrador
+     * y no verla en la app era un misterio). `tone` elige el color del chip.
+     */
+    status?: {
+        label: string;
+        tone: 'live' | 'testing' | 'review' | 'draft' | 'paused';
+    } | null;
+}
+/**
+ * Qué está haciendo la preview en la app. El SDK lo publica cada vez que
+ * evalúa un comando `preview` con `honorTrigger`, para que el panel explique
+ * por qué la guía no se ve (retraso, elemento objetivo, otra página, otro
+ * dispositivo) en vez de parecer rota.
+ */
+type PreviewStatus = {
+    state: 'shown';
+} | {
+    state: 'waiting-delay';
+    delayMs: number;
+} | {
+    state: 'waiting-trigger';
+    trigger: 'on_click' | 'on_hover';
+    selector: string;
+} | {
+    state: 'page-mismatch';
+    pattern: string;
+} | {
+    state: 'device-mismatch';
+    devices: 'desktop' | 'mobile';
+};
+/** Acciones que el usuario dispara en el chrome (barras) y el panel ejecuta. */
+type ChromeAction = {
+    action: 'select-activation';
+} | {
+    action: 'select-step';
+    index: number;
+} | {
+    action: 'add-step';
+} | {
+    action: 'save';
+    exit: boolean;
+} | {
+    action: 'exit';
+} | {
+    action: 'dock';
+    position: 'top' | 'bottom';
+} | {
+    action: 'show-panel';
+} | {
+    action: 'preview';
+} | {
+    action: 'exit-preview';
+};
 /** Eventos que la app del cliente envía al dashboard. */
 type BuilderEvent = {
     type: 'ready';
+    chrome?: boolean;
+} | {
+    type: 'chrome-action';
+    payload: ChromeAction;
 } | {
     type: 'picked';
     payload: PickedElement;
@@ -133,6 +213,9 @@ type BuilderEvent = {
 } | {
     type: 'block-dropped';
     payload: BlockDropPayload;
+} | {
+    type: 'preview-status';
+    payload: PreviewStatus;
 } | {
     type: 'closed';
 };
@@ -147,6 +230,7 @@ type BuilderCommand = {
     type: 'preview';
     guide: PreviewGuideInput;
     editable?: boolean;
+    honorTrigger?: boolean;
 } | {
     type: 'block-drag';
     phase: 'move' | 'drop' | 'cancel';
@@ -158,6 +242,12 @@ type BuilderCommand = {
     type: 'close-preview';
 } | {
     type: 'teardown';
+} | {
+    type: 'editor-state';
+    state: EditorChromeState;
+} | {
+    type: 'panel-visibility';
+    visible: boolean;
 } | {
     type: 'panel-ready';
 };

package/dist/builder.mjs

@@ -1,7 +1,7 @@
-import './chunk-JPANNXIK.mjs';
-import { initBuilderMode } from './chunk-AFU5ZG6Z.mjs';
-export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-AFU5ZG6Z.mjs';
-export { closeGuidePreview, previewGuide } from './chunk-X27GD7IT.mjs';
+import './chunk-HAAT6XVN.mjs';
+import { initBuilderMode } from './chunk-IZXJA55N.mjs';
+export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-IZXJA55N.mjs';
+export { closeGuidePreview, previewGuide } from './chunk-W4R4XCWL.mjs';
 import './chunk-PTG3BTJE.mjs';
 
 // src/builder.ts

package/dist/{chunk-JPANNXIK.mjs → chunk-HAAT6XVN.mjs}

@@ -1,4 +1,4 @@
-import { hasDocument, hasWindow, previewGuide, clearPreviewToken, DEFAULT_TRACKER_MAX_RETRIES, DEFAULT_TRACKER_BATCH_SIZE, DEFAULT_TRACKER_FLUSH_INTERVAL_MS, stepMatchesPage, CompositeRenderer, ModalRenderer, BannerRenderer, WalkthroughRenderer, BadgeRenderer, InlineFormRenderer, FormRenderer, InlineCustomRenderer, InlineRenderer, CustomRenderer, TooltipRenderer, FREQUENCY_CACHE_KEY_PREFIX, FREQUENCY_CACHE_TTL_MS, FREQUENCY_CACHE_MAX_ENTRIES, WALKTHROUGH_STATE_KEY_PREFIX, WALKTHROUGH_ABANDONMENT_TIMEOUT_MS } from './chunk-X27GD7IT.mjs';
+import { hasDocument, hasWindow, isAutomaticActivation, activationDelayMs, clearPreviewToken, DEFAULT_TRACKER_MAX_RETRIES, DEFAULT_TRACKER_BATCH_SIZE, DEFAULT_TRACKER_FLUSH_INTERVAL_MS, isDeviceAllowed, stepMatchesPage, CompositeRenderer, ModalRenderer, BannerRenderer, WalkthroughRenderer, BadgeRenderer, InlineFormRenderer, FormRenderer, InlineCustomRenderer, InlineRenderer, CustomRenderer, TooltipRenderer, previewGuide, FREQUENCY_CACHE_KEY_PREFIX, FREQUENCY_CACHE_TTL_MS, FREQUENCY_CACHE_MAX_ENTRIES, WALKTHROUGH_STATE_KEY_PREFIX, WALKTHROUGH_ABANDONMENT_TIMEOUT_MS } from './chunk-W4R4XCWL.mjs';
 
 // src/plugins/plugin.ts
 function definePlugin(plugin) {
@@ -43,26 +43,87 @@ async function runPreviewMode(opts) {
     }
   };
   let preview = null;
-  const show = () => {
+  let delayTimer = null;
+  let disarmTrigger = null;
+  const baseLabel = guide ? `Vista previa: ${guide.guideName}` : "";
+  const clearWaits = () => {
+    if (delayTimer) clearTimeout(delayTimer);
+    delayTimer = null;
+    disarmTrigger?.();
+    disarmTrigger = null;
+  };
+  const paint = () => {
     if (!guide) return;
     preview?.close();
+    let startStepIndex;
+    if (guide.guideType === "composite") {
+      const steps = guide.guideSteps;
+      const idx = steps.findIndex((st) => stepMatchesPage(st.pageLocation, window.location.href));
+      if (idx === -1) {
+        chip.setLabel(`${baseLabel} \xB7 ning\xFAn paso aplica a esta p\xE1gina`);
+        return;
+      }
+      startStepIndex = idx;
+    }
+    chip.setLabel(baseLabel);
     preview = previewGuide({
       guideType: guide.guideType,
       guideSteps: guide.guideSteps,
       activationRules: guide.activationRules,
       guideName: guide.guideName,
+      ...startStepIndex !== void 0 ? { startStepIndex } : {},
       formSubmit: submitToBackend,
       formSubmitNote: "Vista previa: guardado en TU usuario para probar el flujo."
     });
   };
+  const show = () => {
+    if (!guide) return;
+    clearWaits();
+    const rules = guide.activationRules;
+    const selector = rules.selector?.trim();
+    if ((rules.trigger === "on_click" || rules.trigger === "on_hover") && selector && !isAutomaticActivation(rules)) {
+      const verb = rules.trigger === "on_hover" ? "pasa el mouse por" : "haz clic en";
+      chip.setLabel(`${baseLabel} \xB7 ${verb} el elemento objetivo`);
+      const onFire = (e) => {
+        const target = e.target;
+        if (!(target instanceof Element)) return;
+        if (target.closest("[data-veo-preview-chip],[data-veo-guide]")) return;
+        try {
+          if (!target.closest(selector)) return;
+        } catch {
+          return;
+        }
+        clearWaits();
+        paint();
+      };
+      document.addEventListener("click", onFire, true);
+      if (rules.trigger === "on_hover") document.addEventListener("mouseover", onFire, true);
+      disarmTrigger = () => {
+        document.removeEventListener("click", onFire, true);
+        document.removeEventListener("mouseover", onFire, true);
+      };
+      return;
+    }
+    const delayMs = activationDelayMs(rules);
+    if (delayMs > 0) {
+      chip.setLabel(`${baseLabel} \xB7 aparece en ${Math.round(delayMs / 1e3)} s`);
+      delayTimer = setTimeout(() => {
+        delayTimer = null;
+        paint();
+      }, delayMs);
+      return;
+    }
+    paint();
+  };
   const chip = mountChip({
-    label: guide ? `Vista previa: ${guide.guideName}` : "Link de preview inv\xE1lido o vencido",
+    label: guide ? baseLabel : "Link de preview inv\xE1lido o vencido",
     error: !guide,
     onReshow: guide ? show : null,
     onClose: () => handle.teardown()
   });
   const handle = {
     teardown() {
+      clearWaits();
       preview?.close();
       preview = null;
       chip.remove();
@@ -85,7 +146,7 @@ function mountChip(opts) {
       background: #111827; color: #f9fafb; border-radius: 9999px;
       font: 500 12px/1.2 system-ui, sans-serif; box-shadow: 0 4px 12px rgba(0,0,0,.25); }
     .chip.error { background: #7f1d1d; }
-    .label { max-width: 240px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+    .label { max-width: 360px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
     button { all: unset; cursor: pointer; padding: 2px 6px; border-radius: 9999px;
       font-size: 12px; line-height: 1; }
     button:hover { background: rgba(255,255,255,.15); }
@@ -111,7 +172,19 @@ function mountChip(opts) {
   chip.appendChild(close);
   root.appendChild(chip);
   document.body.appendChild(host);
-  return { remove: () => host.remove() };
+  return {
+    remove: () => host.remove(),
+    setLabel: (text) => {
+      label.textContent = text;
+      label.title = text;
+    }
+  };
+}
+
+// src/plugins/guides/campaign-weekdays.ts
+function isWeekdayAllowed(campaignWeekdays, now = /* @__PURE__ */ new Date()) {
+  if (!campaignWeekdays || campaignWeekdays.length === 0) return true;
+  return campaignWeekdays.includes(now.getDay());
 }
 
 // src/plugins/guides/guide-frequency-cache.ts
@@ -613,6 +686,15 @@ var STATUS_BY_ACTION = {
   step_back: null,
   completed: "completed"
 };
+var REPEAT_UNIT_MS = {
+  minute: 6e4,
+  hour: 36e5,
+  day: 864e5,
+  week: 6048e5
+};
+function repeatIntervalMs(repeat) {
+  return Math.max(0, repeat.every) * REPEAT_UNIT_MS[repeat.unit];
+}
 var GuidesController = class {
   constructor(client, config) {
     this.client = client;
@@ -647,6 +729,20 @@ var GuidesController = class {
      * a esa página (tours multi-página estilo Pendo).
      */
     this.pendingComposite = null;
+    /**
+     * Guías composite con «retrasar la aparición» esperando su `delayMs`. Se
+     * cancelan si el usuario navega a una página donde el paso ya no aplica y en
+     * `destroy()`. Evita el doble arranque por pageviews rápidos durante la espera.
+     */
+    this.compositeDelays = /* @__PURE__ */ new Map();
+    /**
+     * Estado LOCAL de «Repetir la aparición» (por sesión del SDK). El backend es
+     * la fuente de verdad (interacciones persistidas), pero entre el descarte y el
+     * siguiente resolve la cola de interacciones puede no haber salido todavía:
+     * sin esto la guía reaparecía al instante en la próxima navegación.
+     */
+    this.repeatHoldUntil = /* @__PURE__ */ new Map();
+    this.localDismissals = /* @__PURE__ */ new Map();
     /**
      * Guías composite EN PANTALLA con el paso mostrado, por `guideId`. En una SPA,
      * al navegar a una página que ya NO matchea la `pageLocation` del paso, hay que
@@ -712,15 +808,21 @@ var GuidesController = class {
       if (this.debug) console.error("[veo] guides resolver threw:", err);
       return;
     }
+    guides = guides.filter(
+      (g) => isWeekdayAllowed(g.campaignWeekdays) && isDeviceAllowed(g.activationRules.devices)
+    );
     if (this.debug) console.log(`[veo] guides: ${guides.length} eligible at ${pageUrl}`);
     this.disarmTriggers();
     for (const guide of guides) {
-      const trigger = guide.activationRules.trigger;
-      if ((trigger === "on_click" || trigger === "on_hover") && guide.activationRules.selector) {
+      const rules = guide.activationRules;
+      const trigger = rules.trigger;
+      if ((trigger === "on_click" || trigger === "on_hover") && rules.selector) {
         this.armInteractionTrigger(guide, endUserId, sessionId, pageUrl);
-        continue;
+        if (!isAutomaticActivation(rules)) continue;
       }
-      await this.showGuide(guide, endUserId, sessionId, pageUrl);
+      await this.showGuide(guide, endUserId, sessionId, pageUrl, {
+        badgeOpen: trigger !== "manual"
+      });
     }
   }
   /**
@@ -728,11 +830,16 @@ var GuidesController = class {
    * tipo). Cuerpo original del loop de `checkGuides`, extraído para que los
    * disparadores por interacción pasen por LOS MISMOS chequeos al disparar.
    */
-  async showGuide(guide, endUserId, sessionId, pageUrl) {
+  async showGuide(guide, endUserId, sessionId, pageUrl, opts = {}) {
+    const badgeOpen = opts.badgeOpen !== false;
     if (this.frequencyCache.shouldFilter(guide.guideId, guide.displayFrequency)) {
       if (this.debug) console.log(`[veo] guides: filtered locally guideId=${guide.guideId}`);
       return;
     }
+    if (!opts.byUser && this.isHeldByRepeat(guide)) {
+      if (this.debug) console.log(`[veo] guides: held by repeat guideId=${guide.guideId}`);
+      return;
+    }
     if (this.activeByGuideId.has(guide.guideId)) {
       if (this.debug) console.log(`[veo] guides: already shown guideId=${guide.guideId}`);
       return;
@@ -747,7 +854,7 @@ var GuidesController = class {
       return;
     }
     if (guide.guideType === "composite") {
-      this.startComposite(guide, sessionId, pageUrl);
+      this.startComposite(guide, sessionId, pageUrl, badgeOpen);
       return;
     }
     this.runSingleStepRender(guide, sessionId, pageUrl);
@@ -776,7 +883,7 @@ var GuidesController = class {
         return;
       }
       disarm();
-      void this.showGuide(guide, endUserId, sessionId, pageUrl);
+      void this.showGuide(guide, endUserId, sessionId, pageUrl, { byUser: true });
     };
     const disarm = () => {
       document.removeEventListener(eventName, onFire, true);
@@ -843,6 +950,10 @@ ${pageUrl}`;
       this.activeWalkthroughGuide = null;
     }
     this.disarmTriggers();
+    for (const pending of this.compositeDelays.values()) clearTimeout(pending.timer);
+    this.compositeDelays.clear();
+    this.repeatHoldUntil.clear();
+    this.localDismissals.clear();
     this.dispatched.clear();
     this.resolveCache = null;
     this.inflightResolve = null;
@@ -852,7 +963,7 @@ ${pageUrl}`;
     const renderer = this.createSingleStepRenderer(guide.guideType);
     if (!renderer) return;
     this.activeByGuideId.set(guide.guideId, renderer);
-    const delayMs = guide.activationRules.delayMs ?? 0;
+    const delayMs = activationDelayMs(guide.activationRules);
     window.setTimeout(
       () => this.mountSingleStepRenderer(guide, renderer, sessionId, pageUrl),
       delayMs
@@ -863,12 +974,79 @@ ${pageUrl}`;
    * `pageLocation` matchea la URL actual (targeting por-paso) y lo pinta con el
    * `CompositeRenderer`. Si ningún paso aplica a esta página, no muestra nada.
    */
-  startComposite(guide, sessionId, pageUrl) {
+  startComposite(guide, sessionId, pageUrl, badgeOpen = true) {
     if (this.pendingComposite?.guide.guideId === guide.guideId) return;
     const steps = guide.guideSteps;
-    const start = steps.findIndex((s) => stepMatchesPage(s.pageLocation, pageUrl));
+    const remembered = guide.activationRules.repeat?.onLoad === "resume" ? this.recallStep(guide.guideId) : null;
+    const start = remembered !== null && stepMatchesPage(steps[remembered]?.pageLocation, pageUrl) ? remembered : steps.findIndex((s) => stepMatchesPage(s.pageLocation, pageUrl));
     if (start === -1) return;
-    this.renderCompositeStep(guide, start, sessionId, pageUrl);
+    if (guide.activationRules.trigger === "manual" && !steps[start]?.badge?.enabled) return;
+    if (this.compositeDelays.has(guide.guideId)) return;
+    this.resetDispatched(guide.guideId);
+    const delayMs = activationDelayMs(guide.activationRules);
+    if (delayMs <= 0) {
+      this.renderCompositeStep(guide, start, sessionId, pageUrl, badgeOpen);
+      return;
+    }
+    const timer = setTimeout(() => {
+      this.compositeDelays.delete(guide.guideId);
+      if (this.activeByGuideId.has(guide.guideId)) return;
+      this.renderCompositeStep(guide, start, sessionId, pageUrl, badgeOpen);
+    }, delayMs);
+    this.compositeDelays.set(guide.guideId, { guide, stepIndex: start, timer });
+  }
+  /** Olvida el dedupe de interacciones de una guía (nueva aparición). */
+  resetDispatched(guideId) {
+    const prefix = `${guideId}:`;
+    for (const key of this.dispatched) {
+      if (key.startsWith(prefix)) this.dispatched.delete(key);
+    }
+  }
+  /**
+   * «Repetir la aparición» evaluada en local: ya se mostró hace menos del
+   * intervalo, o el usuario ya la descartó N veces en esta sesión del SDK.
+   */
+  isHeldByRepeat(guide) {
+    const repeat = guide.activationRules.repeat;
+    if (!repeat) return false;
+    const until = this.repeatHoldUntil.get(guide.guideId);
+    if (until !== void 0 && Date.now() < until) return true;
+    if (repeat.stopAfter.kind === "dismissals") {
+      return (this.localDismissals.get(guide.guideId) ?? 0) >= repeat.stopAfter.count;
+    }
+    return false;
+  }
+  /** Registra en local el efecto de una interacción sobre «repetir». */
+  recordRepeatLocal(guide, action) {
+    const repeat = guide.activationRules.repeat;
+    if (!repeat) return;
+    if (action === "shown") {
+      this.repeatHoldUntil.set(guide.guideId, Date.now() + repeatIntervalMs(repeat));
+    } else if (action === "dismissed") {
+      this.localDismissals.set(guide.guideId, (this.localDismissals.get(guide.guideId) ?? 0) + 1);
+    } else if (action === "completed" && repeat.stopAfter.kind === "completed") {
+      this.repeatHoldUntil.set(guide.guideId, Number.POSITIVE_INFINITY);
+    }
+  }
+  /** Último paso visto por guía (localStorage) para `repeat.onLoad = 'resume'`. */
+  stepKey(guideId) {
+    return `veo:last_step:${guideId}`;
+  }
+  rememberStep(guideId, idx) {
+    try {
+      localStorage.setItem(this.stepKey(guideId), String(idx));
+    } catch {
+    }
+  }
+  recallStep(guideId) {
+    try {
+      const raw = localStorage.getItem(this.stepKey(guideId));
+      if (raw === null) return null;
+      const n = Number(raw);
+      return Number.isInteger(n) && n >= 0 ? n : null;
+    } catch {
+      return null;
+    }
   }
   /**
    * Destruye las guías composite en pantalla cuyo paso mostrado ya no matchea la
@@ -876,6 +1054,14 @@ ${pageUrl}`;
    * esto la guía queda montada en el DOM y aparece en páginas que no debía.
    */
   pruneComposite(pageUrl) {
+    for (const [guideId, pending] of this.compositeDelays) {
+      const steps = pending.guide.guideSteps;
+      const step = steps[pending.stepIndex];
+      if (!step || !stepMatchesPage(step.pageLocation, pageUrl)) {
+        clearTimeout(pending.timer);
+        this.compositeDelays.delete(guideId);
+      }
+    }
     for (const entry of this.activeComposite.values()) {
       const steps = entry.guide.guideSteps;
       const step = steps[entry.stepIndex];
@@ -907,8 +1093,9 @@ ${pageUrl}`;
    * que los botones next/prev avancen (misma página); en single-step los
    * botones cierran. Cada avance destruye el paso anterior y monta el siguiente.
    */
-  renderCompositeStep(guide, idx, sessionId, pageUrl) {
+  renderCompositeStep(guide, idx, sessionId, pageUrl, badgeOpen = true) {
     const steps = guide.guideSteps;
+    this.rememberStep(guide.guideId, idx);
     const renderer = new CompositeRenderer();
     this.activeRenderers.add(renderer);
     this.activeByGuideId.set(guide.guideId, renderer);
@@ -926,7 +1113,7 @@ ${pageUrl}`;
       if (target < 0 || target >= steps.length) return;
       const step = steps[target];
       if (step && stepMatchesPage(step.pageLocation, pageUrl)) {
-        this.renderCompositeStep(guide, target, sessionId, pageUrl);
+        this.renderCompositeStep(guide, target, sessionId, pageUrl, badgeOpen);
       } else {
         this.pendingComposite = { guide, stepIndex: target };
       }
@@ -952,6 +1139,10 @@ ${pageUrl}`;
         onOpenGuide: (targetGuideId) => {
           void this.openGuideById(targetGuideId, sessionId, pageUrl);
         },
+        // Badge: cuando el MOTOR muestra la guía (automático, elemento objetivo
+        // o encadenada), el contenido se abre solo; el marcador queda para
+        // volver a verla. Solo `manual` deja el tooltip cerrado.
+        badgeOpen,
         ...nav ? { nav } : {}
       });
     } catch (err) {
@@ -1205,6 +1396,8 @@ ${pageUrl}`;
     this.dispatched.add(dedupKey);
     const cacheStatus = STATUS_BY_ACTION[event.action];
     if (cacheStatus) this.frequencyCache.record(guide.guideId, cacheStatus);
+    this.recordRepeatLocal(guide, event.action);
+    if (event.action === "dismissed" || event.action === "completed") this.resolveCache = null;
     const endUserId = this.client.getEndUserId();
     if (!endUserId) {
       if (this.debug)
@@ -1336,5 +1529,5 @@ function guidesPlugin(config) {
 }
 
 export { definePlugin, guidesPlugin, runPreviewMode };
-//# sourceMappingURL=chunk-JPANNXIK.mjs.map
-//# sourceMappingURL=chunk-JPANNXIK.mjs.map
+//# sourceMappingURL=chunk-HAAT6XVN.mjs.map
+//# sourceMappingURL=chunk-HAAT6XVN.mjs.map