stimeo-ui 0.1.0-alpha.1

package/dist/controllers/relative_time_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/relative_time_controller.ts"],"names":[],"mappings":"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","file":"relative_time_controller.js","sourcesContent":["/**\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 { SafeTimeout } from \"../utils/safe_timeout\";\n\n/** A time scale: the upper bound (seconds) it covers and its `Intl` unit/divisor. */\ninterface TimeScale {\n  limit: number;\n  unit: Intl.RelativeTimeFormatUnit;\n  ms: number;\n}\n\n/** Coarsest scale, used as the fallback for anything a year or older. */\nconst YEAR_SCALE: TimeScale = { limit: Number.POSITIVE_INFINITY, unit: \"year\", ms: 31_557_600_000 };\n\n/** Boundaries (in seconds) and the `Intl` unit/divisor used at each scale. */\nconst UNITS: readonly TimeScale[] = [\n  { limit: 60, unit: \"second\", ms: 1000 },\n  { limit: 3600, unit: \"minute\", ms: 60_000 },\n  { limit: 86_400, unit: \"hour\", ms: 3_600_000 },\n  { limit: 604_800, unit: \"day\", ms: 86_400_000 },\n  { limit: 2_629_800, unit: \"week\", ms: 604_800_000 },\n  { limit: 31_557_600, unit: \"month\", ms: 2_629_800_000 },\n  YEAR_SCALE,\n];\n\n/**\n * Headless relative-time behavior: renders an absolute timestamp as \"3 minutes\n * ago\" / \"in 2 days\" and keeps it fresh. No dedicated APG pattern; it follows\n * the HTML `<time>` semantics.\n *\n * Markup contract (identifier: `stimeo--relative-time`):\n *   <time data-controller=\"stimeo--relative-time\"\n *         datetime=\"2026-05-30T12:00:00+09:00\" title=\"2026-05-30 12:00\"\n *         data-stimeo--relative-time-locale-value=\"ja\">2026-05-30 12:00</time>\n *\n * Computes the difference from `datetime` to now and formats it with\n * `Intl.RelativeTimeFormat` (a browser standard — no added dependency). The\n * polling interval widens as the timestamp ages (seconds → minutes → hours →\n * days). Past a `threshold`, it falls back to the authored absolute text.\n *\n * @remarks\n * Behavior only. The machine-readable `datetime` attribute is left untouched\n * while only the visible text updates, and the element is intentionally **not**\n * a live region (silent updates, no announcement interruptions). The polling\n * timer is owned by {@link SafeTimeout} and torn down on `disconnect()` (Turbo\n * navigation included).\n */\nexport class RelativeTimeController extends Controller<HTMLElement> {\n  static override values = {\n    locale: { type: String, default: \"\" },\n    threshold: { type: Number, default: 0 },\n    tickInterval: { type: Number, default: 60_000 },\n  };\n\n  declare localeValue: string;\n  declare thresholdValue: number;\n  declare tickIntervalValue: number;\n\n  readonly #timers = new SafeTimeout();\n\n  /** Epoch ms parsed from `datetime`; `NaN` when absent or invalid. */\n  #targetMs = Number.NaN;\n  /** The authored absolute text, restored when the threshold fallback kicks in. */\n  #absoluteText = \"\";\n\n  override connect(): void {\n    // Don't adopt already-rendered relative text as the absolute fallback: after a\n    // Turbo morph that preserved the live \"3 minutes ago\" text, a fresh re-connect\n    // would otherwise capture that relative string as `#absoluteText`. Only read the\n    // authored textContent before the element has been rendered to a relative form.\n    if (this.element.getAttribute(\"data-state\") !== \"relative\") {\n      this.#absoluteText = (this.element.textContent ?? \"\").trim();\n    }\n    this.#targetMs = Date.parse(this.element.getAttribute(\"datetime\") ?? \"\");\n    if (Number.isNaN(this.#targetMs)) return;\n    this.#schedule();\n  }\n\n  override disconnect(): void {\n    this.#timers.clearAll();\n  }\n\n  /** Renders the current representation and reschedules unless it is now absolute. */\n  #schedule(): void {\n    const nextDelay = this.#applyAndComputeDelay();\n    if (nextDelay !== null) {\n      this.#timers.set(() => this.#schedule(), nextDelay);\n    }\n  }\n\n  /**\n   * Updates the visible text and returns the next poll delay (ms), or `null`\n   * once the absolute fallback is shown (which never changes, so stop polling).\n   */\n  #applyAndComputeDelay(): number | null {\n    const deltaMs = this.#targetMs - Date.now();\n    const absSeconds = Math.abs(deltaMs) / 1000;\n\n    // Only switch to the absolute fallback when we actually hold authored absolute\n    // text; otherwise (e.g. it could not be recovered after a morph) keep rendering\n    // the relative form rather than blanking the element.\n    if (this.thresholdValue > 0 && absSeconds >= this.thresholdValue && this.#absoluteText) {\n      this.element.textContent = this.#absoluteText;\n      this.element.setAttribute(\"data-state\", \"absolute\");\n      return null;\n    }\n\n    const scale = UNITS.find((u) => absSeconds < u.limit) ?? YEAR_SCALE;\n    const value = Math.round(deltaMs / scale.ms);\n    this.element.textContent = this.#formatter.format(value, scale.unit);\n    this.element.setAttribute(\"data-state\", \"relative\");\n\n    // Poll no finer than the configured minimum; widen for coarser units so an\n    // hours-old stamp is not re-rendered every minute.\n    const unitFloor = scale.unit === \"second\" || scale.unit === \"minute\" ? 60_000 : scale.ms;\n    return Math.max(this.tickIntervalValue, Math.min(unitFloor, 86_400_000));\n  }\n\n  /** A `RelativeTimeFormat` for the resolved locale (`numeric: \"auto\"`). */\n  get #formatter(): Intl.RelativeTimeFormat {\n    return new Intl.RelativeTimeFormat(this.#locale, { numeric: \"auto\" });\n  }\n\n  /** Locale precedence: the value, then the element's `lang`, then the document's. */\n  get #locale(): string | undefined {\n    return this.localeValue || this.element.lang || document.documentElement.lang || undefined;\n  }\n}\n"]}

