stimeo-ui 0.1.0-alpha.1

package/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

package/dist/controllers/overflow_menu_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/layout_observer.ts","../../src/utils/safe_timeout.ts","../../src/controllers/overflow_menu_controller.ts"],"names":[],"mappings":"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","file":"overflow_menu_controller.js","sourcesContent":["/**\n * Unified element-size and viewport observation for Stimeo controllers.\n *\n * Layout-sensitive widgets (sliders, resizable panes, scroll spies, popovers)\n * need to react both to their *own* box changing — via {@link ResizeObserver} —\n * and to the *viewport* changing — via the `window` `resize` event. Wiring those\n * two sources by hand in every controller risks leaked listeners on\n * `disconnect()`. {@link LayoutObserver} owns both behind one callback and one\n * {@link LayoutObserver.disconnect | disconnect()} that releases everything.\n *\n * Behavior only: the helper reports *that* layout changed; it never reads or\n * writes styles. Consumers decide what to recompute.\n */\n\n/** Invoked whenever an observed element or the viewport changes size. */\nexport type LayoutCallback = () => void;\n\n/** Constructs a {@link ResizeObserver}; injectable so tests stay deterministic. */\nexport type ResizeObserverFactory = (callback: ResizeObserverCallback) => ResizeObserver;\n\n/** Options for {@link LayoutObserver}. */\nexport interface LayoutObserverOptions {\n  /**\n   * Factory for the {@link ResizeObserver} used by {@link LayoutObserver.observe}.\n   * Defaults to the global constructor; override it in tests, or to no-op in\n   * environments where `ResizeObserver` is unavailable.\n   */\n  resizeObserverFactory?: ResizeObserverFactory;\n}\n\n/**\n * Observes element resizes and/or viewport resizes through a single callback,\n * with guaranteed teardown.\n *\n * @example\n * ```ts\n * #layout = new LayoutObserver(() => this.#reposition());\n *\n * connect() {\n *   this.#layout.observe(this.panelTarget);\n *   this.#layout.observeViewport();\n * }\n *\n * disconnect() {\n *   this.#layout.disconnect();\n * }\n * ```\n */\nexport class LayoutObserver {\n  readonly #callback: LayoutCallback;\n  readonly #resizeObserverFactory: ResizeObserverFactory | null;\n  #resizeObserver: ResizeObserver | null = null;\n  #observingViewport = false;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  constructor(callback: LayoutCallback, options: LayoutObserverOptions = {}) {\n    this.#callback = callback;\n    this.#resizeObserverFactory =\n      options.resizeObserverFactory ??\n      (typeof ResizeObserver === \"undefined\" ? null : (cb) => new ResizeObserver(cb));\n  }\n\n  /**\n   * Starts observing an element's size. Repeated calls observe additional\n   * elements through the same shared observer. No-ops when no\n   * `ResizeObserver` implementation is available.\n   */\n  observe(element: Element): void {\n    if (!this.#resizeObserverFactory) return;\n    if (!this.#resizeObserver) {\n      this.#resizeObserver = this.#resizeObserverFactory(() => {\n        this.#callback();\n      });\n    }\n    this.#resizeObserver.observe(element);\n  }\n\n  /** Stops observing a single element while leaving any others in place. */\n  unobserve(element: Element): void {\n    this.#resizeObserver?.unobserve(element);\n  }\n\n  /** Starts observing viewport resizes. Idempotent: the listener is added once. */\n  observeViewport(): void {\n    if (this.#observingViewport) return;\n    this.#observingViewport = true;\n    window.addEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /** Stops observing viewport resizes without affecting element observation. */\n  unobserveViewport(): void {\n    if (!this.#observingViewport) return;\n    this.#observingViewport = false;\n    window.removeEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and\n   * removes the viewport listener. Safe to call multiple times. Call this from a\n   * controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n  }\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { LayoutObserver } from \"../utils/layout_observer\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless **overflow / priority menu**: items that no longer fit their container are\n * moved into a \"More\" dropdown (lowest `data-priority` first) and moved back as space\n * returns, watched with a {@link ResizeObserver} (no dedicated APG pattern — a\n * composition; the menu's a11y is delegated to Menu, so it is not re-implemented).\n *\n * Markup contract (identifier: `stimeo--overflow-menu`):\n *   <div data-controller=\"stimeo--overflow-menu\" role=\"toolbar\">\n *     <div data-stimeo--overflow-menu-target=\"items\">\n *       <a data-priority=\"1\">Save</a><a data-priority=\"2\">Duplicate</a><a>Delete</a>\n *     </div>\n *     <div data-controller=\"stimeo--menu\" data-stimeo--overflow-menu-target=\"more\" hidden>\n *       <button data-stimeo--menu-target=\"trigger\">More</button>\n *       <ul role=\"menu\" data-stimeo--menu-target=\"menu\" hidden></ul>\n *     </div>\n *   </div>\n *\n * On connect (and every debounced resize) it measures the items against the container\n * width and, when they overflow, banks the lowest-priority ones into the More menu —\n * giving each `role=\"menuitem\"` / `tabindex=\"-1\"` and the menu's `item` target so Menu\n * drives it — until the rest fit beside the More button. When nothing overflows the\n * More button is `hidden`. The controller element carries `data-overflowing` /\n * `data-overflow-count`, and a `change` event fires on each transition.\n *\n * @remarks\n * Items are *moved* (not cloned). When a focused item retreats into the (collapsed)\n * menu it would otherwise be hidden and lose focus, so focus is redirected to the More\n * trigger. Priority: lower `data-priority` is kept longer; items without one drop first.\n * Behavior only — no styling. The `ResizeObserver` and debounce timer are released on\n * `disconnect()` (Turbo navigation included); state is derived from the DOM each pass\n * (no module-scope state), so `connect()` re-syncs after a Turbo morph. Captures the\n * managed item set at connect; call the `update` action to re-measure after adding\n * items dynamically.\n */\nexport class OverflowMenuController extends Controller<HTMLElement> {\n  static override targets = [\"items\", \"more\"];\n  static override values = {\n    moreLabel: { type: String, default: \"More\" },\n    debounce: { type: Number, default: 100 },\n  };\n  static actions = [\"update\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly itemsTarget: HTMLElement;\n  declare readonly moreTarget: HTMLElement;\n  declare readonly hasItemsTarget: boolean;\n  declare readonly hasMoreTarget: boolean;\n\n  declare moreLabelValue: string;\n  declare debounceValue: number;\n\n  readonly #layout = new LayoutObserver(() => this.#scheduleUpdate());\n  readonly #timers = new SafeTimeout();\n  /** The managed items in canonical (authored) order, captured at connect. */\n  #items: HTMLElement[] = [];\n  #index = new WeakMap<HTMLElement, number>();\n  /**\n   * Cached bar-context width per item. An item's natural width is location-independent,\n   * so this lets a measure pass read only the items currently in the bar (menu items\n   * reuse their last value) instead of pulling everything back to measure — one reflow,\n   * not two.\n   */\n  #widths = new WeakMap<HTMLElement, number>();\n  /** Last reported overflow count, so `change` fires only on transitions. */\n  #lastHidden: number | null = null;\n\n  override connect(): void {\n    if (!this.hasItemsTarget || !this.hasMoreTarget) return;\n\n    const trigger = this.#trigger();\n    if (trigger && (trigger.textContent ?? \"\").trim() === \"\") {\n      trigger.textContent = this.moreLabelValue;\n    }\n\n    this.#layout.observe(this.element);\n    this.#layout.observeViewport();\n    this.update();\n  }\n\n  override disconnect(): void {\n    this.#layout.disconnect();\n    this.#timers.clearAll();\n    this.#lastHidden = null;\n  }\n\n  /** Re-measures and rebalances items between the bar and the More menu. */\n  update(): void {\n    if (!this.hasItemsTarget || !this.hasMoreTarget) return;\n    this.#syncItems();\n\n    // Reveal More so its trigger is measurable, then refresh cached widths for the items\n    // currently in the bar (menu items keep their location-independent last value).\n    this.moreTarget.hidden = false;\n    for (const item of this.#items) {\n      if (item.parentElement === this.itemsTarget) this.#widths.set(item, item.offsetWidth);\n    }\n    const moreWidth = (this.#trigger() ?? this.moreTarget).offsetWidth;\n    const gap = this.#gap();\n\n    const widthOf = (el: HTMLElement): number => this.#widths.get(el) ?? el.offsetWidth;\n    const containerWidth = this.element.clientWidth;\n    const itemsWidth = this.#items.reduce((sum, el) => sum + widthOf(el), 0);\n    let visibleWidth = itemsWidth + Math.max(0, this.#items.length - 1) * gap;\n\n    const hidden = new Set<HTMLElement>();\n    if (visibleWidth > containerWidth) {\n      const budget = containerWidth - moreWidth - gap; // reserve the More button + its gap\n      // Drop lowest-retention first: no `data-priority` (rank ∞), then highest number;\n      // ties broken right-to-left so leading items survive.\n      const dropOrder = [...this.#items].sort(\n        (a, b) => this.#rank(b) - this.#rank(a) || this.#indexOf(b) - this.#indexOf(a),\n      );\n      for (const item of dropOrder) {\n        if (visibleWidth <= budget) break;\n        hidden.add(item);\n        visibleWidth -= widthOf(item) + gap; // dropping an item frees its width and a gap\n      }\n    }\n\n    // Re-home every item in canonical order so the bar and the menu both stay correctly\n    // ordered — a banked middle item returns to its original slot, not the end.\n    const menu = this.#menuList();\n    // If the focused item is one of the ones retreating, redirect focus to the More\n    // trigger: in a collapsed menu the banked item becomes hidden and the browser would\n    // otherwise drop focus to <body>. Decided before the move (not by polling\n    // activeElement afterwards) so it does not race the browser's blur.\n    const active = document.activeElement;\n    const refocusTrigger = active instanceof HTMLElement && hidden.has(active);\n    for (const item of this.#items) {\n      if (hidden.has(item)) this.#toMenu(item, menu);\n      else this.#toBar(item);\n    }\n    if (refocusTrigger) this.#trigger()?.focus();\n\n    const count = hidden.size;\n    this.moreTarget.hidden = count === 0;\n    if (count > 0) this.element.setAttribute(\"data-overflowing\", \"true\");\n    else this.element.removeAttribute(\"data-overflowing\");\n    this.element.setAttribute(\"data-overflow-count\", String(count));\n\n    if (this.#lastHidden !== count) {\n      this.#lastHidden = count;\n      this.dispatch(\"change\", { detail: { visible: this.#items.length - count, hidden: count } });\n    }\n  }\n\n  /** The flex `column-gap` between items in px (0 when none / unsupported). */\n  #gap(): number {\n    if (typeof window.getComputedStyle !== \"function\") return 0;\n    const style = window.getComputedStyle(this.itemsTarget);\n    const value = Number.parseFloat(style.columnGap || style.gap || \"\");\n    return Number.isNaN(value) ? 0 : value;\n  }\n\n  /**\n   * Reconciles the managed item set with the DOM each pass: adopts items appended to the\n   * bar since last time (so the documented \"add items, then call `update`\" flow works)\n   * and drops any the consumer removed, then renumbers canonical indices. Banked items\n   * live in the menu (still within the controller element) and are retained.\n   */\n  #syncItems(): void {\n    const known = new Set(this.#items);\n    for (const el of this.itemsTarget.children) {\n      if (el instanceof HTMLElement && !known.has(el)) this.#items.push(el);\n    }\n    this.#items = this.#items.filter((el) => this.element.contains(el));\n    this.#index = new WeakMap();\n    this.#items.forEach((el, i) => {\n      this.#index.set(el, i);\n    });\n  }\n\n  /** Debounced re-measure for resize-driven churn. */\n  #scheduleUpdate(): void {\n    this.#timers.clearAll();\n    this.#timers.set(() => this.update(), this.debounceValue);\n  }\n\n  /** Returns the menu list the items are banked into (falls back to the More wrapper). */\n  #menuList(): HTMLElement {\n    return (\n      this.moreTarget.querySelector<HTMLElement>('[data-stimeo--menu-target=\"menu\"]') ??\n      this.moreTarget\n    );\n  }\n\n  #trigger(): HTMLElement | null {\n    return this.moreTarget.querySelector<HTMLElement>('[data-stimeo--menu-target=\"trigger\"]');\n  }\n\n  /** Restores an item to the bar, stripping the menu semantics we may have added. */\n  #toBar(item: HTMLElement): void {\n    // Always append (in canonical-order calls) so the bar's order is rebuilt correctly.\n    this.itemsTarget.appendChild(item);\n    if (item.dataset.overflowMenuized === undefined) return;\n    item.removeAttribute(\"data-stimeo--menu-target\");\n    this.#restoreAttr(item, \"role\", item.dataset.overflowOrigRole);\n    this.#restoreAttr(item, \"tabindex\", item.dataset.overflowOrigTabindex);\n    delete item.dataset.overflowMenuized;\n    delete item.dataset.overflowOrigRole;\n    delete item.dataset.overflowOrigTabindex;\n  }\n\n  /** Banks an item into the menu with menuitem semantics for Menu to manage. */\n  #toMenu(item: HTMLElement, menu: HTMLElement): void {\n    if (item.dataset.overflowMenuized === undefined) {\n      item.dataset.overflowMenuized = \"true\";\n      item.dataset.overflowOrigRole = item.getAttribute(\"role\") ?? \"\";\n      item.dataset.overflowOrigTabindex = item.getAttribute(\"tabindex\") ?? \"\";\n      item.setAttribute(\"role\", \"menuitem\");\n      item.setAttribute(\"tabindex\", \"-1\");\n      item.setAttribute(\"data-stimeo--menu-target\", \"item\");\n    }\n    menu.appendChild(item);\n  }\n\n  /** Re-applies a saved attribute value, or removes the attribute when it was absent. */\n  #restoreAttr(item: HTMLElement, name: string, original: string | undefined): void {\n    if (original === undefined || original === \"\") item.removeAttribute(name);\n    else item.setAttribute(name, original);\n  }\n\n  #indexOf(item: HTMLElement): number {\n    return this.#index.get(item) ?? 0;\n  }\n\n  /** Retention rank: lower keeps longer; no `data-priority` ranks lowest (drops first). */\n  #rank(item: HTMLElement): number {\n    const raw = item.getAttribute(\"data-priority\");\n    if (raw === null) return Number.POSITIVE_INFINITY;\n    const value = Number(raw);\n    return Number.isNaN(value) ? Number.POSITIVE_INFINITY : value;\n  }\n}\n"]}

package/dist/controllers/pagination_controller.d.ts

@@ -0,0 +1,69 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible pagination behavior.
+ *
+ * Markup contract (identifier: `stimeo--pagination`):
+ *   <nav data-controller="stimeo--pagination" aria-label="Pagination"
+ *        data-stimeo--pagination-page-value="1"
+ *        data-stimeo--pagination-total-value="5">
+ *     <button type="button" data-stimeo--pagination-target="prev"
+ *             data-action="stimeo--pagination#prev">Prev</button>
+ *     <button type="button" data-page="1" aria-current="page"
+ *             data-stimeo--pagination-target="page"
+ *             data-action="stimeo--pagination#select">1</button>
+ *     <!-- more page buttons -->
+ *     <button type="button" data-stimeo--pagination-target="next"
+ *             data-action="stimeo--pagination#next">Next</button>
+ *   </nav>
+ *
+ * There is no dedicated APG pattern; this uses a navigation landmark plus
+ * `aria-current="page"`. The controller owns current-page state, the
+ * `aria-current` sync, boundary disabling of prev/next, and the change event.
+ * Generating/eliding the page buttons and fetching data stay with the consumer.
+ *
+ * @remarks
+ * Behavior only — each control is in the natural Tab order (no roving). When a
+ * boundary disables the button that currently has focus, focus is moved first so
+ * it is never lost to a `disabled` element.
+ *
+ * Behavior provided:
+ * - `select` reads the clicked button's `data-page` and makes it current.
+ * - `prev`/`next` step by one, clamped to `[1, total]`.
+ * - The current page button gets `aria-current="page"` (removed from the rest);
+ *   `prev` is `disabled` at page 1 and `next` at `total`.
+ * - Every change dispatches `stimeo--pagination:change`.
+ */
+declare class PaginationController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        page: {
+            type: NumberConstructor;
+            default: number;
+        };
+        total: {
+            type: NumberConstructor;
+            default: number;
+        };
+    };
+    static actions: readonly ["next", "prev", "select"];
+    static events: readonly ["change"];
+    readonly pageTargets: HTMLElement[];
+    readonly prevTarget: HTMLButtonElement;
+    readonly nextTarget: HTMLButtonElement;
+    readonly hasPrevTarget: boolean;
+    readonly hasNextTarget: boolean;
+    pageValue: number;
+    totalValue: number;
+    /** Normalizes out-of-range initial values and renders the initial state. */
+    connect(): void;
+    /** Makes the clicked page button (its `data-page`) current. */
+    select(event: Event): void;
+    /** Steps to the previous page. */
+    prev(): void;
+    /** Steps to the next page. */
+    next(): void;
+}
+
+export { PaginationController };

