@unhingged/vizu-core 0.1.21 → 0.1.23

package/dist/index.d.cts

@@ -731,6 +731,15 @@ declare class Vizu {
     disable(): void;
     toggle(): void;
     isEnabled(): boolean;
+    /**
+     * Kick the cloud sign-in flow. Call this alongside `enable()` from an
+     * explicit user gesture — a host-rendered launcher button, a menu item —
+     * so cloud-mode users get the sign-in popup immediately instead of only
+     * after clicking an element. The keyboard shortcut goes through this
+     * same path. No-op outside cloud mode, when already signed in, or when
+     * the workspace has already denied access this session.
+     */
+    requestAuth(): void;
     destroy(): void;
     addAction(action: VizuAction): void;
     removeAction(id: string): void;

package/dist/index.d.ts

@@ -731,6 +731,15 @@ declare class Vizu {
     disable(): void;
     toggle(): void;
     isEnabled(): boolean;
+    /**
+     * Kick the cloud sign-in flow. Call this alongside `enable()` from an
+     * explicit user gesture — a host-rendered launcher button, a menu item —
+     * so cloud-mode users get the sign-in popup immediately instead of only
+     * after clicking an element. The keyboard shortcut goes through this
+     * same path. No-op outside cloud mode, when already signed in, or when
+     * the workspace has already denied access this session.
+     */
+    requestAuth(): void;
     destroy(): void;
     addAction(action: VizuAction): void;
     removeAction(id: string): void;

package/dist/index.js

@@ -3688,14 +3688,7 @@ var Vizu = class {
         e.preventDefault();
         const wasEnabled = this.enabled;
         this.toggle();
-        if (!wasEnabled && this.enabled && this.storage instanceof CloudStorageAdapter) {
-          void this.storage.preflightAuth().catch((err) => {
-            if (err?.code === "auth_canceled" || err?.code === "popup_blocked") return;
-            if (typeof console !== "undefined") {
-              console.warn("[vizu] preflight auth failed:", err);
-            }
-          });
-        }
+        if (!wasEnabled && this.enabled) this.requestAuth();
       }
     };
     /* ===== Reposition on scroll/resize ===== */
@@ -3849,6 +3842,25 @@ var Vizu = class {
   isEnabled() {
     return this.enabled;
   }
+  /**
+   * Kick the cloud sign-in flow. Call this alongside `enable()` from an
+   * explicit user gesture — a host-rendered launcher button, a menu item —
+   * so cloud-mode users get the sign-in popup immediately instead of only
+   * after clicking an element. The keyboard shortcut goes through this
+   * same path. No-op outside cloud mode, when already signed in, or when
+   * the workspace has already denied access this session.
+   */
+  requestAuth() {
+    if (!(this.storage instanceof CloudStorageAdapter)) return;
+    if (this.user) return;
+    if (this.storage.isAccessDenied()) return;
+    void this.storage.preflightAuth().catch((err) => {
+      if (err?.code === "auth_canceled" || err?.code === "popup_blocked") return;
+      if (typeof console !== "undefined") {
+        console.warn("[vizu] preflight auth failed:", err);
+      }
+    });
+  }
   destroy() {
     this.disable();
     if (typeof window !== "undefined") window.removeEventListener("keydown", this.onKeyDown);