stimeo-ui 0.17.0 → 0.18.1

data/dist/controllers/rating_controller.js

@@ -30,17 +30,31 @@ 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;
+  if (value === null) element.removeAttribute(name);
+  else element.setAttribute(name, value);
+  return true;
+}
 
 function sharedRegistry(key, create) {
   const symbol = Symbol.for(key);
   const scope = globalThis;
   const existing = scope[symbol];
   if (existing !== void 0) return existing;
-  const registry = create();
-  Object.defineProperty(globalThis, symbol, { value: registry });
-  return registry;
+  const registry2 = create();
+  Object.defineProperty(globalThis, symbol, { value: registry2 });
+  return registry2;
 }
 
+var registry = sharedRegistry(
+  "stimeo-ui.attribute-lease.registry.v1",
+  () => ({ stacks: /* @__PURE__ */ new WeakMap(), names: /* @__PURE__ */ new Map() })
+);
 function isAttributeValue(value) {
   return value === null || typeof value === "string";
 }
@@ -57,24 +71,46 @@ function readLeaseRecord(element, record) {
     return void 0;
   }
 }
-var AttributeLease = class _AttributeLease {
-  static #registry = sharedRegistry(
-    "stimeo-ui.attribute-lease.registry.v1",
-    () => ({ stacks: /* @__PURE__ */ new WeakMap(), names: /* @__PURE__ */ new Map() })
-  );
+function attributeStack(element, attribute) {
+  const byAttribute = registry.stacks.get(element) ?? /* @__PURE__ */ new Map();
+  registry.stacks.set(element, byAttribute);
+  const known = byAttribute.get(attribute);
+  if (known) return known;
+  const found = [];
+  for (const record of registry.names.get(attribute) ?? []) {
+    const read = readLeaseRecord(element, record);
+    if (read) found.push({ ...read, record });
+  }
+  const depth = ({ beneath }) => beneath.filter((name) => found.some((other) => other.record === name)).length;
+  const stack = found.sort((one, other) => depth(one) - depth(other)).map(({ record, written, original, linked }, index) => ({
+    lease: null,
+    record,
+    written,
+    original,
+    linked: linked && index > 0
+  }));
+  byAttribute.set(attribute, stack);
+  return stack;
+}
+function findHold(stack, lease, record) {
+  return stack.find((held) => held.lease === lease) ?? stack.find((held) => held.lease === null && held.record === record);
+}
+var AttributeLease = class {
   #attribute;
   #record;
   #base;
+  #preserveAuthor;
   #held = /* @__PURE__ */ new Set();
   constructor(attribute, owner, options = {}) {
     this.#attribute = attribute;
     this.#record = `data-${owner}-${attribute}-lease`;
     this.#base = options.base === true;
-    const names = _AttributeLease.#registry.names;
+    this.#preserveAuthor = options.preserveAuthor === true;
+    const names = registry.names;
     names.set(attribute, (names.get(attribute) ?? /* @__PURE__ */ new Set()).add(this.#record));
   }
   write(element, value) {
-    const stack = this.#stack(element);
+    const stack = attributeStack(element, this.#attribute);
     const hold = this.#take(stack) ?? this.#acquire(element, stack);
     this.#held.add(element);
     const shows = !this.#covered(element, stack, hold);
@@ -84,8 +120,8 @@ var AttributeLease = class _AttributeLease {
   }
   return(element) {
     const held = this.#held.delete(element);
-    const known = _AttributeLease.#registry.stacks.get(element)?.has(this.#attribute);
-    const stack = held || known || element.hasAttribute(this.#record) ? this.#stack(element) : [];
+    const known = registry.stacks.get(element)?.has(this.#attribute);
+    const stack = held || known || element.hasAttribute(this.#record) ? attributeStack(element, this.#attribute) : [];
     const hold = this.#take(stack);
     if (!hold) return false;
     const carries = element.getAttribute(this.#attribute) === hold.written;
@@ -103,31 +139,8 @@ var AttributeLease = class _AttributeLease {
   returnAll() {
     for (const element of Array.from(this.#held)) this.return(element);
   }
-  #stack(element) {
-    const stacks = _AttributeLease.#registry.stacks;
-    const byAttribute = stacks.get(element) ?? /* @__PURE__ */ new Map();
-    stacks.set(element, byAttribute);
-    const stack = byAttribute.get(this.#attribute) ?? this.#seed(element);
-    byAttribute.set(this.#attribute, stack);
-    return stack;
-  }
-  #seed(element) {
-    const found = [];
-    for (const record of _AttributeLease.#registry.names.get(this.#attribute) ?? []) {
-      const read = readLeaseRecord(element, record);
-      if (read) found.push({ ...read, record });
-    }
-    const depth = ({ beneath }) => beneath.filter((name) => found.some((other) => other.record === name)).length;
-    return found.sort((one, other) => depth(one) - depth(other)).map(({ record, written, original, linked }, index) => ({
-      lease: null,
-      record,
-      written,
-      original,
-      linked: linked && index > 0
-    }));
-  }
   #take(stack) {
-    const hold = stack.find((held) => held.lease === this) ?? stack.find((held) => held.lease === null && held.record === this.#record);
+    const hold = findHold(stack, this, this.#record);
     if (hold) hold.lease = this;
     return hold;
   }
@@ -136,7 +149,7 @@ var AttributeLease = class _AttributeLease {
     const top = stack.at(-1);
     const bottom = stack[0];
     const over = top?.written === current ? top : void 0;
-    const from = this.#base ? bottom : over;
+    const from = this.#base ? this.#preserveAuthor && !stack.some((held) => held.written === current) ? void 0 : bottom : over;
     const hold = {
       lease: this,
       record: this.#record,
@@ -166,15 +179,11 @@ var AttributeLease = class _AttributeLease {
       );
     });
     for (const [name, recorded] of records) {
-      if (element.getAttribute(name) === recorded) continue;
-      if (recorded === null) element.removeAttribute(name);
-      else element.setAttribute(name, recorded);
+      setAttributeIfChanged(element, name, recorded);
     }
   }
   #reflect(element, value) {
-    if (element.getAttribute(this.#attribute) === value) return;
-    if (value === null) element.removeAttribute(this.#attribute);
-    else element.setAttribute(this.#attribute, value);
+    setAttributeIfChanged(element, this.#attribute, value);
   }
 };
 
@@ -214,6 +223,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;
@@ -244,6 +256,9 @@ var MorphRenderWatcher = class {
   schedule() {
     this.#pass.schedule();
   }
+  get pending() {
+    return this.#pass.pending;
+  }
   disconnect() {
     this.#listeners.dispose();
     this.#pass.cancel();
@@ -323,6 +338,11 @@ var RovingTabindex = class {
     if (focus) items[index]?.focus();
   }
 };
+function deepActiveElement(ownerDocument) {
+  let active = ownerDocument.activeElement;
+  while (active?.shadowRoot?.activeElement) active = active.shadowRoot.activeElement;
+  return active;
+}
 
 function queryOpenDescendants(root, selector) {
   const matches = [];
@@ -340,6 +360,9 @@ function queryOpenDescendants(root, selector) {
   return matches;
 }
 
+function holdsFocus(element) {
+  return element.matches(":focus") || deepActiveElement(element.ownerDocument) === element;
+}
 var TabindexLoan = class _TabindexLoan {
   static #registry = sharedRegistry(
     "stimeo-ui.tabindex-loan.registry.v1",
@@ -347,19 +370,22 @@ var TabindexLoan = class _TabindexLoan {
   );
   #value;
   #record;
+  #preserveFocus;
   #lent = /* @__PURE__ */ new Set();
-  constructor(value, owner) {
+  constructor(value, owner, options = {}) {
     this.#value = value;
     this.#record = `data-${owner}-tabindex-loan`;
+    this.#preserveFocus = options.preserveFocus === true;
     _TabindexLoan.#registry.names.add(this.#record);
   }
-  lend(element) {
+  lend(element, options = {}) {
     const stack = this.#stack(element);
     const current = element.getAttribute("tabindex");
     const held = stack.find((hold) => hold.loan === this) ?? stack.find(
       (hold) => hold.loan === null && hold.record === this.#record && hold.value === this.#value
     );
     const linked = stack.at(-1)?.value === current;
+    if (!held && options.onlyIfUnfocusable && (current !== null || element.tabIndex >= 0)) return;
     if (!held && current !== null && !linked) return;
     this.#lent.add(element);
     if (held) held.loan = this;
@@ -369,19 +395,28 @@ var TabindexLoan = class _TabindexLoan {
       element.setAttribute("tabindex", this.#value);
     }
   }
-  returnAll() {
-    for (const element of this.#lent) {
-      const stack = this.#stack(element);
-      const hold = stack.find((held) => held.loan === this);
-      if (hold) this.#release(element, stack, hold);
+  return(element) {
+    const stack = this.#stack(element);
+    const hold = stack.find((held) => held.loan === this) ?? stack.find(
+      (held) => held.loan === null && held.record === this.#record && held.value === this.#value
+    );
+    if (!hold) return false;
+    if (!this.#release(element, stack, hold, this.#preserveFocus)) {
+      hold.loan = this;
+      this.#lent.add(element);
+      return false;
     }
-    this.#lent.clear();
+    this.#lent.delete(element);
+    return true;
+  }
+  returnAll() {
+    for (const element of Array.from(this.#lent)) this.return(element);
   }
   reclaim(element) {
     if (element.getAttribute(this.#record) !== this.#value) return;
     const stack = this.#stack(element);
     const hold = stack.find((held) => held.loan === null && held.record === this.#record);
-    if (hold && !element.matches(":focus")) this.#release(element, stack, hold);
+    if (hold && !holdsFocus(element)) this.#release(element, stack, hold);
   }
   reclaimWithin(root) {
     for (const element of queryOpenDescendants(root, `[${this.#record}]`)) {
@@ -405,26 +440,26 @@ var TabindexLoan = class _TabindexLoan {
     for (const [index, hold] of holds.entries()) hold.linked = index > 0;
     return holds;
   }
-  #release(element, stack, hold) {
+  #release(element, stack, hold, preserveFocus = false) {
     const current = element.getAttribute("tabindex");
     const index = stack.indexOf(hold);
     const owns = current === hold.value && !stack.slice(index + 1).some((above2) => above2.value === current);
+    if (owns && preserveFocus && holdsFocus(element)) return false;
     stack.splice(index, 1);
     const above = stack[index];
     if (above) above.linked &&= hold.linked;
     this.#mark(element, stack);
-    if (!owns) return;
+    if (!owns) return true;
     const below = hold.linked ? stack[index - 1] : void 0;
     if (!below) element.removeAttribute("tabindex");
     else if (below.value !== current) element.setAttribute("tabindex", below.value);
+    return true;
   }
   #mark(element, stack) {
     const records = /* @__PURE__ */ new Map([[this.#record, null]]);
     for (const hold of stack) records.set(hold.record, hold.value);
     for (const [name, recorded] of records) {
-      if (element.getAttribute(name) === recorded) continue;
-      if (recorded === null) element.removeAttribute(name);
-      else element.setAttribute(name, recorded);
+      setAttributeIfChanged(element, name, recorded);
     }
   }
 };
@@ -529,6 +564,7 @@ var RatingController = class _RatingController extends Controller {
   }
   onKeydown(event) {
     if (event.defaultPrevented || isReservedArrowChord(event) || this.readonlyValue) return;
+    if ((event.key === "Home" || event.key === "End") && hasModifierChord(event)) return;
     const current = this.#normalize(this.#safeValue);
     let next = null;
     const rtl = isRtl(this.element);

data/dist/controllers/read_more_controller.js

@@ -107,6 +107,13 @@ function stateReasonFor(event) {
   return "user";
 }
 
+function setAttributeIfChanged(element, name, value, beforeWrite) {
+  if (element.getAttribute(name) === value) return false;
+  if (value === null) element.removeAttribute(name);
+  else element.setAttribute(name, value);
+  return true;
+}
+
 function sharedRegistry(key, create) {
   const symbol = Symbol.for(key);
   const scope = globalThis;
@@ -161,9 +168,8 @@ var StateRegions = class _StateRegions {
         const below = hold.linked ? stack[index - 1] : void 0;
         if (below) {
           if (region.hidden !== below.written) region.hidden = below.written;
-        } else if (region.getAttribute("hidden") !== hold.authored) {
-          if (hold.authored === null) region.removeAttribute("hidden");
-          else region.setAttribute("hidden", hold.authored);
+        } else {
+          setAttributeIfChanged(region, "hidden", hold.authored);
         }
       }
       this.#mark(region, stack);
@@ -238,9 +244,7 @@ var StateRegions = class _StateRegions {
       );
     });
     for (const [name, recorded] of records) {
-      if (region.getAttribute(name) === recorded) continue;
-      if (recorded === null) region.removeAttribute(name);
-      else region.setAttribute(name, recorded);
+      setAttributeIfChanged(region, name, recorded);
     }
   }
   #recorded(region, name) {

data/dist/controllers/reading_progress_controller.js

@@ -71,6 +71,24 @@ var LayoutObserver = class {
   }
 };
 
+var ListenerSet = class {
+  #abort = new AbortController();
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
+
+function setAttributeIfChanged(element, name, value, beforeWrite) {
+  if (element.getAttribute(name) === value) return false;
+  if (value === null) element.removeAttribute(name);
+  else element.setAttribute(name, value);
+  return true;
+}
+
 function sharedRegistry(key, create) {
   const symbol = Symbol.for(key);
   const scope = globalThis;
@@ -210,9 +228,7 @@ var StylePropertyLease = class _StylePropertyLease {
       );
     });
     for (const [name, recorded] of records) {
-      if (element.getAttribute(name) === recorded) continue;
-      if (recorded === null) element.removeAttribute(name);
-      else element.setAttribute(name, recorded);
+      setAttributeIfChanged(element, name, recorded);
     }
   }
   #carries(element, hold) {
@@ -238,10 +254,11 @@ var ReadingProgressController = class extends Controller {
   #progress = -1;
   #baselined = false;
   #onScroll = () => this.#frames.schedule(() => this.#measure());
+  #listeners = new ListenerSet();
   connect() {
     this.#progress = -1;
     this.#baselined = false;
-    window.addEventListener("scroll", this.#onScroll, { passive: true, capture: true });
+    this.#listeners.add(window, "scroll", this.#onScroll, { passive: true, capture: true });
     this.#layout.observe(this.element);
     this.#layout.observeViewport();
     this.#measure();
@@ -251,7 +268,7 @@ var ReadingProgressController = class extends Controller {
     });
   }
   disconnect() {
-    window.removeEventListener("scroll", this.#onScroll, { capture: true });
+    this.#listeners.dispose();
     this.#layout.disconnect();
     this.#frames.cancel();
     this.#lease.return(this.element);

data/dist/controllers/relative_time_controller.js

@@ -1,5 +1,52 @@
 import { Controller } from '@hotwired/stimulus';
 
+function setAttributeIfChanged(element, name, value, beforeWrite) {
+  if (element.getAttribute(name) === value) return false;
+  if (value === null) element.removeAttribute(name);
+  else element.setAttribute(name, value);
+  return true;
+}
+
+var DATETIME = /^([+-]\d{6}|\d{4})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d+))?)?(Z|[+-]\d{2}:?\d{2})?)?$/;
+function readDatetime(element) {
+  const raw = element.getAttribute("datetime");
+  if (raw === null) return null;
+  const match = DATETIME.exec(raw.trim());
+  if (match === null) return null;
+  const [
+    ,
+    yearText,
+    monthText,
+    dayText,
+    hourText = "00",
+    minuteText = "00",
+    secondText = "00",
+    fraction = "",
+    zone = "Z"
+  ] = match;
+  const year = Number(yearText);
+  const month = Number(monthText);
+  const day = Number(dayText);
+  const leap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const days = [31, leap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  if (month < 1 || month > 12 || day < 1 || day > (days[month - 1] ?? 0)) return null;
+  const hour = Number(hourText);
+  const minute = Number(minuteText);
+  const second = Number(secondText);
+  if (hour === 24 && (minute !== 0 || second !== 0 || /[1-9]/.test(fraction))) return null;
+  let offset = zone;
+  if (zone !== "Z") {
+    const digits = zone.slice(1).replace(":", "");
+    const offsetHour = digits.slice(0, 2);
+    const offsetMinute = digits.slice(2);
+    offset = `${zone[0]}${offsetHour}:${offsetMinute}`;
+  }
+  const milliseconds = fraction.slice(0, 3).padEnd(3, "0");
+  const canonical = `${yearText}-${monthText}-${dayText}T${hourText}:${minuteText}:${secondText}.${milliseconds}${offset}`;
+  const instant = Date.parse(canonical);
+  return Number.isNaN(instant) ? null : instant;
+}
+
 var formatters = /* @__PURE__ */ new WeakMap();
 function intlFormatter(factory, locale, options, fallbackLocale) {
   const cache = cacheFor(factory);
@@ -59,6 +106,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;
@@ -89,6 +139,9 @@ var MorphRenderWatcher = class {
   schedule() {
     this.#pass.schedule();
   }
+  get pending() {
+    return this.#pass.pending;
+  }
   disconnect() {
     this.#listeners.dispose();
     this.#pass.cancel();
@@ -202,6 +255,12 @@ var RelativeTimeController = class _RelativeTimeController extends Controller {
   };
   #timers = new SafeTimeout();
   #resync = new MorphRenderWatcher(() => {
+    const target = readDatetime(this.element) ?? Number.NaN;
+    if (!Object.is(target, this.#targetMs)) {
+      this.#targetMs = target;
+      this.#adoptAuthoredText();
+      this.#valuesDirty = true;
+    }
     if (this.#valuesDirty) {
       this.#valuesDirty = false;
       this.#resyncToValues();
@@ -210,25 +269,32 @@ var RelativeTimeController = class _RelativeTimeController extends Controller {
     }
   });
   #valuesDirty = false;
+  #datetimeWatch = new MutationObserver(() => this.#resync.schedule());
   #targetMs = Number.NaN;
   #absoluteText = "";
   connect() {
+    this.#timers.clearAll();
     this.#valuesDirty = false;
     this.#resync.observe(this.element);
-    if (this.element.getAttribute("data-state") !== "relative") {
-      this.#absoluteText = (this.element.textContent ?? "").trim();
-    } else {
-      const recorded = this.#recordedText();
-      if (recorded !== null) this.#absoluteText = recorded;
-    }
-    this.#targetMs = Date.parse(this.element.getAttribute("datetime") ?? "");
+    this.#datetimeWatch.observe(this.element, { attributeFilter: ["datetime"] });
+    this.#adoptAuthoredText();
+    this.#targetMs = readDatetime(this.element) ?? Number.NaN;
     if (Number.isNaN(this.#targetMs)) return;
     this.#schedule();
   }
   disconnect() {
     this.#resync.disconnect();
+    this.#datetimeWatch.disconnect();
     this.#timers.clearAll();
   }
+  #adoptAuthoredText() {
+    if (this.element.getAttribute("data-state") !== "relative") {
+      this.#absoluteText = (this.element.textContent ?? "").trim();
+    } else {
+      const recorded = this.#recordedText();
+      if (recorded !== null) this.#absoluteText = recorded;
+    }
+  }
   get #textRecord() {
     return `data-${this.identifier}-${TEXT_RECORD}`;
   }
@@ -253,8 +319,8 @@ var RelativeTimeController = class _RelativeTimeController extends Controller {
     this.#resync.schedule();
   }
   #resyncToValues() {
-    if (Number.isNaN(this.#targetMs)) return;
     this.#timers.clearAll();
+    if (Number.isNaN(this.#targetMs)) return;
     this.#schedule();
   }
   #schedule() {
@@ -282,9 +348,7 @@ var RelativeTimeController = class _RelativeTimeController extends Controller {
     this.element.textContent = formatter.format(value, scale.unit);
     this.element.setAttribute("data-state", "relative");
     const record = JSON.stringify(this.#absoluteText);
-    if (this.element.getAttribute(this.#textRecord) !== record) {
-      this.element.setAttribute(this.#textRecord, record);
-    }
+    setAttributeIfChanged(this.element, this.#textRecord, record);
     return nextDelay;
   }
   get #formatter() {

data/dist/controllers/reset_on_restore_controller.js

@@ -46,6 +46,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;
@@ -76,6 +79,9 @@ var MorphRenderWatcher = class {
   schedule() {
     this.#pass.schedule();
   }
+  get pending() {
+    return this.#pass.pending;
+  }
   disconnect() {
     this.#listeners.dispose();
     this.#pass.cancel();