package/dist/controllers/reset_before_cache_controller.d.ts

@@ -0,0 +1,54 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless **before-cache reset** — the most Hotwire-specific gap part (no APG
+ * pattern). On `turbo:before-cache` it returns transient UI (open menus/modals,
+ * typed-in values, spinning indicators) to its initial state, so a page restored by
+ * the Back button is not frozen mid-interaction. Place one on `<body>`.
+ *
+ * Markup contract (identifier: `stimeo--reset-before-cache`):
+ *   <body data-controller="stimeo--reset-before-cache">
+ *     <details data-reset-attr="open">…</details>     <!-- remove these attributes -->
+ *     <div data-reset-class="is-open is-loading">…</div> <!-- remove these classes -->
+ *     <form data-reset-form>…</form>                   <!-- form.reset() -->
+ *     <input data-reset-value>                          <!-- clear the value -->
+ *     <div data-reset-hidden>transient overlay</div>    <!-- re-hide -->
+ *     <div data-reset-remove>flash toast</div>          <!-- drop from the DOM -->
+ *   </body>
+ *
+ * @remarks
+ * Behavior only and **idempotent** — every run converges on the same initial state,
+ * holding no module-scope state. It does the cross-cutting DOM cleanup directly
+ * (attribute removal, class removal, value clearing, re-hiding, node removal) and, when
+ * `dispatchReset` is on, fires `stimeo--reset-before-cache:request` so individual
+ * Stimeo controllers can run their own close logic. The `turbo:before-cache`
+ * listener is paired to `connect()` / `disconnect()` so it never double-registers or
+ * leaks. {@link reset} is also a public action for manual triggering.
+ */
+declare class ResetBeforeCacheController extends Controller<HTMLElement> {
+    #private;
+    static values: {
+        scope: {
+            type: StringConstructor;
+            default: string;
+        };
+        dispatchReset: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+    };
+    static actions: readonly ["reset"];
+    static events: readonly ["reset", "request"];
+    scopeValue: string;
+    dispatchResetValue: boolean;
+    connect(): void;
+    disconnect(): void;
+    /**
+     * Resets transient UI within scope to its initial state. Asks controllers to
+     * close (via `request`) first, then applies the declarative `data-reset-*` cleanup,
+     * and finally emits `reset`. Safe to call any number of times (idempotent).
+     */
+    reset(): void;
+}
+
+export { ResetBeforeCacheController };

package/dist/controllers/reset_before_cache_controller.js

@@ -0,0 +1,62 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/reset_before_cache_controller.ts
+var ResetBeforeCacheController = class extends Controller {
+  static values = {
+    scope: { type: String, default: "" },
+    dispatchReset: { type: Boolean, default: true }
+  };
+  static actions = ["reset"];
+  static events = ["reset", "request"];
+  /** Runs the reset just before Turbo caches the snapshot. */
+  #onBeforeCache = () => this.reset();
+  connect() {
+    document.addEventListener("turbo:before-cache", this.#onBeforeCache);
+  }
+  disconnect() {
+    document.removeEventListener("turbo:before-cache", this.#onBeforeCache);
+  }
+  /**
+   * Resets transient UI within scope to its initial state. Asks controllers to
+   * close (via `request`) first, then applies the declarative `data-reset-*` cleanup,
+   * and finally emits `reset`. Safe to call any number of times (idempotent).
+   */
+  reset() {
+    const root = this.#scopeRoot();
+    if (this.dispatchResetValue) this.dispatch("request");
+    for (const element of root.querySelectorAll("[data-reset-attr]")) {
+      for (const name of (element.getAttribute("data-reset-attr") ?? "").split(/\s+/)) {
+        if (name) element.removeAttribute(name);
+      }
+    }
+    for (const element of root.querySelectorAll("[data-reset-class]")) {
+      for (const token of (element.getAttribute("data-reset-class") ?? "").split(/\s+/)) {
+        if (token) element.classList.remove(token);
+      }
+    }
+    for (const element of root.querySelectorAll("[data-reset-form]")) {
+      if (element instanceof HTMLFormElement) element.reset();
+    }
+    for (const element of root.querySelectorAll("[data-reset-value]")) {
+      if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement) {
+        element.value = "";
+      }
+    }
+    for (const element of root.querySelectorAll("[data-reset-hidden]")) {
+      element.hidden = true;
+    }
+    for (const element of root.querySelectorAll("[data-reset-remove]")) {
+      element.remove();
+    }
+    this.dispatch("reset");
+  }
+  /** The scan root: a `scope` descendant when set, else the controller element. */
+  #scopeRoot() {
+    if (!this.scopeValue) return this.element;
+    return this.element.querySelector(this.scopeValue) ?? this.element;
+  }
+};
+
+export { ResetBeforeCacheController };
+//# sourceMappingURL=reset_before_cache_controller.js.map
+//# sourceMappingURL=reset_before_cache_controller.js.map

