@unhingged/vizu-core 0.1.23 → 0.2.0

package/dist/index.cjs

@@ -9,9 +9,9 @@ var __export = (target, all) => {
 };
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
-    for (let key2 of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key2) && key2 !== except)
-        __defProp(to, key2, { get: () => from[key2], enumerable: !(desc = __getOwnPropDesc(from, key2)) || desc.enumerable });
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
   }
   return to;
 };
@@ -21,9 +21,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   CloudStorageAdapter: () => CloudStorageAdapter,
-  InMemoryStorageAdapter: () => InMemoryStorageAdapter,
-  LocalStorageAdapter: () => LocalStorageAdapter,
-  NullStorageAdapter: () => NullStorageAdapter,
   SCHEMA_VERSION: () => SCHEMA_VERSION,
   Vizu: () => Vizu,
   findByFingerprint: () => findByFingerprint,
@@ -168,204 +165,6 @@ function needsPersist(raws) {
   return false;
 }
 
-// src/storage.ts
-var key = (ns) => `vizu:comments:${ns}`;
-var LocalStorageAdapter = class {
-  async load(namespace) {
-    return readArray(namespace);
-  }
-  async addComment(namespace, comment) {
-    const list = readArray(namespace);
-    list.push(comment);
-    writeArray(namespace, list);
-  }
-  async updateComment(namespace, id, patch) {
-    const list = readArray(namespace);
-    const idx = list.findIndex((c) => c.id === id);
-    if (idx === -1) return null;
-    const next = { ...list[idx], ...patch, id: list[idx].id };
-    list[idx] = next;
-    writeArray(namespace, list);
-    return next;
-  }
-  async removeComment(namespace, id) {
-    const list = readArray(namespace);
-    writeArray(namespace, list.filter((c) => c.id !== id));
-  }
-  async setAll(namespace, comments) {
-    writeArray(namespace, comments);
-  }
-  async clear(namespace) {
-    if (typeof localStorage === "undefined") return;
-    localStorage.removeItem(key(namespace));
-  }
-  async addReply(namespace, commentId, reply) {
-    const list = readArray(namespace);
-    const idx = list.findIndex((c) => c.id === commentId);
-    if (idx === -1) return null;
-    const next = { ...list[idx], replies: [...list[idx].replies ?? [], reply] };
-    list[idx] = next;
-    writeArray(namespace, list);
-    return next;
-  }
-  async removeReply(namespace, commentId, replyId) {
-    const list = readArray(namespace);
-    const idx = list.findIndex((c) => c.id === commentId);
-    if (idx === -1) return null;
-    const next = {
-      ...list[idx],
-      replies: (list[idx].replies ?? []).filter((r) => r.id !== replyId)
-    };
-    list[idx] = next;
-    writeArray(namespace, list);
-    return next;
-  }
-};
-function readArray(namespace) {
-  if (typeof localStorage === "undefined") return [];
-  const raw = localStorage.getItem(key(namespace));
-  if (!raw) return [];
-  try {
-    const parsed = JSON.parse(raw);
-    return Array.isArray(parsed) ? migrateComments(parsed) : [];
-  } catch {
-    return [];
-  }
-}
-function writeArray(namespace, comments) {
-  if (typeof localStorage === "undefined") return;
-  localStorage.setItem(key(namespace), JSON.stringify(comments));
-}
-var InMemoryStorageAdapter = class {
-  constructor() {
-    this.store = /* @__PURE__ */ new Map();
-  }
-  async load(namespace) {
-    return [...this.store.get(namespace) || []];
-  }
-  async addComment(namespace, comment) {
-    const list = this.store.get(namespace) ?? [];
-    this.store.set(namespace, [...list, comment]);
-  }
-  async updateComment(namespace, id, patch) {
-    const list = this.store.get(namespace) ?? [];
-    const idx = list.findIndex((c) => c.id === id);
-    if (idx === -1) return null;
-    const next = { ...list[idx], ...patch, id: list[idx].id };
-    const copy = [...list];
-    copy[idx] = next;
-    this.store.set(namespace, copy);
-    return next;
-  }
-  async removeComment(namespace, id) {
-    const list = this.store.get(namespace) ?? [];
-    this.store.set(
-      namespace,
-      list.filter((c) => c.id !== id)
-    );
-  }
-  async setAll(namespace, comments) {
-    this.store.set(namespace, [...comments]);
-  }
-  async clear(namespace) {
-    this.store.delete(namespace);
-  }
-  async addReply(namespace, commentId, reply) {
-    const list = this.store.get(namespace) ?? [];
-    const idx = list.findIndex((c) => c.id === commentId);
-    if (idx === -1) return null;
-    const next = { ...list[idx], replies: [...list[idx].replies ?? [], reply] };
-    const copy = [...list];
-    copy[idx] = next;
-    this.store.set(namespace, copy);
-    return next;
-  }
-  async removeReply(namespace, commentId, replyId) {
-    const list = this.store.get(namespace) ?? [];
-    const idx = list.findIndex((c) => c.id === commentId);
-    if (idx === -1) return null;
-    const next = {
-      ...list[idx],
-      replies: (list[idx].replies ?? []).filter((r) => r.id !== replyId)
-    };
-    const copy = [...list];
-    copy[idx] = next;
-    this.store.set(namespace, copy);
-    return next;
-  }
-};
-var NullStorageAdapter = class {
-  async load() {
-    return [];
-  }
-  async addComment() {
-  }
-  async updateComment() {
-    return null;
-  }
-  async removeComment() {
-  }
-  async setAll() {
-  }
-  async clear() {
-  }
-};
-function isV1Adapter(x) {
-  if (!x || typeof x !== "object") return false;
-  const o = x;
-  return typeof o.load === "function" && typeof o.save === "function" && typeof o.clear === "function" && typeof o.addComment !== "function";
-}
-function wrapV1Adapter(v1) {
-  if (!isV1Adapter(v1)) return v1;
-  let warned = false;
-  const warnOnce = () => {
-    if (warned) return;
-    warned = true;
-    if (typeof console !== "undefined") {
-      console.warn(
-        "[vizu] StorageAdapter v1 detected. Per-comment ops are emulated via full-array rewrites \u2014 upgrade your adapter to the v2 interface (addComment / updateComment / removeComment / setAll / load / clear) when you can."
-      );
-    }
-  };
-  return {
-    async load(namespace) {
-      warnOnce();
-      return v1.load(namespace);
-    },
-    async addComment(namespace, comment) {
-      warnOnce();
-      const list = await v1.load(namespace);
-      list.push(comment);
-      await v1.save(namespace, list);
-    },
-    async updateComment(namespace, id, patch) {
-      warnOnce();
-      const list = await v1.load(namespace);
-      const idx = list.findIndex((c) => c.id === id);
-      if (idx === -1) return null;
-      const next = { ...list[idx], ...patch, id: list[idx].id };
-      list[idx] = next;
-      await v1.save(namespace, list);
-      return next;
-    },
-    async removeComment(namespace, id) {
-      warnOnce();
-      const list = await v1.load(namespace);
-      await v1.save(
-        namespace,
-        list.filter((c) => c.id !== id)
-      );
-    },
-    async setAll(namespace, comments) {
-      warnOnce();
-      await v1.save(namespace, comments);
-    },
-    async clear(namespace) {
-      await v1.clear(namespace);
-    }
-  };
-}
-
 // src/cloud.ts
 var DEFAULT_API_URL = "https://vizu.unhingged.com";
 var POPUP_WIDTH = 480;
