veo-sdk 0.5.32 → 0.5.33

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-C73rKO0u.cjs';
+export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-C73rKO0u.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-C73rKO0u.js';
+export { a as PreviewHandle, b as PreviewResult, c as closeGuidePreview, p as previewGuide } from './guide-preview-C73rKO0u.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-FZ72JUAR.mjs';
+import { initBuilderMode } from './chunk-3ZOKCQ54.mjs';
+export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-3ZOKCQ54.mjs';
+export { closeGuidePreview, previewGuide } from './chunk-M6PB5UMW.mjs';
 import './chunk-PTG3BTJE.mjs';
 
 // src/builder.ts