package/dist/controllers/reset_before_cache_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/reset_before_cache_controller.ts"],"names":[],"mappings":";;;AA2BO,IAAM,0BAAA,GAAN,cAAyC,UAAA,CAAwB;AAAA,EACtE,OAAgB,MAAA,GAAS;AAAA,IACvB,KAAA,EAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,EAAA,EAAG;AAAA,IACnC,aAAA,EAAe,EAAE,IAAA,EAAM,OAAA,EAAS,SAAS,IAAA;AAAK,GAChD;AAAA,EACA,OAAO,OAAA,GAAU,CAAC,OAAO,CAAA;AAAA,EACzB,OAAO,MAAA,GAAS,CAAC,OAAA,EAAS,SAAS,CAAA;AAAA;AAAA,EAM1B,cAAA,GAAiB,MAAY,IAAA,CAAK,KAAA,EAAM;AAAA,EAExC,OAAA,GAAgB;AACvB,IAAA,QAAA,CAAS,gBAAA,CAAiB,oBAAA,EAAsB,IAAA,CAAK,cAAc,CAAA;AAAA,EACrE;AAAA,EAES,UAAA,GAAmB;AAC1B,IAAA,QAAA,CAAS,mBAAA,CAAoB,oBAAA,EAAsB,IAAA,CAAK,cAAc,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAA,GAAc;AACZ,IAAA,MAAM,IAAA,GAAO,KAAK,UAAA,EAAW;AAE7B,IAAA,IAAI,IAAA,CAAK,kBAAA,EAAoB,IAAA,CAAK,QAAA,CAAS,SAAS,CAAA;AAEpD,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,gBAAA,CAAiB,mBAAmB,CAAA,EAAG;AAChE,MAAA,KAAA,MAAW,IAAA,IAAA,CAAS,QAAQ,YAAA,CAAa,iBAAiB,KAAK,EAAA,EAAI,KAAA,CAAM,KAAK,CAAA,EAAG;AAC/E,QAAA,IAAI,IAAA,EAAM,OAAA,CAAQ,eAAA,CAAgB,IAAI,CAAA;AAAA,MACxC;AAAA,IACF;AACA,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,gBAAA,CAAiB,oBAAoB,CAAA,EAAG;AACjE,MAAA,KAAA,MAAW,KAAA,IAAA,CAAU,QAAQ,YAAA,CAAa,kBAAkB,KAAK,EAAA,EAAI,KAAA,CAAM,KAAK,CAAA,EAAG;AACjF,QAAA,IAAI,KAAA,EAAO,OAAA,CAAQ,SAAA,CAAU,MAAA,CAAO,KAAK,CAAA;AAAA,MAC3C;AAAA,IACF;AACA,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,gBAAA,CAAiB,mBAAmB,CAAA,EAAG;AAChE,MAAA,IAAI,OAAA,YAAmB,eAAA,EAAiB,OAAA,CAAQ,KAAA,EAAM;AAAA,IACxD;AACA,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,gBAAA,CAAiB,oBAAoB,CAAA,EAAG;AACjE,MAAA,IACE,OAAA,YAAmB,gBAAA,IACnB,OAAA,YAAmB,mBAAA,IACnB,mBAAmB,iBAAA,EACnB;AACA,QAAA,OAAA,CAAQ,KAAA,GAAQ,EAAA;AAAA,MAClB;AAAA,IACF;AACA,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,gBAAA,CAA8B,qBAAqB,CAAA,EAAG;AAC/E,MAAA,OAAA,CAAQ,MAAA,GAAS,IAAA;AAAA,IACnB;AAEA,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,gBAAA,CAAiB,qBAAqB,CAAA,EAAG;AAClE,MAAA,OAAA,CAAQ,MAAA,EAAO;AAAA,IACjB;AAEA,IAAA,IAAA,CAAK,SAAS,OAAO,CAAA;AAAA,EACvB;AAAA;AAAA,EAGA,UAAA,GAAsB;AACpB,IAAA,IAAI,CAAC,IAAA,CAAK,UAAA,EAAY,OAAO,IAAA,CAAK,OAAA;AAClC,IAAA,OAAO,KAAK,OAAA,CAAQ,aAAA,CAAc,IAAA,CAAK,UAAU,KAAK,IAAA,CAAK,OAAA;AAAA,EAC7D;AACF","file":"reset_before_cache_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless **before-cache reset** — the most Hotwire-specific gap part (no APG\n * pattern). On `turbo:before-cache` it returns transient UI (open menus/modals,\n * typed-in values, spinning indicators) to its initial state, so a page restored by\n * the Back button is not frozen mid-interaction. Place one on `<body>`.\n *\n * Markup contract (identifier: `stimeo--reset-before-cache`):\n *   <body data-controller=\"stimeo--reset-before-cache\">\n *     <details data-reset-attr=\"open\">…</details>     <!-- remove these attributes -->\n *     <div data-reset-class=\"is-open is-loading\">…</div> <!-- remove these classes -->\n *     <form data-reset-form>…</form>                   <!-- form.reset() -->\n *     <input data-reset-value>                          <!-- clear the value -->\n *     <div data-reset-hidden>transient overlay</div>    <!-- re-hide -->\n *     <div data-reset-remove>flash toast</div>          <!-- drop from the DOM -->\n *   </body>\n *\n * @remarks\n * Behavior only and **idempotent** — every run converges on the same initial state,\n * holding no module-scope state. It does the cross-cutting DOM cleanup directly\n * (attribute removal, class removal, value clearing, re-hiding, node removal) and, when\n * `dispatchReset` is on, fires `stimeo--reset-before-cache:request` so individual\n * Stimeo controllers can run their own close logic. The `turbo:before-cache`\n * listener is paired to `connect()` / `disconnect()` so it never double-registers or\n * leaks. {@link reset} is also a public action for manual triggering.\n */\nexport class ResetBeforeCacheController extends Controller<HTMLElement> {\n  static override values = {\n    scope: { type: String, default: \"\" },\n    dispatchReset: { type: Boolean, default: true },\n  };\n  static actions = [\"reset\"] as const;\n  static events = [\"reset\", \"request\"] as const;\n\n  declare scopeValue: string;\n  declare dispatchResetValue: boolean;\n\n  /** Runs the reset just before Turbo caches the snapshot. */\n  readonly #onBeforeCache = (): void => this.reset();\n\n  override connect(): void {\n    document.addEventListener(\"turbo:before-cache\", this.#onBeforeCache);\n  }\n\n  override disconnect(): void {\n    document.removeEventListener(\"turbo:before-cache\", this.#onBeforeCache);\n  }\n\n  /**\n   * Resets transient UI within scope to its initial state. Asks controllers to\n   * close (via `request`) first, then applies the declarative `data-reset-*` cleanup,\n   * and finally emits `reset`. Safe to call any number of times (idempotent).\n   */\n  reset(): void {\n    const root = this.#scopeRoot();\n\n    if (this.dispatchResetValue) this.dispatch(\"request\");\n\n    for (const element of root.querySelectorAll(\"[data-reset-attr]\")) {\n      for (const name of (element.getAttribute(\"data-reset-attr\") ?? \"\").split(/\\s+/)) {\n        if (name) element.removeAttribute(name);\n      }\n    }\n    for (const element of root.querySelectorAll(\"[data-reset-class]\")) {\n      for (const token of (element.getAttribute(\"data-reset-class\") ?? \"\").split(/\\s+/)) {\n        if (token) element.classList.remove(token);\n      }\n    }\n    for (const element of root.querySelectorAll(\"[data-reset-form]\")) {\n      if (element instanceof HTMLFormElement) element.reset();\n    }\n    for (const element of root.querySelectorAll(\"[data-reset-value]\")) {\n      if (\n        element instanceof HTMLInputElement ||\n        element instanceof HTMLTextAreaElement ||\n        element instanceof HTMLSelectElement\n      ) {\n        element.value = \"\";\n      }\n    }\n    for (const element of root.querySelectorAll<HTMLElement>(\"[data-reset-hidden]\")) {\n      element.hidden = true;\n    }\n    // Removal runs last so it cannot drop a node another rule still needed to visit.\n    for (const element of root.querySelectorAll(\"[data-reset-remove]\")) {\n      element.remove();\n    }\n\n    this.dispatch(\"reset\");\n  }\n\n  /** The scan root: a `scope` descendant when set, else the controller element. */\n  #scopeRoot(): Element {\n    if (!this.scopeValue) return this.element;\n    return this.element.querySelector(this.scopeValue) ?? this.element;\n  }\n}\n"]}

