stimeo-ui 0.1.0.pre.alpha.1

data/dist/controllers/overflow_menu_controller.js

@@ -0,0 +1,274 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/overflow_menu_controller.ts
+
+// src/utils/layout_observer.ts
+var LayoutObserver = class {
+  #callback;
+  #resizeObserverFactory;
+  #resizeObserver = null;
+  #observingViewport = false;
+  /** Stable bound handler so add/removeEventListener target the same reference. */
+  #handleViewportResize = () => {
+    this.#callback();
+  };
+  constructor(callback, options = {}) {
+    this.#callback = callback;
+    this.#resizeObserverFactory = options.resizeObserverFactory ?? (typeof ResizeObserver === "undefined" ? null : (cb) => new ResizeObserver(cb));
+  }
+  /**
+   * Starts observing an element's size. Repeated calls observe additional
+   * elements through the same shared observer. No-ops when no
+   * `ResizeObserver` implementation is available.
+   */
+  observe(element) {
+    if (!this.#resizeObserverFactory) return;
+    if (!this.#resizeObserver) {
+      this.#resizeObserver = this.#resizeObserverFactory(() => {
+        this.#callback();
+      });
+    }
+    this.#resizeObserver.observe(element);
+  }
+  /** Stops observing a single element while leaving any others in place. */
+  unobserve(element) {
+    this.#resizeObserver?.unobserve(element);
+  }
+  /** Starts observing viewport resizes. Idempotent: the listener is added once. */
+  observeViewport() {
+    if (this.#observingViewport) return;
+    this.#observingViewport = true;
+    window.addEventListener("resize", this.#handleViewportResize);
+  }
+  /** Stops observing viewport resizes without affecting element observation. */
+  unobserveViewport() {
+    if (!this.#observingViewport) return;
+    this.#observingViewport = false;
+    window.removeEventListener("resize", this.#handleViewportResize);
+  }
+  /**
+   * Releases every observation: disconnects the {@link ResizeObserver} and
+   * removes the viewport listener. Safe to call multiple times. Call this from a
+   * controller's `disconnect()`.
+   */
+  disconnect() {
+    this.#resizeObserver?.disconnect();
+    this.#resizeObserver = null;
+    this.unobserveViewport();
+  }
+};
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeTimeout = class extends TimerRegistry {
+  /**
+   * Schedules `callback` after `delay` ms and returns the timer id.
+   *
+   * The id is removed from the registry automatically when the timeout fires,
+   * so {@link TimerRegistry.size | size} reflects only still-pending timers.
+   */
+  set(callback, delay) {
+    const id = this.schedule(() => {
+      this.ids.delete(id);
+      callback();
+    }, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setTimeout(callback, delay);
+  }
+  cancel(id) {
+    window.clearTimeout(id);
+  }
+};
+
+// src/controllers/overflow_menu_controller.ts
+var OverflowMenuController = class extends Controller {
+  static targets = ["items", "more"];
+  static values = {
+    moreLabel: { type: String, default: "More" },
+    debounce: { type: Number, default: 100 }
+  };
+  static actions = ["update"];
+  static events = ["change"];
+  #layout = new LayoutObserver(() => this.#scheduleUpdate());
+  #timers = new SafeTimeout();
+  /** The managed items in canonical (authored) order, captured at connect. */
+  #items = [];
+  #index = /* @__PURE__ */ new WeakMap();
+  /**
+   * Cached bar-context width per item. An item's natural width is location-independent,
+   * so this lets a measure pass read only the items currently in the bar (menu items
+   * reuse their last value) instead of pulling everything back to measure — one reflow,
+   * not two.
+   */
+  #widths = /* @__PURE__ */ new WeakMap();
+  /** Last reported overflow count, so `change` fires only on transitions. */
+  #lastHidden = null;
+  connect() {
+    if (!this.hasItemsTarget || !this.hasMoreTarget) return;
+    const trigger = this.#trigger();
+    if (trigger && (trigger.textContent ?? "").trim() === "") {
+      trigger.textContent = this.moreLabelValue;
+    }
+    this.#layout.observe(this.element);
+    this.#layout.observeViewport();
+    this.update();
+  }
+  disconnect() {
+    this.#layout.disconnect();
+    this.#timers.clearAll();
+    this.#lastHidden = null;
+  }
+  /** Re-measures and rebalances items between the bar and the More menu. */
+  update() {
+    if (!this.hasItemsTarget || !this.hasMoreTarget) return;
+    this.#syncItems();
+    this.moreTarget.hidden = false;
+    for (const item of this.#items) {
+      if (item.parentElement === this.itemsTarget) this.#widths.set(item, item.offsetWidth);
+    }
+    const moreWidth = (this.#trigger() ?? this.moreTarget).offsetWidth;
+    const gap = this.#gap();
+    const widthOf = (el) => this.#widths.get(el) ?? el.offsetWidth;
+    const containerWidth = this.element.clientWidth;
+    const itemsWidth = this.#items.reduce((sum, el) => sum + widthOf(el), 0);
+    let visibleWidth = itemsWidth + Math.max(0, this.#items.length - 1) * gap;
+    const hidden = /* @__PURE__ */ new Set();
+    if (visibleWidth > containerWidth) {
+      const budget = containerWidth - moreWidth - gap;
+      const dropOrder = [...this.#items].sort(
+        (a, b) => this.#rank(b) - this.#rank(a) || this.#indexOf(b) - this.#indexOf(a)
+      );
+      for (const item of dropOrder) {
+        if (visibleWidth <= budget) break;
+        hidden.add(item);
+        visibleWidth -= widthOf(item) + gap;
+      }
+    }
+    const menu = this.#menuList();
+    const active = document.activeElement;
+    const refocusTrigger = active instanceof HTMLElement && hidden.has(active);
+    for (const item of this.#items) {
+      if (hidden.has(item)) this.#toMenu(item, menu);
+      else this.#toBar(item);
+    }
+    if (refocusTrigger) this.#trigger()?.focus();
+    const count = hidden.size;
+    this.moreTarget.hidden = count === 0;
+    if (count > 0) this.element.setAttribute("data-overflowing", "true");
+    else this.element.removeAttribute("data-overflowing");
+    this.element.setAttribute("data-overflow-count", String(count));
+    if (this.#lastHidden !== count) {
+      this.#lastHidden = count;
+      this.dispatch("change", { detail: { visible: this.#items.length - count, hidden: count } });
+    }
+  }
+  /** The flex `column-gap` between items in px (0 when none / unsupported). */
+  #gap() {
+    if (typeof window.getComputedStyle !== "function") return 0;
+    const style = window.getComputedStyle(this.itemsTarget);
+    const value = Number.parseFloat(style.columnGap || style.gap || "");
+    return Number.isNaN(value) ? 0 : value;
+  }
+  /**
+   * Reconciles the managed item set with the DOM each pass: adopts items appended to the
+   * bar since last time (so the documented "add items, then call `update`" flow works)
+   * and drops any the consumer removed, then renumbers canonical indices. Banked items
+   * live in the menu (still within the controller element) and are retained.
+   */
+  #syncItems() {
+    const known = new Set(this.#items);
+    for (const el of this.itemsTarget.children) {
+      if (el instanceof HTMLElement && !known.has(el)) this.#items.push(el);
+    }
+    this.#items = this.#items.filter((el) => this.element.contains(el));
+    this.#index = /* @__PURE__ */ new WeakMap();
+    this.#items.forEach((el, i) => {
+      this.#index.set(el, i);
+    });
+  }
+  /** Debounced re-measure for resize-driven churn. */
+  #scheduleUpdate() {
+    this.#timers.clearAll();
+    this.#timers.set(() => this.update(), this.debounceValue);
+  }
+  /** Returns the menu list the items are banked into (falls back to the More wrapper). */
+  #menuList() {
+    return this.moreTarget.querySelector('[data-stimeo--menu-target="menu"]') ?? this.moreTarget;
+  }
+  #trigger() {
+    return this.moreTarget.querySelector('[data-stimeo--menu-target="trigger"]');
+  }
+  /** Restores an item to the bar, stripping the menu semantics we may have added. */
+  #toBar(item) {
+    this.itemsTarget.appendChild(item);
+    if (item.dataset.overflowMenuized === void 0) return;
+    item.removeAttribute("data-stimeo--menu-target");
+    this.#restoreAttr(item, "role", item.dataset.overflowOrigRole);
+    this.#restoreAttr(item, "tabindex", item.dataset.overflowOrigTabindex);
+    delete item.dataset.overflowMenuized;
+    delete item.dataset.overflowOrigRole;
+    delete item.dataset.overflowOrigTabindex;
+  }
+  /** Banks an item into the menu with menuitem semantics for Menu to manage. */
+  #toMenu(item, menu) {
+    if (item.dataset.overflowMenuized === void 0) {
+      item.dataset.overflowMenuized = "true";
+      item.dataset.overflowOrigRole = item.getAttribute("role") ?? "";
+      item.dataset.overflowOrigTabindex = item.getAttribute("tabindex") ?? "";
+      item.setAttribute("role", "menuitem");
+      item.setAttribute("tabindex", "-1");
+      item.setAttribute("data-stimeo--menu-target", "item");
+    }
+    menu.appendChild(item);
+  }
+  /** Re-applies a saved attribute value, or removes the attribute when it was absent. */
+  #restoreAttr(item, name, original) {
+    if (original === void 0 || original === "") item.removeAttribute(name);
+    else item.setAttribute(name, original);
+  }
+  #indexOf(item) {
+    return this.#index.get(item) ?? 0;
+  }
+  /** Retention rank: lower keeps longer; no `data-priority` ranks lowest (drops first). */
+  #rank(item) {
+    const raw = item.getAttribute("data-priority");
+    if (raw === null) return Number.POSITIVE_INFINITY;
+    const value = Number(raw);
+    return Number.isNaN(value) ? Number.POSITIVE_INFINITY : value;
+  }
+};
+
+export { OverflowMenuController };
+//# sourceMappingURL=overflow_menu_controller.js.map
+//# sourceMappingURL=overflow_menu_controller.js.map

