@returningai/widget-sdk 1.8.1 → 1.8.2

package/dist/rai-widget.js

@@ -12689,12 +12689,31 @@ function waitWithTimeout(promise, timeoutMs, timeoutMessage) {
     );
   });
 }
-async function waitForBundleMountReadiness(mountResult, firstPaint, timeoutMs = BUNDLE_READY_TIMEOUT_MS) {
-  const resolvedMountResult = isPromiseLike(mountResult) ? await waitWithTimeout(
+function resolveBundleMountResult(mountResult, timeoutMs = BUNDLE_READY_TIMEOUT_MS) {
+  return isPromiseLike(mountResult) ? waitWithTimeout(
     mountResult,
     timeoutMs,
     `Widget bundle mount did not resolve within ${timeoutMs}ms`
-  ) : mountResult;
+  ) : Promise.resolve(mountResult);
+}
+function createBundleMountCleanup(mountResult) {
+  if (typeof mountResult !== "object" || mountResult === null || !("unmount" in mountResult)) {
+    return void 0;
+  }
+  const unmount = mountResult.unmount;
+  if (typeof unmount !== "function") return void 0;
+  let unmounted = false;
+  return () => {
+    if (unmounted) return;
+    unmounted = true;
+    unmount.call(mountResult);
+  };
+}
+async function waitForBundleMountReadiness(mountResult, firstPaint, timeoutMs = BUNDLE_READY_TIMEOUT_MS) {
+  const resolvedMountResult = await resolveBundleMountResult(
+    mountResult,
+    timeoutMs
+  );
   if (!isReadyHandle(resolvedMountResult)) {
     await firstPaint;
     return "first-paint";
@@ -12706,11 +12725,51 @@ async function waitForBundleMountReadiness(mountResult, firstPaint, timeoutMs =
   );
   return "deep-ready";
 }
+const MAX_PRELOAD_ASSETS = 24;
+function resolveBundlePreloadAssets(bundleUrl, manifest) {
+  if (manifest.version !== 1) return [];
+  const normalizedBundleUrl = new URL(bundleUrl);
+  const bundleDirectory = new URL("./", normalizedBundleUrl);
+  const candidates = [
+    ...(Array.isArray(manifest.scripts) ? manifest.scripts : []).map((value) => ({
+      value,
+      rel: "modulepreload",
+      as: "script",
+      extension: ".js"
+    })),
+    ...(Array.isArray(manifest.styles) ? manifest.styles : []).map((value) => ({
+      value,
+      rel: "preload",
+      as: "style",
+      extension: ".css"
+    }))
+  ];
+  const seen = /* @__PURE__ */ new Set();
+  const assets = [];
+  for (const candidate of candidates) {
+    if (assets.length >= MAX_PRELOAD_ASSETS) break;
+    if (typeof candidate.value !== "string") continue;
+    let resolved;
+    try {
+      resolved = new URL(candidate.value, bundleDirectory);
+    } catch {
+      continue;
+    }
+    if (resolved.origin !== bundleDirectory.origin || !resolved.pathname.startsWith(bundleDirectory.pathname) || !resolved.pathname.endsWith(candidate.extension) || seen.has(resolved.href)) {
+      continue;
+    }
+    seen.add(resolved.href);
+    assets.push({ url: resolved.href, rel: candidate.rel, as: candidate.as });
+  }
+  return assets;
+}
 function createBundleRuntimeWarmer({
   preloadScript: preloadScript2,
+  preloadBundleAssets: preloadBundleAssets2,
   baseUrl
 }) {
   const preloadPromises = /* @__PURE__ */ new Map();
+  const deepPreloadPromises = /* @__PURE__ */ new Map();
   return function warmBundleRuntime2(globalName, bundleUrl) {
     const normalizedUrl = normalizeBundleUrl(bundleUrl, baseUrl());
     if (preloadPromises.has(normalizedUrl)) return;
@@ -12718,6 +12777,12 @@ function createBundleRuntimeWarmer({
       preloadPromises.delete(normalizedUrl);
     });
     preloadPromises.set(normalizedUrl, preloadPromise);
+    if (preloadBundleAssets2 && !deepPreloadPromises.has(normalizedUrl)) {
+      const deepPreloadPromise = preloadBundleAssets2(normalizedUrl).catch(() => {
+        deepPreloadPromises.delete(normalizedUrl);
+      });
+      deepPreloadPromises.set(normalizedUrl, deepPreloadPromise);
+    }
   };
 }
 function isWidgetBundleRuntime(value) {
@@ -12797,6 +12862,35 @@ function preloadScript(url) {
     document.head.appendChild(link);
   });
 }
+const preloadedBundleAssets = /* @__PURE__ */ new Set();
+function appendBundleAssetPreload(asset) {
+  const cacheKey = `${asset.rel}:${asset.url}`;
+  if (preloadedBundleAssets.has(cacheKey)) return;
+  const link = document.createElement("link");
+  link.rel = asset.rel;
+  link.as = asset.as;
+  link.href = asset.url;
+  link.crossOrigin = "anonymous";
+  link.onload = () => void 0;
+  link.onerror = () => {
+    preloadedBundleAssets.delete(cacheKey);
+    link.remove();
+  };
+  preloadedBundleAssets.add(cacheKey);
+  document.head.appendChild(link);
+}
+async function preloadBundleAssets(bundleUrl) {
+  const manifestUrl = new URL("./preload-manifest.json", bundleUrl);
+  const response = await fetch(manifestUrl, {
+    credentials: "omit",
+    headers: { Accept: "application/json" }
+  });
+  if (!response.ok) throw new Error(`Bundle preload manifest returned ${response.status}`);
+  const manifest = await response.json();
+  for (const asset of resolveBundlePreloadAssets(bundleUrl, manifest)) {
+    appendBundleAssetPreload(asset);
+  }
+}
 const loadBrowserBundleRuntime = createBundleRuntimeLoader({
   loadScript: appendScript,
   readGlobal: (globalName) => window[globalName],
@@ -12804,6 +12898,7 @@ const loadBrowserBundleRuntime = createBundleRuntimeLoader({
 });
 const warmBrowserBundleRuntime = createBundleRuntimeWarmer({
   preloadScript,
+  preloadBundleAssets,
   baseUrl: () => document.baseURI
 });
 function warmBundleRuntime(globalName, bundleUrl) {
@@ -13059,6 +13154,100 @@ function dispatchHostCallback(input) {
     }
   );
 }
+const SUPPORTED_WIDGET_LANGUAGES = [
+  "en",
+  "de",
+  "es",
+  "fr",
+  "it",
+  "pt",
+  "pl",
+  "da",
+  "nl",
+  "ru",
+  "chs",
+  "el",
+  "ko",
+  "cht",
+  "th",
+  "ja",
+  "id",
+  "vt",
+  "ms",
+  "hi",
+  "fil",
+  "ta",
+  "tr",
+  "ar",
+  "mn",
+  "sw"
+];
+const supportedWidgetLanguages = new Set(SUPPORTED_WIDGET_LANGUAGES);
+const warnedUnsupportedLanguages = /* @__PURE__ */ new Set();
+const LANGUAGE_TAG_PATTERN = /^[a-z]{2,8}(?:-[a-z0-9]{1,8})*$/;
+function resolveWidgetLanguage(language) {
+  const normalized = language == null ? void 0 : language.trim().toLowerCase().replace(/_/g, "-");
+  if (!normalized || !LANGUAGE_TAG_PATTERN.test(normalized)) return void 0;
+  const segments = normalized.split("-");
+  const primaryLanguage = segments[0];
+  if (primaryLanguage === "zh") {
+    if (segments.includes("hant")) {
+      return "cht";
+    }
+    if (segments.includes("hans")) {
+      return "chs";
+    }
+    if (segments.includes("tw") || segments.includes("hk") || segments.includes("mo")) {
+      return "cht";
+    }
+    if (segments.includes("cn") || segments.includes("sg")) {
+      return "chs";
+    }
+    return void 0;
+  }
+  if (primaryLanguage === "vi" || primaryLanguage === "vt") {
+    return "vt";
+  }
+  return supportedWidgetLanguages.has(primaryLanguage) ? primaryLanguage : void 0;
+}
+function warnUnsupportedWidgetLanguage(language) {
+  const value = language.trim();
+  if (!value) return;
+  const warningKey = value.toLowerCase();
+  if (warnedUnsupportedLanguages.has(warningKey)) return;
+  warnedUnsupportedLanguages.add(warningKey);
+  console.warn(
+    `[rai-widget] Unsupported language "${value.slice(
+      0,
+      80
+    )}". Falling back to the browser language. Supported language codes: ${SUPPORTED_WIDGET_LANGUAGES.join(
+      ", "
+    )}.`
+  );
+}
+const PERCENTAGE_HEIGHT = /^(\d+(?:\.\d+)?)%$/;
+function parsePercentageHeight(value) {
+  const match = value.trim().match(PERCENTAGE_HEIGHT);
+  if (!match) return null;
+  const percentage = Number(match[1]);
+  return Number.isFinite(percentage) && percentage > 0 ? percentage : null;
+}
+function resolvePercentageViewportHeight(value, viewportHeight) {
+  const percentage = parsePercentageHeight(value);
+  return percentage === null ? 0 : viewportHeight * percentage / 100;
+}
+function resolveCollapsedRestoredHeight({
+  originalHeight,
+  restoredHeight,
+  resolvedHeight,
+  isRendered
+}) {
+  if (!isRendered || Number.isFinite(restoredHeight) && restoredHeight > 0) {
+    return null;
+  }
+  const percentage = parsePercentageHeight(originalHeight);
+  return percentage === null ? `${resolvedHeight}px` : `${percentage}vh`;
+}
 function debounce(fn, wait) {
   let timer = null;
   return {
@@ -13213,6 +13402,54 @@ function setupMessageListener(config, state, _shadow, iframe, onRefreshScheduled
     heightSetter.cancel();
   };
 }
+async function resolveStartupAuthentication(authentication, loadErrorSettings) {
+  const authenticated = await authentication;
+  if (authenticated) {
+    void loadErrorSettings({ skipCache: true }).catch(() => {
+    });
+    return true;
+  }
+  try {
+    await loadErrorSettings();
+  } catch {
+  }
+  return false;
+}
+function resolveWidgetPreconnectOrigins(config, baseUrl) {
+  const values = [
+    config.apiUrl,
+    config.v2ApiUrl,
+    config.authUrl,
+    config.bundleUrl,
+    config.widgetUrl,
+    config.widgetDomain
+  ];
+  const origins = [];
+  for (const value of values) {
+    if (!value) continue;
+    try {
+      const url = new URL(value, baseUrl);
+      if ((url.protocol === "http:" || url.protocol === "https:") && !origins.includes(url.origin)) {
+        origins.push(url.origin);
+      }
+    } catch {
+    }
+  }
+  return origins;
+}
+function ensureWidgetPreconnects(origins, targetDocument) {
+  const documentTarget = document;
+  for (const origin of origins) {
+    const id = `rai-widget-preconnect-${origin.replace(/[^a-z0-9]+/gi, "-")}`;
+    if (documentTarget.getElementById(id)) continue;
+    const link = documentTarget.createElement("link");
+    link.id = id;
+    link.rel = "preconnect";
+    link.href = origin;
+    link.crossOrigin = "anonymous";
+    documentTarget.head.appendChild(link);
+  }
+}
 const widgetCSS = ':host{display:block;position:relative;width:100%;height:100%}.rai-loader{position:absolute;top:0;left:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:.75rem;width:100%;height:100%;background:var(--rai-loading-background, var(--background-5, var(--rai-loader-bg, #ffffff)));border-radius:8px;z-index:10;transition:opacity .3s ease-out;font-family:var(--rai-loader-font, "Roboto", system-ui, -apple-system, sans-serif)}.rai-loader.fade-out{opacity:0;pointer-events:none}.rai-loader-pending-settings{visibility:hidden}.rai-loader-text{margin:.5rem 0 0;font-family:var(--rai-loading-text-font, var(--rai-loader-font, "Roboto", system-ui, -apple-system, sans-serif));font-size:var(--rai-loading-text-size, 1.125rem);line-height:1.75rem;font-weight:var(--rai-loading-text-weight, 400);font-style:var(--rai-loading-text-style, normal);text-decoration:var(--rai-loading-text-decoration, none);letter-spacing:normal;color:var(--rai-loading-text-color, var(--accent-1, var(--rai-accent, #000000)));text-align:center}@media (min-width: 768px){.rai-loader-text{font-size:var(--rai-loading-text-size, 1.5rem);line-height:2rem}}.rai-error{display:none;position:absolute;top:0;left:0;width:100%;height:100%;align-items:center;justify-content:center;flex-direction:column;gap:12px;background:var(--rai-error-bg, #1a1a1a);border-radius:8px;padding:24px;box-sizing:border-box;text-align:center;color:var(--rai-error-text, #9ca3af);font-family:system-ui,-apple-system,sans-serif;z-index:10}.rai-error.visible{display:flex}iframe{display:block;border:none;opacity:0;transition:opacity .3s ease-in}iframe.loaded{opacity:1}.rai-lottie-loader{width:100px;height:100px}.rai-lottie-loader svg{width:100%!important;height:100%!important}.rai-lottie-spinner{width:32px;height:32px;margin:34px auto;border:3px solid var(--rai-text4, #6b7280);border-top-color:var(--rai-accent, #000000);border-radius:50%;animation:rai-spin .7s linear infinite}@keyframes rai-spin{to{transform:rotate(360deg)}}.rai-sdk-loader{position:relative;width:75px;height:100px}.rai-sdk-loader__bar{position:absolute;bottom:0;width:10px;height:50%;background:var(--rai-accent, #000000);transform-origin:center bottom;box-shadow:1px 1px #0003}.rai-sdk-loader__bar:nth-child(1){left:0;transform:scaleY(.2);animation:rai-sdk-barUp1 4s infinite}.rai-sdk-loader__bar:nth-child(2){left:15px;transform:scaleY(.4);animation:rai-sdk-barUp2 4s infinite}.rai-sdk-loader__bar:nth-child(3){left:30px;transform:scaleY(.6);animation:rai-sdk-barUp3 4s infinite}.rai-sdk-loader__bar:nth-child(4){left:45px;transform:scaleY(.8);animation:rai-sdk-barUp4 4s infinite}.rai-sdk-loader__bar:nth-child(5){left:60px;transform:scale(1);animation:rai-sdk-barUp5 4s infinite}.rai-sdk-loader__ball{position:absolute;bottom:10px;left:0;width:10px;height:10px;background:var(--rai-accent, #000000);border-radius:50%;animation:rai-sdk-ball 4s infinite}@keyframes rai-sdk-ball{0%{transform:translate(0)}5%{transform:translate(8px,-14px)}10%{transform:translate(15px,-10px)}17%{transform:translate(23px,-24px)}20%{transform:translate(30px,-20px)}27%{transform:translate(38px,-34px)}30%{transform:translate(45px,-30px)}37%{transform:translate(53px,-44px)}40%{transform:translate(60px,-40px)}50%{transform:translate(60px)}57%{transform:translate(53px,-14px)}60%{transform:translate(45px,-10px)}67%{transform:translate(37px,-24px)}70%{transform:translate(30px,-20px)}77%{transform:translate(22px,-34px)}80%{transform:translate(15px,-30px)}87%{transform:translate(7px,-44px)}90%{transform:translateY(-40px)}to{transform:translate(0)}}@keyframes rai-sdk-barUp1{0%{transform:scaleY(.2)}40%{transform:scaleY(.2)}50%{transform:scale(1)}90%{transform:scale(1)}to{transform:scaleY(.2)}}@keyframes rai-sdk-barUp2{0%{transform:scaleY(.4)}40%{transform:scaleY(.4)}50%{transform:scaleY(.8)}90%{transform:scaleY(.8)}to{transform:scaleY(.4)}}@keyframes rai-sdk-barUp3{0%{transform:scaleY(.6)}to{transform:scaleY(.6)}}@keyframes rai-sdk-barUp4{0%{transform:scaleY(.8)}40%{transform:scaleY(.8)}50%{transform:scaleY(.4)}90%{transform:scaleY(.4)}to{transform:scaleY(.8)}}@keyframes rai-sdk-barUp5{0%{transform:scale(1)}40%{transform:scale(1)}50%{transform:scaleY(.2)}90%{transform:scaleY(.2)}to{transform:scale(1)}}#loading-square{width:75px;aspect-ratio:1;display:flex;color:var(--rai-accent, #000000);background:linear-gradient(currentColor 0 0) right / 51% 100%,linear-gradient(currentColor 0 0) bottom / 100% 51%;background-repeat:no-repeat;animation:l16-0 2s infinite linear .25s}#loading-square>div{width:50%;height:50%;background:currentColor;animation:l16-1 .5s infinite linear}@keyframes l16-0{0%,12.49%{transform:rotate(0)}12.5%,37.49%{transform:rotate(90deg)}37.5%,62.49%{transform:rotate(180deg)}62.5%,87.49%{transform:rotate(270deg)}87.5%,to{transform:rotate(360deg)}}@keyframes l16-1{0%{transform:perspective(80px) rotate3d(-1,-1,0,0)}80%,to{transform:perspective(80px) rotate3d(-1,-1,0,-180deg)}}#loading-circle{width:75px;aspect-ratio:1;display:grid;grid:50%/50%;color:var(--rai-accent, #000000);border-radius:50%;--_g: no-repeat linear-gradient(currentColor 0 0);background:var(--_g),var(--_g),var(--_g);background-size:50.1% 50.1%;animation:l9-0 1.5s infinite steps(1) alternate,l9-0-0 3s infinite steps(1) alternate}#loading-circle>div{background:var(--rai-text4, #6b7280);border-top-left-radius:100px;transform:perspective(150px) rotateY(0) rotateX(0);transform-origin:bottom right;animation:l9-1 1.5s infinite linear alternate}@keyframes l9-0{0%{background-position:0 100%,100% 100%,100% 0}33%{background-position:100% 100%,100% 100%,100% 0}66%{background-position:100% 0,100% 0,100% 0}}@keyframes l9-0-0{0%{transform:scaleX(1) rotate(0)}50%{transform:scaleX(-1) rotate(-90deg)}}@keyframes l9-1{16.5%{transform:perspective(150px) rotateX(-90deg) rotateY(0) rotateX(0);filter:grayscale(.8)}33%{transform:perspective(150px) rotateX(-180deg) rotateY(0) rotateX(0)}66%{transform:perspective(150px) rotateX(-180deg) rotateY(-180deg) rotateX(0)}to{transform:perspective(150px) rotateX(-180deg) rotateY(-180deg) rotateX(-180deg);filter:grayscale(.8)}}.rai-custom-error{position:absolute;top:0;left:0;width:100%;height:100%;z-index:10}.tiptap strong.tw-font-bold,.tiptap b.tw-font-bold{font-weight:700}.tiptap em.tw-font-italic,.tiptap i.tw-font-italic{font-style:italic}.tiptap a.tiptap-rich-text-link{color:#3b82f6;text-decoration:underline;position:relative;display:inline-block;width:fit-content}.tiptap a.tiptap-rich-text-link:hover{color:#3b82f6cc;text-decoration:none}.tiptap a.tiptap-rich-text-link:not([title=""]):before{content:attr(title);position:absolute;top:-2rem;left:50%;transform:translate(-50%);white-space:nowrap;border-radius:.25rem;background-color:#000;padding:.25rem .5rem;color:#fff;opacity:0;transition:opacity .2s;pointer-events:none}.tiptap a.tiptap-rich-text-link:not([title=""]):hover:before{opacity:1}.tiptap p[style*="text-align: left"]{text-align:left}.tiptap p[style*="text-align: center"]{text-align:center}.tiptap p[style*="text-align: right"]{text-align:right}.tiptap p[style*="text-align: justify"]{text-align:justify}.tiptap u{text-decoration:underline}.tiptap.ProseMirror{background-color:transparent;height:fit-content!important;word-wrap:break-word;white-space:pre-wrap;white-space:break-spaces;-webkit-font-variant-ligatures:none;font-variant-ligatures:none;font-feature-settings:"liga" 0;padding:0;width:100%;overflow-y:auto}.tiptap{line-height:1.6;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,sans-serif}.tiptap p{margin:.5em 0}.tiptap p:first-child{margin-top:0}.tiptap p:last-child{margin-bottom:0}.tiptap img{max-width:100%;height:auto;display:block}.tiptap p[style*="text-align: left"] img{margin-left:0;margin-right:auto}.tiptap p[style*="text-align: center"] img{margin-left:auto;margin-right:auto}.tiptap p[style*="text-align: right"] img{margin-left:auto;margin-right:0}.rai-retry-btn{padding:8px 20px;border:none;border-radius:6px;background:var(--rai-accent, #000000);color:var(--rai-error-bg, #ffffff);font-size:14px;font-family:system-ui,-apple-system,sans-serif;cursor:pointer}.rai-retry-btn:hover{opacity:.85}';
 const DEFINED_ATTRS = /* @__PURE__ */ new Set([
   "community-id",
@@ -13233,6 +13470,7 @@ const DEFINED_ATTRS = /* @__PURE__ */ new Set([
   "max-retries",
   "retry-delay",
   "height-debounce",
+  "language",
   "locale",
   "custom-data",
   "retry-label",
@@ -13493,6 +13731,13 @@ function readConfig(el2, existingId) {
       return void 0;
     }
   })();
+  const explicitLanguage = get("language").trim();
+  const legacyLocale = get("locale").trim();
+  const requestedLanguage = explicitLanguage || legacyLocale || void 0;
+  const language = resolveWidgetLanguage(requestedLanguage);
+  if (requestedLanguage && !language) {
+    warnUnsupportedWidgetLanguage(requestedLanguage);
+  }
   return {
     communityId,
     channelId,
@@ -13518,7 +13763,12 @@ function readConfig(el2, existingId) {
     // #2
     heightDebounce: num("height-debounce", 100),
     // #4
-    locale: get("locale") || void 0,
+    // `language` is the canonical forced widget locale. Keep `locale` as a
+    // backwards-compatible alias only when it supplied the selected value.
+    // Unsupported explicit values are omitted so the widget uses its existing
+    // browser-language fallback.
+    language,
+    locale: !explicitLanguage && legacyLocale ? language : void 0,
     // #5
     customData,
     // #8
@@ -13580,6 +13830,8 @@ class BaseWidget extends HTMLElement {
     __publicField(this, "config");
     __publicField(this, "state", createInitialState());
     __publicField(this, "loaderEl", null);
+    __publicField(this, "loaderHeightRestore", null);
+    __publicField(this, "loaderHeightObserver", null);
     __publicField(this, "errorEl", null);
     __publicField(this, "msgEl", null);
     __publicField(this, "cleanupListener");
@@ -13591,14 +13843,21 @@ class BaseWidget extends HTMLElement {
     __publicField(this, "hasAttemptedInit", false);
     __publicField(this, "initGeneration", 0);
     __publicField(this, "lottieInstances", []);
-    __publicField(this, "renderedLoaderAnimationKey", null);
     __publicField(this, "callbackRegistry", new WidgetCallbackRegistry());
     __publicField(this, "bannerNode", null);
     __publicField(this, "releaseAutoThemeDisableLease");
+    __publicField(this, "bundleUnmount");
     this.shadow = this.attachShadow({ mode: "closed" });
   }
   static get observedAttributes() {
-    return ["embed-token", "data-embed-token"];
+    return [
+      "embed-token",
+      "data-embed-token",
+      "language",
+      "data-language",
+      "locale",
+      "data-locale"
+    ];
   }
   registerCallback(callbackName, callback) {
     this.callbackRegistry.registerCallback(callbackName, callback);
@@ -13610,6 +13869,9 @@ class BaseWidget extends HTMLElement {
     this.config = readConfig(this, void 0);
     this.identitySignature = identitySignatureForConfig(this.config);
     this.setupIdentityAttributeObserver();
+    ensureWidgetPreconnects(
+      resolveWidgetPreconnectOrigins(this.config, document.baseURI)
+    );
     const style = document.createElement("style");
     style.textContent = widgetCSS;
     this.shadow.appendChild(style);
@@ -13645,13 +13907,23 @@ class BaseWidget extends HTMLElement {
     (_c = this.identityAttributeObserver) == null ? void 0 : _c.disconnect();
     this.teardownMountedWidget();
     this.clearLottieInstances();
+    this.restoreLoaderHeight();
     this.removeBanner();
     clearState(this.state);
   }
   attributeChangedCallback(name, oldValue, newValue) {
     if (oldValue === newValue) return;
-    if (name !== "embed-token" && name !== "data-embed-token") return;
-    this.handleIdentityConfigChange();
+    if (name === "embed-token" || name === "data-embed-token") {
+      this.handleIdentityConfigChange();
+      return;
+    }
+    if (this.isConnected && this.config) {
+      if (this.hasAttemptedInit) {
+        void this.reload();
+      } else {
+        this.config = readConfig(this, this.config.communityId);
+      }
+    }
   }
   setupIdentityAttributeObserver() {
     var _a;
@@ -13807,22 +14079,6 @@ class BaseWidget extends HTMLElement {
       textEl.hidden = !loadingText.enabled;
     }
   }
-  getLoadingAnimationRenderKey() {
-    var _a, _b, _c;
-    const animation = this.state.loadingAnimation;
-    const theme = this.config.theme === "dark" ? "dark" : "light";
-    const custom = (animation == null ? void 0 : animation.type) === "custom" ? ((_a = animation.custom) == null ? void 0 : _a[theme]) || ((_b = animation.custom) == null ? void 0 : _b.light) || ((_c = animation.custom) == null ? void 0 : _c.dark) : void 0;
-    return JSON.stringify({
-      theme,
-      type: (animation == null ? void 0 : animation.type) ?? null,
-      preset: (animation == null ? void 0 : animation.preset) ?? null,
-      custom: custom ? {
-        type: custom.type ?? null,
-        html: custom.html ?? null,
-        lottie: custom.lottie ?? null
-      } : null
-    });
-  }
   renderShell() {
     this.loaderEl = document.createElement("div");
     this.loaderEl.className = "rai-loader";
@@ -13834,6 +14090,7 @@ class BaseWidget extends HTMLElement {
     textEl.textContent = this.config.loadingText;
     this.loaderEl.appendChild(textEl);
     this.shadow.appendChild(this.loaderEl);
+    this.freezeIframeLoaderHeight();
     this.applyLoadingSettings();
     this.fetchAndRenderLoader();
     this.errorEl = document.createElement("div");
@@ -13854,11 +14111,9 @@ class BaseWidget extends HTMLElement {
    * Loads the community loading animation + theme palette from cache or API
    * and renders the configured animation above the loading text.
    *
-   * Stale-while-revalidate:
-   *   - Cache hit  → apply palette & render animation synchronously, fire
-   *                  background refresh.
-   *   - Cache miss → retain the initial shell; await network; apply palette +
-   *                  render the resolved animation or fallback.
+   * Cached settings are applied synchronously. On a first visit, settings load
+   * alongside authentication so the generic loader stays hidden until the
+   * configured animation is known. This request never blocks widget launch.
    */
   async fetchAndRenderLoader() {
     var _a;
@@ -13867,26 +14122,14 @@ class BaseWidget extends HTMLElement {
       applyErrorSettingsToState(this.state, cached);
       this.applyLoadingSettings();
       this.renderLoaderAnimation();
-      void fetchErrorSettings(this.config, this.state, { skipCache: true }).then(() => {
-        var _a2;
-        if (!this.loaderEl) return;
-        const theme2 = this.config.theme === "dark" ? "dark" : "light";
-        const palette2 = (_a2 = this.state.themePalette) == null ? void 0 : _a2[theme2];
-        if (palette2) this.applyPalette(palette2);
-        if (this.state.font) this.applyFont(this.state.font);
-        this.applyLoadingSettings();
-        if (this.renderedLoaderAnimationKey !== this.getLoadingAnimationRenderKey()) {
-          this.renderLoaderAnimation();
-        }
-      }).catch(() => {
-      });
       return;
     }
     try {
       await fetchErrorSettings(this.config, this.state);
     } catch {
     }
-    if (!this.loaderEl) return;
+    const loaderEl = this.loaderEl;
+    if (!loaderEl) return;
     if (!this.config.themeExplicit && (this.state.defaultColorSchema === "light" || this.state.defaultColorSchema === "dark") && this.state.defaultColorSchema !== this.config.theme) {
       this.config.theme = this.state.defaultColorSchema;
     }
@@ -13896,7 +14139,7 @@ class BaseWidget extends HTMLElement {
     if (this.state.font) this.applyFont(this.state.font);
     this.applyLoadingSettings();
     this.renderLoaderAnimation();
-    this.loaderEl.classList.remove("rai-loader-pending-settings");
+    loaderEl.classList.remove("rai-loader-pending-settings");
   }
   /**
    * Append the loading animation above the text. Removes any previous
@@ -13905,7 +14148,6 @@ class BaseWidget extends HTMLElement {
    */
   renderLoaderAnimation() {
     if (!this.loaderEl) return;
-    this.renderedLoaderAnimationKey = this.getLoadingAnimationRenderKey();
     this.clearLottieInstances();
     const existing = this.loaderEl.querySelector(".rai-loader-anim");
     if (existing) existing.remove();
@@ -13992,9 +14234,82 @@ class BaseWidget extends HTMLElement {
     setTimeout(() => {
       loader.remove();
       lottieInstances.forEach((instance) => instance.destroy());
+      this.restoreLoaderHeight();
     }, 300);
     this.loaderEl = null;
   }
+  /**
+   * Keep percentage-based iframe embeds at their resolved startup height while
+   * the SDK loader is visible. The child iframe may resize during auth/data
+   * loading; without this pin the loader's 100% centering moves with the host.
+   */
+  freezeIframeLoaderHeight() {
+    var _a;
+    if (this.config.bundleUrl || this.loaderHeightRestore) return;
+    const measuredHeight = this.getBoundingClientRect().height;
+    const isRendered = this.getClientRects().length > 0;
+    const hasPercentageHeight = parsePercentageHeight(this.style.height) !== null;
+    const percentageHeight = resolvePercentageViewportHeight(
+      this.style.height,
+      window.innerHeight
+    );
+    if (measuredHeight <= 0 && hasPercentageHeight && !isRendered) {
+      this.deferIframeLoaderHeightFreeze();
+      return;
+    }
+    const resolvedHeight = measuredHeight > 0 ? measuredHeight : percentageHeight;
+    if (!Number.isFinite(resolvedHeight) || resolvedHeight <= 0) return;
+    (_a = this.loaderHeightObserver) == null ? void 0 : _a.disconnect();
+    this.loaderHeightObserver = null;
+    this.loaderHeightRestore = {
+      value: this.style.getPropertyValue("height"),
+      priority: this.style.getPropertyPriority("height"),
+      resolvedHeight
+    };
+    this.style.setProperty("height", `${resolvedHeight}px`);
+  }
+  deferIframeLoaderHeightFreeze() {
+    if (this.loaderHeightObserver || typeof ResizeObserver === "undefined") {
+      return;
+    }
+    this.loaderHeightObserver = new ResizeObserver(() => {
+      var _a, _b;
+      if (!this.isConnected || !this.loaderEl || this.config.bundleUrl) {
+        (_a = this.loaderHeightObserver) == null ? void 0 : _a.disconnect();
+        this.loaderHeightObserver = null;
+        return;
+      }
+      if (this.getClientRects().length === 0) return;
+      (_b = this.loaderHeightObserver) == null ? void 0 : _b.disconnect();
+      this.loaderHeightObserver = null;
+      this.freezeIframeLoaderHeight();
+    });
+    this.loaderHeightObserver.observe(this);
+  }
+  restoreLoaderHeight() {
+    var _a;
+    (_a = this.loaderHeightObserver) == null ? void 0 : _a.disconnect();
+    this.loaderHeightObserver = null;
+    if (!this.loaderHeightRestore) return;
+    const { value, priority, resolvedHeight } = this.loaderHeightRestore;
+    this.loaderHeightRestore = null;
+    if (value) {
+      this.style.setProperty("height", value, priority);
+    } else {
+      this.style.removeProperty("height");
+    }
+    const restoredHeight = this.getBoundingClientRect().height;
+    const isRendered = this.isConnected && this.getClientRects().length > 0;
+    const collapsedFallback = resolveCollapsedRestoredHeight({
+      originalHeight: value,
+      restoredHeight,
+      resolvedHeight,
+      isRendered
+    });
+    if (collapsedFallback) {
+      this.style.setProperty("height", collapsedFallback, priority);
+    }
+  }
   /**
    * Resolve after a legacy bundle's first rendered child has reached a paint.
    * This remains the fallback for bundles that do not expose a deep-ready
@@ -14207,14 +14522,10 @@ class BaseWidget extends HTMLElement {
         this.config.bundleUrl
       );
     }
-    const errorSettingsPromise = fetchErrorSettings(this.config, this.state);
-    const finishStartup = async (authentication) => {
-      const [authenticated] = await Promise.all([
-        authentication,
-        errorSettingsPromise
-      ]);
-      return authenticated;
-    };
+    const finishStartup = (authentication) => resolveStartupAuthentication(
+      authentication,
+      (options) => fetchErrorSettings(this.config, this.state, options)
+    );
     const launchWidget = () => {
       var _a;
       if (!this.isCurrentInit(initId)) return;
@@ -14314,6 +14625,13 @@ class BaseWidget extends HTMLElement {
   }
   teardownMountedWidget() {
     var _a;
+    const bundleUnmount = this.bundleUnmount;
+    this.bundleUnmount = void 0;
+    try {
+      bundleUnmount == null ? void 0 : bundleUnmount();
+    } catch (error) {
+      console.error("[rai-widget] Bundle unmount failed:", error);
+    }
     (_a = this.releaseAutoThemeDisableLease) == null ? void 0 : _a.call(this);
     this.releaseAutoThemeDisableLease = void 0;
     if (this.cleanupListener) {
@@ -14389,6 +14707,7 @@ class BaseWidget extends HTMLElement {
   async mountWidget(initId) {
     var _a;
     let container = null;
+    let cleanupBundleMount;
     try {
       this.teardownMountedWidget();
       const autoHeight = this.config.height.trim().toLowerCase() === "auto";
@@ -14451,6 +14770,7 @@ class BaseWidget extends HTMLElement {
         // injected by SSR for the explicit `/open-widget` route.
         isOpenWidget: !this.state.accessToken,
         defaultColorSchema: this.config.widgetType === "custom" && !this.config.themeExplicit ? null : colorMode,
+        language: this.config.language,
         // Bundle loading screens are rendered beneath an instance-scoped
         // provider. Do not put these values on window: pages can mount several
         // widget types at once.
@@ -14473,8 +14793,20 @@ class BaseWidget extends HTMLElement {
           transport: "bundle"
         })
       });
-      await waitForBundleMountReadiness(mountResult, firstPaint);
+      const resolvedMountResult = await resolveBundleMountResult(mountResult);
+      cleanupBundleMount = createBundleMountCleanup(resolvedMountResult);
       if (!this.isCurrentInit(initId) || !container.isConnected) {
+        cleanupBundleMount == null ? void 0 : cleanupBundleMount();
+        container.remove();
+        return;
+      }
+      this.bundleUnmount = cleanupBundleMount;
+      await waitForBundleMountReadiness(resolvedMountResult, firstPaint);
+      if (!this.isCurrentInit(initId) || !container.isConnected) {
+        cleanupBundleMount == null ? void 0 : cleanupBundleMount();
+        if (this.bundleUnmount === cleanupBundleMount) {
+          this.bundleUnmount = void 0;
+        }
         container.remove();
         return;
       }
@@ -14482,11 +14814,16 @@ class BaseWidget extends HTMLElement {
       this.hideLoader();
       this.emit("rai-mounted");
     } catch (err) {
+      cleanupBundleMount == null ? void 0 : cleanupBundleMount();
+      if (this.bundleUnmount === cleanupBundleMount) {
+        this.bundleUnmount = void 0;
+      }
       if (!this.isCurrentInit(initId)) {
         container == null ? void 0 : container.remove();
         return;
       }
       console.error("[rai-widget] Bundle mount failed:", err);
+      container == null ? void 0 : container.remove();
       (_a = this.releaseAutoThemeDisableLease) == null ? void 0 : _a.call(this);
       this.releaseAutoThemeDisableLease = void 0;
       this.showError();
@@ -14578,6 +14915,7 @@ class StoreWidget extends BaseWidget {
     url.searchParams.set("containerId", config.container);
     url.searchParams.set("connectType", "simple");
     url.searchParams.set("mode", "private");
+    if (config.language) url.searchParams.set("language", config.language);
     if (config.locale) url.searchParams.set("locale", config.locale);
     return url.toString();
   }
@@ -14588,10 +14926,12 @@ class ChannelWidget extends BaseWidget {
     try {
       const u = new URL(base);
       u.searchParams.set("color", config.theme);
+      if (config.language) u.searchParams.set("language", config.language);
       if (config.locale) u.searchParams.set("locale", config.locale);
       return u.toString();
     } catch {
       const params = [`color=${config.theme}`];
+      if (config.language) params.push(`language=${encodeURIComponent(config.language)}`);
       if (config.locale) params.push(`locale=${encodeURIComponent(config.locale)}`);
       return `${base}?${params.join("&")}`;
     }
@@ -14603,10 +14943,12 @@ class MilestoneWidget extends BaseWidget {
     try {
       const u = new URL(base);
       u.searchParams.set("color", config.theme);
+      if (config.language) u.searchParams.set("language", config.language);
       if (config.locale) u.searchParams.set("locale", config.locale);
       return u.toString();
     } catch {
       const params = [`color=${config.theme}`];
+      if (config.language) params.push(`language=${encodeURIComponent(config.language)}`);
       if (config.locale) params.push(`locale=${encodeURIComponent(config.locale)}`);
       return `${base}?${params.join("&")}`;
     }
@@ -14618,10 +14960,12 @@ class SocialWidget extends BaseWidget {
     try {
       const u = new URL(base);
       u.searchParams.set("color", config.theme);
+      if (config.language) u.searchParams.set("language", config.language);
       if (config.locale) u.searchParams.set("locale", config.locale);
       return u.toString();
     } catch {
       const params = [`color=${config.theme}`];
+      if (config.language) params.push(`language=${encodeURIComponent(config.language)}`);
       if (config.locale) params.push(`locale=${encodeURIComponent(config.locale)}`);
       return `${base}?${params.join("&")}`;
     }
@@ -14633,10 +14977,12 @@ class CurrencyWidget extends BaseWidget {
     try {
       const u = new URL(base);
       u.searchParams.set("color", config.theme);
+      if (config.language) u.searchParams.set("language", config.language);
       if (config.locale) u.searchParams.set("locale", config.locale);
       return u.toString();
     } catch {
       const params = [`color=${config.theme}`];
+      if (config.language) params.push(`language=${encodeURIComponent(config.language)}`);
       if (config.locale) params.push(`locale=${encodeURIComponent(config.locale)}`);
       return `${base}?${params.join("&")}`;
     }
@@ -14648,10 +14994,12 @@ class ReferralWidget extends BaseWidget {
     try {
       const u = new URL(base);
       u.searchParams.set("color", config.theme);
+      if (config.language) u.searchParams.set("language", config.language);
       if (config.locale) u.searchParams.set("locale", config.locale);
       return u.toString();
     } catch {
       const params = [`color=${config.theme}`];
+      if (config.language) params.push(`language=${encodeURIComponent(config.language)}`);
       if (config.locale) params.push(`locale=${encodeURIComponent(config.locale)}`);
       return `${base}?${params.join("&")}`;
     }
@@ -14664,17 +15012,19 @@ class CustomWidget extends BaseWidget {
       const u = new URL(base);
       u.searchParams.set("auth", "postmessage");
       if (config.themeExplicit) u.searchParams.set("color", config.theme);
+      if (config.language) u.searchParams.set("language", config.language);
       if (config.locale) u.searchParams.set("locale", config.locale);
       return u.toString();
     } catch {
       const params = ["auth=postmessage"];
       if (config.themeExplicit) params.push(`color=${config.theme}`);
+      if (config.language) params.push(`language=${encodeURIComponent(config.language)}`);
       if (config.locale) params.push(`locale=${encodeURIComponent(config.locale)}`);
       return params.length > 0 ? `${base}?${params.join("&")}` : base;
     }
   }
 }
-console.log(`[rai-widget] v${"1.8.1"}`);
+console.log(`[rai-widget] v${"1.8.2"}`);
 class StoreWidgetCompat extends StoreWidget {
 }
 const WIDGET_REGISTRY = [
@@ -14738,7 +15088,7 @@ function exposePublicApi() {
   })();
   const widget = container == null ? void 0 : container.querySelector(ALL_WIDGET_SELECTOR);
   window.ReturningAIWidget = {
-    version: "1.8.1",
+    version: "1.8.2",
     reload: () => (widget == null ? void 0 : widget.reload()) ?? Promise.resolve(),
     logout: () => (widget == null ? void 0 : widget.logoutPublic()) ?? Promise.resolve(),
     isAuthenticated: () => (widget == null ? void 0 : widget.isAuthenticated()) ?? false,