@mochabug/adapt-web 1.0.1-rc.21 → 1.0.1-rc.22

package/dist/umd/adapt-web.core.js

@@ -10950,8 +10950,21 @@ html.mb-dragging webview {
       }
     }
     // --- Lifecycle ---
+    /**
+     * Explicitly initialize the element after all properties are set.
+     * Framework wrappers (React, Vue, Svelte, Angular, Astro) MUST call this
+     * after setting non-serializable properties like `signals`, `inheritFrom`, etc.
+     *
+     * For plain HTML usage without a framework, the element auto-initializes
+     * when `automation-id` is set (via `attributeChangedCallback`).
+     *
+     * Idempotent — safe to call multiple times. Only creates the client once.
+     */
+    initialize() {
+      this._tryInit();
+    }
     connectedCallback() {
-      queueMicrotask(() => this._tryInit());
+      requestAnimationFrame(() => this._tryInit());
     }
     disconnectedCallback() {
       this._destroyClient();
@@ -10960,7 +10973,7 @@ html.mb-dragging webview {
       if (oldValue === newValue) return;
       if (name === "automation-id" || name === "persist" || name === "debug") {
         this._destroyClient();
-        queueMicrotask(() => this._tryInit());
+        requestAnimationFrame(() => this._tryInit());
         return;
       }
       if (!this._client) return;
@@ -11083,21 +11096,37 @@ html.mb-dragging webview {
       if (challengeToken) options.challengeToken = challengeToken;
       if (requiresChallenge) options.requiresChallenge = true;
       if (inheritToken) options.inheritToken = inheritToken;
-      if (this.signals !== void 0) options.signals = this.signals;
-      if (this.capWidgetOptions !== void 0)
-        options.capWidgetOptions = this.capWidgetOptions;
-      if (this.inheritFrom !== void 0) options.inheritFrom = this.inheritFrom;
-      if (this.classNames !== void 0) options.classNames = this.classNames;
+      const signals = this.signals ?? this._parseData("adaptSignals");
+      const capWidgetOptions = this.capWidgetOptions ?? this._parseData("adaptCapWidgetOptions");
+      const inheritFrom = this.inheritFrom ?? this._parseData("adaptInheritFrom");
+      const classNames = this.classNames ?? this._parseData("adaptClassNames");
+      const text = this.text ?? this._parseData("adaptText");
+      const theme = this._theme ?? this._parseData("adaptTheme");
+      const persistOptions = this.persistOptions ?? this._parseData("adaptPersistOptions");
+      if (signals !== void 0) options.signals = signals;
+      if (capWidgetOptions !== void 0)
+        options.capWidgetOptions = capWidgetOptions;
+      if (inheritFrom !== void 0) options.inheritFrom = inheritFrom;
+      if (classNames !== void 0) options.classNames = classNames;
       if (this.styles !== void 0) options.styles = this.styles;
-      if (this.text !== void 0) options.text = this.text;
-      if (this._theme !== void 0) options.theme = this._theme;
-      if (this.persistOptions !== void 0) {
-        options.persist = this.persistOptions;
+      if (text !== void 0) options.text = text;
+      if (theme !== void 0) options.theme = theme;
+      if (persistOptions !== void 0) {
+        options.persist = persistOptions;
       } else if (this.persist) {
         options.persist = true;
       }
       this._client = new AdaptWebClient(options);
     }
+    _parseData(key) {
+      const raw = this.dataset[key];
+      if (!raw) return void 0;
+      try {
+        return JSON.parse(raw);
+      } catch {
+        return void 0;
+      }
+    }
     _destroyClient() {
       if (this._client) {
         this._client.destroy();