veo-sdk 0.5.32 → 0.5.34

package/dist/{guide-preview-XUnTmzUO.d.cts → guide-preview-DbEZdGBV.d.cts}

@@ -34,7 +34,7 @@ interface CustomPlacement {
     height?: number | string;
 }
 type UrlMatchType = 'exact' | 'prefix' | 'regex';
-type ActivationTrigger = 'immediate' | 'on_element' | 'on_event' | 'delayed' | 'on_click' | 'on_hover';
+type ActivationTrigger = 'immediate' | 'on_element' | 'on_event' | 'delayed' | 'on_click' | 'on_hover' | 'manual';
 type CtaAction = 'dismiss' | 'next' | 'url' | 'guide';
 /**
  * Acciones de un bloque `button` en el modelo unificado (estilo Pendo). Superset
@@ -45,12 +45,42 @@ interface UrlMatcher {
     type: UrlMatchType;
     pattern: string;
 }
+type RepeatUnit = 'minute' | 'hour' | 'day' | 'week';
+type ActivationDevices = 'all' | 'desktop' | 'mobile';
+/** «Repetir la aparición»: el intervalo y el tope los aplica el BACKEND en el
+ *  resolve; el SDK usa `onLoad` (retomar el último paso visto). */
+interface ActivationRepeat {
+    every: number;
+    unit: RepeatUnit;
+    stopAfter: {
+        kind: 'never';
+    } | {
+        kind: 'dismissals';
+        count: number;
+    } | {
+        kind: 'completed';
+    };
+    onLoad: 'restart' | 'resume';
+}
 interface ActivationRules {
     url: UrlMatcher;
     trigger: ActivationTrigger;
     selector?: string;
     eventName?: string;
     delayMs?: number;
+    /**
+     * Con `on_click`/`on_hover`: además de abrirse al interactuar con el
+     * elemento objetivo, la guía arranca sola al cargar (Automático + Elemento
+     * objetivo). `delayMs` aplica a ese arranque automático.
+     */
+    autoShow?: boolean | null;
+    repeat?: ActivationRepeat | null;
+    /** En qué dispositivos se muestra; lo filtra el SDK (`isDeviceAllowed`). */
+    devices?: ActivationDevices | null;
+    /** Solo editor: cómo se derivó `selector` (sugerido/padre/custom/heredado del paso 1). */
+    targetMode?: 'suggested' | 'parent' | 'custom' | 'inherit' | null;
+    /** Solo editor: selector tal como lo devolvió el picker (base de los modos). */
+    targetBase?: string | null;
 }
 /** Tipo de un bloque de contenido (para pasos con varios títulos/textos/botones). */
 type StepBlockType = 'title' | 'text' | 'button' | 'image' | 'code' | 'form';
@@ -152,6 +182,18 @@ interface PreviewGuideInput {
     formSubmit?: (answers: Record<string, unknown>) => Promise<boolean>;
     /** Nota bajo el "¡Gracias!" cuando hay `formSubmit` propio. */
     formSubmitNote?: string;
+    /** Modo badge: montar con el tooltip ABIERTO (toggle del editor). */
+    /**
+     * Badge: tooltip abierto (true) o cerrado (false). Sin definir, se abre si la
+     * activación es automática (igual que el runtime).
+     */
+    badgeOpen?: boolean;
+    /**
+     * Se llama cuando el USUARIO cierra la preview (✕ / descartar), no cuando el
+     * editor la reemplaza por otra. El modo builder lo usa para re-armar el
+     * disparador por elemento objetivo.
+     */
+    onClosed?: () => void;
 }
 /** Resultado del primer render de una preview. */
 interface PreviewResult {

package/dist/{guide-preview-XUnTmzUO.d.ts → guide-preview-DbEZdGBV.d.ts}

@@ -34,7 +34,7 @@ interface CustomPlacement {
     height?: number | string;
 }
 type UrlMatchType = 'exact' | 'prefix' | 'regex';
-type ActivationTrigger = 'immediate' | 'on_element' | 'on_event' | 'delayed' | 'on_click' | 'on_hover';
+type ActivationTrigger = 'immediate' | 'on_element' | 'on_event' | 'delayed' | 'on_click' | 'on_hover' | 'manual';
 type CtaAction = 'dismiss' | 'next' | 'url' | 'guide';
 /**
  * Acciones de un bloque `button` en el modelo unificado (estilo Pendo). Superset
@@ -45,12 +45,42 @@ interface UrlMatcher {
     type: UrlMatchType;
     pattern: string;
 }
+type RepeatUnit = 'minute' | 'hour' | 'day' | 'week';
+type ActivationDevices = 'all' | 'desktop' | 'mobile';
+/** «Repetir la aparición»: el intervalo y el tope los aplica el BACKEND en el
+ *  resolve; el SDK usa `onLoad` (retomar el último paso visto). */
+interface ActivationRepeat {
+    every: number;
+    unit: RepeatUnit;
+    stopAfter: {
+        kind: 'never';
+    } | {
+        kind: 'dismissals';
+        count: number;
+    } | {
+        kind: 'completed';
+    };
+    onLoad: 'restart' | 'resume';
+}
 interface ActivationRules {
     url: UrlMatcher;
     trigger: ActivationTrigger;
     selector?: string;
     eventName?: string;
     delayMs?: number;
+    /**
+     * Con `on_click`/`on_hover`: además de abrirse al interactuar con el
+     * elemento objetivo, la guía arranca sola al cargar (Automático + Elemento
+     * objetivo). `delayMs` aplica a ese arranque automático.
+     */
+    autoShow?: boolean | null;
+    repeat?: ActivationRepeat | null;
+    /** En qué dispositivos se muestra; lo filtra el SDK (`isDeviceAllowed`). */
+    devices?: ActivationDevices | null;
+    /** Solo editor: cómo se derivó `selector` (sugerido/padre/custom/heredado del paso 1). */
+    targetMode?: 'suggested' | 'parent' | 'custom' | 'inherit' | null;
+    /** Solo editor: selector tal como lo devolvió el picker (base de los modos). */
+    targetBase?: string | null;
 }
 /** Tipo de un bloque de contenido (para pasos con varios títulos/textos/botones). */
 type StepBlockType = 'title' | 'text' | 'button' | 'image' | 'code' | 'form';
@@ -152,6 +182,18 @@ interface PreviewGuideInput {
     formSubmit?: (answers: Record<string, unknown>) => Promise<boolean>;
     /** Nota bajo el "¡Gracias!" cuando hay `formSubmit` propio. */
     formSubmitNote?: string;
+    /** Modo badge: montar con el tooltip ABIERTO (toggle del editor). */
+    /**
+     * Badge: tooltip abierto (true) o cerrado (false). Sin definir, se abre si la
+     * activación es automática (igual que el runtime).
+     */
+    badgeOpen?: boolean;
+    /**
+     * Se llama cuando el USUARIO cierra la preview (✕ / descartar), no cuando el
+     * editor la reemplaza por otra. El modo builder lo usa para re-armar el
+     * disparador por elemento objetivo.
+     */
+    onClosed?: () => void;
 }
 /** Resultado del primer render de una preview. */
 interface PreviewResult {