package/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

package/dist/controllers/pagination_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/pagination_controller.ts"],"names":[],"mappings":";;;AAoCO,IAAM,oBAAA,GAAN,cAAmC,UAAA,CAAwB;AAAA,EAChE,OAAgB,OAAA,GAAU,CAAC,MAAA,EAAQ,QAAQ,MAAM,CAAA;AAAA,EACjD,OAAgB,MAAA,GAAS;AAAA,IACvB,IAAA,EAAM,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,CAAA,EAAE;AAAA,IACjC,KAAA,EAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,CAAA;AAAE,GACpC;AAAA,EACA,OAAO,OAAA,GAAU,CAAC,MAAA,EAAQ,QAAQ,QAAQ,CAAA;AAAA,EAC1C,OAAO,MAAA,GAAS,CAAC,QAAQ,CAAA;AAAA;AAAA,EAWhB,OAAA,GAAgB;AACvB,IAAA,IAAA,CAAK,UAAA,GAAa,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,IAAA,CAAK,UAAU,CAAC,CAAA;AACzD,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA,CAAK,GAAA,CAAI,IAAA,CAAK,UAAA,EAAY,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAS,CAAC,CAAC,CAAA;AAClF,IAAA,IAAA,CAAK,OAAA,EAAQ;AAAA,EACf;AAAA;AAAA,EAGA,OAAO,KAAA,EAAoB;AACzB,IAAA,MAAM,SAAS,KAAA,CAAM,aAAA;AACrB,IAAA,MAAM,IAAA,GAAO,MAAA,CAAO,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA;AACvC,IAAA,IAAI,CAAC,MAAA,CAAO,QAAA,CAAS,IAAI,CAAA,EAAG;AAC5B,IAAA,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EACjB;AAAA;AAAA,EAGA,IAAA,GAAa;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,GAAY,CAAC,CAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,IAAA,GAAa;AACX,IAAA,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,SAAA,GAAY,CAAC,CAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,MAAM,IAAA,EAAoB;AAExB,IAAA,MAAM,KAAA,GAAQ,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,KAAA,CAAM,IAAA,CAAK,UAAU,CAAC,CAAA;AACrD,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,GAAA,CAAI,KAAA,EAAO,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,KAAA,CAAM,IAAI,CAAC,CAAC,CAAA;AAC5D,IAAA,IAAI,MAAA,KAAW,KAAK,SAAA,EAAW;AAC/B,IAAA,MAAM,WAAW,IAAA,CAAK,SAAA;AACtB,IAAA,IAAA,CAAK,SAAA,GAAY,MAAA;AACjB,IAAA,IAAA,CAAK,OAAA,EAAQ;AACb,IAAA,IAAA,CAAK,SAAS,QAAA,EAAU;AAAA,MACtB,QAAQ,EAAE,IAAA,EAAM,QAAQ,KAAA,EAAO,IAAA,CAAK,YAAY,QAAA;AAAS,KAC1D,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,OAAA,GAAgB;AACd,IAAA,KAAA,MAAW,MAAA,IAAU,KAAK,WAAA,EAAa;AACrC,MAAA,IAAI,OAAO,MAAA,CAAO,OAAA,CAAQ,IAAI,CAAA,KAAM,KAAK,SAAA,EAAW;AAClD,QAAA,MAAA,CAAO,YAAA,CAAa,gBAAgB,MAAM,CAAA;AAAA,MAC5C,CAAA,MAAO;AACL,QAAA,MAAA,CAAO,gBAAgB,cAAc,CAAA;AAAA,MACvC;AAAA,IACF;AACA,IAAA,IAAA,CAAK,YAAA,CAAa,KAAK,aAAA,GAAgB,IAAA,CAAK,aAAa,IAAA,EAAM,IAAA,CAAK,aAAa,CAAC,CAAA;AAClF,IAAA,IAAA,CAAK,YAAA;AAAA,MACH,IAAA,CAAK,aAAA,GAAgB,IAAA,CAAK,UAAA,GAAa,IAAA;AAAA,MACvC,IAAA,CAAK,aAAa,IAAA,CAAK;AAAA,KACzB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAA,CAAa,QAAkC,QAAA,EAAyB;AACtE,IAAA,IAAI,CAAC,MAAA,EAAQ;AACb,IAAA,IAAI,QAAA,IAAY,MAAA,KAAW,QAAA,CAAS,aAAA,EAAe;AACjD,MAAA,IAAA,CAAK,mBAAmB,MAAM,CAAA;AAAA,IAChC;AACA,IAAA,MAAA,CAAO,QAAA,GAAW,QAAA;AAAA,EACpB;AAAA;AAAA,EAGA,mBAAmB,MAAA,EAAiC;AAClD,IAAA,MAAM,QAAA,GACJ,MAAA,MAAY,IAAA,CAAK,aAAA,GAAgB,KAAK,UAAA,GAAa,IAAA,CAAA,GAC/C,IAAA,CAAK,aAAA,GACH,KAAK,UAAA,GACL,IAAA,GACF,IAAA,CAAK,aAAA,GACH,KAAK,UAAA,GACL,IAAA;AACR,IAAA,MAAM,WAAA,GAAc,KAAK,WAAA,CAAY,IAAA;AAAA,MACnC,CAAC,SAAA,KAAc,MAAA,CAAO,UAAU,OAAA,CAAQ,IAAI,MAAM,IAAA,CAAK;AAAA,KACzD;AACA,IAAA,MAAM,WAAA,GAAc,QAAA,IAAY,CAAC,QAAA,CAAS,WAAW,QAAA,GAAW,WAAA;AAChE,IAAA,IAAI,WAAA,EAAa;AACf,MAAA,WAAA,CAAY,KAAA,EAAM;AAClB,MAAA;AAAA,IACF;AAKA,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,UAAU,GAAG,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,UAAA,EAAY,IAAI,CAAA;AACtF,IAAA,IAAA,CAAK,QAAQ,KAAA,EAAM;AAAA,EACrB;AACF","file":"pagination_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, accessible pagination behavior.\n *\n * Markup contract (identifier: `stimeo--pagination`):\n *   <nav data-controller=\"stimeo--pagination\" aria-label=\"Pagination\"\n *        data-stimeo--pagination-page-value=\"1\"\n *        data-stimeo--pagination-total-value=\"5\">\n *     <button type=\"button\" data-stimeo--pagination-target=\"prev\"\n *             data-action=\"stimeo--pagination#prev\">Prev</button>\n *     <button type=\"button\" data-page=\"1\" aria-current=\"page\"\n *             data-stimeo--pagination-target=\"page\"\n *             data-action=\"stimeo--pagination#select\">1</button>\n *     <!-- more page buttons -->\n *     <button type=\"button\" data-stimeo--pagination-target=\"next\"\n *             data-action=\"stimeo--pagination#next\">Next</button>\n *   </nav>\n *\n * There is no dedicated APG pattern; this uses a navigation landmark plus\n * `aria-current=\"page\"`. The controller owns current-page state, the\n * `aria-current` sync, boundary disabling of prev/next, and the change event.\n * Generating/eliding the page buttons and fetching data stay with the consumer.\n *\n * @remarks\n * Behavior only — each control is in the natural Tab order (no roving). When a\n * boundary disables the button that currently has focus, focus is moved first so\n * it is never lost to a `disabled` element.\n *\n * Behavior provided:\n * - `select` reads the clicked button's `data-page` and makes it current.\n * - `prev`/`next` step by one, clamped to `[1, total]`.\n * - The current page button gets `aria-current=\"page\"` (removed from the rest);\n *   `prev` is `disabled` at page 1 and `next` at `total`.\n * - Every change dispatches `stimeo--pagination:change`.\n */\nexport class PaginationController extends Controller<HTMLElement> {\n  static override targets = [\"page\", \"prev\", \"next\"];\n  static override values = {\n    page: { type: Number, default: 1 },\n    total: { type: Number, default: 1 },\n  };\n  static actions = [\"next\", \"prev\", \"select\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly pageTargets: HTMLElement[];\n  declare readonly prevTarget: HTMLButtonElement;\n  declare readonly nextTarget: HTMLButtonElement;\n  declare readonly hasPrevTarget: boolean;\n  declare readonly hasNextTarget: boolean;\n  declare pageValue: number;\n  declare totalValue: number;\n\n  /** Normalizes out-of-range initial values and renders the initial state. */\n  override connect(): void {\n    this.totalValue = Math.max(1, Math.trunc(this.totalValue));\n    this.pageValue = Math.min(this.totalValue, Math.max(1, Math.trunc(this.pageValue)));\n    this.#render();\n  }\n\n  /** Makes the clicked page button (its `data-page`) current. */\n  select(event: Event): void {\n    const button = event.currentTarget as HTMLElement;\n    const page = Number(button.dataset.page);\n    if (!Number.isFinite(page)) return;\n    this.#goto(page);\n  }\n\n  /** Steps to the previous page. */\n  prev(): void {\n    this.#goto(this.pageValue - 1);\n  }\n\n  /** Steps to the next page. */\n  next(): void {\n    this.#goto(this.pageValue + 1);\n  }\n\n  /** Moves to `page` (clamped to `[1, total]`), re-renders, and dispatches `change`. */\n  #goto(page: number): void {\n    // Normalize total first so a stray total<=0 can't clamp the 1-based page to 0.\n    const total = Math.max(1, Math.trunc(this.totalValue));\n    const target = Math.min(total, Math.max(1, Math.trunc(page)));\n    if (target === this.pageValue) return;\n    const previous = this.pageValue;\n    this.pageValue = target;\n    this.#render();\n    this.dispatch(\"change\", {\n      detail: { page: target, total: this.totalValue, previous },\n    });\n  }\n\n  /** Syncs `aria-current` on the page buttons and the prev/next `disabled` state. */\n  #render(): void {\n    for (const button of this.pageTargets) {\n      if (Number(button.dataset.page) === this.pageValue) {\n        button.setAttribute(\"aria-current\", \"page\");\n      } else {\n        button.removeAttribute(\"aria-current\");\n      }\n    }\n    this.#setDisabled(this.hasPrevTarget ? this.prevTarget : null, this.pageValue <= 1);\n    this.#setDisabled(\n      this.hasNextTarget ? this.nextTarget : null,\n      this.pageValue >= this.totalValue,\n    );\n  }\n\n  /**\n   * Sets `disabled` on a boundary button, first moving focus off it if it is the\n   * active element so disabling never strands focus.\n   */\n  #setDisabled(button: HTMLButtonElement | null, disabled: boolean): void {\n    if (!button) return;\n    if (disabled && button === document.activeElement) {\n      this.#moveFocusAwayFrom(button);\n    }\n    button.disabled = disabled;\n  }\n\n  /** Moves focus to the opposite enabled control, falling back to the current page. */\n  #moveFocusAwayFrom(button: HTMLButtonElement): void {\n    const opposite =\n      button === (this.hasPrevTarget ? this.prevTarget : null)\n        ? this.hasNextTarget\n          ? this.nextTarget\n          : null\n        : this.hasPrevTarget\n          ? this.prevTarget\n          : null;\n    const currentPage = this.pageTargets.find(\n      (candidate) => Number(candidate.dataset.page) === this.pageValue,\n    );\n    const destination = opposite && !opposite.disabled ? opposite : currentPage;\n    if (destination) {\n      destination.focus();\n      return;\n    }\n    // Degenerate config (e.g. a lone boundary button, no page buttons): keep focus\n    // inside the pagination landmark instead of letting the browser drop it to\n    // <body> when the button disables. The root is made programmatically focusable\n    // just-in-time with `tabindex=\"-1\"`, which is not a Tab stop.\n    if (!this.element.hasAttribute(\"tabindex\")) this.element.setAttribute(\"tabindex\", \"-1\");\n    this.element.focus();\n  }\n}\n"]}

