stimeo-ui 0.17.0 → 0.18.0

package/dist/controllers/tree_view_controller.js

@@ -30,6 +30,107 @@ function isReservedArrowChord(event, allow = []) {
   if (!event.key.startsWith("Arrow")) return false;
   return event.altKey && !allow.includes("alt") || event.ctrlKey && !allow.includes("ctrl") || event.metaKey && !allow.includes("meta") || event.shiftKey && !allow.includes("shift");
 }
+function hasModifierChord(event) {
+  return event.altKey || event.ctrlKey || event.metaKey || event.shiftKey;
+}
+
+function setAttributeIfChanged(element, name, value, beforeWrite) {
+  if (element.getAttribute(name) === value) return false;
+  beforeWrite?.();
+  if (value === null) element.removeAttribute(name);
+  else element.setAttribute(name, value);
+  return true;
+}
+
+var AuthoredMutationWatcher = class {
+  #onAuthored;
+  #claims = null;
+  #observer = null;
+  constructor(onAuthored) {
+    this.#onAuthored = onAuthored;
+  }
+  observe(root, options) {
+    this.disconnect();
+    const observer = new MutationObserver((records) => {
+      if (this.#observer !== observer) return;
+      const authored = this.#filter(records);
+      if (authored.length > 0) this.#onAuthored(authored);
+    });
+    this.#observer = observer;
+    this.#claims = { attributes: /* @__PURE__ */ new Map(), children: /* @__PURE__ */ new Map() };
+    observer.observe(root, {
+      attributes: true,
+      attributeFilter: [...options.attributes],
+      subtree: options.subtree ?? false,
+      childList: options.childList ?? false
+    });
+    if (options.ancestorAttributes) {
+      let ancestor = root.parentElement;
+      while (ancestor) {
+        observer.observe(ancestor, {
+          attributes: true,
+          attributeFilter: [...options.ancestorAttributes]
+        });
+        ancestor = ancestor.parentElement;
+      }
+    }
+  }
+  claim(target, name, value) {
+    const claims = this.#claims?.attributes;
+    let attributes = claims?.get(target);
+    if (!attributes) {
+      attributes = /* @__PURE__ */ new Map();
+      claims?.set(target, attributes);
+    }
+    const pending = attributes.get(name);
+    attributes.set(name, { value, count: (pending?.count ?? 0) + 1 });
+  }
+  claimCurrent(target, name) {
+    this.claim(target, name, target.getAttribute(name));
+  }
+  claimChildList(target, added, removed) {
+    const claims = this.#claims?.children;
+    const pending = claims?.get(target) ?? { added: /* @__PURE__ */ new Map(), removed: /* @__PURE__ */ new Map() };
+    for (const node of added) pending.added.set(node, (pending.added.get(node) ?? 0) + 1);
+    for (const node of removed) pending.removed.set(node, (pending.removed.get(node) ?? 0) + 1);
+    claims?.set(target, pending);
+  }
+  take() {
+    return this.#filter(this.#observer?.takeRecords() ?? []);
+  }
+  disconnect() {
+    this.#observer?.disconnect();
+    this.#observer = null;
+    this.#claims = null;
+  }
+  #filter(records) {
+    const authored = records.filter((record) => !this.#consume(record));
+    this.#claims?.attributes.clear();
+    this.#claims?.children.clear();
+    return authored;
+  }
+  #consume(record) {
+    if (record.type === "attributes") {
+      const target = record.target;
+      const pending2 = this.#claims?.attributes.get(target)?.get(record.attributeName);
+      if (!pending2 || pending2.count === 0 || target.getAttribute(record.attributeName) !== pending2.value) {
+        return false;
+      }
+      pending2.count -= 1;
+      return true;
+    }
+    const pending = this.#claims?.children.get(record.target);
+    if (!pending) return false;
+    const added = [...record.addedNodes];
+    const removed = [...record.removedNodes];
+    if (added.some((node) => !pending.added.get(node)) || removed.some((node) => !pending.removed.get(node))) {
+      return false;
+    }
+    for (const node of added) pending.added.set(node, (pending.added.get(node) ?? 0) - 1);
+    for (const node of removed) pending.removed.set(node, (pending.removed.get(node) ?? 0) - 1);
+    return true;
+  }
+};
 
 function writeField(field, value) {
   if (field.value === value) return false;
@@ -111,6 +212,9 @@ var MicrotaskCoalescer = class {
     this.#queued = false;
     this.#generation += 1;
   }
+  get pending() {
+    return this.#queued;
+  }
   schedule() {
     if (!this.#active || this.#queued) return;
     this.#queued = true;
@@ -141,6 +245,9 @@ var MorphRenderWatcher = class {
   schedule() {
     this.#pass.schedule();
   }
+  get pending() {
+    return this.#pass.pending;
+  }
   disconnect() {
     this.#listeners.dispose();
     this.#pass.cancel();
@@ -262,19 +369,19 @@ function findTypeaheadMatch(items, from, query, label = (item) => typeaheadLabel
 }
 
 var OBSERVED_ATTRIBUTES = ["aria-selected", "data-value"];
-function setAttributeIfChanged(element, name, value) {
-  if (element.getAttribute(name) !== value) element.setAttribute(name, value);
-}
 var NESTED_INTERACTIVE = INTERACTIVE_HOST_SELECTOR;
 var TreeViewController = class extends Controller {
   #moves = new MoveCounter();
+  #connectionGeneration = 0;
   static targets = ["item", "group", "field"];
   static actions = ["onKeydown", "select", "toggle"];
   static events = ["select", "toggle", "reconcile"];
   #roving = new RovingTabindex(() => this.itemTargets);
   #typeahead = new Typeahead();
   #reconcile = new MorphRenderWatcher(() => this.#reconcileSelection());
-  #observer = null;
+  #observer = new AuthoredMutationWatcher((records) => {
+    if (this.#concernsItems(records)) this.#reconcile.schedule();
+  });
   #settled = { item: null, value: "" };
   #connected = false;
   #order = [];
@@ -293,9 +400,10 @@ var TreeViewController = class extends Controller {
       if (this.#focused === row && row.isConnected) this.#focused = null;
     });
   };
+  #listeners = new ListenerSet();
   connect() {
-    this.element.addEventListener("focusin", this.#onFocusIn);
-    this.element.addEventListener("focusout", this.#onFocusOut);
+    this.#listeners.add(this.element, "focusin", this.#onFocusIn);
+    this.#listeners.add(this.element, "focusout", this.#onFocusOut);
     this.#seedFocused();
     this.#reconcileExpansion();
     this.#normalizeSelection();
@@ -314,12 +422,11 @@ var TreeViewController = class extends Controller {
     this.#reconcile.schedule();
   }
   disconnect() {
-    this.element.removeEventListener("focusin", this.#onFocusIn);
-    this.element.removeEventListener("focusout", this.#onFocusOut);
+    this.#connectionGeneration += 1;
+    this.#listeners.dispose();
     this.#connected = false;
     this.#reconcile.disconnect();
-    this.#observer?.disconnect();
-    this.#observer = null;
+    this.#observer.disconnect();
     this.#typeahead.reset();
     this.#order = [];
     this.#focused = null;
@@ -337,7 +444,7 @@ var TreeViewController = class extends Controller {
     const items = this.itemTargets;
     const selected = items.find((item) => item.getAttribute("aria-selected") === "true");
     for (const item of items) {
-      setAttributeIfChanged(item, "aria-selected", item === selected ? "true" : "false");
+      this.#writeSelection(item, item === selected ? "true" : "false");
     }
   }
   #mirrorField(notify) {
@@ -353,7 +460,7 @@ var TreeViewController = class extends Controller {
     this.#reconcileExpansion();
     this.#normalizeSelection();
     this.#normalizeTabStop();
-    this.#dropOwnRecords();
+    this.#flushMutations();
     this.#mirrorField(false);
     this.#reportMove();
   }
@@ -364,22 +471,17 @@ var TreeViewController = class extends Controller {
     this.dispatch("reconcile", { detail: { item: selection.item } });
   }
   #observeItems() {
-    const observer = new MutationObserver((records) => {
-      if (this.#concernsItems(records)) this.#reconcile.schedule();
-    });
-    observer.observe(this.element, {
+    this.#observer.observe(this.element, {
       subtree: true,
-      attributes: true,
-      attributeFilter: OBSERVED_ATTRIBUTES
+      attributes: OBSERVED_ATTRIBUTES
     });
-    this.#observer = observer;
   }
   #concernsItems(records) {
     const items = new Set(this.itemTargets);
     return records.some((record) => items.has(record.target));
   }
-  #dropOwnRecords() {
-    this.#observer?.takeRecords();
+  #flushMutations() {
+    if (this.#concernsItems(this.#observer.take())) this.#reconcile.schedule();
   }
   itemTargetDisconnected(item) {
     if (!this.#connected || !this.element.isConnected) return;
@@ -408,6 +510,7 @@ var TreeViewController = class extends Controller {
   onKeydown(event) {
     if (event.defaultPrevented) return;
     if (isReservedArrowChord(event)) return;
+    if ((event.key === "Home" || event.key === "End") && hasModifierChord(event)) return;
     if (event.isComposing) return;
     const item = this.#ownerItem(event);
     if (!item) return;
@@ -553,10 +656,11 @@ var TreeViewController = class extends Controller {
   }
   #select(item, reason = "user") {
     if (this.#isDisabled(item)) return;
+    const generation = this.#connectionGeneration;
     for (const candidate of this.itemTargets) {
-      setAttributeIfChanged(candidate, "aria-selected", candidate === item ? "true" : "false");
+      this.#writeSelection(candidate, candidate === item ? "true" : "false");
     }
-    this.#dropOwnRecords();
+    this.#flushMutations();
     const selection = this.#selection();
     const changed = selection.item !== this.#settled.item || selection.value !== this.#settled.value;
     this.#settled = selection;
@@ -566,7 +670,7 @@ var TreeViewController = class extends Controller {
     }
     const token = this.#moves.record();
     this.#mirrorField(true);
-    if (!this.#moves.isLatest(token)) return;
+    if (generation !== this.#connectionGeneration || !this.#moves.isLatest(token)) return;
     this.dispatch("select", { detail: { item, reason } });
   }
   #setExpanded(item, group, expanded, reason = "user") {
@@ -631,7 +735,7 @@ var TreeViewController = class extends Controller {
     }
     const selected = visible.find((item) => item.getAttribute("aria-selected") === "true");
     const next = selected ?? visible[0];
-    this.#roving.setActive(items.findIndex((item) => item === next));
+    this.#roving.setActive(items.indexOf(next));
   }
   get #visibleItems() {
     return this.itemTargets.filter((item) => {
@@ -664,6 +768,11 @@ var TreeViewController = class extends Controller {
       return text;
     });
   }
+  #writeSelection(target, value) {
+    setAttributeIfChanged(target, "aria-selected", value, () => {
+      this.#observer.claim(target, "aria-selected", value);
+    });
+  }
 };
 
 export { TreeViewController };