data/dist/controllers/pagination_controller.js

@@ -0,0 +1,89 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/pagination_controller.ts
+var PaginationController = class extends Controller {
+  static targets = ["page", "prev", "next"];
+  static values = {
+    page: { type: Number, default: 1 },
+    total: { type: Number, default: 1 }
+  };
+  static actions = ["next", "prev", "select"];
+  static events = ["change"];
+  /** Normalizes out-of-range initial values and renders the initial state. */
+  connect() {
+    this.totalValue = Math.max(1, Math.trunc(this.totalValue));
+    this.pageValue = Math.min(this.totalValue, Math.max(1, Math.trunc(this.pageValue)));
+    this.#render();
+  }
+  /** Makes the clicked page button (its `data-page`) current. */
+  select(event) {
+    const button = event.currentTarget;
+    const page = Number(button.dataset.page);
+    if (!Number.isFinite(page)) return;
+    this.#goto(page);
+  }
+  /** Steps to the previous page. */
+  prev() {
+    this.#goto(this.pageValue - 1);
+  }
+  /** Steps to the next page. */
+  next() {
+    this.#goto(this.pageValue + 1);
+  }
+  /** Moves to `page` (clamped to `[1, total]`), re-renders, and dispatches `change`. */
+  #goto(page) {
+    const total = Math.max(1, Math.trunc(this.totalValue));
+    const target = Math.min(total, Math.max(1, Math.trunc(page)));
+    if (target === this.pageValue) return;
+    const previous = this.pageValue;
+    this.pageValue = target;
+    this.#render();
+    this.dispatch("change", {
+      detail: { page: target, total: this.totalValue, previous }
+    });
+  }
+  /** Syncs `aria-current` on the page buttons and the prev/next `disabled` state. */
+  #render() {
+    for (const button of this.pageTargets) {
+      if (Number(button.dataset.page) === this.pageValue) {
+        button.setAttribute("aria-current", "page");
+      } else {
+        button.removeAttribute("aria-current");
+      }
+    }
+    this.#setDisabled(this.hasPrevTarget ? this.prevTarget : null, this.pageValue <= 1);
+    this.#setDisabled(
+      this.hasNextTarget ? this.nextTarget : null,
+      this.pageValue >= this.totalValue
+    );
+  }
+  /**
+   * Sets `disabled` on a boundary button, first moving focus off it if it is the
+   * active element so disabling never strands focus.
+   */
+  #setDisabled(button, disabled) {
+    if (!button) return;
+    if (disabled && button === document.activeElement) {
+      this.#moveFocusAwayFrom(button);
+    }
+    button.disabled = disabled;
+  }
+  /** Moves focus to the opposite enabled control, falling back to the current page. */
+  #moveFocusAwayFrom(button) {
+    const opposite = button === (this.hasPrevTarget ? this.prevTarget : null) ? this.hasNextTarget ? this.nextTarget : null : this.hasPrevTarget ? this.prevTarget : null;
+    const currentPage = this.pageTargets.find(
+      (candidate) => Number(candidate.dataset.page) === this.pageValue
+    );
+    const destination = opposite && !opposite.disabled ? opposite : currentPage;
+    if (destination) {
+      destination.focus();
+      return;
+    }
+    if (!this.element.hasAttribute("tabindex")) this.element.setAttribute("tabindex", "-1");
+    this.element.focus();
+  }
+};
+
+export { PaginationController };
+//# sourceMappingURL=pagination_controller.js.map
+//# sourceMappingURL=pagination_controller.js.map