package/dist/controllers/resizable_controller.d.ts

@@ -0,0 +1,81 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, highly accessible Window Splitter / Resizable panes logic.
+ *
+ * Markup contract (identifier: `stimeo--resizable`):
+ *   <div data-controller="stimeo--resizable"
+ *        data-stimeo--resizable-min-value="20"
+ *        data-stimeo--resizable-max-value="80"
+ *        data-stimeo--resizable-value-value="50">
+ *     <div data-stimeo--resizable-target="primary" id="pane-1">Pane A</div>
+ *     <div role="separator" tabindex="0" aria-orientation="vertical"
+ *          aria-controls="pane-1" aria-valuemin="20" aria-valuemax="80"
+ *          aria-valuenow="50" aria-label="Resize splitter"
+ *          data-stimeo--resizable-target="separator"
+ *          data-action="pointerdown->stimeo--resizable#onPointerDown
+ *                       keydown->stimeo--resizable#onKeydown"></div>
+ *     <div data-stimeo--resizable-target="secondary">Pane B</div>
+ *   </div>
+ *
+ * Implements the WAI-ARIA APG **Window Splitter** pattern:
+ * - Robust dragging track using W3C `setPointerCapture` to ensure uninterrupted dragging
+ *   even when pointers quickly stray outside the separator area.
+ * - Auto-clamped flex-percentage updates with bounds safety.
+ * - Smooth step keyboard adjustments for Arrow keys based on vertical/horizontal orientation.
+ * - Root-level CSS custom property `--stimeo--resizable-fraction` (0..1) to drive presentation styles.
+ *
+ * @remarks
+ * Behavior only. The controller adjusts the CSS custom property on the root element,
+ * updates ARIA values on the separator, and emits `stimeo--resizable:change` events.
+ */
+declare class ResizableController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        min: {
+            type: NumberConstructor;
+            default: number;
+        };
+        max: {
+            type: NumberConstructor;
+            default: number;
+        };
+        step: {
+            type: NumberConstructor;
+            default: number;
+        };
+        value: {
+            type: NumberConstructor;
+            default: number;
+        };
+    };
+    static actions: readonly ["onKeydown", "onPointerDown", "toggle"];
+    static events: readonly ["change"];
+    readonly primaryTarget: HTMLElement;
+    readonly secondaryTarget: HTMLElement;
+    readonly separatorTarget: HTMLElement;
+    readonly hasPrimaryTarget: boolean;
+    readonly hasSecondaryTarget: boolean;
+    readonly hasSeparatorTarget: boolean;
+    minValue: number;
+    maxValue: number;
+    stepValue: number;
+    valueValue: number;
+    connect(): void;
+    /** Cancels any active pointer drag so listeners never leak past disconnect. */
+    disconnect(): void;
+    /**
+     * Stimulus lifecycle callback when the valueValue changes.
+     * Keeps CSS fractions and ARIA status completely aligned.
+     */
+    valueValueChanged(): void;
+    /** Starts active pointer drag tracking and locks capture. */
+    onPointerDown(event: PointerEvent): void;
+    /** Keydown adjustments for ArrowUp/Down/Left/Right and Home/End. */
+    onKeydown(event: KeyboardEvent): void;
+    /** Double-click or Enter to collapse/restore pane to min/max levels. */
+    toggle(): void;
+}
+
+export { ResizableController };

