stimeo-ui 0.4.0 → 0.6.0

data/dist/controllers/overflow_menu_controller.js

@@ -161,6 +161,8 @@ var SafeTimeout = class extends TimerRegistry {
 var TabindexLoan = class {
   #value;
   #lent = /* @__PURE__ */ new Set();
+  /** Returns live loans before Turbo can copy them into its page snapshot. */
+  #beforeCache = new BeforeCacheReset(() => this.returnAll());
   /**
    * @param value - the `tabindex` to lend. `"-1"` (the default) is
    *   programmatically focusable but not a Tab stop; `"0"` is a real Tab stop,
@@ -174,6 +176,7 @@ var TabindexLoan = class {
     if (element.hasAttribute("tabindex")) return;
     element.setAttribute("tabindex", this.#value);
     this.#lent.add(element);
+    this.#beforeCache.activate();
   }
   /** Takes back every loan whose value is still the one that was lent. */
   returnAll() {
@@ -181,6 +184,7 @@ var TabindexLoan = class {
       if (element.getAttribute("tabindex") === this.#value) element.removeAttribute("tabindex");
     }
     this.#lent.clear();
+    this.#beforeCache.deactivate();
   }
 };
 
@@ -190,7 +194,7 @@ var INDEX = "data-stimeo--overflow-menu-index";
 var BOUNDARY = "data-stimeo--overflow-menu-boundary";
 var SAVED_ROLE = "data-stimeo--overflow-menu-role";
 var SAVED_TABINDEX = "data-stimeo--overflow-menu-tabindex";
-var SAVED_MENU_TARGET = "data-stimeo--overflow-menu-menu-target";
+var SAVED_MENU_TARGET = "data-stimeo--overflow-menu-saved-menu";
 var MENU_TARGET = "data-stimeo--menu-target";
 var BOOKKEEPING = [BANKED, INDEX, SAVED_ROLE, SAVED_TABINDEX, SAVED_MENU_TARGET];
 var OverflowMenuController = class extends Controller {

data/dist/controllers/pagination_controller.js

@@ -19,10 +19,41 @@ function canTakeFocus(element) {
   return !inheritsFieldsetDisabled(element);
 }
 
+// src/utils/before_cache_reset.ts
+var BeforeCacheReset = class _BeforeCacheReset {
+  /** Every subscribed instance, iterated by the one shared document listener. */
+  static #subscribers = /* @__PURE__ */ new Set();
+  /** The shared listener; installed while at least one instance is subscribed. */
+  static #onBeforeCache = () => {
+    for (const subscriber of _BeforeCacheReset.#subscribers) subscriber.#rewind();
+  };
+  #rewind;
+  /** @param rewind - the pass that returns this controller's state to its initial form. */
+  constructor(rewind) {
+    this.#rewind = rewind;
+  }
+  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */
+  activate() {
+    const first = _BeforeCacheReset.#subscribers.size === 0;
+    _BeforeCacheReset.#subscribers.add(this);
+    if (first) {
+      document.addEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+    }
+  }
+  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */
+  deactivate() {
+    _BeforeCacheReset.#subscribers.delete(this);
+    if (_BeforeCacheReset.#subscribers.size > 0) return;
+    document.removeEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+  }
+};
+
 // src/utils/tabindex_loan.ts
 var TabindexLoan = class {
   #value;
   #lent = /* @__PURE__ */ new Set();
+  /** Returns live loans before Turbo can copy them into its page snapshot. */
+  #beforeCache = new BeforeCacheReset(() => this.returnAll());
   /**
    * @param value - the `tabindex` to lend. `"-1"` (the default) is
    *   programmatically focusable but not a Tab stop; `"0"` is a real Tab stop,
@@ -36,6 +67,7 @@ var TabindexLoan = class {
     if (element.hasAttribute("tabindex")) return;
     element.setAttribute("tabindex", this.#value);
     this.#lent.add(element);
+    this.#beforeCache.activate();
   }
   /** Takes back every loan whose value is still the one that was lent. */
   returnAll() {
@@ -43,6 +75,7 @@ var TabindexLoan = class {
       if (element.getAttribute("tabindex") === this.#value) element.removeAttribute("tabindex");
     }
     this.#lent.clear();
+    this.#beforeCache.deactivate();
   }
 };
 
@@ -132,7 +165,11 @@ var PaginationController = class _PaginationController extends Controller {
     if (!Object.is(page, this.pageValue)) this.pageValue = page;
     this.#render();
   }
-  /** Syncs `aria-current` on the page buttons and the prev/next `disabled` state. */
+  /**
+   * Syncs `aria-current` on the page buttons and the prev/next `disabled` state.
+   *
+   * @stimeoRenderRoot
+   */
   #render() {
     const page = this.#page;
     for (const button of this.pageTargets) {

data/dist/controllers/password_strength_controller.js

@@ -55,8 +55,23 @@ var SafeTimeout = class extends TimerRegistry {
   }
 };
 
+// src/utils/string_list.ts
+function parseStringList(raw, fallback = []) {
+  const text = raw.trim();
+  if (text.length === 0) return [...fallback];
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return [...fallback];
+  }
+  if (!Array.isArray(parsed)) return [...fallback];
+  return parsed.filter((entry) => typeof entry === "string");
+}
+
 // src/controllers/password_strength_controller.ts
 var CLASS_PATTERNS = [/[a-z]/, /[A-Z]/, /[0-9]/, /[^A-Za-z0-9]/];
+var DEFAULT_LEVELS = ["weak", "fair", "good", "strong"];
 var LENGTH_MILESTONES = [8, 12, 16];
 var MAX_POINTS = LENGTH_MILESTONES.length + (CLASS_PATTERNS.length - 1);
 var STRENGTH_BANDS = ["weak", "fair", "good", "strong"];
@@ -64,7 +79,10 @@ var PasswordStrengthController = class _PasswordStrengthController extends Contr
   static targets = ["input", "meter", "label"];
   static values = {
     minScore: { type: Number, default: 0 },
-    levels: { type: Array, default: ["weak", "fair", "good", "strong"] }
+    // A JSON list read through `parseStringList` rather than Stimulus's `Array`
+    // type: that reader throws out of the value observer before any callback
+    // runs, so one malformed attribute would stop the meter connecting.
+    levels: { type: String, default: "" }
   };
   static actions = ["evaluate"];
   static events = ["change"];
@@ -90,7 +108,7 @@ var PasswordStrengthController = class _PasswordStrengthController extends Contr
    */
   #update(options = {}) {
     const password = this.hasInputTarget ? this.inputTarget.value : "";
-    const labels = this.levelsValue;
+    const labels = parseStringList(this.levelsValue, DEFAULT_LEVELS);
     const max = labels.length;
     const score = this.#score(password, max);
     const label = score > 0 ? labels[score - 1] ?? "" : "";
@@ -126,7 +144,7 @@ var PasswordStrengthController = class _PasswordStrengthController extends Contr
     this.#toggle("data-strength", band, band.length > 0);
     this.#toggle("data-below-min", "true", score > 0 && score < this.minScoreValue);
     const ratio = max > 0 ? score / max : 0;
-    this.element.style.setProperty("--stimeo-password-strength", String(ratio));
+    this.element.style.setProperty("--stimeo--password-strength", String(ratio));
   }
   #writeLabel(label) {
     if (this.hasLabelTarget) this.labelTarget.textContent = label;

data/dist/controllers/persist_controller.js

@@ -55,8 +55,23 @@ var SafeTimeout = class extends TimerRegistry {
   }
 };
 
+// src/utils/string_list.ts
+function parseStringList(raw, fallback = []) {
+  const text = raw.trim();
+  if (text.length === 0) return [...fallback];
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    return [...fallback];
+  }
+  if (!Array.isArray(parsed)) return [...fallback];
+  return parsed.filter((entry) => typeof entry === "string");
+}
+
 // src/controllers/persist_controller.ts
 var NON_VALUE_TYPES = /* @__PURE__ */ new Set(["file", "submit", "reset", "button", "image"]);
+var DEFAULT_EXCLUDE = ["password"];
 var STORAGE_PREFIX = "stimeo--persist:";
 var OCCURRENCE_SEP = "\0";
 var PersistController = class extends Controller {
@@ -64,7 +79,10 @@ var PersistController = class extends Controller {
   static values = {
     key: { type: String, default: "" },
     debounce: { type: Number, default: 400 },
-    exclude: { type: Array, default: ["password"] },
+    // A JSON list read through `parseStringList` rather than Stimulus's `Array`
+    // type: that reader throws out of the value observer before any callback
+    // runs, so one malformed attribute would stop the controller connecting.
+    exclude: { type: String, default: "" },
     clearOn: { type: String, default: "" }
   };
   static actions = ["clear"];
@@ -208,15 +226,16 @@ var PersistController = class extends Controller {
   /** The fields to persist: `field` targets, or the element's named controls. */
   #fields() {
     const candidates = this.hasFieldTarget ? this.fieldTargets : Array.from(this.element.querySelectorAll("input, textarea, select"));
-    return candidates.filter((field) => this.#persistable(field));
+    const excluded = parseStringList(this.excludeValue, DEFAULT_EXCLUDE);
+    return candidates.filter((field) => this.#persistable(field, excluded));
   }
   /** Whether a field carries a restorable, non-excluded value. */
-  #persistable(field) {
+  #persistable(field, excluded) {
     if (this.#keyOf(field) === null) return false;
     const type = field instanceof HTMLInputElement ? field.type : "";
     if (NON_VALUE_TYPES.has(type)) return false;
-    if (this.excludeValue.includes(type)) return false;
-    if (field.name.length > 0 && this.excludeValue.includes(field.name)) return false;
+    if (excluded.includes(type)) return false;
+    if (field.name.length > 0 && excluded.includes(field.name)) return false;
     return true;
   }
   /** A stable storage sub-key for a field (its name, else id). */

data/dist/controllers/pointer_drag_controller.js

@@ -12,6 +12,16 @@ function isReservedArrowChord(event, allow = []) {
 var DetachGate = class _DetachGate {
   /** Set while a probe is queued, waiting for a reconnect to cancel it. */
   #pending = false;
+  /**
+   * True while a probe is queued — the last disconnect was ambiguous and no
+   * reconnect has cancelled it yet. Read it from `connect()` to tell the
+   * reconnect half of an in-page move from a first connect: a controller whose
+   * initialisation restarts a measurement (a min-duration floor, an elapsed
+   * counter) must skip it for the move, where nothing actually restarted.
+   */
+  get pending() {
+    return this.#pending;
+  }
   /**
    * True when the disconnect is definitely a real detach — the element left
    * the document, or `data-controller` no longer lists the identifier. False

data/dist/controllers/portal_controller.js

@@ -6,6 +6,16 @@ import { Controller } from '@hotwired/stimulus';
 var DetachGate = class _DetachGate {
   /** Set while a probe is queued, waiting for a reconnect to cancel it. */
   #pending = false;
+  /**
+   * True while a probe is queued — the last disconnect was ambiguous and no
+   * reconnect has cancelled it yet. Read it from `connect()` to tell the
+   * reconnect half of an in-page move from a first connect: a controller whose
+   * initialisation restarts a measurement (a min-duration floor, an elapsed
+   * counter) must skip it for the move, where nothing actually restarted.
+   */
+  get pending() {
+    return this.#pending;
+  }
   /**
    * True when the disconnect is definitely a real detach — the element left
    * the document, or `data-controller` no longer lists the identifier. False

data/dist/controllers/progress_controller.js

@@ -153,20 +153,24 @@ var ProgressController = class extends Controller {
   get #ratio() {
     return rangeFraction(this.valueValue, this.minValue, this.maxValue);
   }
-  /** Reflects value/range/indeterminate onto ARIA, `data-state`, and the ratio. */
+  /**
+   * Reflects value/range/indeterminate onto ARIA, `data-state`, and the ratio.
+   *
+   * @stimeoRenderRoot
+   */
   #render() {
     this.element.setAttribute("aria-valuemin", String(this.minValue));
     this.element.setAttribute("aria-valuemax", String(this.maxValue));
     if (this.indeterminateValue) {
       this.element.removeAttribute("aria-valuenow");
       this.#clearOwnValueText();
-      this.element.style.removeProperty("--stimeo-progress-ratio");
+      this.element.style.removeProperty("--stimeo--progress-ratio");
       this.element.setAttribute("data-state", "indeterminate");
       return;
     }
     const value = this.#clamp(this.valueValue);
     this.element.setAttribute("aria-valuenow", String(value));
-    this.element.style.setProperty("--stimeo-progress-ratio", String(this.#ratio));
+    this.element.style.setProperty("--stimeo--progress-ratio", String(this.#ratio));
     this.element.setAttribute("data-state", "determinate");
     this.#applyValueText(value);
   }