@lionrapid/core 0.6.5 → 0.7.0

package/dist/browser/lionrapid.auto.dev.js

@@ -42,6 +42,216 @@ var __lionrapidAutoExports = (() => {
     parseConfig: () => parseConfig
   });
 
+  // src/browser/md5.ts
+  function safeAdd(x, y) {
+    const lsw = (x & 65535) + (y & 65535);
+    const msw = (x >> 16) + (y >> 16) + (lsw >> 16);
+    return msw << 16 | lsw & 65535;
+  }
+  function bitRotateLeft(num, cnt) {
+    return num << cnt | num >>> 32 - cnt;
+  }
+  function md5cmn(q, a, b, x, s, t) {
+    return safeAdd(bitRotateLeft(safeAdd(safeAdd(a, q), safeAdd(x, t)), s), b);
+  }
+  function md5ff(a, b, c, d, x, s, t) {
+    return md5cmn(b & c | ~b & d, a, b, x, s, t);
+  }
+  function md5gg(a, b, c, d, x, s, t) {
+    return md5cmn(b & d | c & ~d, a, b, x, s, t);
+  }
+  function md5hh(a, b, c, d, x, s, t) {
+    return md5cmn(b ^ c ^ d, a, b, x, s, t);
+  }
+  function md5ii(a, b, c, d, x, s, t) {
+    return md5cmn(c ^ (b | ~d), a, b, x, s, t);
+  }
+  function binlMD5(x, len) {
+    x[len >> 5] |= 128 << len % 32;
+    x[(len + 64 >>> 9 << 4) + 14] = len;
+    let a = 1732584193;
+    let b = -271733879;
+    let c = -1732584194;
+    let d = 271733878;
+    for (let i = 0; i < x.length; i += 16) {
+      const olda = a;
+      const oldb = b;
+      const oldc = c;
+      const oldd = d;
+      a = md5ff(a, b, c, d, x[i], 7, -680876936);
+      d = md5ff(d, a, b, c, x[i + 1], 12, -389564586);
+      c = md5ff(c, d, a, b, x[i + 2], 17, 606105819);
+      b = md5ff(b, c, d, a, x[i + 3], 22, -1044525330);
+      a = md5ff(a, b, c, d, x[i + 4], 7, -176418897);
+      d = md5ff(d, a, b, c, x[i + 5], 12, 1200080426);
+      c = md5ff(c, d, a, b, x[i + 6], 17, -1473231341);
+      b = md5ff(b, c, d, a, x[i + 7], 22, -45705983);
+      a = md5ff(a, b, c, d, x[i + 8], 7, 1770035416);
+      d = md5ff(d, a, b, c, x[i + 9], 12, -1958414417);
+      c = md5ff(c, d, a, b, x[i + 10], 17, -42063);
+      b = md5ff(b, c, d, a, x[i + 11], 22, -1990404162);
+      a = md5ff(a, b, c, d, x[i + 12], 7, 1804603682);
+      d = md5ff(d, a, b, c, x[i + 13], 12, -40341101);
+      c = md5ff(c, d, a, b, x[i + 14], 17, -1502002290);
+      b = md5ff(b, c, d, a, x[i + 15], 22, 1236535329);
+      a = md5gg(a, b, c, d, x[i + 1], 5, -165796510);
+      d = md5gg(d, a, b, c, x[i + 6], 9, -1069501632);
+      c = md5gg(c, d, a, b, x[i + 11], 14, 643717713);
+      b = md5gg(b, c, d, a, x[i], 20, -373897302);
+      a = md5gg(a, b, c, d, x[i + 5], 5, -701558691);
+      d = md5gg(d, a, b, c, x[i + 10], 9, 38016083);
+      c = md5gg(c, d, a, b, x[i + 15], 14, -660478335);
+      b = md5gg(b, c, d, a, x[i + 4], 20, -405537848);
+      a = md5gg(a, b, c, d, x[i + 9], 5, 568446438);
+      d = md5gg(d, a, b, c, x[i + 14], 9, -1019803690);
+      c = md5gg(c, d, a, b, x[i + 3], 14, -187363961);
+      b = md5gg(b, c, d, a, x[i + 8], 20, 1163531501);
+      a = md5gg(a, b, c, d, x[i + 13], 5, -1444681467);
+      d = md5gg(d, a, b, c, x[i + 2], 9, -51403784);
+      c = md5gg(c, d, a, b, x[i + 7], 14, 1735328473);
+      b = md5gg(b, c, d, a, x[i + 12], 20, -1926607734);
+      a = md5hh(a, b, c, d, x[i + 5], 4, -378558);
+      d = md5hh(d, a, b, c, x[i + 8], 11, -2022574463);
+      c = md5hh(c, d, a, b, x[i + 11], 16, 1839030562);
+      b = md5hh(b, c, d, a, x[i + 14], 23, -35309556);
+      a = md5hh(a, b, c, d, x[i + 1], 4, -1530992060);
+      d = md5hh(d, a, b, c, x[i + 4], 11, 1272893353);
+      c = md5hh(c, d, a, b, x[i + 7], 16, -155497632);
+      b = md5hh(b, c, d, a, x[i + 10], 23, -1094730640);
+      a = md5hh(a, b, c, d, x[i + 13], 4, 681279174);
+      d = md5hh(d, a, b, c, x[i + 0], 11, -358537222);
+      c = md5hh(c, d, a, b, x[i + 3], 16, -722521979);
+      b = md5hh(b, c, d, a, x[i + 6], 23, 76029189);
+      a = md5hh(a, b, c, d, x[i + 9], 4, -640364487);
+      d = md5hh(d, a, b, c, x[i + 12], 11, -421815835);
+      c = md5hh(c, d, a, b, x[i + 15], 16, 530742520);
+      b = md5hh(b, c, d, a, x[i + 2], 23, -995338651);
+      a = md5ii(a, b, c, d, x[i], 6, -198630844);
+      d = md5ii(d, a, b, c, x[i + 7], 10, 1126891415);
+      c = md5ii(c, d, a, b, x[i + 14], 15, -1416354905);
+      b = md5ii(b, c, d, a, x[i + 5], 21, -57434055);
+      a = md5ii(a, b, c, d, x[i + 12], 6, 1700485571);
+      d = md5ii(d, a, b, c, x[i + 3], 10, -1894986606);
+      c = md5ii(c, d, a, b, x[i + 10], 15, -1051523);
+      b = md5ii(b, c, d, a, x[i + 1], 21, -2054922799);
+      a = md5ii(a, b, c, d, x[i + 8], 6, 1873313359);
+      d = md5ii(d, a, b, c, x[i + 15], 10, -30611744);
+      c = md5ii(c, d, a, b, x[i + 6], 15, -1560198380);
+      b = md5ii(b, c, d, a, x[i + 13], 21, 1309151649);
+      a = md5ii(a, b, c, d, x[i + 4], 6, -145523070);
+      d = md5ii(d, a, b, c, x[i + 11], 10, -1120210379);
+      c = md5ii(c, d, a, b, x[i + 2], 15, 718787259);
+      b = md5ii(b, c, d, a, x[i + 9], 21, -343485551);
+      a = safeAdd(a, olda);
+      b = safeAdd(b, oldb);
+      c = safeAdd(c, oldc);
+      d = safeAdd(d, oldd);
+    }
+    return [a, b, c, d];
+  }
+  function binl2hex(binarray) {
+    const hexTab = "0123456789abcdef";
+    let str = "";
+    for (let i = 0; i < binarray.length * 4; i++) {
+      str += hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 + 4 & 15) + hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 & 15);
+    }
+    return str;
+  }
+  function utf8Bytes(str) {
+    if (typeof TextEncoder !== "undefined") {
+      return new TextEncoder().encode(str);
+    }
+    const out = [];
+    for (let i = 0; i < str.length; i++) {
+      const c = str.charCodeAt(i);
+      if (c < 128) {
+        out.push(c);
+      } else if (c < 2048) {
+        out.push(192 | c >> 6, 128 | c & 63);
+      } else if (c >= 55296 && c < 56320 && i + 1 < str.length) {
+        const c2 = str.charCodeAt(++i);
+        const cp = 65536 + (c - 55296 << 10) + (c2 - 56320);
+        out.push(
+          240 | cp >> 18,
+          128 | cp >> 12 & 63,
+          128 | cp >> 6 & 63,
+          128 | cp & 63
+        );
+      } else {
+        out.push(
+          224 | c >> 12,
+          128 | c >> 6 & 63,
+          128 | c & 63
+        );
+      }
+    }
+    return new Uint8Array(out);
+  }
+  function bytes2binl(bytes) {
+    const bin = [];
+    for (let i = 0; i < bytes.length; i++) {
+      bin[i >> 2] |= bytes[i] << i % 4 * 8;
+    }
+    return bin;
+  }
+  function md5(str) {
+    const bytes = utf8Bytes(str);
+    return binl2hex(binlMD5(bytes2binl(bytes), bytes.length * 8));
+  }
+  function generateAutoKey(text) {
+    const trimmed = text.trim();
+    return "auto_" + md5(trimmed).substring(0, 12);
+  }
+
+  // src/utils/log-safe.ts
+  var LOG_VALUE_FULL_MAX = 200;
+  var LOG_VALUE_EDGE = 90;
+  function contentIdentity(value) {
+    return `${value.length} chars, md5:${md5(value.trim()).slice(0, 12)}`;
+  }
+  function contentExcerpt(value) {
+    if (value.length <= LOG_VALUE_FULL_MAX) {
+      return JSON.stringify(value);
+    }
+    return JSON.stringify(
+      `${value.slice(0, LOG_VALUE_EDGE)}\u2026${value.slice(-LOG_VALUE_EDGE)}`
+    );
+  }
+  var LOG_ERROR_MAX = 200;
+  var LOG_DATA_MAX = 500;
+  var LOG_STACK_FRAMES = 2;
+  var LOG_FRAME_MAX = 120;
+  function bound(text, max) {
+    return text.length <= max ? text : `${text.slice(0, max)}\u2026 (${text.length} chars)`;
+  }
+  function oneLine(text) {
+    return JSON.stringify(text).slice(1, -1);
+  }
+  function describeError(error) {
+    if (error instanceof Error) {
+      const name = error.name || "Error";
+      return bound(oneLine(`${name}: ${error.message}`), LOG_ERROR_MAX);
+    }
+    return bound(oneLine(String(error)), LOG_ERROR_MAX);
+  }
+  function describeLogData(data) {
+    if (data instanceof Error) {
+      const headerLines = String(data.message ?? "").split("\n").length;
+      const frames = (data.stack ?? "").split("\n").slice(headerLines).map((frame) => frame.trim()).filter((frame) => frame.startsWith("at ")).slice(0, LOG_STACK_FRAMES).map((frame) => bound(frame, LOG_FRAME_MAX));
+      return [describeError(data), ...frames].join(" | ");
+    }
+    let rendered;
+    try {
+      rendered = JSON.stringify(data);
+    } catch {
+      return "[unserializable]";
+    }
+    return bound(rendered ?? oneLine(String(data)), LOG_DATA_MAX);
+  }
+  function describeContent(value) {
+    return `${contentIdentity(value)}, ${contentExcerpt(value)}`;
+  }
+
   // src/config/logger.config.ts
   var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
     LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