package/dist/controllers/resizable_controller.js

@@ -0,0 +1,163 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/resizable_controller.ts
+var ResizableController = class extends Controller {
+  static targets = ["primary", "secondary", "separator"];
+  static values = {
+    min: { type: Number, default: 0 },
+    max: { type: Number, default: 100 },
+    step: { type: Number, default: 1 },
+    value: { type: Number, default: 50 }
+  };
+  static actions = ["onKeydown", "onPointerDown", "toggle"];
+  static events = ["change"];
+  /** Track previously held value before collapse toggles. */
+  #valueBeforeCollapse = 50;
+  /** Aborts in-progress pointer-drag listeners when the drag ends or on teardown. */
+  #dragAbort = null;
+  connect() {
+    this.#clampAndSync();
+  }
+  /** Cancels any active pointer drag so listeners never leak past disconnect. */
+  disconnect() {
+    this.#dragAbort?.abort();
+    this.#dragAbort = null;
+  }
+  /**
+   * Stimulus lifecycle callback when the valueValue changes.
+   * Keeps CSS fractions and ARIA status completely aligned.
+   */
+  valueValueChanged() {
+    this.#clampAndSync();
+  }
+  /** Starts active pointer drag tracking and locks capture. */
+  onPointerDown(event) {
+    if (!this.hasSeparatorTarget || event.button !== 0) return;
+    event.preventDefault();
+    const separator = this.separatorTarget;
+    separator.setPointerCapture(event.pointerId);
+    separator.focus();
+    this.element.setAttribute("data-dragging", "true");
+    this.#dragAbort?.abort();
+    const abort = new AbortController();
+    this.#dragAbort = abort;
+    separator.addEventListener("pointermove", this.#onPointerMove, { signal: abort.signal });
+    separator.addEventListener("pointerup", this.#onPointerUp, { signal: abort.signal });
+    separator.addEventListener("pointercancel", this.#onPointerUp, { signal: abort.signal });
+  }
+  /** Keydown adjustments for ArrowUp/Down/Left/Right and Home/End. */
+  onKeydown(event) {
+    if (!this.hasSeparatorTarget) return;
+    const orientation = this.separatorTarget.getAttribute("aria-orientation") || "vertical";
+    const isVertical = orientation === "vertical";
+    let handled = true;
+    let nextValue = this.valueValue;
+    switch (event.key) {
+      case "ArrowLeft":
+        if (isVertical) {
+          nextValue -= this.stepValue;
+        } else {
+          handled = false;
+        }
+        break;
+      case "ArrowRight":
+        if (isVertical) {
+          nextValue += this.stepValue;
+        } else {
+          handled = false;
+        }
+        break;
+      case "ArrowUp":
+        if (!isVertical) {
+          nextValue -= this.stepValue;
+        } else {
+          handled = false;
+        }
+        break;
+      case "ArrowDown":
+        if (!isVertical) {
+          nextValue += this.stepValue;
+        } else {
+          handled = false;
+        }
+        break;
+      case "Home":
+        nextValue = this.minValue;
+        break;
+      case "End":
+        nextValue = this.maxValue;
+        break;
+      case "Enter":
+        event.preventDefault();
+        this.toggle();
+        return;
+      default:
+        handled = false;
+        break;
+    }
+    if (handled) {
+      event.preventDefault();
+      this.valueValue = Math.max(this.minValue, Math.min(nextValue, this.maxValue));
+      this.#clampAndSync();
+      this.#dispatchChange();
+    }
+  }
+  /** Double-click or Enter to collapse/restore pane to min/max levels. */
+  toggle() {
+    const threshold = this.minValue + (this.maxValue - this.minValue) / 2;
+    if (this.valueValue > this.minValue) {
+      this.#valueBeforeCollapse = this.valueValue;
+      this.valueValue = this.minValue;
+    } else {
+      this.valueValue = this.#valueBeforeCollapse >= threshold ? this.#valueBeforeCollapse : this.maxValue;
+    }
+    this.#clampAndSync();
+    this.#dispatchChange();
+  }
+  #onPointerMove = (event) => {
+    if (!this.hasSeparatorTarget) return;
+    const rect = this.element.getBoundingClientRect();
+    const orientation = this.separatorTarget.getAttribute("aria-orientation") || "vertical";
+    const isVertical = orientation === "vertical";
+    let fraction = 0.5;
+    if (isVertical) {
+      fraction = (event.clientX - rect.left) / rect.width;
+    } else {
+      fraction = (event.clientY - rect.top) / rect.height;
+    }
+    fraction = Math.max(0, Math.min(fraction, 1));
+    const percent = Math.round(fraction * 100);
+    this.valueValue = Math.max(this.minValue, Math.min(percent, this.maxValue));
+    this.#clampAndSync();
+  };
+  #onPointerUp = (event) => {
+    if (!this.hasSeparatorTarget) return;
+    const separator = this.separatorTarget;
+    separator.releasePointerCapture(event.pointerId);
+    this.element.removeAttribute("data-dragging");
+    this.#dragAbort?.abort();
+    this.#dragAbort = null;
+    this.#dispatchChange();
+  };
+  #clampAndSync() {
+    const clamped = Math.max(this.minValue, Math.min(this.valueValue, this.maxValue));
+    if (this.valueValue !== clamped) {
+      this.valueValue = clamped;
+    }
+    const fraction = clamped / 100;
+    this.element.style.setProperty("--stimeo--resizable-fraction", String(fraction));
+    if (this.hasSeparatorTarget) {
+      this.separatorTarget.setAttribute("aria-valuenow", String(clamped));
+      this.separatorTarget.setAttribute("aria-valuemin", String(this.minValue));
+      this.separatorTarget.setAttribute("aria-valuemax", String(this.maxValue));
+    }
+  }
+  #dispatchChange() {
+    const fraction = this.valueValue / 100;
+    this.dispatch("change", { detail: { value: this.valueValue, fraction } });
+  }
+};
+
+export { ResizableController };
+//# sourceMappingURL=resizable_controller.js.map
+//# sourceMappingURL=resizable_controller.js.map