@@ -1422,8 +1221,8 @@ var Popover = class {
       const removeBtn = target.closest('[data-vz="remove-anchor"]');
       if (removeBtn) {
         e.stopPropagation();
-        const key2 = removeBtn.getAttribute("data-fp-key");
-        if (key2) this.removeAnchor(key2);
+        const key = removeBtn.getAttribute("data-fp-key");
+        if (key) this.removeAnchor(key);
         return;
       }
       const refEl = target.closest('[data-vz="ref"]');
@@ -1518,8 +1317,8 @@ var Popover = class {
   }
   /** Add another anchor to the in-progress comment (Shift+Click flow). */
   addAnchor(fp, target) {
-    const key2 = fingerprintKey(fp);
-    if (this.anchorFingerprints.some((x) => fingerprintKey(x) === key2)) return false;
+    const key = fingerprintKey(fp);
+    if (this.anchorFingerprints.some((x) => fingerprintKey(x) === key)) return false;
     this.anchorFingerprints.push(fp);
     if (target) this.anchorTargets.push(target);
     this.callbacks.onAnchorsChanged([...this.anchorFingerprints]);
@@ -1528,9 +1327,9 @@ var Popover = class {
     return true;
   }
   /** Remove an anchor by fingerprint key. Never removes the last anchor. */
-  removeAnchor(key2) {
+  removeAnchor(key) {
     if (this.anchorFingerprints.length <= 1) return false;
-    const idx = this.anchorFingerprints.findIndex((x) => fingerprintKey(x) === key2);
+    const idx = this.anchorFingerprints.findIndex((x) => fingerprintKey(x) === key);
     if (idx < 0) return false;
     this.anchorFingerprints.splice(idx, 1);
     this.anchorTargets.splice(idx, 1);
@@ -1640,9 +1439,9 @@ var Popover = class {
       return;
     }
     const chips = this.anchorFingerprints.map((fp) => {
-      const key2 = fingerprintKey(fp);
+      const key = fingerprintKey(fp);
       const label = fingerprintLabel(fp);
-      return `<span class="vz-anchor-chip" data-fp-key="${escapeHtml(key2)}">${escapeHtml(label)}<button class="vz-anchor-chip-remove" data-vz="remove-anchor" data-fp-key="${escapeHtml(key2)}" aria-label="Remove anchor">\xD7</button></span>`;
+      return `<span class="vz-anchor-chip" data-fp-key="${escapeHtml(key)}">${escapeHtml(label)}<button class="vz-anchor-chip-remove" data-vz="remove-anchor" data-fp-key="${escapeHtml(key)}" aria-label="Remove anchor">\xD7</button></span>`;
     }).join("");
     wrap.innerHTML = `
       <div class="vz-anchor-hint">Anchored to ${this.anchorFingerprints.length} elements:</div>
@@ -2369,10 +2168,10 @@ var Sidebar = class {
       const fps = c.fingerprints || [];
       const primary = fps[0];
       if (!primary) continue;
-      const key2 = fingerprintKey(primary);
-      const g = groups.get(key2);
+      const key = fingerprintKey(primary);
+      const g = groups.get(key);
       if (g) g.comments.push(c);
-      else groups.set(key2, { fp: primary, comments: [c] });
+      else groups.set(key, { fp: primary, comments: [c] });
     }
     const groupHtml = [];
     let gi = 0;
@@ -2433,8 +2232,8 @@ var Sidebar = class {
     }
     const chips = this.el.querySelectorAll('[data-vz="jump-fp"]');
     for (const chip of chips) {
-      const key2 = chip.getAttribute("data-fp-key");
-      const fp = findFingerprintByKey(visible, key2 || "");
+      const key = chip.getAttribute("data-fp-key");
+      const fp = findFingerprintByKey(visible, key || "");
       chip.__fp = fp;
     }
   }
@@ -2522,10 +2321,10 @@ function renderOrphansHtml(orphans) {
     </div>
   `;
 }
-function findFingerprintByKey(comments, key2) {
+function findFingerprintByKey(comments, key) {
   for (const c of comments) {
     for (const fp of c.fingerprints || []) {
-      if (fingerprintKey(fp) === key2) return fp;
+      if (fingerprintKey(fp) === key) return fp;
     }
   }
   return null;
@@ -3620,30 +3419,17 @@ var EventBus = class {
 // src/index.ts
 var DEFAULTS = {
   shortcut: "mod+shift+e",
-  namespace: "default",
   accent: "#FF6647"
 };
-function resolveStorage(storage, cloud, defaultMode, onAuthChanged) {
-  if (cloud) {
-    if (storage && typeof console !== "undefined") {
-      console.warn("[vizu] Both `cloud` and `storage` set; `cloud` wins. Drop `storage` to silence this.");
-    }
-    return new CloudStorageAdapter({
-      workspace: cloud.workspace,
-      apiUrl: cloud.apiUrl,
-      autoSignIn: cloud.autoSignIn,
-      onAuthChanged
-    });
-  }
-  if (!storage) return defaultMode === "local" ? new LocalStorageAdapter() : new InMemoryStorageAdapter();
-  if (storage === "local") return new LocalStorageAdapter();
-  if (storage === "memory") return new InMemoryStorageAdapter();
-  if (storage === "none") return new NullStorageAdapter();
-  if (isV1Adapter(storage)) return wrapV1Adapter(storage);
-  return storage;
-}
 var Vizu = class {
-  constructor(options = {}, _defaultStorage = "memory") {
+  constructor(options, storageOverride) {
+    /**
+     * The cloud adapter when this instance runs in the normal cloud mode;
+     * null only under the internal storage override (tests / storybook).
+     * Auth-gated behavior (mount gate, write gate, sign-in kicks) branches
+     * on this instead of `instanceof` checks against `this.storage`.
+     */
+    this.cloud = null;
     this.root = null;
     this.highlighter = null;
     this.popover = null;
@@ -3705,8 +3491,8 @@ var Vizu = class {
     this.pendingTargets = [];
     /**
      * Subscribe to remote-change notifications from the active storage
-     * adapter (cloud adapters only). Local adapters never emit. The
-     * subscription is torn down on `destroy()`.
+     * adapter, when it implements `subscribe` (none do today — kept as
+     * the hook realtime lands on). Torn down on `destroy()`.
      */
     this.unsubscribeStorage = null;
     this.onKeyDown = (e) => {
@@ -3749,23 +3535,34 @@ var Vizu = class {
         this.popover?.reposition();
       });
     };
+    if (!storageOverride && !options?.workspace) {
+      throw new Error(
+        "[vizu] `workspace` is required \u2014 create one at https://vizu.unhingged.com and pass new Vizu({ workspace: 'your-slug' })."
+      );
+    }
     this.opts = { ...options };
     this.opts.shortcut = options.shortcut ?? DEFAULTS.shortcut;
-    this.opts.namespace = options.namespace ?? DEFAULTS.namespace;
     this.opts.accent = options.accent ?? DEFAULTS.accent;
+    this.ns = options.workspace ?? "default";
     this.parsedShortcut = parseShortcut(this.opts.shortcut);
     this.user = options.user ?? null;
-    this.storage = resolveStorage(
-      options.storage,
-      options.cloud,
-      _defaultStorage,
-      (info) => {
-        if (info.user) this.setUser(info.user);
-        if (this.hasLoadedComments) {
-          void this.loadComments();
+    if (storageOverride) {
+      this.storage = storageOverride;
+      this.cloud = null;
+    } else {
+      this.cloud = new CloudStorageAdapter({
+        workspace: options.workspace,
+        apiUrl: options.apiUrl,
+        autoSignIn: options.autoSignIn,
+        onAuthChanged: (info) => {
+          if (info.user) this.setUser(info.user);
+          if (this.hasLoadedComments) {
+            void this.loadComments();
+          }
         }
-      }
-    );
+      });
+      this.storage = this.cloud;
+    }
     if (options.actions) this.actions = [...options.actions];
     if (options.onCommentAdded) this.bus.on("comment:added", (p) => options.onCommentAdded(p.comment));
     if (options.onCommentRemoved) this.bus.on("comment:removed", (p) => options.onCommentRemoved(p.id));
@@ -3807,8 +3604,8 @@ var Vizu = class {
    * Resolution order:
    *   1. `options.mentionable` if provided — host-supplied static or
    *      custom resolver. Wins over everything else.
-   *   2. Cloud adapter's API call if running cloud mode.
-   *   3. Empty array (non-cloud, no override).
+   *   2. The workspace's mentionable-members API.
+   *   3. Empty array (internal storage override, no override).
    */
   async searchMentionable() {
     if (this.opts.mentionable) {
@@ -3821,38 +3618,36 @@ var Vizu = class {
         return [];
       }
     }
-    if (this.storage instanceof CloudStorageAdapter) {
-      return this.storage.searchMentionable();
-    }
+    if (this.cloud) return this.cloud.searchMentionable();
     return [];
   }
   /**
    * Whether the full Vizu UI (pill, highlighter, markers, popover) can
-   * be mounted right now. Cloud-mode workspaces hold off until the
-   * user is signed in; non-cloud usage (local / memory storage) has no
-   * auth concept and mounts immediately. Re-checked from `enable()`
-   * and from `setUser()` so that the moment auth resolves, the UI
-   * appears without the user needing to press the shortcut again.
+   * be mounted right now: not until the user is signed in to the
+   * workspace. Re-checked from `enable()` and from `setUser()` so that
+   * the moment auth resolves, the UI appears without the user needing
+   * to press the shortcut again. (Under the internal storage override
+   * there is no auth concept and the UI mounts immediately.)
    */
   shouldMount() {
-    if (!(this.storage instanceof CloudStorageAdapter)) return true;
+    if (!this.cloud) return true;
     return this.user !== null;
   }
   /**
-   * Cloud-mode write gate. Every entry point that creates or modifies a
-   * comment first checks that we have a known user. Without one, the
-   * write would land as Anonymous (or 401 on the backend) — neither is
-   * the right UX. So we re-trigger the sign-in popup and refuse the
-   * action. The user signs in, this.user gets set via onAuthChanged,
-   * then they can retry the click themselves.
+   * Write gate. Every entry point that creates or modifies a comment
+   * first checks that we have a known user. Without one, the write
+   * would land as Anonymous (or 401 on the backend) — neither is the
+   * right UX. So we re-trigger the sign-in popup and refuse the action.
+   * The user signs in, this.user gets set via onAuthChanged, then they
+   * can retry the click themselves.
    *
    * Returns true when the caller may proceed.
    */
   requireUserOrAuth() {
-    if (!(this.storage instanceof CloudStorageAdapter)) return true;
+    if (!this.cloud) return true;
     if (this.user) return true;
-    if (this.storage.isAccessDenied()) return false;
-    void this.storage.preflightAuth().catch(() => {
+    if (this.cloud.isAccessDenied()) return false;
+    void this.cloud.preflightAuth().catch(() => {
     });
     return false;
   }
@@ -3879,19 +3674,19 @@ var Vizu = class {
     return this.enabled;
   }
   /**
-   * Kick the cloud sign-in flow. Call this alongside `enable()` from an
+   * Kick the 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.
+   * so users get the sign-in popup immediately instead of only after
+   * clicking an element. The keyboard shortcut goes through this same
+   * path. No-op when already signed in, when the workspace has already
+   * denied access this session, or under the internal storage override.
    */
   requestAuth() {
-    if (!(this.storage instanceof CloudStorageAdapter)) return;
+    if (!this.cloud) 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 (this.cloud.isAccessDenied()) return;
+    void this.cloud.preflightAuth().catch((err) => {
+      if (err?.code === "auth_canceled" || err?.code === "popup_blocked" || err?.code === "auth_required") return;
       if (typeof console !== "undefined") {
         console.warn("[vizu] preflight auth failed:", err);
       }
@@ -3932,7 +3727,7 @@ var Vizu = class {
   }
   async setComments(comments, opts) {
     this.comments = migrateComments(comments);
-    if (opts?.persist !== false) await this.storage.setAll(this.opts.namespace, this.comments);
+    if (opts?.persist !== false) await this.storage.setAll(this.ns, this.comments);
     this.bus.emit("comments:set", { comments: this.getComments() });
     this.refreshUi();
   }
@@ -3947,7 +3742,7 @@ var Vizu = class {
     const { id: _i, schemaVersion: _s, ...safe } = patch;
     const next = { ...this.comments[idx], ...safe };
     this.comments[idx] = next;
-    const persisted = await this.storage.updateComment(this.opts.namespace, id, safe);
+    const persisted = await this.storage.updateComment(this.ns, id, safe);
     this.bus.emit("comment:updated", { comment: persisted ?? next });
     this.refreshUi();
     return next;
@@ -3989,7 +3784,7 @@ var Vizu = class {
     const idx = this.comments.findIndex((x) => x.id === c.id);
     if (idx !== -1) this.comments[idx] = { ...this.comments[idx], ...patch };
     try {
-      await this.storage.updateComment(this.opts.namespace, c.id, patch);
+      await this.storage.updateComment(this.ns, c.id, patch);
     } catch (err) {
       if (typeof console !== "undefined") {
         console.warn("[vizu] self-heal write failed for", c.id, err);
@@ -4011,8 +3806,8 @@ var Vizu = class {
   }
   /**
    * True iff the active storage adapter implements `uploadAttachment`.
-   * The popover hides its upload UI when this returns false (local /
-   * memory modes don't support attachments today).
+   * The popover hides its upload UI when this returns false (only the
+   * internal offline adapters lack uploads).
    */
   canUploadAttachments() {
     return typeof this.storage.uploadAttachment === "function";
@@ -4025,10 +3820,10 @@ var Vizu = class {
   async uploadAttachment(file) {
     if (!this.storage.uploadAttachment) {
       throw new Error(
-        "[vizu] active storage adapter does not support uploadAttachment; only the CloudStorageAdapter does in v1"
+        "[vizu] active storage adapter does not support uploadAttachment"
       );
     }
-    return this.storage.uploadAttachment(this.opts.namespace, file);
+    return this.storage.uploadAttachment(this.ns, file);
   }
   /**
    * Append a reply to a comment. Returns the parent comment or null if
@@ -4056,9 +3851,9 @@ var Vizu = class {
     this.comments[idx] = updated;
     try {
       if (this.storage.addReply) {
-        await this.storage.addReply(this.opts.namespace, commentId, reply);
+        await this.storage.addReply(this.ns, commentId, reply);
       } else {
-        await this.storage.updateComment(this.opts.namespace, commentId, { replies: updated.replies });
+        await this.storage.updateComment(this.ns, commentId, { replies: updated.replies });
       }
     } catch (err) {
       const cur = this.comments[idx];
@@ -4098,9 +3893,9 @@ var Vizu = class {
     const updated = { ...this.comments[idx], replies: filtered };
     this.comments[idx] = updated;
     if (this.storage.removeReply) {
-      await this.storage.removeReply(this.opts.namespace, commentId, replyId);
+      await this.storage.removeReply(this.ns, commentId, replyId);
     } else {
-      await this.storage.updateComment(this.opts.namespace, commentId, { replies: filtered });
+      await this.storage.updateComment(this.ns, commentId, { replies: filtered });
     }
     this.bus.emit("comment:updated", { comment: updated });
     this.refreshUi();
@@ -4113,7 +3908,7 @@ var Vizu = class {
   async clearAll() {
     const previous = this.comments;
     this.comments = [];
-    await this.storage.clear(this.opts.namespace);
+    await this.storage.clear(this.ns);
     this.bus.emit("comments:cleared", { previous });
     this.refreshUi();
     this.popover?.close();
@@ -4154,10 +3949,10 @@ var Vizu = class {
   }
   /* ===== Internal ===== */
   async loadComments() {
-    const raw = await this.storage.load(this.opts.namespace);
+    const raw = await this.storage.load(this.ns);
     this.comments = migrateComments(raw);
     if (needsPersist(raw)) {
-      void this.storage.setAll(this.opts.namespace, this.comments).catch(() => {
+      void this.storage.setAll(this.ns, this.comments).catch(() => {
       });
     }
     this.bus.emit("comments:loaded", { comments: this.getComments() });
@@ -4166,7 +3961,7 @@ var Vizu = class {
   subscribeStorage() {
     if (this.unsubscribeStorage) return;
     if (!this.storage.subscribe) return;
-    this.unsubscribeStorage = this.storage.subscribe(this.opts.namespace, (e) => {
+    this.unsubscribeStorage = this.storage.subscribe(this.ns, (e) => {
       if (e.type === "added") {
         const fresh = migrateComment(e.comment);
         if (!this.comments.some((c) => c.id === fresh.id)) {
@@ -4318,9 +4113,9 @@ var Vizu = class {
     this.bus.emit("element:deselected", {});
   }
   addToSelection(fp, el) {
-    const key2 = fingerprintKey(fp);
-    if (this.pendingFingerprints.some((x) => fingerprintKey(x) === key2)) {
-      this.pendingFingerprints = this.pendingFingerprints.filter((x) => fingerprintKey(x) !== key2);
+    const key = fingerprintKey(fp);
+    if (this.pendingFingerprints.some((x) => fingerprintKey(x) === key)) {
+      this.pendingFingerprints = this.pendingFingerprints.filter((x) => fingerprintKey(x) !== key);
       this.pendingTargets = this.pendingTargets.filter((t) => t !== el);
     } else {
       this.pendingFingerprints.push(fp);
@@ -4344,9 +4139,9 @@ var Vizu = class {
     return (c.status ?? "open") === this.statusFilter;
   }
   commentsForElement(fp) {
-    const key2 = fingerprintKey(fp);
+    const key = fingerprintKey(fp);
     return this.comments.filter(
-      (c) => (c.fingerprints || []).some((f) => fingerprintKey(f) === key2)
+      (c) => (c.fingerprints || []).some((f) => fingerprintKey(f) === key)
     );
   }
   async addCommentFromPopover(text, fps, references, mentions, attachments) {
@@ -4370,7 +4165,7 @@ var Vizu = class {
       mentions: mentions ?? []
     };
     this.comments.push(c);
-    await this.storage.addComment(this.opts.namespace, c);
+    await this.storage.addComment(this.ns, c);
     this.bus.emit("comment:added", { comment: c });
     this.popover?.update(this.commentsForElement(fps[0]));
     this.refreshUi();
@@ -4381,7 +4176,7 @@ var Vizu = class {
     const comment = this.comments[idx];
     this.comments = this.comments.filter((c) => c.id !== id);
     try {
-      await this.storage.removeComment(this.opts.namespace, id);
+      await this.storage.removeComment(this.ns, id);
     } catch (err) {
       this.comments.splice(idx, 0, comment);
       const status = err?.status;
@@ -4479,8 +4274,8 @@ var Vizu = class {
         this.spotlights.delete(entry);
       }, 1800);
     }
-    const key2 = fingerprintKey(fp);
-    const outline = this.outlines.get(key2)?.outline;
+    const key = fingerprintKey(fp);
+    const outline = this.outlines.get(key)?.outline;
     if (outline) {
       setTimeout(() => {
         outline.classList.remove("is-pulsing");
@@ -4503,8 +4298,8 @@ var Vizu = class {
     const bestConf = (a, b) => a === void 0 ? b : rankConf(b) > rankConf(a) ? b : a;
     for (const c of this.comments) {
       for (const fp of c.fingerprints || []) {
-        const key2 = fingerprintKey(fp);
-        let bucket = byElement.get(key2);
+        const key = fingerprintKey(fp);
+        let bucket = byElement.get(key);
         if (!bucket) {
           const match = findByFingerprint(fp);
           bucket = {
@@ -4513,7 +4308,7 @@ var Vizu = class {
             confidence: match.confidence,
             commentIds: []
           };
-          byElement.set(key2, bucket);
+          byElement.set(key, bucket);
         }
         bucket.commentIds.push(c.id);
         perComment.set(c.id, bestConf(perComment.get(c.id), bucket.confidence));
@@ -4532,7 +4327,7 @@ var Vizu = class {
       if (this.resolvedConfidence.get(c.id) !== "drifted") continue;
       void this.selfHealComment(c, byElement);
     }
-    for (const [key2, info] of byElement) {
+    for (const [key, info] of byElement) {
       if (info.confidence === "orphaned" || !info.target) continue;
       const idsForFilter = info.commentIds.filter((id) => this.commentMatchesStatusFilter(id));
       if (idsForFilter.length === 0) continue;
@@ -4540,11 +4335,11 @@ var Vizu = class {
       outlineEl.className = "vz-comment-outline";
       if (info.confidence === "drifted") outlineEl.classList.add("vz-comment-outline-drifted");
       this.root.appendChild(outlineEl);
-      this.outlines.set(key2, { outline: outlineEl, target: info.target, fp: info.fp });
+      this.outlines.set(key, { outline: outlineEl, target: info.target, fp: info.fp });
       const marker = document.createElement("button");
       marker.className = "vz-marker";
       if (info.confidence === "drifted") marker.classList.add("vz-marker-drifted");
-      marker.setAttribute("data-element-key", key2);
+      marker.setAttribute("data-element-key", key);
       marker.setAttribute("data-confidence", info.confidence);
       const total = idsForFilter.length;
       if (total > 1) {
@@ -4563,9 +4358,9 @@ var Vizu = class {
           this.openPopoverFor([info.target], [info.fp], elComments);
         }
       });
-      marker.addEventListener("mouseenter", () => this.pulseRelatedElements(idsForFilter, key2));
+      marker.addEventListener("mouseenter", () => this.pulseRelatedElements(idsForFilter, key));
       this.root.appendChild(marker);
-      this.markers.set(key2, { marker, target: info.target, fp: info.fp, commentIds: idsForFilter });
+      this.markers.set(key, { marker, target: info.target, fp: info.fp, commentIds: idsForFilter });
       if (info.target) {
         this.positionMarker(marker, info.target);
         this.positionOutline(outlineEl, info.target);
@@ -4588,8 +4383,8 @@ var Vizu = class {
         if (k !== selfKey) relatedKeys.add(k);
       }
     }
-    for (const key2 of relatedKeys) {
-      const outline = this.outlines.get(key2)?.outline;
+    for (const key of relatedKeys) {
+      const outline = this.outlines.get(key)?.outline;
       if (!outline) continue;
       outline.classList.remove("is-pulsing");
       void outline.offsetWidth;
@@ -4623,22 +4418,22 @@ var Vizu = class {
   syncActiveAnchorOutlines(fps) {
     if (!this.root) return;
     const wanted = new Set(fps.map((fp) => fingerprintKey(fp)));
-    for (const [key2, info] of this.activeAnchorOutlines) {
-      if (!wanted.has(key2)) {
+    for (const [key, info] of this.activeAnchorOutlines) {
+      if (!wanted.has(key)) {
         info.el.remove();
-        this.activeAnchorOutlines.delete(key2);
+        this.activeAnchorOutlines.delete(key);
       }
     }
     for (const fp of fps) {
-      const key2 = fingerprintKey(fp);
-      if (this.activeAnchorOutlines.has(key2)) continue;
+      const key = fingerprintKey(fp);
+      if (this.activeAnchorOutlines.has(key)) continue;
       const outline = document.createElement("div");
       outline.className = "vz-comment-outline is-selected-pending";
       this.root.appendChild(outline);
       const target = findElementByFingerprint(fp);
       if (target) this.positionOutline(outline, target);
       else outline.style.display = "none";
-      this.activeAnchorOutlines.set(key2, { el: outline, fp });
+      this.activeAnchorOutlines.set(key, { el: outline, fp });
     }
   }
   clearActiveAnchorOutlines() {
@@ -4686,9 +4481,6 @@ function fallbackCopy(text) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CloudStorageAdapter,
-  InMemoryStorageAdapter,
-  LocalStorageAdapter,
-  NullStorageAdapter,
   SCHEMA_VERSION,
   Vizu,
   findByFingerprint,