package/dist/controllers/password_strength_controller.d.ts

@@ -0,0 +1,67 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless password-strength behavior: scores the field with a lightweight
+ * zero-dependency heuristic and drives a meter plus an `aria-live` label. No
+ * dedicated APG pattern; the meter display follows {@link MeterController}.
+ *
+ * Markup contract (identifier: `stimeo--password-strength`):
+ *   <div data-controller="stimeo--password-strength">
+ *     <input type="password" data-stimeo--password-strength-target="input"
+ *            data-action="input->stimeo--password-strength#evaluate" aria-describedby="pw">
+ *     <div data-stimeo--password-strength-target="meter" role="meter"
+ *          aria-valuemin="0" aria-valuemax="4"></div>
+ *     <span id="pw" data-stimeo--password-strength-target="label" aria-live="polite"></span>
+ *   </div>
+ *
+ * On each input the controller scores the password (length milestones + character
+ * variety, capped for trivial repetition), syncs the meter's `aria-valuenow`,
+ * reflects a stable band on `data-strength`, the `0–1` fill on
+ * `--stimeo-password-strength`, and (when `minScore` is set) `data-below-min`,
+ * and writes the level label into the label target.
+ *
+ * @remarks
+ * Behavior only — the meter/bar look is the consumer's, keyed off the data hooks.
+ * `data-strength` is one of the fixed {@link STRENGTH_BANDS} (not the localizable
+ * `levels` text), so consumers can style by it regardless of locale; the visible
+ * label receives the matching `levels` entry. Non-text state (meter ARIA,
+ * `data-strength`/`data-below-min`, the custom property, and the `change` event)
+ * updates **immediately** on every keystroke so styling and consumers stay
+ * responsive, while the label — in an `aria-live="polite"` region — is written on
+ * a short debounce so a screen reader is not flooded mid-typing. The score is a
+ * pure function of the input value (no module-scope state), so `connect()`
+ * re-evaluates idempotently after a Turbo cache restore; the debounce timer is
+ * owned by {@link SafeTimeout} and torn down on `disconnect()` (Turbo included).
+ * The estimator is intentionally not a dictionary/zxcvbn-grade one (kept
+ * zero-dep); swap a stronger one in on the consumer side if needed.
+ */
+declare class PasswordStrengthController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        minScore: {
+            type: NumberConstructor;
+            default: number;
+        };
+        levels: {
+            type: ArrayConstructor;
+            default: string[];
+        };
+    };
+    static actions: readonly ["evaluate"];
+    static events: readonly ["change"];
+    readonly inputTarget: HTMLInputElement;
+    readonly meterTarget: HTMLElement;
+    readonly labelTarget: HTMLElement;
+    readonly hasInputTarget: boolean;
+    readonly hasMeterTarget: boolean;
+    readonly hasLabelTarget: boolean;
+    minScoreValue: number;
+    levelsValue: string[];
+    connect(): void;
+    disconnect(): void;
+    /** Re-evaluates strength from the input. Bound via `data-action` (`input`). */
+    evaluate(): void;
+}
+
+export { PasswordStrengthController };