package/dist/controllers/resizable_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/resizable_controller.ts"],"names":[],"mappings":"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","file":"resizable_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, highly accessible Window Splitter / Resizable panes logic.\n *\n * Markup contract (identifier: `stimeo--resizable`):\n *   <div data-controller=\"stimeo--resizable\"\n *        data-stimeo--resizable-min-value=\"20\"\n *        data-stimeo--resizable-max-value=\"80\"\n *        data-stimeo--resizable-value-value=\"50\">\n *     <div data-stimeo--resizable-target=\"primary\" id=\"pane-1\">Pane A</div>\n *     <div role=\"separator\" tabindex=\"0\" aria-orientation=\"vertical\"\n *          aria-controls=\"pane-1\" aria-valuemin=\"20\" aria-valuemax=\"80\"\n *          aria-valuenow=\"50\" aria-label=\"Resize splitter\"\n *          data-stimeo--resizable-target=\"separator\"\n *          data-action=\"pointerdown->stimeo--resizable#onPointerDown\n *                       keydown->stimeo--resizable#onKeydown\"></div>\n *     <div data-stimeo--resizable-target=\"secondary\">Pane B</div>\n *   </div>\n *\n * Implements the WAI-ARIA APG **Window Splitter** pattern:\n * - Robust dragging track using W3C `setPointerCapture` to ensure uninterrupted dragging\n *   even when pointers quickly stray outside the separator area.\n * - Auto-clamped flex-percentage updates with bounds safety.\n * - Smooth step keyboard adjustments for Arrow keys based on vertical/horizontal orientation.\n * - Root-level CSS custom property `--stimeo--resizable-fraction` (0..1) to drive presentation styles.\n *\n * @remarks\n * Behavior only. The controller adjusts the CSS custom property on the root element,\n * updates ARIA values on the separator, and emits `stimeo--resizable:change` events.\n */\nexport class ResizableController extends Controller<HTMLElement> {\n  static override targets = [\"primary\", \"secondary\", \"separator\"];\n  static override values = {\n    min: { type: Number, default: 0 },\n    max: { type: Number, default: 100 },\n    step: { type: Number, default: 1 },\n    value: { type: Number, default: 50 },\n  };\n  static actions = [\"onKeydown\", \"onPointerDown\", \"toggle\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly primaryTarget: HTMLElement;\n  declare readonly secondaryTarget: HTMLElement;\n  declare readonly separatorTarget: HTMLElement;\n  declare readonly hasPrimaryTarget: boolean;\n  declare readonly hasSecondaryTarget: boolean;\n  declare readonly hasSeparatorTarget: boolean;\n\n  declare minValue: number;\n  declare maxValue: number;\n  declare stepValue: number;\n  declare valueValue: number;\n\n  /** Track previously held value before collapse toggles. */\n  #valueBeforeCollapse = 50;\n\n  /** Aborts in-progress pointer-drag listeners when the drag ends or on teardown. */\n  #dragAbort: AbortController | null = null;\n\n  override connect(): void {\n    this.#clampAndSync();\n  }\n\n  /** Cancels any active pointer drag so listeners never leak past disconnect. */\n  override disconnect(): void {\n    this.#dragAbort?.abort();\n    this.#dragAbort = null;\n  }\n\n  /**\n   * Stimulus lifecycle callback when the valueValue changes.\n   * Keeps CSS fractions and ARIA status completely aligned.\n   */\n  valueValueChanged(): void {\n    this.#clampAndSync();\n  }\n\n  /** Starts active pointer drag tracking and locks capture. */\n  onPointerDown(event: PointerEvent): void {\n    if (!this.hasSeparatorTarget || event.button !== 0) return;\n\n    event.preventDefault();\n\n    const separator = this.separatorTarget;\n    separator.setPointerCapture(event.pointerId);\n    // preventDefault() above suppresses the implicit focus, so move focus\n    // explicitly — otherwise keyboard (arrow) adjustments never reach the\n    // separator after a pointer interaction (WCAG 2.1.1).\n    separator.focus();\n\n    this.element.setAttribute(\"data-dragging\", \"true\");\n\n    this.#dragAbort?.abort();\n    const abort = new AbortController();\n    this.#dragAbort = abort;\n    separator.addEventListener(\"pointermove\", this.#onPointerMove, { signal: abort.signal });\n    separator.addEventListener(\"pointerup\", this.#onPointerUp, { signal: abort.signal });\n    separator.addEventListener(\"pointercancel\", this.#onPointerUp, { signal: abort.signal });\n  }\n\n  /** Keydown adjustments for ArrowUp/Down/Left/Right and Home/End. */\n  onKeydown(event: KeyboardEvent): void {\n    if (!this.hasSeparatorTarget) return;\n\n    const orientation = this.separatorTarget.getAttribute(\"aria-orientation\") || \"vertical\";\n    const isVertical = orientation === \"vertical\";\n\n    let handled = true;\n    let nextValue = this.valueValue;\n\n    switch (event.key) {\n      case \"ArrowLeft\":\n        if (isVertical) {\n          nextValue -= this.stepValue;\n        } else {\n          handled = false;\n        }\n        break;\n      case \"ArrowRight\":\n        if (isVertical) {\n          nextValue += this.stepValue;\n        } else {\n          handled = false;\n        }\n        break;\n      case \"ArrowUp\":\n        if (!isVertical) {\n          nextValue -= this.stepValue;\n        } else {\n          handled = false;\n        }\n        break;\n      case \"ArrowDown\":\n        if (!isVertical) {\n          nextValue += this.stepValue;\n        } else {\n          handled = false;\n        }\n        break;\n      case \"Home\":\n        nextValue = this.minValue;\n        break;\n      case \"End\":\n        nextValue = this.maxValue;\n        break;\n      case \"Enter\":\n        event.preventDefault();\n        this.toggle();\n        return;\n      default:\n        handled = false;\n        break;\n    }\n\n    if (handled) {\n      event.preventDefault();\n      this.valueValue = Math.max(this.minValue, Math.min(nextValue, this.maxValue));\n      this.#clampAndSync();\n      this.#dispatchChange();\n    }\n  }\n\n  /** Double-click or Enter to collapse/restore pane to min/max levels. */\n  toggle(): void {\n    const threshold = this.minValue + (this.maxValue - this.minValue) / 2;\n    if (this.valueValue > this.minValue) {\n      this.#valueBeforeCollapse = this.valueValue;\n      this.valueValue = this.minValue;\n    } else {\n      this.valueValue =\n        this.#valueBeforeCollapse >= threshold ? this.#valueBeforeCollapse : this.maxValue;\n    }\n    this.#clampAndSync();\n    this.#dispatchChange();\n  }\n\n  readonly #onPointerMove = (event: PointerEvent): void => {\n    if (!this.hasSeparatorTarget) return;\n\n    const rect = this.element.getBoundingClientRect();\n    const orientation = this.separatorTarget.getAttribute(\"aria-orientation\") || \"vertical\";\n    const isVertical = orientation === \"vertical\";\n\n    let fraction = 0.5;\n\n    if (isVertical) {\n      fraction = (event.clientX - rect.left) / rect.width;\n    } else {\n      fraction = (event.clientY - rect.top) / rect.height;\n    }\n\n    // Restrict within absolute boundaries\n    fraction = Math.max(0, Math.min(fraction, 1));\n    const percent = Math.round(fraction * 100);\n\n    this.valueValue = Math.max(this.minValue, Math.min(percent, this.maxValue));\n    this.#clampAndSync();\n  };\n\n  readonly #onPointerUp = (event: PointerEvent): void => {\n    if (!this.hasSeparatorTarget) return;\n\n    const separator = this.separatorTarget;\n    separator.releasePointerCapture(event.pointerId);\n\n    this.element.removeAttribute(\"data-dragging\");\n\n    this.#dragAbort?.abort();\n    this.#dragAbort = null;\n\n    this.#dispatchChange();\n  };\n\n  #clampAndSync(): void {\n    const clamped = Math.max(this.minValue, Math.min(this.valueValue, this.maxValue));\n\n    // Keep the stored value in range so valueValue, ARIA, CSS, and dispatched\n    // events never diverge (e.g. an initial value above max). Writing back\n    // re-enters valueValueChanged once, but the value is already clamped there\n    // so it does not recurse.\n    if (this.valueValue !== clamped) {\n      this.valueValue = clamped;\n    }\n\n    // Expose local fraction to consumer CSS custom property\n    const fraction = clamped / 100;\n    this.element.style.setProperty(\"--stimeo--resizable-fraction\", String(fraction));\n\n    if (this.hasSeparatorTarget) {\n      this.separatorTarget.setAttribute(\"aria-valuenow\", String(clamped));\n      this.separatorTarget.setAttribute(\"aria-valuemin\", String(this.minValue));\n      this.separatorTarget.setAttribute(\"aria-valuemax\", String(this.maxValue));\n    }\n  }\n\n  #dispatchChange(): void {\n    const fraction = this.valueValue / 100;\n    this.dispatch(\"change\", { detail: { value: this.valueValue, fraction } });\n  }\n}\n"]}