@@ -169,7 +379,7 @@ var __lionrapidAutoExports = (() => {
         const locationInfo2 = callSite ? ` (${callSite.fileName}:${callSite.lineNumber})` : "";
         let logMessage = `${this.config.prefix} ${emoji} ${levelName} ${message}${locationInfo2}`;
         if (data !== void 0) {
-          logMessage += ` ${JSON.stringify(data)}`;
+          logMessage += ` ${describeLogData(data)}`;
         }
         return logMessage;
       }
@@ -180,7 +390,7 @@ var __lionrapidAutoExports = (() => {
       const coloredLevel = `${levelColor}${Colors.BOLD}${levelName}${reset}`;
       const coloredMessage = `${levelColor}${message}${reset}`;
       const locationInfo = callSite ? `${Colors.DIM}${Colors.BRIGHT_BLACK} (${callSite.fileName}:${callSite.lineNumber})${reset}` : "";
-      const dataInfo = data !== void 0 ? `${Colors.DIM}${Colors.CYAN} ${JSON.stringify(data)}${reset}` : "";
+      const dataInfo = data !== void 0 ? `${Colors.DIM}${Colors.CYAN} ${describeLogData(data)}${reset}` : "";
       return `${coloredPrefix} ${coloredEmoji} ${coloredLevel} ${coloredMessage}${locationInfo}${dataInfo}`;
     }
     getLevelColor(level) {
@@ -918,6 +1128,24 @@ var __lionrapidAutoExports = (() => {
       });
       await Promise.allSettled(savePromises);
     }
+    /** Forget `locale:namespace` in every memory and storage handler (a 404). */
+    async forgetNamespaceInHandlers(context) {
+      for (const handler of this.syncHandlers) {
+        try {
+          handler.forgetNamespace?.(context);
+        } catch (error) {
+          logger.warn(`Failed to clear namespace in ${handler.name}`, error);
+        }
+      }
+      for (const handler of this.asyncHandlers) {
+        if (handler.type !== "storage" && handler.type !== "memory") continue;
+        try {
+          await handler.forgetNamespace?.(context);
+        } catch (error) {
+          logger.warn(`Failed to clear namespace in ${handler.name}`, error);
+        }
+      }
+    }
     async saveNamespaceToHandlers(translations, context) {
       this.saveNamespaceToMemoryHandlers(translations, context);
       await this.saveNamespaceToStorageHandlers(translations, context);
@@ -1019,6 +1247,10 @@ var __lionrapidAutoExports = (() => {
             });
             return result.data;
           }
+          if (result && result.status === 404) {
+            await this.forgetNamespaceInHandlers({ namespace, locale });
+            return null;
+          }
         } catch (error) {
           logger.warn(
             `Failed to load namespace: ${locale}:${namespace} from ${handler.name}`,
@@ -1402,6 +1634,7 @@ var __lionrapidAutoExports = (() => {
         context.locale + ":" + context.namespace,
         this.name
       );
+      const previousKeys = this.storedNamespaceKeys(context.locale, context.namespace);
       const namespaceCacheKey = createNamespaceCacheKey(
         context.locale,
         context.namespace
@@ -1413,11 +1646,38 @@ var __lionrapidAutoExports = (() => {
         context.locale,
         context.namespace
       );
+      for (const key of previousKeys) {
+        if (!(key in flattened)) this.removeQuietly(key);
+      }
       for (const [flatKey, flatValue] of Object.entries(flattened)) {
         this.setWithTTL(flatKey, flatValue);
       }
       repoBus.setSuccess(JSON.stringify(translations));
     }
+    /** Forget a namespace the server says does not exist (404). See AsyncStorageHandler. */
+    forgetNamespace(context) {
+      if (!context.namespace) return;
+      for (const key of this.storedNamespaceKeys(context.locale, context.namespace)) {
+        this.removeQuietly(key);
+      }
+      this.clearNamespace(context.locale, context.namespace);
+    }
+    storedNamespaceKeys(locale, namespace) {
+      try {
+        const blob = this.repository.get(createNamespaceCacheKey(locale, namespace));
+        if (!blob) return [];
+        return Object.keys(flattenTranslations(JSON.parse(blob), "", locale, namespace));
+      } catch {
+        return [];
+      }
+    }
+    removeQuietly(cacheKey) {
+      this.ttlMap.delete(cacheKey);
+      try {
+        this.repository.remove(cacheKey);
+      } catch {
+      }
+    }
     /**
      * ✅ Strategy 1: Direct cache lookup using unified pattern
      * Returns parsed ContentUnit (text + styles) or null
@@ -1671,6 +1931,7 @@ var __lionrapidAutoExports = (() => {
       logger.debug(
         `Saving namespace: ${context.locale}:${context.namespace} (${keyCount} keys)`
       );
+      const previousKeys = await this.storedNamespaceKeys(context.locale, context.namespace);
       const namespaceCacheKey = createNamespaceCacheKey(
         context.locale,
         context.namespace
@@ -1682,6 +1943,9 @@ var __lionrapidAutoExports = (() => {
         context.locale,
         context.namespace
       );
+      for (const key of previousKeys) {
+        if (!(key in flattened)) await this.removeQuietly(key);
+      }
       let savedCount = 0;
       for (const [flatKey, flatValue] of Object.entries(flattened)) {
         await this.setWithTTL(flatKey, flatValue);
@@ -1690,6 +1954,35 @@ var __lionrapidAutoExports = (() => {
       logger.debug(`Saved: ${savedCount} keys + namespace blob`);
       repoBus.setSuccess(JSON.stringify(translations));
     }
+    /**
+     * Forget a namespace the server says does not exist (404): its blob and
+     * every per-key entry the blob listed. A network failure never gets here,
+     * so the offline floor still serves when the server is unreachable.
+     */
+    async forgetNamespace(context) {
+      if (!context.namespace) return;
+      for (const key of await this.storedNamespaceKeys(context.locale, context.namespace)) {
+        await this.removeQuietly(key);
+      }
+      await this.removeQuietly(createNamespaceCacheKey(context.locale, context.namespace));
+    }
+    /** The per-key cache keys (`locale:namespace:key`) the stored blob lists. */
+    async storedNamespaceKeys(locale, namespace) {
+      try {
+        const blob = await this.repository.get(createNamespaceCacheKey(locale, namespace));
+        if (!blob) return [];
+        return Object.keys(flattenTranslations(JSON.parse(blob), "", locale, namespace));
+      } catch {
+        return [];
+      }
+    }
+    async removeQuietly(cacheKey) {
+      this.ttlMap.delete(cacheKey);
+      try {
+        await this.repository.remove(cacheKey);
+      } catch {
+      }
+    }
     /**
      * ✅ Strategy 1: Direct cache lookup using unified pattern
      * Returns parsed ContentUnit (text + styles) or null
@@ -2234,6 +2527,15 @@ var __lionrapidAutoExports = (() => {
       const config = this.repository.getConfig();
       return config.options?.preloadNamespaces || [];
     }
+    /**
+     * The host this handler talks to. Exposed so a failure can NAME it: "the
+     * server is unreachable" is not actionable, and a default pointing at a dead
+     * host is exactly the case where the reader needs to be told which host.
+     */
+    getBaseUrl() {
+      const config = this.repository.getConfig();
+      return config.options?.baseUrl || "";
+    }
   };
 
   // src/content/canonical-tag.ts
@@ -3080,7 +3382,9 @@ var __lionrapidAutoExports = (() => {
         const processedText = this.processTranslationValue(unit.text, request);
         return processedText.replace(/<\/?[0-9]+\/?>/g, "");
       } catch (error) {
-        logger.warn(`ContentUnit processing failed for "${value}":`, error);
+        logger.warn(
+          `ContentUnit processing failed for key "${request.cleanKey}" \u2014 ${describeContent(value)}: ${describeError(error)}`
+        );
         return this.processTranslationValue(value, request);
       }
     }
@@ -3133,7 +3437,9 @@ var __lionrapidAutoExports = (() => {
         }
         return processedValue;
       } catch (error) {
-        logger.warn(`Translation processing failed for "${value}":`, error);
+        logger.warn(
+          `Translation processing failed for key "${resolvedKey ?? "(no key)"}" \u2014 ${describeContent(value)}: ${describeError(error)}`
+        );
         return value;
       }
     }
@@ -3850,8 +4156,9 @@ var __lionrapidAutoExports = (() => {
       const warnLoudlyOnce = (namespaceKey, error) => {
         if (!isLoudPreloadFailure(error) || warnedLoudly) return;
         warnedLoudly = true;
+        const baseUrl = networkHandler.getBaseUrl() || "(no base URL configured)";
         console.warn(
-          `[LionRapid] Could not load translations for ${namespaceKey} \u2014 the page stays untranslated until the server is reachable.`,
+          `[LionRapid] Could not load translations for ${namespaceKey} from ${baseUrl} \u2014 the page stays untranslated until that host is reachable. If it is wrong, set data-base-url on the snippet tag (or \`baseUrl\` in the network repository options).`,
           error
         );
       };
@@ -3871,6 +4178,12 @@ var __lionrapidAutoExports = (() => {
             logger.debug(`Preloaded: ${namespaceKey}`);
             return;
           }
+          if (result?.status === 404) {
+            await handlerChain.forgetNamespaceInHandlers({
+              locale: preloadConfig.locale,
+              namespace: preloadConfig.namespace
+            });
+          }
           if (result?.error) {
             warnLoudlyOnce(namespaceKey, result.error);
             logger.warn(`Preload failed: ${namespaceKey}`, result.error);
@@ -3979,7 +4292,7 @@ var __lionrapidAutoExports = (() => {
           throw new TranslationNotFoundError(key);
         }
         if (typeof translation === "object" && "text" in translation) {
-          logger.debug(`ContentUnit text: "${translation.text}"`);
+          logger.debug(`ContentUnit text: ${describeContent(translation.text)}`);
           return translation.text;
         }
         return String(translation);
@@ -4014,13 +4327,18 @@ var __lionrapidAutoExports = (() => {
           throw new TranslationNotFoundError(key);
         }
         if (typeof translation === "object" && "text" in translation) {
-          logger.debug(`ContentUnit for "${key}": text="${translation.text}", styles=`, translation.styles);
+          logger.debug(
+            `ContentUnit for "${key}": text=${describeContent(translation.text)}, styles=`,
+            translation.styles
+          );
           return {
             text: translation.text,
             styles: translation.styles || {}
           };
         }
-        logger.debug(`Plain string for "${key}": "${translation}" (no styles)`);
+        logger.debug(
+          `Plain string for "${key}": ${describeContent(String(translation))} (no styles)`
+        );
         return {
           text: String(translation),
           styles: {}
@@ -4603,167 +4921,6 @@ var __lionrapidAutoExports = (() => {
     return { text, styles };
   }
 
-  // src/browser/md5.ts
-  function safeAdd(x, y) {
-    const lsw = (x & 65535) + (y & 65535);
-    const msw = (x >> 16) + (y >> 16) + (lsw >> 16);
-    return msw << 16 | lsw & 65535;
-  }
-  function bitRotateLeft(num, cnt) {
-    return num << cnt | num >>> 32 - cnt;
-  }
-  function md5cmn(q, a, b, x, s, t) {
-    return safeAdd(bitRotateLeft(safeAdd(safeAdd(a, q), safeAdd(x, t)), s), b);
-  }
-  function md5ff(a, b, c, d, x, s, t) {
-    return md5cmn(b & c | ~b & d, a, b, x, s, t);
-  }
-  function md5gg(a, b, c, d, x, s, t) {
-    return md5cmn(b & d | c & ~d, a, b, x, s, t);
-  }
-  function md5hh(a, b, c, d, x, s, t) {
-    return md5cmn(b ^ c ^ d, a, b, x, s, t);
-  }
-  function md5ii(a, b, c, d, x, s, t) {
-    return md5cmn(c ^ (b | ~d), a, b, x, s, t);
-  }
-  function binlMD5(x, len) {
-    x[len >> 5] |= 128 << len % 32;
-    x[(len + 64 >>> 9 << 4) + 14] = len;
-    let a = 1732584193;
-    let b = -271733879;
-    let c = -1732584194;
-    let d = 271733878;
-    for (let i = 0; i < x.length; i += 16) {
-      const olda = a;
-      const oldb = b;
-      const oldc = c;
-      const oldd = d;
-      a = md5ff(a, b, c, d, x[i], 7, -680876936);
-      d = md5ff(d, a, b, c, x[i + 1], 12, -389564586);
-      c = md5ff(c, d, a, b, x[i + 2], 17, 606105819);
-      b = md5ff(b, c, d, a, x[i + 3], 22, -1044525330);
-      a = md5ff(a, b, c, d, x[i + 4], 7, -176418897);
-      d = md5ff(d, a, b, c, x[i + 5], 12, 1200080426);
-      c = md5ff(c, d, a, b, x[i + 6], 17, -1473231341);
-      b = md5ff(b, c, d, a, x[i + 7], 22, -45705983);
-      a = md5ff(a, b, c, d, x[i + 8], 7, 1770035416);
-      d = md5ff(d, a, b, c, x[i + 9], 12, -1958414417);
-      c = md5ff(c, d, a, b, x[i + 10], 17, -42063);
-      b = md5ff(b, c, d, a, x[i + 11], 22, -1990404162);
-      a = md5ff(a, b, c, d, x[i + 12], 7, 1804603682);
-      d = md5ff(d, a, b, c, x[i + 13], 12, -40341101);
-      c = md5ff(c, d, a, b, x[i + 14], 17, -1502002290);
-      b = md5ff(b, c, d, a, x[i + 15], 22, 1236535329);
-      a = md5gg(a, b, c, d, x[i + 1], 5, -165796510);
-      d = md5gg(d, a, b, c, x[i + 6], 9, -1069501632);
-      c = md5gg(c, d, a, b, x[i + 11], 14, 643717713);
-      b = md5gg(b, c, d, a, x[i], 20, -373897302);
-      a = md5gg(a, b, c, d, x[i + 5], 5, -701558691);
-      d = md5gg(d, a, b, c, x[i + 10], 9, 38016083);
-      c = md5gg(c, d, a, b, x[i + 15], 14, -660478335);
-      b = md5gg(b, c, d, a, x[i + 4], 20, -405537848);
-      a = md5gg(a, b, c, d, x[i + 9], 5, 568446438);
-      d = md5gg(d, a, b, c, x[i + 14], 9, -1019803690);
-      c = md5gg(c, d, a, b, x[i + 3], 14, -187363961);
-      b = md5gg(b, c, d, a, x[i + 8], 20, 1163531501);
-      a = md5gg(a, b, c, d, x[i + 13], 5, -1444681467);
-      d = md5gg(d, a, b, c, x[i + 2], 9, -51403784);
-      c = md5gg(c, d, a, b, x[i + 7], 14, 1735328473);
-      b = md5gg(b, c, d, a, x[i + 12], 20, -1926607734);
-      a = md5hh(a, b, c, d, x[i + 5], 4, -378558);
-      d = md5hh(d, a, b, c, x[i + 8], 11, -2022574463);
-      c = md5hh(c, d, a, b, x[i + 11], 16, 1839030562);
-      b = md5hh(b, c, d, a, x[i + 14], 23, -35309556);
-      a = md5hh(a, b, c, d, x[i + 1], 4, -1530992060);
-      d = md5hh(d, a, b, c, x[i + 4], 11, 1272893353);
-      c = md5hh(c, d, a, b, x[i + 7], 16, -155497632);
-      b = md5hh(b, c, d, a, x[i + 10], 23, -1094730640);
-      a = md5hh(a, b, c, d, x[i + 13], 4, 681279174);
-      d = md5hh(d, a, b, c, x[i + 0], 11, -358537222);
-      c = md5hh(c, d, a, b, x[i + 3], 16, -722521979);
-      b = md5hh(b, c, d, a, x[i + 6], 23, 76029189);
-      a = md5hh(a, b, c, d, x[i + 9], 4, -640364487);
-      d = md5hh(d, a, b, c, x[i + 12], 11, -421815835);
-      c = md5hh(c, d, a, b, x[i + 15], 16, 530742520);
-      b = md5hh(b, c, d, a, x[i + 2], 23, -995338651);
-      a = md5ii(a, b, c, d, x[i], 6, -198630844);
-      d = md5ii(d, a, b, c, x[i + 7], 10, 1126891415);
-      c = md5ii(c, d, a, b, x[i + 14], 15, -1416354905);
-      b = md5ii(b, c, d, a, x[i + 5], 21, -57434055);
-      a = md5ii(a, b, c, d, x[i + 12], 6, 1700485571);
-      d = md5ii(d, a, b, c, x[i + 3], 10, -1894986606);
-      c = md5ii(c, d, a, b, x[i + 10], 15, -1051523);
-      b = md5ii(b, c, d, a, x[i + 1], 21, -2054922799);
-      a = md5ii(a, b, c, d, x[i + 8], 6, 1873313359);
-      d = md5ii(d, a, b, c, x[i + 15], 10, -30611744);
-      c = md5ii(c, d, a, b, x[i + 6], 15, -1560198380);
-      b = md5ii(b, c, d, a, x[i + 13], 21, 1309151649);
-      a = md5ii(a, b, c, d, x[i + 4], 6, -145523070);
-      d = md5ii(d, a, b, c, x[i + 11], 10, -1120210379);
-      c = md5ii(c, d, a, b, x[i + 2], 15, 718787259);
-      b = md5ii(b, c, d, a, x[i + 9], 21, -343485551);
-      a = safeAdd(a, olda);
-      b = safeAdd(b, oldb);
-      c = safeAdd(c, oldc);
-      d = safeAdd(d, oldd);
-    }
-    return [a, b, c, d];
-  }
-  function binl2hex(binarray) {
-    const hexTab = "0123456789abcdef";
-    let str = "";
-    for (let i = 0; i < binarray.length * 4; i++) {
-      str += hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 + 4 & 15) + hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 & 15);
-    }
-    return str;
-  }
-  function utf8Bytes(str) {
-    if (typeof TextEncoder !== "undefined") {
-      return new TextEncoder().encode(str);
-    }
-    const out = [];
-    for (let i = 0; i < str.length; i++) {
-      const c = str.charCodeAt(i);
-      if (c < 128) {
-        out.push(c);
-      } else if (c < 2048) {
-        out.push(192 | c >> 6, 128 | c & 63);
-      } else if (c >= 55296 && c < 56320 && i + 1 < str.length) {
-        const c2 = str.charCodeAt(++i);
-        const cp = 65536 + (c - 55296 << 10) + (c2 - 56320);
-        out.push(
-          240 | cp >> 18,
-          128 | cp >> 12 & 63,
-          128 | cp >> 6 & 63,
-          128 | cp & 63
-        );
-      } else {
-        out.push(
-          224 | c >> 12,
-          128 | c >> 6 & 63,
-          128 | c & 63
-        );
-      }
-    }
-    return new Uint8Array(out);
-  }
-  function bytes2binl(bytes) {
-    const bin = [];
-    for (let i = 0; i < bytes.length; i++) {
-      bin[i >> 2] |= bytes[i] << i % 4 * 8;
-    }
-    return bin;
-  }
-  function md5(str) {
-    const bytes = utf8Bytes(str);
-    return binl2hex(binlMD5(bytes2binl(bytes), bytes.length * 8));
-  }
-  function generateAutoKey(text) {
-    const trimmed = text.trim();
-    return "auto_" + md5(trimmed).substring(0, 12);
-  }
-
   // src/browser/block-extractor.ts
   var BLOCK_SELECTOR = "p,h1,h2,h3,h4,h5,h6,li,td,th,label,button,figcaption,dt,dd,summary,caption";
   var INLINE_BLOCK_SELECTOR = "a";
@@ -5563,6 +5720,32 @@ var __lionrapidAutoExports = (() => {
 .lionrapid-btn-row button:hover { background: #f5f5f5; }
 .lionrapid-btn-row button.active { background: #3b82f6; color: #fff; }
 `;
+  var HEADER_GAP_PX = 8;
+  var CORNER_INSET_PX = 20;
+  function topCornerOffset(doc = document, win = window) {
+    const viewport = win.innerHeight || doc.documentElement.clientHeight || 0;
+    const span = (el) => {
+      const style = win.getComputedStyle(el);
+      if (style.display === "none" || style.visibility === "hidden") return null;
+      const rect = el.getBoundingClientRect();
+      if (rect.height <= 0) return null;
+      const pinned = style.position === "fixed" || style.position === "sticky";
+      const shift = pinned ? 0 : win.scrollY;
+      return [rect.top + shift, rect.bottom + shift];
+    };
+    const adminBar = doc.getElementById("wpadminbar");
+    const barBottom = adminBar && span(adminBar)?.[1] || 0;
+    let bottom = barBottom;
+    doc.querySelectorAll('header, [role="banner"]').forEach((el) => {
+      if (el.closest("article, main, aside")) return;
+      const s = span(el);
+      if (!s || s[0] > barBottom + HEADER_GAP_PX * 4) return;
+      bottom = Math.max(bottom, s[1]);
+    });
+    if (bottom === 0) return CORNER_INSET_PX;
+    const below = Math.ceil(bottom) + HEADER_GAP_PX;
+    return viewport > 0 ? Math.min(below, Math.floor(viewport / 2)) : below;
+  }
   var LanguageSwitcher = class {
     constructor() {
       __publicField(this, "core", null);
@@ -5623,6 +5806,14 @@ var __lionrapidAutoExports = (() => {
       const showNames = element.dataset.lionrapidSwitcherShowNames !== "false";
       const customCss = element.dataset.lionrapidSwitcherCustomCss || null;
       element.dataset.position = position;
+      if (position.startsWith("top")) {
+        const place = () => {
+          element.style.top = `${topCornerOffset()}px`;
+        };
+        place();
+        window.addEventListener("load", place);
+        window.addEventListener("resize", place);
+      }
       if (customCss) {
         const styleEl = document.createElement("style");
         styleEl.textContent = customCss;
@@ -6061,6 +6252,8 @@ var __lionrapidAutoExports = (() => {
       __publicField(this, "type", "storage");
       __publicField(this, "config");
       __publicField(this, "cacheName");
+      /** CACHE_PREFIX, plus `<scope>/` when scoped. */
+      __publicField(this, "entryPrefix");
       __publicField(this, "defaultTTL");
       __publicField(this, "available");
       this.config = {
@@ -6074,6 +6267,8 @@ var __lionrapidAutoExports = (() => {
         }
       };
       this.cacheName = this.config.options?.cacheName ?? CACHE_NAME;
+      const scope = this.config.options?.scope;
+      this.entryPrefix = scope ? `${CACHE_PREFIX}${encodeURIComponent(scope)}/` : CACHE_PREFIX;
       this.defaultTTL = this.config.options?.ttl ?? 7 * 24 * 60 * 60 * 1e3;
       this.available = this.checkAvailability();
     }
@@ -6094,13 +6289,13 @@ var __lionrapidAutoExports = (() => {
       }
       try {
         const cache = await caches.open(this.cacheName);
-        const response = await cache.match(CACHE_PREFIX + key);
+        const response = await cache.match(this.entryPrefix + key);
         if (!response) {
           throw new TranslationNotFoundError(key);
         }
         const data = await response.json();
         if (data.expiry !== null && Date.now() > data.expiry) {
-          await cache.delete(CACHE_PREFIX + key);
+          await cache.delete(this.entryPrefix + key);
           throw new TranslationNotFoundError(key);
         }
         return data.value;
@@ -6124,7 +6319,7 @@ var __lionrapidAutoExports = (() => {
           timestamp: Date.now()
         };
         await cache.put(
-          CACHE_PREFIX + key,
+          this.entryPrefix + key,
           new Response(JSON.stringify(data), {
             headers: { "Content-Type": "application/json" }
           })
@@ -6139,7 +6334,7 @@ var __lionrapidAutoExports = (() => {
       if (!this.available) return;
       try {
         const cache = await caches.open(this.cacheName);
-        await cache.delete(CACHE_PREFIX + key);
+        await cache.delete(this.entryPrefix + key);
       } catch {
       }
     }
@@ -6152,7 +6347,7 @@ var __lionrapidAutoExports = (() => {
         const cache = await caches.open(this.cacheName);
         const keys = await cache.keys();
         await Promise.all(
-          keys.filter((request) => request.url.includes(CACHE_PREFIX)).map((request) => cache.delete(request))
+          keys.filter((request) => request.url.includes(this.entryPrefix)).map((request) => cache.delete(request))
         );
       } catch {
       }
@@ -6170,7 +6365,7 @@ var __lionrapidAutoExports = (() => {
         await Promise.all(
           keys.filter((request) => {
             const url = request.url;
-            const key = url.includes(CACHE_PREFIX) ? url.substring(url.indexOf(CACHE_PREFIX) + CACHE_PREFIX.length) : "";
+            const key = url.includes(this.entryPrefix) ? url.substring(url.indexOf(this.entryPrefix) + this.entryPrefix.length) : "";
             return key === namespaceCacheKey || key.startsWith(keyPrefix);
           }).map((request) => cache.delete(request))
         );
@@ -6222,9 +6417,9 @@ var __lionrapidAutoExports = (() => {
         const keys = await cache.keys();
         for (const request of keys) {
           const url = request.url;
-          if (!url.includes(CACHE_PREFIX)) continue;
+          if (!url.includes(this.entryPrefix)) continue;
           const key = url.substring(
-            url.indexOf(CACHE_PREFIX) + CACHE_PREFIX.length
+            url.indexOf(this.entryPrefix) + this.entryPrefix.length
           );
           try {
             const value = await this.get(key);
@@ -6246,7 +6441,7 @@ var __lionrapidAutoExports = (() => {
       try {
         const cache = await caches.open(this.cacheName);
         const keys = await cache.keys();
-        const size = keys.filter((r) => r.url.includes(CACHE_PREFIX)).length;
+        const size = keys.filter((r) => r.url.includes(this.entryPrefix)).length;
         return { size, cacheName: this.cacheName };
       } catch {
         return { size: 0, cacheName: this.cacheName };
@@ -6254,6 +6449,14 @@ var __lionrapidAutoExports = (() => {
     }
   };
 
+  // src/config/api.config.ts
+  var DEFAULT_API_BASE_URL = "https://app.lionrapid.com";
+
+  // src/browser/storage/scope.ts
+  function storageScope(apiKey) {
+    return apiKey ? md5(apiKey).slice(0, 8) : "none";
+  }
+
   // src/browser/auto-init.ts
   function resolveWritePolicy(apiKey) {
     const isPublishable = apiKey.startsWith("pk_");
@@ -6302,7 +6505,7 @@ var __lionrapidAutoExports = (() => {
   }
   function parseConfig(script) {
     const apiKey = script.dataset.apiKey || "";
-    const baseUrl = script.dataset.baseUrl || "https://api.lionrapid.com";
+    const baseUrl = script.dataset.baseUrl || DEFAULT_API_BASE_URL;
     const defaultLocale = script.dataset.defaultLocale || "en";
     const namespace = script.dataset.namespace || "default";
     const languages = (script.dataset.languages || defaultLocale).split(",").map((s) => s.trim()).filter(Boolean);
@@ -6383,6 +6586,12 @@ var __lionrapidAutoExports = (() => {
       document.documentElement.dir = localeDir(locale);
     }
   }
+  function applyLocaleAttrs(locale) {
+    if (typeof document !== "undefined" && locale) {
+      document.documentElement.lang = locale;
+    }
+    applyLocaleDir(locale);
+  }
   function findConfigScript() {
     const current = document.currentScript;
     if (current instanceof HTMLScriptElement && current.dataset.apiKey) {
@@ -6415,7 +6624,11 @@ var __lionrapidAutoExports = (() => {
       );
     }
     const initialLocale = resolveInitialLocale(config);
-    applyLocaleDir(initialLocale);
+    if (config.mode === "dynamic-only") {
+      applyLocaleDir(initialLocale);
+    } else {
+      applyLocaleAttrs(initialLocale);
+    }
     const languageSwitcher = new LanguageSwitcher();
     languageSwitcher.setLanguages(config.languages);
     languageSwitcher.setInitialLocale(initialLocale);
@@ -6449,18 +6662,25 @@ var __lionrapidAutoExports = (() => {
       navigate: config.mode === "dynamic-only" ? (locale) => navigateToLocale(locale, config.defaultLocale, config.languages) : null
     });
     languageSwitcher.setOnLanguageChange(localeHandler.onChange);
+    const storeScope = storageScope(config.apiKey);
     try {
       const builder = LionRapidBuilder.init({
         defaultLocale: initialLocale,
         namespace: config.namespace
-      }).use(new MemoryRepository({ enabled: true })).use(new LocalStorageRepository({ enabled: true })).use(new CacheStorageRepository({ enabled: true }));
+      }).use(new MemoryRepository({ enabled: true })).use(
+        new LocalStorageRepository({
+          enabled: true,
+          options: { prefix: `lionrapid:${storeScope}:` }
+        })
+      ).use(new CacheStorageRepository({ enabled: true, options: { scope: storeScope } }));
       if (config.offline !== false) {
         builder.use(
           new CacheStorageRepository({
             enabled: true,
             options: {
               ttl: Number.MAX_SAFE_INTEGER,
-              cacheName: CORE_CACHE_NAMES.offlineFloor
+              cacheName: CORE_CACHE_NAMES.offlineFloor,
+              scope: storeScope
             }
           })
         );
@@ -6501,7 +6721,7 @@ var __lionrapidAutoExports = (() => {
         await core.changeLanguage(locale, {
           preloadNamespaces: [config.namespace]
         });
-        applyLocaleDir(locale);
+        applyLocaleAttrs(locale);
         autoTranslator.updateLocale(locale);
         autoTranslator.retranslate();
       });
@@ -6548,7 +6768,7 @@ var __lionrapidAutoExports = (() => {
           await core.changeLanguage(locale, {
             preloadNamespaces: [config.namespace]
           });
-          applyLocaleDir(locale);
+          applyLocaleAttrs(locale);
           autoTranslator.updateLocale(locale);
           autoTranslator.retranslate();
           languageSwitcher.initAll();