veo-sdk 0.6.2 → 0.6.3

package/dist/builder.d.cts

@@ -85,6 +85,14 @@ interface ElementPickerOptions {
     hint?: string;
     /** Subtítulo del banner (default: cómo abrir menús con Alt + clic). */
     subhint?: string;
+    /**
+     * `'interactive'`: solo se pueden elegir elementos interactivos (botones,
+     * enlaces, campos, formularios, controles ARIA…); al pasar sobre un hijo
+     * (p. ej. el `<span>` de un botón) se resalta el control que lo contiene, y
+     * sobre zonas no interactivas no se resalta ni se puede elegir nada.
+     * Default: cualquier elemento (anclas de guías).
+     */
+    only?: 'interactive';
 }
 interface ElementPickerHandle {
     /** Cierra el picker sin elegir nada. Idempotente. */
@@ -127,6 +135,14 @@ declare function stopElementPicker(): void;
  * de verdad; el chrome solo lo refleja y devuelve `chrome-action`s.
  */
 interface EditorChromeState {
+    /**
+     * `tagging` = «Modo tagging» (panel de features): solo la topbar, con ese
+     * título y sin fila de pasos, vista previa ni Guardar (cada tag se guarda al
+     * crearse). Default `guide` = editor de guías.
+     */
+    variant?: 'guide' | 'tagging';
+    /** Título del header de la tarjeta; si falta, el SDK lo deriva de la sección. */
+    panelTitle?: string;
     guideName: string;
     /** ISO de creación (null = guía nueva sin guardar). */
     createdAt: string | null;
@@ -286,16 +302,75 @@ type BuilderEvent = {
 } | {
     type: 'preview-status';
     payload: PreviewStatus;
+}
+/** Respuesta a `scan-page`: elementos clickeables de la página y qué selectores dados existen en ella. */
+ | {
+    type: 'page-scan';
+    payload: PageScan;
+}
+/** El autor cerró el modal de `show-confirmation`. */
+ | {
+    type: 'confirmation-closed';
 } | {
     type: 'closed';
 };
+/**
+ * Modal de confirmación que el SDK pinta CENTRADO sobre la app del cliente
+ * (mock «Feature tagueada»): check verde, título, mensaje, filas
+ * label/valor y un botón que lo cierra. Mientras está abierto el panel se
+ * oculta; al cerrarlo el SDK postea `confirmation-closed`.
+ */
+interface ConfirmationCard {
+    title: string;
+    message: string;
+    rows: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Texto del botón. Default «Listo». */
+    buttonLabel?: string;
+}
+/** Un elemento clickeable de la página (candidato a feature), sin `rect`. */
+type PageElement = Omit<PickedElement, 'rect'>;
+interface PageScan {
+    /** `location.pathname`: el mismo valor que `$page_path` de autocapture (restricción «Solo en esta página»). */
+    pagePath: string;
+    /**
+     * Ruta «humana» de la app: en apps con hash routing (`/#/settings`) incluye
+     * el hash; si no, es igual a `pagePath`. Para mostrar y para la foto del
+     * elemento, NO para contar (autocapture no lleva el hash).
+     */
+    routePath: string;
+    /** Elementos clickeables visibles que NO matchean ninguno de los `selectors` pedidos. */
+    candidates: PageElement[];
+    /** De los `selectors` pedidos, cuáles existen en esta página. */
+    present: string[];
+}
 /** Comandos que el dashboard/panel envía a la app del cliente. */
-type BuilderCommand = {
+type BuilderCommand = 
+/** `only: 'interactive'` (features): solo botones/enlaces/campos/formularios… (ver `ElementPickerOptions.only`). */
+{
     type: 'start-picker';
     maxAncestors?: number;
     hint?: string;
+    only?: 'interactive';
 } | {
     type: 'stop-picker';
+}
+/** Panel de features: inventario de la página actual (ver `PageScan`). */
+ | {
+    type: 'scan-page';
+    selectors: string[];
+}
+/** Resalta (o deja de resaltar) un elemento por selector, sin entrar en modo picker. */
+ | {
+    type: 'highlight';
+    selector: string | null;
+}
+/** Modal de confirmación centrado sobre la app (ver `ConfirmationCard`). */
+ | {
+    type: 'show-confirmation';
+    payload: ConfirmationCard;
 } | {
     type: 'preview';
     guide: PreviewGuideInput;
@@ -360,11 +435,6 @@ interface BuilderModeHandle {
     /** Desconecta el puente y limpia picker/preview/panel. */
     teardown(): void;
 }
-/**
- * Inicializa el modo builder si hay contexto (URL o persistido). Devuelve un
- * handle, o `null` si no estamos en modo builder o no hay canal con el editor.
- * Es seguro llamarla siempre.
- */
 declare function initBuilderMode(): BuilderModeHandle | null;
 
 interface BuilderSessionOptions {

package/dist/builder.d.ts

@@ -85,6 +85,14 @@ interface ElementPickerOptions {
     hint?: string;
     /** Subtítulo del banner (default: cómo abrir menús con Alt + clic). */
     subhint?: string;
+    /**
+     * `'interactive'`: solo se pueden elegir elementos interactivos (botones,
+     * enlaces, campos, formularios, controles ARIA…); al pasar sobre un hijo
+     * (p. ej. el `<span>` de un botón) se resalta el control que lo contiene, y
+     * sobre zonas no interactivas no se resalta ni se puede elegir nada.
+     * Default: cualquier elemento (anclas de guías).
+     */
+    only?: 'interactive';
 }
 interface ElementPickerHandle {
     /** Cierra el picker sin elegir nada. Idempotente. */
@@ -127,6 +135,14 @@ declare function stopElementPicker(): void;
  * de verdad; el chrome solo lo refleja y devuelve `chrome-action`s.
  */
 interface EditorChromeState {
+    /**
+     * `tagging` = «Modo tagging» (panel de features): solo la topbar, con ese
+     * título y sin fila de pasos, vista previa ni Guardar (cada tag se guarda al
+     * crearse). Default `guide` = editor de guías.
+     */
+    variant?: 'guide' | 'tagging';
+    /** Título del header de la tarjeta; si falta, el SDK lo deriva de la sección. */
+    panelTitle?: string;
     guideName: string;
     /** ISO de creación (null = guía nueva sin guardar). */
     createdAt: string | null;
@@ -286,16 +302,75 @@ type BuilderEvent = {
 } | {
     type: 'preview-status';
     payload: PreviewStatus;
+}
+/** Respuesta a `scan-page`: elementos clickeables de la página y qué selectores dados existen en ella. */
+ | {
+    type: 'page-scan';
+    payload: PageScan;
+}
+/** El autor cerró el modal de `show-confirmation`. */
+ | {
+    type: 'confirmation-closed';
 } | {
     type: 'closed';
 };
+/**
+ * Modal de confirmación que el SDK pinta CENTRADO sobre la app del cliente
+ * (mock «Feature tagueada»): check verde, título, mensaje, filas
+ * label/valor y un botón que lo cierra. Mientras está abierto el panel se
+ * oculta; al cerrarlo el SDK postea `confirmation-closed`.
+ */
+interface ConfirmationCard {
+    title: string;
+    message: string;
+    rows: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Texto del botón. Default «Listo». */
+    buttonLabel?: string;
+}
+/** Un elemento clickeable de la página (candidato a feature), sin `rect`. */
+type PageElement = Omit<PickedElement, 'rect'>;
+interface PageScan {
+    /** `location.pathname`: el mismo valor que `$page_path` de autocapture (restricción «Solo en esta página»). */
+    pagePath: string;
+    /**
+     * Ruta «humana» de la app: en apps con hash routing (`/#/settings`) incluye
+     * el hash; si no, es igual a `pagePath`. Para mostrar y para la foto del
+     * elemento, NO para contar (autocapture no lleva el hash).
+     */
+    routePath: string;
+    /** Elementos clickeables visibles que NO matchean ninguno de los `selectors` pedidos. */
+    candidates: PageElement[];
+    /** De los `selectors` pedidos, cuáles existen en esta página. */
+    present: string[];
+}
 /** Comandos que el dashboard/panel envía a la app del cliente. */
-type BuilderCommand = {
+type BuilderCommand = 
+/** `only: 'interactive'` (features): solo botones/enlaces/campos/formularios… (ver `ElementPickerOptions.only`). */
+{
     type: 'start-picker';
     maxAncestors?: number;
     hint?: string;
+    only?: 'interactive';
 } | {
     type: 'stop-picker';
+}
+/** Panel de features: inventario de la página actual (ver `PageScan`). */
+ | {
+    type: 'scan-page';
+    selectors: string[];
+}
+/** Resalta (o deja de resaltar) un elemento por selector, sin entrar en modo picker. */
+ | {
+    type: 'highlight';
+    selector: string | null;
+}
+/** Modal de confirmación centrado sobre la app (ver `ConfirmationCard`). */
+ | {
+    type: 'show-confirmation';
+    payload: ConfirmationCard;
 } | {
     type: 'preview';
     guide: PreviewGuideInput;
@@ -360,11 +435,6 @@ interface BuilderModeHandle {
     /** Desconecta el puente y limpia picker/preview/panel. */
     teardown(): void;
 }
-/**
- * Inicializa el modo builder si hay contexto (URL o persistido). Devuelve un
- * handle, o `null` si no estamos en modo builder o no hay canal con el editor.
- * Es seguro llamarla siempre.
- */
 declare function initBuilderMode(): BuilderModeHandle | null;
 
 interface BuilderSessionOptions {

package/dist/builder.mjs

@@ -1,7 +1,7 @@
-import './chunk-L3QQJLDJ.mjs';
-import { initBuilderMode } from './chunk-4QZDNJJE.mjs';
-export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-4QZDNJJE.mjs';
-export { closeGuidePreview, previewGuide } from './chunk-ZILDR4YE.mjs';
+import './chunk-3JEAPZ6A.mjs';
+import { initBuilderMode } from './chunk-DU6I4ZU2.mjs';
+export { createBuilderSession, initBuilderMode, startElementPicker, stopElementPicker } from './chunk-DU6I4ZU2.mjs';
+export { closeGuidePreview, previewGuide } from './chunk-SZCIXA5X.mjs';
 import './chunk-PTG3BTJE.mjs';
 
 // src/builder.ts

package/dist/{chunk-L3QQJLDJ.mjs → chunk-3JEAPZ6A.mjs}

@@ -1,4 +1,4 @@
-import { hasDocument, hasWindow, isAutomaticActivation, activationDelayMs, clearPreviewToken, DEFAULT_TRACKER_MAX_RETRIES, DEFAULT_TRACKER_BATCH_SIZE, DEFAULT_TRACKER_FLUSH_INTERVAL_MS, isDeviceAllowed, isSnoozed, 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-ZILDR4YE.mjs';
+import { hasDocument, hasWindow, isAutomaticActivation, activationDelayMs, clearPreviewToken, DEFAULT_TRACKER_MAX_RETRIES, DEFAULT_TRACKER_BATCH_SIZE, DEFAULT_TRACKER_FLUSH_INTERVAL_MS, isDeviceAllowed, isSnoozed, 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-SZCIXA5X.mjs';
 
 // src/plugins/plugin.ts
 function definePlugin(plugin) {
@@ -1616,5 +1616,5 @@ function guidesPlugin(config) {
 }
 
 export { definePlugin, guidesPlugin, runPreviewMode };
-//# sourceMappingURL=chunk-L3QQJLDJ.mjs.map
-//# sourceMappingURL=chunk-L3QQJLDJ.mjs.map
+//# sourceMappingURL=chunk-3JEAPZ6A.mjs.map
+//# sourceMappingURL=chunk-3JEAPZ6A.mjs.map