package/dist/controllers/roving_controller.d.ts

@@ -0,0 +1,63 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless **roving tabindex**: makes a set of `item`s a single Tab stop and
+ * moves focus between them with the arrow keys — the APG roving-tabindex
+ * technique, surfaced as a standalone controller. It is the policy layer over the
+ * shared {@link RovingTabindex} util (counterpart to Focus Scope over `FocusTrap`),
+ * giving the orientation / wrap / Home-End the util deliberately leaves out. No
+ * dedicated APG pattern; it is the keyboard primitive Toolbar / Menu / Radio Group
+ * and friends build on. Core (zero dependencies).
+ *
+ * Markup contract (identifier: `stimeo--roving`):
+ *   <div data-controller="stimeo--roving"
+ *        data-stimeo--roving-orientation-value="horizontal">
+ *     <button data-stimeo--roving-target="item">A</button>
+ *     <button data-stimeo--roving-target="item">B</button>
+ *     <button data-stimeo--roving-target="item">C</button>
+ *   </div>
+ *
+ * Exactly one item is tabbable (`tabindex="0"`); the arrow keys (per
+ * `orientation`) move focus and that tab stop together, `Home`/`End` jump to the
+ * ends (`homeEnd`), and `wrap` cycles past the ends or clamps at them. Listeners
+ * are **delegated on the container** — `keydown` for movement and `focusin` to
+ * sync the tab stop when focus arrives by click or programmatically — so
+ * dynamically added/removed items need no per-item `data-action`. It emits
+ * `change` whenever the tabbable item changes.
+ *
+ * @remarks
+ * Behavior only: it owns `tabindex` and focus movement, nothing else. It does
+ * **not** assign roles (`role="toolbar"`/`"radiogroup"` is the author's), manage
+ * selection / selection-follows-focus, typeahead, or activation (`Enter`/`Space`)
+ * — those stay with the consuming pattern. `connect()` is idempotent: it keeps an
+ * existing tab stop (reads it back from the DOM) and only defaults to the first
+ * item when none is set, so a Turbo cache restore / morph never resets the user's
+ * position. The delegated listeners are torn down on `disconnect()`.
+ */
+declare class RovingController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        orientation: {
+            type: StringConstructor;
+            default: string;
+        };
+        wrap: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        homeEnd: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+    };
+    static events: readonly ["change"];
+    readonly itemTargets: HTMLElement[];
+    orientationValue: string;
+    wrapValue: boolean;
+    homeEndValue: boolean;
+    connect(): void;
+    disconnect(): void;
+}
+
+export { RovingController };