data/dist/controllers/password_strength_controller.js

@@ -0,0 +1,175 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/password_strength_controller.ts
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeTimeout = class extends TimerRegistry {
+  /**
+   * Schedules `callback` after `delay` ms and returns the timer id.
+   *
+   * The id is removed from the registry automatically when the timeout fires,
+   * so {@link TimerRegistry.size | size} reflects only still-pending timers.
+   */
+  set(callback, delay) {
+    const id = this.schedule(() => {
+      this.ids.delete(id);
+      callback();
+    }, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setTimeout(callback, delay);
+  }
+  cancel(id) {
+    window.clearTimeout(id);
+  }
+};
+
+// src/controllers/password_strength_controller.ts
+var CLASS_PATTERNS = [/[a-z]/, /[A-Z]/, /[0-9]/, /[^A-Za-z0-9]/];
+var LENGTH_MILESTONES = [8, 12, 16];
+var MAX_POINTS = LENGTH_MILESTONES.length + (CLASS_PATTERNS.length - 1);
+var STRENGTH_BANDS = ["weak", "fair", "good", "strong"];
+var PasswordStrengthController = class _PasswordStrengthController extends Controller {
+  static targets = ["input", "meter", "label"];
+  static values = {
+    minScore: { type: Number, default: 0 },
+    levels: { type: Array, default: ["weak", "fair", "good", "strong"] }
+  };
+  static actions = ["evaluate"];
+  static events = ["change"];
+  /** Delay (ms) before the polite live-region label is written, to throttle SR flooding. */
+  static #announceDelay = 200;
+  #timers = new SafeTimeout();
+  #announceId = null;
+  connect() {
+    this.#update({ announce: false });
+  }
+  disconnect() {
+    this.#timers.clearAll();
+    this.#announceId = null;
+  }
+  /** Re-evaluates strength from the input. Bound via `data-action` (`input`). */
+  evaluate() {
+    this.#update();
+  }
+  /**
+   * Recomputes the strength. The meter ARIA, data hooks, the custom property and
+   * the `change` event apply immediately; the live-region label text is debounced
+   * unless `announce` is `false` (the initial render).
+   */
+  #update(options = {}) {
+    const password = this.hasInputTarget ? this.inputTarget.value : "";
+    const labels = this.levelsValue;
+    const max = labels.length;
+    const score = this.#score(password, max);
+    const label = score > 0 ? labels[score - 1] ?? "" : "";
+    this.#reflectMeter(score, max);
+    this.#reflectRoot(score, max);
+    if (options.announce === false) {
+      this.#writeLabel(label);
+      return;
+    }
+    this.dispatch("change", {
+      detail: { score, level: label, max, meetsMin: score > 0 && score >= this.minScoreValue }
+    });
+    if (this.#announceId !== null) this.#timers.clear(this.#announceId);
+    this.#announceId = this.#timers.set(() => {
+      this.#writeLabel(label);
+      this.#announceId = null;
+    }, _PasswordStrengthController.#announceDelay);
+  }
+  /** Syncs the meter target's ARIA value attributes (`0..levels.length`). */
+  #reflectMeter(score, max) {
+    if (!this.hasMeterTarget) return;
+    this.meterTarget.setAttribute("aria-valuemin", "0");
+    this.meterTarget.setAttribute("aria-valuemax", String(max));
+    this.meterTarget.setAttribute("aria-valuenow", String(score));
+  }
+  /**
+   * Reflects the level onto the root: the stable `data-strength` band (absent when
+   * empty), the `data-below-min` hook when the score is under `minScore`, and the
+   * `0–1` fill the consumer's CSS turns into the bar width.
+   */
+  #reflectRoot(score, max) {
+    const band = this.#band(score, max);
+    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));
+  }
+  #writeLabel(label) {
+    if (this.hasLabelTarget) this.labelTarget.textContent = label;
+  }
+  /**
+   * Locale-independent styling band (one of {@link STRENGTH_BANDS}) for `score`
+   * out of `max`. Empty input → `""`. Quantizes the `score/max` ratio into the
+   * four fixed bands, so a non-default level count still maps onto a stable hook.
+   */
+  #band(score, max) {
+    if (score <= 0 || max <= 0) return "";
+    const index = Math.ceil(score / max * STRENGTH_BANDS.length) - 1;
+    return STRENGTH_BANDS[Math.min(STRENGTH_BANDS.length - 1, Math.max(0, index))] ?? "";
+  }
+  /** Sets `name` to `value` when `on`, else removes it (value/presence data hook). */
+  #toggle(name, value, on) {
+    if (on) {
+      this.element.setAttribute(name, value);
+    } else {
+      this.element.removeAttribute(name);
+    }
+  }
+  /**
+   * Lightweight zero-dependency strength heuristic returning an integer in
+   * `[0, max]` (`max` = number of levels). Empty input is `0` (no level); any
+   * non-empty password is at least `1`. Points accrue from length milestones and
+   * character-class variety, then bucket into the level scale. A tiny alphabet
+   * (≤ 2 distinct characters, e.g. "aaaa") is capped as the weakest, so length
+   * alone cannot mask trivial repetition.
+   */
+  #score(password, max) {
+    if (password.length === 0 || max === 0) return 0;
+    let points = 0;
+    for (const milestone of LENGTH_MILESTONES) {
+      if (password.length >= milestone) points += 1;
+    }
+    points += CLASS_PATTERNS.filter((re) => re.test(password)).length - 1;
+    if (new Set(password).size <= 2) points = 0;
+    const bucketed = Math.round(points / MAX_POINTS * max);
+    return Math.min(max, Math.max(1, bucketed));
+  }
+};
+
+export { PasswordStrengthController };
+//# sourceMappingURL=password_strength_controller.js.map
+//# sourceMappingURL=password_strength_controller.js.map