package/dist/controllers/roving_controller.js

@@ -0,0 +1,116 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/roving_controller.ts
+
+// src/utils/roving_tabindex.ts
+var RovingTabindex = class {
+  /** Returns the current ordered item elements; called on every operation. */
+  #getItems;
+  /**
+   * @param getItems - Returns the current ordered item elements. Called on every
+   *   operation so the live target list is always used.
+   */
+  constructor(getItems) {
+    this.#getItems = getItems;
+  }
+  /** Index of the currently tabbable item (`tabindex="0"`), or `-1` if none. */
+  get activeIndex() {
+    return this.#getItems().findIndex((item) => item.tabIndex === 0);
+  }
+  /**
+   * Makes exactly the item at `index` tabbable (`tabindex="0"`) and removes every
+   * other item from the Tab sequence (`tabindex="-1"`). An out-of-range `index`
+   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express
+   * "nothing is currently tabbable".
+   *
+   * @param index - Position of the item to make tabbable.
+   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.
+   */
+  setActive(index, { focus = false } = {}) {
+    const items = this.#getItems();
+    items.forEach((item, i) => {
+      item.tabIndex = i === index ? 0 : -1;
+    });
+    if (focus) items[index]?.focus();
+  }
+};
+function rovingMove(current, length, delta, wrap) {
+  if (length === 0) return -1;
+  const next = current + delta;
+  if (wrap === "wrap") return (next + length) % length;
+  return Math.min(length - 1, Math.max(0, next));
+}
+
+// src/controllers/roving_controller.ts
+var RovingController = class extends Controller {
+  static targets = ["item"];
+  static values = {
+    orientation: { type: String, default: "horizontal" },
+    wrap: { type: Boolean, default: true },
+    homeEnd: { type: Boolean, default: true }
+  };
+  static events = ["change"];
+  #roving = new RovingTabindex(() => this.itemTargets);
+  connect() {
+    const active = this.#roving.activeIndex;
+    this.#roving.setActive(active === -1 ? 0 : active);
+    this.element.addEventListener("keydown", this.#onKeydown);
+    this.element.addEventListener("focusin", this.#onFocusin);
+  }
+  disconnect() {
+    this.element.removeEventListener("keydown", this.#onKeydown);
+    this.element.removeEventListener("focusin", this.#onFocusin);
+  }
+  /** Arrow keys move focus + the tab stop; Home/End jump to the ends. */
+  #onKeydown = (event) => {
+    const items = this.itemTargets;
+    const current = this.#indexOf(event.target);
+    if (current === -1) return;
+    const length = items.length;
+    const wrap = this.wrapValue ? "wrap" : "clamp";
+    const orientation = this.orientationValue;
+    const horizontal = orientation === "horizontal" || orientation === "both";
+    const vertical = orientation === "vertical" || orientation === "both";
+    let next;
+    if (horizontal && event.key === "ArrowRight" || vertical && event.key === "ArrowDown") {
+      next = rovingMove(current, length, 1, wrap);
+    } else if (horizontal && event.key === "ArrowLeft" || vertical && event.key === "ArrowUp") {
+      next = rovingMove(current, length, -1, wrap);
+    } else if (this.homeEndValue && event.key === "Home") {
+      next = 0;
+    } else if (this.homeEndValue && event.key === "End") {
+      next = length - 1;
+    } else {
+      return;
+    }
+    event.preventDefault();
+    this.#activate(next, true);
+  };
+  /**
+   * Syncs the single tab stop to an item that received focus by other means
+   * (click, programmatic `focus()`), so returning via Tab lands on it. The
+   * keyboard path's own `focus()` re-enters here but is a no-op (index unchanged).
+   */
+  #onFocusin = (event) => {
+    const index = this.#indexOf(event.target);
+    if (index !== -1) this.#activate(index, false);
+  };
+  /** Resolves the item index owning an event target (the item or a descendant). */
+  #indexOf(target) {
+    const node = target;
+    if (!node) return -1;
+    return this.itemTargets.findIndex((item) => item === node || item.contains(node));
+  }
+  /** Makes `index` the tab stop (optionally focusing it), emitting `change` once. */
+  #activate(index, focus) {
+    const previous = this.#roving.activeIndex;
+    this.#roving.setActive(index, { focus });
+    if (index !== previous) {
+      this.dispatch("change", { detail: { index, item: this.itemTargets[index] } });
+    }
+  }
+};
+
+export { RovingController };
+//# sourceMappingURL=roving_controller.js.map
+//# sourceMappingURL=roving_controller.js.map