stimeo-ui 0.2.0 → 0.3.0

package/dist/controllers/transition_controller.d.ts

@@ -17,20 +17,26 @@ import { Controller } from '@hotwired/stimulus';
  *        data-stimeo--transition-leave-to-value="opacity-0" hidden>…</div>
  *
  * `enter()` unhides the element, applies `enter` + `enterFrom`, then on the next frame
- * swaps `enterFrom` → `enterTo` so the CSS transition runs, and on `transitionend` (or
- * a safety timeout) settles to `entered`. `leave()` mirrors it and re-applies `hidden`.
+ * swaps `enterFrom` → `enterTo` so the CSS transition runs, and settles to `entered`
+ * once the transition completes. `leave()` mirrors it and re-applies `hidden`.
  * `toggle()` reverses the current direction. The element carries `data-transition-state`
  * (`entering` / `entered` / `leaving` / `left`) and `entered` / `left` events fire on
  * completion.
  *
  * @remarks
  * Behavior only — the animation itself is the consumer's CSS; this controls *when* the
- * stage classes are applied. Under `prefers-reduced-motion: reduce` it switches
- * instantly (no staging). An interrupting call cancels the in-flight transition and
- * starts the new one. State lives solely in `hidden` / `data-transition-state`, and
- * `connect()` reconciles to a stable state (stripping any half-applied stage classes
- * from a Turbo cache); the `transitionend` listener, rAF, and safety timer are released
- * on `disconnect()` (Turbo navigation included).
+ * stage classes are applied. Completion is owned by the shared
+ * {@link TransitionCompletion}: every declared transition property must settle
+ * (`transitionend` / `transitioncancel`, pseudo-element events excluded) with a
+ * `max(duration + delay) + 50ms` bounded fallback, and a computed 0ms transition
+ * settles synchronously at the staging frame. A positive `timeout` Value replaces the
+ * fallback verbatim and keeps the wait armed even for a computed 0ms transition.
+ * Under `prefers-reduced-motion: reduce` it switches instantly (no staging). An
+ * interrupting call cancels the in-flight transition and starts the new one. State
+ * lives solely in `hidden` / `data-transition-state`, and `connect()` reconciles to a
+ * stable state (stripping any half-applied stage classes from a Turbo cache); the
+ * terminal-event listeners, rAF, and fallback timer are released on `disconnect()`
+ * (Turbo navigation included).
  */
 declare class TransitionController extends Controller<HTMLElement> {
     #private;

package/dist/controllers/transition_controller.js

@@ -2,6 +2,11 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/transition_controller.ts
 
+// src/utils/reduced_motion.ts
+function prefersReducedMotion() {
+  return typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+}
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -55,14 +60,149 @@ var SafeTimeout = class extends TimerRegistry {
   }
 };
 
+// src/utils/transition_completion.ts
+function timeMs(value) {
+  const trimmed = value.trim();
+  const amount = Number.parseFloat(trimmed);
+  if (!Number.isFinite(amount)) return 0;
+  if (trimmed.endsWith("ms")) return amount;
+  if (trimmed.endsWith("s")) return amount * 1e3;
+  return 0;
+}
+function cssList(value) {
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function transitionTimings(style) {
+  const properties = cssList(style.transitionProperty);
+  const durations = cssList(style.transitionDuration).map(timeMs);
+  const delays = cssList(style.transitionDelay).map(timeMs);
+  const effectiveProperties = properties.length > 0 ? properties : Array.from({ length: Math.max(durations.length, delays.length, 1) }, () => "all");
+  const effectiveDurations = durations.length > 0 ? durations : [0];
+  const effectiveDelays = delays.length > 0 ? delays : [0];
+  return effectiveProperties.filter((property) => property !== "none").map((property, index) => ({
+    property,
+    totalMs: Math.max(
+      0,
+      (effectiveDurations[index % effectiveDurations.length] ?? 0) + (effectiveDelays[index % effectiveDelays.length] ?? 0)
+    )
+  }));
+}
+function maxTotalMs(timings) {
+  return timings.reduce((max, { totalMs }) => Math.max(max, totalMs), 0);
+}
+var TransitionCompletion = class {
+  #timers = new SafeTimeout();
+  #element = null;
+  #complete = null;
+  #pendingProperties = null;
+  #deadline = 0;
+  /**
+   * Replaces any prior wait and invokes `complete` synchronously for a 0ms
+   * transition (including when `getComputedStyle` is unavailable).
+   *
+   * With a positive `options.timeoutMs` the synchronous fast-path is skipped and
+   * the override replaces the auto-computed fallback (see {@link TransitionWaitOptions}).
+   */
+  wait(element, complete, options = {}) {
+    this.cancel();
+    const requested = options.timeoutMs ?? 0;
+    const override = Number.isFinite(requested) && requested > 0 ? requested : 0;
+    const timings = typeof window.getComputedStyle === "function" ? transitionTimings(window.getComputedStyle(element)) : [];
+    const maximum = maxTotalMs(timings);
+    if (maximum <= 0 && override <= 0) {
+      complete();
+      return;
+    }
+    this.#element = element;
+    this.#complete = complete;
+    this.#deadline = Date.now() + maximum;
+    const activeProperties = this.#activeTransitionProperties(element);
+    this.#pendingProperties = activeProperties.size > 0 ? activeProperties : this.#explicitPendingProperties(timings);
+    element.addEventListener("transitionend", this.#onTerminal);
+    element.addEventListener("transitioncancel", this.#onTerminal);
+    this.#timers.set(() => this.#finish(), override > 0 ? override : maximum + 50);
+  }
+  /** Cancels the pending wait without invoking its completion callback. */
+  cancel() {
+    this.#complete = null;
+    this.#teardown();
+  }
+  /**
+   * Handles terminal events from the observed element only.
+   *
+   * For explicit property lists, every declared positive-time property must
+   * settle. For `all`, no reliable property set exists, so an event can finish
+   * only after the computed maximum time; the safety timeout owns the usual path.
+   */
+  #onTerminal = (event) => {
+    if (event.target !== this.#element) return;
+    const transitionEvent = event;
+    if (transitionEvent.pseudoElement) return;
+    if (this.#pendingProperties) {
+      const propertyName = transitionEvent.propertyName;
+      const active = this.#activeTransitionProperties(this.#element);
+      if (active.has(propertyName)) return;
+      if (!this.#pendingProperties.delete(propertyName)) return;
+      if (this.#pendingProperties.size > 0) return;
+      if (active.size > 0) {
+        this.#pendingProperties = active;
+        return;
+      }
+      this.#finish();
+      return;
+    }
+    if (Date.now() >= this.#deadline) this.#finish();
+  };
+  /**
+   * Returns active CSS transition properties expanded to the names reported by
+   * terminal events. CSS animations and pseudo-element effects are excluded.
+   */
+  #activeTransitionProperties(element) {
+    if (!element || typeof element.getAnimations !== "function") return /* @__PURE__ */ new Set();
+    try {
+      const properties = element.getAnimations().flatMap((animation) => {
+        if (animation.playState === "idle" || animation.playState === "finished") return [];
+        const effect = animation.effect;
+        if (effect?.pseudoElement) return [];
+        const target = effect?.target;
+        if (target && target !== element) return [];
+        const property = animation.transitionProperty;
+        return typeof property === "string" && property.length > 0 ? [property] : [];
+      });
+      return new Set(properties);
+    } catch {
+      return /* @__PURE__ */ new Set();
+    }
+  }
+  /** Returns explicit positive-time properties, or `null` for the ambiguous `all`. */
+  #explicitPendingProperties(timings) {
+    if (timings.some(({ property }) => property === "all")) return null;
+    const pending = new Set(
+      timings.filter(({ totalMs }) => totalMs > 0).map(({ property }) => property)
+    );
+    return pending.size > 0 ? pending : null;
+  }
+  /** Completes exactly once, releasing listeners and the fallback before the callback. */
+  #finish() {
+    const complete = this.#complete;
+    if (!complete) return;
+    this.#complete = null;
+    this.#teardown();
+    complete();
+  }
+  /** Releases the exact element listeners and timer owned by the current wait. */
+  #teardown() {
+    this.#timers.clearAll();
+    this.#element?.removeEventListener("transitionend", this.#onTerminal);
+    this.#element?.removeEventListener("transitioncancel", this.#onTerminal);
+    this.#element = null;
+    this.#pendingProperties = null;
+    this.#deadline = 0;
+  }
+};
+
 // src/controllers/transition_controller.ts
 var tokensOf = (value) => value.split(/\s+/).filter(Boolean);
-var firstTimeMs = (value) => {
-  const first = value.split(",")[0]?.trim() ?? "";
-  const amount = Number.parseFloat(first);
-  if (Number.isNaN(amount)) return 0;
-  return first.endsWith("ms") ? amount : amount * 1e3;
-};
 var TransitionController = class extends Controller {
   static values = {
     enter: { type: String, default: "" },
@@ -75,9 +215,9 @@ var TransitionController = class extends Controller {
   };
   static actions = ["enter", "leave", "toggle"];
   static events = ["entered", "left"];
-  #timers = new SafeTimeout();
+  /** Owns the cancellable completion wait (terminal events + bounded fallback). */
+  #transition = new TransitionCompletion();
   #rafId = null;
-  #endListener = null;
   connect() {
     this.#strip();
     this.element.setAttribute("data-transition-state", this.element.hidden ? "left" : "entered");
@@ -104,7 +244,7 @@ var TransitionController = class extends Controller {
     const isEnter = kind === "enter";
     if (isEnter) this.element.hidden = false;
     this.element.setAttribute("data-transition-state", isEnter ? "entering" : "leaving");
-    if (this.#prefersReducedMotion()) {
+    if (prefersReducedMotion()) {
       this.#finish(kind);
       return;
     }
@@ -116,12 +256,13 @@ var TransitionController = class extends Controller {
       this.#rafId = null;
       this.#remove(from);
       this.#add(to);
-      this.#awaitEnd(() => this.#finish(kind));
+      this.#transition.wait(this.element, () => this.#finish(kind), {
+        timeoutMs: this.timeoutValue
+      });
     });
   }
   /** Settles the element into the completed state, clearing the stage classes. */
   #finish(kind) {
-    this.#cleanupEnd();
     this.#strip();
     if (kind === "enter") {
       this.element.setAttribute("data-transition-state", "entered");
@@ -132,29 +273,13 @@ var TransitionController = class extends Controller {
       this.dispatch("left", { detail: {} });
     }
   }
-  /** Resolves on the element's own `transitionend`, with a safety timeout fallback. */
-  #awaitEnd(done) {
-    this.#endListener = (event) => {
-      if (event.target === this.element) done();
-    };
-    this.element.addEventListener("transitionend", this.#endListener);
-    const ms = this.timeoutValue > 0 ? this.timeoutValue : this.#duration();
-    this.#timers.set(done, ms);
-  }
-  #cleanupEnd() {
-    if (this.#endListener) {
-      this.element.removeEventListener("transitionend", this.#endListener);
-      this.#endListener = null;
-    }
-    this.#timers.clearAll();
-  }
   /** Cancels any in-flight transition (interruption / teardown). */
   #cancel() {
     if (this.#rafId !== null) {
       this.#cancelRaf(this.#rafId);
       this.#rafId = null;
     }
-    this.#cleanupEnd();
+    this.#transition.cancel();
     this.#strip();
   }
   #add(...lists) {
@@ -176,13 +301,6 @@ var TransitionController = class extends Controller {
       this.leaveToValue
     );
   }
-  /** Auto-computed safety duration (transition time + delay, with a small buffer). */
-  #duration() {
-    if (typeof window.getComputedStyle !== "function") return 0;
-    const style = window.getComputedStyle(this.element);
-    const total = firstTimeMs(style.transitionDuration) + firstTimeMs(style.transitionDelay);
-    return total > 0 ? total + 50 : 0;
-  }
   #raf(callback) {
     if (typeof window.requestAnimationFrame === "function") {
       return window.requestAnimationFrame(() => callback());
@@ -193,9 +311,6 @@ var TransitionController = class extends Controller {
     if (typeof window.cancelAnimationFrame === "function") window.cancelAnimationFrame(id);
     else window.clearTimeout(id);
   }
-  #prefersReducedMotion() {
-    return typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
-  }
 };
 
 export { TransitionController };

package/dist/controllers/transition_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/transition_controller.ts"],"names":[],"mappings":"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","file":"transition_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/** Splits a space-separated class-list value into individual, non-empty tokens. */\nconst tokensOf = (value: string): string[] => value.split(/\\s+/).filter(Boolean);\n\n/** First `<time>` of a computed `transition-duration` / `-delay` value, in ms. */\nconst firstTimeMs = (value: string): number => {\n  const first = value.split(\",\")[0]?.trim() ?? \"\";\n  const amount = Number.parseFloat(first);\n  if (Number.isNaN(amount)) return 0;\n  return first.endsWith(\"ms\") ? amount : amount * 1000;\n};\n\n/**\n * Headless **enter/leave transition base**: stages CSS classes for showing and hiding\n * an element (the shared substrate other widgets can lean on instead of hand-rolling\n * it). Counterpart to Headless UI `Transition` / Alpine `x-transition` (no APG pattern;\n * honors WCAG 2.2 **2.3.3** via `prefers-reduced-motion` and keeps the visual state in\n * sync with `hidden`).\n *\n * Markup contract (identifier: `stimeo--transition`):\n *   <div data-controller=\"stimeo--transition\"\n *        data-stimeo--transition-enter-value=\"ease-out duration-200\"\n *        data-stimeo--transition-enter-from-value=\"opacity-0\"\n *        data-stimeo--transition-enter-to-value=\"opacity-100\"\n *        data-stimeo--transition-leave-value=\"ease-in duration-150\"\n *        data-stimeo--transition-leave-from-value=\"opacity-100\"\n *        data-stimeo--transition-leave-to-value=\"opacity-0\" hidden>…</div>\n *\n * `enter()` unhides the element, applies `enter` + `enterFrom`, then on the next frame\n * swaps `enterFrom` → `enterTo` so the CSS transition runs, and on `transitionend` (or\n * a safety timeout) settles to `entered`. `leave()` mirrors it and re-applies `hidden`.\n * `toggle()` reverses the current direction. The element carries `data-transition-state`\n * (`entering` / `entered` / `leaving` / `left`) and `entered` / `left` events fire on\n * completion.\n *\n * @remarks\n * Behavior only — the animation itself is the consumer's CSS; this controls *when* the\n * stage classes are applied. Under `prefers-reduced-motion: reduce` it switches\n * instantly (no staging). An interrupting call cancels the in-flight transition and\n * starts the new one. State lives solely in `hidden` / `data-transition-state`, and\n * `connect()` reconciles to a stable state (stripping any half-applied stage classes\n * from a Turbo cache); the `transitionend` listener, rAF, and safety timer are released\n * on `disconnect()` (Turbo navigation included).\n */\nexport class TransitionController extends Controller<HTMLElement> {\n  static override values = {\n    enter: { type: String, default: \"\" },\n    enterFrom: { type: String, default: \"\" },\n    enterTo: { type: String, default: \"\" },\n    leave: { type: String, default: \"\" },\n    leaveFrom: { type: String, default: \"\" },\n    leaveTo: { type: String, default: \"\" },\n    timeout: { type: Number, default: 0 },\n  };\n  static actions = [\"enter\", \"leave\", \"toggle\"] as const;\n  static events = [\"entered\", \"left\"] as const;\n\n  declare enterValue: string;\n  declare enterFromValue: string;\n  declare enterToValue: string;\n  declare leaveValue: string;\n  declare leaveFromValue: string;\n  declare leaveToValue: string;\n  declare timeoutValue: number;\n\n  readonly #timers = new SafeTimeout();\n  #rafId: number | null = null;\n  #endListener: ((event: Event) => void) | null = null;\n\n  override connect(): void {\n    // Drop any half-applied stage classes a cache may have captured, then settle the\n    // state hook to match the element's current visibility.\n    this.#strip();\n    this.element.setAttribute(\"data-transition-state\", this.element.hidden ? \"left\" : \"entered\");\n  }\n\n  override disconnect(): void {\n    this.#cancel();\n  }\n\n  /** Shows the element with the enter transition. */\n  enter(): void {\n    this.#run(\"enter\");\n  }\n\n  /** Hides the element with the leave transition. */\n  leave(): void {\n    this.#run(\"leave\");\n  }\n\n  /** Reverses the current direction (enter when hidden/leaving, else leave). */\n  toggle(): void {\n    const state = this.element.getAttribute(\"data-transition-state\");\n    if (state === \"entered\" || state === \"entering\") this.leave();\n    else this.enter();\n  }\n\n  #run(kind: \"enter\" | \"leave\"): void {\n    this.#cancel();\n    const isEnter = kind === \"enter\";\n    if (isEnter) this.element.hidden = false;\n    this.element.setAttribute(\"data-transition-state\", isEnter ? \"entering\" : \"leaving\");\n\n    if (this.#prefersReducedMotion()) {\n      this.#finish(kind);\n      return;\n    }\n\n    const base = isEnter ? this.enterValue : this.leaveValue;\n    const from = isEnter ? this.enterFromValue : this.leaveFromValue;\n    const to = isEnter ? this.enterToValue : this.leaveToValue;\n\n    this.#add(base, from);\n    this.#rafId = this.#raf(() => {\n      this.#rafId = null;\n      this.#remove(from);\n      this.#add(to);\n      this.#awaitEnd(() => this.#finish(kind));\n    });\n  }\n\n  /** Settles the element into the completed state, clearing the stage classes. */\n  #finish(kind: \"enter\" | \"leave\"): void {\n    this.#cleanupEnd();\n    this.#strip();\n    if (kind === \"enter\") {\n      this.element.setAttribute(\"data-transition-state\", \"entered\");\n      this.dispatch(\"entered\", { detail: {} });\n    } else {\n      this.element.hidden = true;\n      this.element.setAttribute(\"data-transition-state\", \"left\");\n      this.dispatch(\"left\", { detail: {} });\n    }\n  }\n\n  /** Resolves on the element's own `transitionend`, with a safety timeout fallback. */\n  #awaitEnd(done: () => void): void {\n    this.#endListener = (event: Event): void => {\n      if (event.target === this.element) done();\n    };\n    this.element.addEventListener(\"transitionend\", this.#endListener);\n    const ms = this.timeoutValue > 0 ? this.timeoutValue : this.#duration();\n    this.#timers.set(done, ms);\n  }\n\n  #cleanupEnd(): void {\n    if (this.#endListener) {\n      this.element.removeEventListener(\"transitionend\", this.#endListener);\n      this.#endListener = null;\n    }\n    this.#timers.clearAll();\n  }\n\n  /** Cancels any in-flight transition (interruption / teardown). */\n  #cancel(): void {\n    if (this.#rafId !== null) {\n      this.#cancelRaf(this.#rafId);\n      this.#rafId = null;\n    }\n    this.#cleanupEnd();\n    this.#strip();\n  }\n\n  #add(...lists: string[]): void {\n    const tokens = lists.flatMap(tokensOf);\n    if (tokens.length > 0) this.element.classList.add(...tokens);\n  }\n\n  #remove(...lists: string[]): void {\n    const tokens = lists.flatMap(tokensOf);\n    if (tokens.length > 0) this.element.classList.remove(...tokens);\n  }\n\n  /** Removes every stage class so no half-applied state lingers. */\n  #strip(): void {\n    this.#remove(\n      this.enterValue,\n      this.enterFromValue,\n      this.enterToValue,\n      this.leaveValue,\n      this.leaveFromValue,\n      this.leaveToValue,\n    );\n  }\n\n  /** Auto-computed safety duration (transition time + delay, with a small buffer). */\n  #duration(): number {\n    if (typeof window.getComputedStyle !== \"function\") return 0;\n    const style = window.getComputedStyle(this.element);\n    const total = firstTimeMs(style.transitionDuration) + firstTimeMs(style.transitionDelay);\n    return total > 0 ? total + 50 : 0;\n  }\n\n  #raf(callback: () => void): number {\n    if (typeof window.requestAnimationFrame === \"function\") {\n      return window.requestAnimationFrame(() => callback());\n    }\n    return window.setTimeout(callback, 0);\n  }\n\n  #cancelRaf(id: number): void {\n    if (typeof window.cancelAnimationFrame === \"function\") window.cancelAnimationFrame(id);\n    else window.clearTimeout(id);\n  }\n\n  #prefersReducedMotion(): boolean {\n    return (\n      typeof window.matchMedia === \"function\" &&\n      window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/reduced_motion.ts","../../src/utils/safe_timeout.ts","../../src/utils/transition_completion.ts","../../src/controllers/transition_controller.ts"],"names":[],"mappings":"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","file":"transition_controller.js","sourcesContent":["/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers\n * (count-up, highlight, overflow-indicator, scroll-visibility, stick-to-bottom,\n * transition).\n *\n * This one-liner keeps the media query string and the environment guard\n * single-sourced across them. The preference is intentionally re-read on every\n * call — the controllers check it at each animation/scroll start (WCAG 2.2\n * **2.3.3**), so flipping the OS setting takes effect immediately without any\n * listener or cache bookkeeping here.\n */\n\n/**\n * Whether the user currently requests reduced motion.\n *\n * @returns `true` when `(prefers-reduced-motion: reduce)` matches; `false`\n * otherwise, including environments without `window.matchMedia` (treated as\n * \"no preference\").\n */\nexport function prefersReducedMotion(): boolean {\n  return (\n    typeof window.matchMedia === \"function\" &&\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\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 { SafeTimeout } from \"./safe_timeout\";\n\n/** Computed transition fields needed to determine when an element has settled. */\nexport type TransitionStyle = Pick<\n  CSSStyleDeclaration,\n  \"transitionProperty\" | \"transitionDuration\" | \"transitionDelay\"\n>;\n\n/** Parsed transition property paired with its effective duration and delay. */\ninterface TransitionTiming {\n  property: string;\n  totalMs: number;\n}\n\n/** Parses a CSS `<time>` into milliseconds, returning `0` for malformed values. */\nfunction timeMs(value: string): number {\n  const trimmed = value.trim();\n  const amount = Number.parseFloat(trimmed);\n  if (!Number.isFinite(amount)) return 0;\n  if (trimmed.endsWith(\"ms\")) return amount;\n  if (trimmed.endsWith(\"s\")) return amount * 1000;\n  return 0;\n}\n\n/** Splits a computed comma-separated CSS list into normalized, non-empty items. */\nfunction cssList(value: string): string[] {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * Pairs transition properties, durations, and delays using CSS list repetition.\n *\n * The `transition-property` list determines the number of transitions. Shorter\n * duration/delay lists repeat, while extra values are ignored. A negative delay\n * shortens the remaining wall-clock time, and a non-positive total is settled.\n */\nfunction transitionTimings(style: TransitionStyle): TransitionTiming[] {\n  const properties = cssList(style.transitionProperty);\n  const durations = cssList(style.transitionDuration).map(timeMs);\n  const delays = cssList(style.transitionDelay).map(timeMs);\n  const effectiveProperties =\n    properties.length > 0\n      ? properties\n      : Array.from({ length: Math.max(durations.length, delays.length, 1) }, () => \"all\");\n  const effectiveDurations = durations.length > 0 ? durations : [0];\n  const effectiveDelays = delays.length > 0 ? delays : [0];\n\n  return effectiveProperties\n    .filter((property) => property !== \"none\")\n    .map((property, index) => ({\n      property,\n      totalMs: Math.max(\n        0,\n        (effectiveDurations[index % effectiveDurations.length] ?? 0) +\n          (effectiveDelays[index % effectiveDelays.length] ?? 0),\n      ),\n    }));\n}\n\n/** Maximum total over already-parsed timings (0 when the list is empty). */\nfunction maxTotalMs(timings: TransitionTiming[]): number {\n  return timings.reduce((max, { totalMs }) => Math.max(max, totalMs), 0);\n}\n\n/** Maximum effective transition duration plus delay, in milliseconds. */\nexport function maxTransitionTotalMs(style: TransitionStyle): number {\n  return maxTotalMs(transitionTimings(style));\n}\n\n/** Optional tuning for a single {@link TransitionCompletion.wait} call. */\nexport interface TransitionWaitOptions {\n  /**\n   * Positive wall-clock override (ms) for the bounded fallback, replacing the\n   * auto-computed `max + 50ms` timer verbatim. It also keeps the wait armed for\n   * a computed 0ms transition (no synchronous completion): the consumer asserts\n   * a transition budget that computed styles cannot see. Non-positive and\n   * non-finite (`NaN` / `Infinity`) values are ignored.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Owns one cancellable wait for an element's CSS transitions to settle.\n *\n * When available, active CSS transitions provide their expanded property names.\n * Tracking those names lets shorthand declarations settle from their longhand\n * terminal events. A terminal event from an interrupted phase is ignored while a\n * replacement transition for the same property is still active. Because that set\n * is sampled when the wait is armed, a property whose transition only starts a\n * frame later would otherwise be settled over; the still-running set is therefore\n * re-read before completing and adopted when it is not yet empty. Without Web\n * Animations data, explicit transition properties retain the declared-property\n * behavior and the ambiguous `transition-property: all` form waits until the\n * computed maximum wall-clock time. A `max + 50ms` timeout is always armed\n * because browsers emit no terminal event when a property never transitions, an\n * ancestor disappears, or rendering is otherwise interrupted; a consumer with\n * better knowledge can replace that fallback via\n * {@link TransitionWaitOptions.timeoutMs}.\n */\nexport class TransitionCompletion {\n  readonly #timers = new SafeTimeout();\n  #element: HTMLElement | null = null;\n  #complete: (() => void) | null = null;\n  #pendingProperties: Set<string> | null = null;\n  #deadline = 0;\n\n  /**\n   * Replaces any prior wait and invokes `complete` synchronously for a 0ms\n   * transition (including when `getComputedStyle` is unavailable).\n   *\n   * With a positive `options.timeoutMs` the synchronous fast-path is skipped and\n   * the override replaces the auto-computed fallback (see {@link TransitionWaitOptions}).\n   */\n  wait(element: HTMLElement, complete: () => void, options: TransitionWaitOptions = {}): void {\n    this.cancel();\n\n    const requested = options.timeoutMs ?? 0;\n    const override = Number.isFinite(requested) && requested > 0 ? requested : 0;\n    // A non-browser / partial-DOM environment cannot report a computable\n    // transition, which is indistinguishable from a 0ms one.\n    const timings =\n      typeof window.getComputedStyle === \"function\"\n        ? transitionTimings(window.getComputedStyle(element))\n        : [];\n    const maximum = maxTotalMs(timings);\n    if (maximum <= 0 && override <= 0) {\n      complete();\n      return;\n    }\n\n    this.#element = element;\n    this.#complete = complete;\n    this.#deadline = Date.now() + maximum;\n    const activeProperties = this.#activeTransitionProperties(element);\n    this.#pendingProperties =\n      activeProperties.size > 0 ? activeProperties : this.#explicitPendingProperties(timings);\n    element.addEventListener(\"transitionend\", this.#onTerminal);\n    element.addEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#timers.set(() => this.#finish(), override > 0 ? override : maximum + 50);\n  }\n\n  /** Cancels the pending wait without invoking its completion callback. */\n  cancel(): void {\n    this.#complete = null;\n    this.#teardown();\n  }\n\n  /**\n   * Handles terminal events from the observed element only.\n   *\n   * For explicit property lists, every declared positive-time property must\n   * settle. For `all`, no reliable property set exists, so an event can finish\n   * only after the computed maximum time; the safety timeout owns the usual path.\n   */\n  readonly #onTerminal = (event: Event): void => {\n    if (event.target !== this.#element) return;\n    const transitionEvent = event as TransitionEvent;\n    // A pseudo-element's transition is reported with its originating element\n    // as `target`; it must not settle the element's own transition.\n    if (transitionEvent.pseudoElement) return;\n\n    if (this.#pendingProperties) {\n      const propertyName = transitionEvent.propertyName;\n      const active = this.#activeTransitionProperties(this.#element);\n      // An interrupted transition queues its cancel event before the replacement\n      // phase starts, but dispatch can happen after the new wait is armed. The\n      // replacement is then the active transition for this property, so the stale\n      // terminal event must not settle the new phase.\n      if (active.has(propertyName)) return;\n      if (!this.#pendingProperties.delete(propertyName)) return;\n      if (this.#pendingProperties.size > 0) return;\n      // The tracked set is an arm-time snapshot, so a transition the phase starts\n      // one frame later is absent from it. Re-reading the still-running set before\n      // settling adopts those stragglers instead of completing over them; the\n      // fallback timer stays armed, so this cannot extend the wait unboundedly.\n      if (active.size > 0) {\n        this.#pendingProperties = active;\n        return;\n      }\n      this.#finish();\n      return;\n    }\n\n    if (Date.now() >= this.#deadline) this.#finish();\n  };\n\n  /**\n   * Returns active CSS transition properties expanded to the names reported by\n   * terminal events. CSS animations and pseudo-element effects are excluded.\n   */\n  #activeTransitionProperties(element: HTMLElement | null): Set<string> {\n    if (!element || typeof element.getAnimations !== \"function\") return new Set();\n\n    try {\n      const properties = element.getAnimations().flatMap((animation) => {\n        if (animation.playState === \"idle\" || animation.playState === \"finished\") return [];\n        const effect = animation.effect as KeyframeEffect | null;\n        // A pseudo-element effect names the originating element as its target, so\n        // `target` alone cannot separate it. Its terminal events are ignored, so\n        // tracking its properties would only strand the wait on the fallback.\n        if (effect?.pseudoElement) return [];\n        const target = effect?.target;\n        if (target && target !== element) return [];\n        const property = (animation as Partial<CSSTransition>).transitionProperty;\n        return typeof property === \"string\" && property.length > 0 ? [property] : [];\n      });\n      return new Set(properties);\n    } catch {\n      // Partial DOM implementations can expose getAnimations without supporting\n      // it. The declared-property tracker and bounded timer remain safe fallbacks.\n      return new Set();\n    }\n  }\n\n  /** Returns explicit positive-time properties, or `null` for the ambiguous `all`. */\n  #explicitPendingProperties(timings: TransitionTiming[]): Set<string> | null {\n    if (timings.some(({ property }) => property === \"all\")) return null;\n    const pending = new Set(\n      timings.filter(({ totalMs }) => totalMs > 0).map(({ property }) => property),\n    );\n    // An empty set is only reachable through a timeout override (a 0ms transition\n    // otherwise completes synchronously). With nothing to track, fall back to the\n    // deadline rule so any terminal event can settle the wait, exactly like `all`.\n    return pending.size > 0 ? pending : null;\n  }\n\n  /** Completes exactly once, releasing listeners and the fallback before the callback. */\n  #finish(): void {\n    const complete = this.#complete;\n    if (!complete) return;\n    this.#complete = null;\n    this.#teardown();\n    complete();\n  }\n\n  /** Releases the exact element listeners and timer owned by the current wait. */\n  #teardown(): void {\n    this.#timers.clearAll();\n    this.#element?.removeEventListener(\"transitionend\", this.#onTerminal);\n    this.#element?.removeEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#element = null;\n    this.#pendingProperties = null;\n    this.#deadline = 0;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\nimport { TransitionCompletion } from \"../utils/transition_completion\";\n\n/** Splits a space-separated class-list value into individual, non-empty tokens. */\nconst tokensOf = (value: string): string[] => value.split(/\\s+/).filter(Boolean);\n\n/**\n * Headless **enter/leave transition base**: stages CSS classes for showing and hiding\n * an element (the shared substrate other widgets can lean on instead of hand-rolling\n * it). Counterpart to Headless UI `Transition` / Alpine `x-transition` (no APG pattern;\n * honors WCAG 2.2 **2.3.3** via `prefers-reduced-motion` and keeps the visual state in\n * sync with `hidden`).\n *\n * Markup contract (identifier: `stimeo--transition`):\n *   <div data-controller=\"stimeo--transition\"\n *        data-stimeo--transition-enter-value=\"ease-out duration-200\"\n *        data-stimeo--transition-enter-from-value=\"opacity-0\"\n *        data-stimeo--transition-enter-to-value=\"opacity-100\"\n *        data-stimeo--transition-leave-value=\"ease-in duration-150\"\n *        data-stimeo--transition-leave-from-value=\"opacity-100\"\n *        data-stimeo--transition-leave-to-value=\"opacity-0\" hidden>…</div>\n *\n * `enter()` unhides the element, applies `enter` + `enterFrom`, then on the next frame\n * swaps `enterFrom` → `enterTo` so the CSS transition runs, and settles to `entered`\n * once the transition completes. `leave()` mirrors it and re-applies `hidden`.\n * `toggle()` reverses the current direction. The element carries `data-transition-state`\n * (`entering` / `entered` / `leaving` / `left`) and `entered` / `left` events fire on\n * completion.\n *\n * @remarks\n * Behavior only — the animation itself is the consumer's CSS; this controls *when* the\n * stage classes are applied. Completion is owned by the shared\n * {@link TransitionCompletion}: every declared transition property must settle\n * (`transitionend` / `transitioncancel`, pseudo-element events excluded) with a\n * `max(duration + delay) + 50ms` bounded fallback, and a computed 0ms transition\n * settles synchronously at the staging frame. A positive `timeout` Value replaces the\n * fallback verbatim and keeps the wait armed even for a computed 0ms transition.\n * Under `prefers-reduced-motion: reduce` it switches instantly (no staging). An\n * interrupting call cancels the in-flight transition and starts the new one. State\n * lives solely in `hidden` / `data-transition-state`, and `connect()` reconciles to a\n * stable state (stripping any half-applied stage classes from a Turbo cache); the\n * terminal-event listeners, rAF, and fallback timer are released on `disconnect()`\n * (Turbo navigation included).\n */\nexport class TransitionController extends Controller<HTMLElement> {\n  static override values = {\n    enter: { type: String, default: \"\" },\n    enterFrom: { type: String, default: \"\" },\n    enterTo: { type: String, default: \"\" },\n    leave: { type: String, default: \"\" },\n    leaveFrom: { type: String, default: \"\" },\n    leaveTo: { type: String, default: \"\" },\n    timeout: { type: Number, default: 0 },\n  };\n  static actions = [\"enter\", \"leave\", \"toggle\"] as const;\n  static events = [\"entered\", \"left\"] as const;\n\n  declare enterValue: string;\n  declare enterFromValue: string;\n  declare enterToValue: string;\n  declare leaveValue: string;\n  declare leaveFromValue: string;\n  declare leaveToValue: string;\n  declare timeoutValue: number;\n\n  /** Owns the cancellable completion wait (terminal events + bounded fallback). */\n  readonly #transition = new TransitionCompletion();\n  #rafId: number | null = null;\n\n  override connect(): void {\n    // Drop any half-applied stage classes a cache may have captured, then settle the\n    // state hook to match the element's current visibility.\n    this.#strip();\n    this.element.setAttribute(\"data-transition-state\", this.element.hidden ? \"left\" : \"entered\");\n  }\n\n  override disconnect(): void {\n    this.#cancel();\n  }\n\n  /** Shows the element with the enter transition. */\n  enter(): void {\n    this.#run(\"enter\");\n  }\n\n  /** Hides the element with the leave transition. */\n  leave(): void {\n    this.#run(\"leave\");\n  }\n\n  /** Reverses the current direction (enter when hidden/leaving, else leave). */\n  toggle(): void {\n    const state = this.element.getAttribute(\"data-transition-state\");\n    if (state === \"entered\" || state === \"entering\") this.leave();\n    else this.enter();\n  }\n\n  #run(kind: \"enter\" | \"leave\"): void {\n    this.#cancel();\n    const isEnter = kind === \"enter\";\n    if (isEnter) this.element.hidden = false;\n    this.element.setAttribute(\"data-transition-state\", isEnter ? \"entering\" : \"leaving\");\n\n    if (prefersReducedMotion()) {\n      this.#finish(kind);\n      return;\n    }\n\n    const base = isEnter ? this.enterValue : this.leaveValue;\n    const from = isEnter ? this.enterFromValue : this.leaveFromValue;\n    const to = isEnter ? this.enterToValue : this.leaveToValue;\n\n    this.#add(base, from);\n    this.#rafId = this.#raf(() => {\n      this.#rafId = null;\n      this.#remove(from);\n      this.#add(to);\n      // The consumer's `timeout` Value (positive) replaces the auto-computed\n      // fallback so an author-declared budget always wins over computed styles.\n      this.#transition.wait(this.element, () => this.#finish(kind), {\n        timeoutMs: this.timeoutValue,\n      });\n    });\n  }\n\n  /** Settles the element into the completed state, clearing the stage classes. */\n  #finish(kind: \"enter\" | \"leave\"): void {\n    this.#strip();\n    if (kind === \"enter\") {\n      this.element.setAttribute(\"data-transition-state\", \"entered\");\n      this.dispatch(\"entered\", { detail: {} });\n    } else {\n      this.element.hidden = true;\n      this.element.setAttribute(\"data-transition-state\", \"left\");\n      this.dispatch(\"left\", { detail: {} });\n    }\n  }\n\n  /** Cancels any in-flight transition (interruption / teardown). */\n  #cancel(): void {\n    if (this.#rafId !== null) {\n      this.#cancelRaf(this.#rafId);\n      this.#rafId = null;\n    }\n    this.#transition.cancel();\n    this.#strip();\n  }\n\n  #add(...lists: string[]): void {\n    const tokens = lists.flatMap(tokensOf);\n    if (tokens.length > 0) this.element.classList.add(...tokens);\n  }\n\n  #remove(...lists: string[]): void {\n    const tokens = lists.flatMap(tokensOf);\n    if (tokens.length > 0) this.element.classList.remove(...tokens);\n  }\n\n  /** Removes every stage class so no half-applied state lingers. */\n  #strip(): void {\n    this.#remove(\n      this.enterValue,\n      this.enterFromValue,\n      this.enterToValue,\n      this.leaveValue,\n      this.leaveFromValue,\n      this.leaveToValue,\n    );\n  }\n\n  #raf(callback: () => void): number {\n    if (typeof window.requestAnimationFrame === \"function\") {\n      return window.requestAnimationFrame(() => callback());\n    }\n    return window.setTimeout(callback, 0);\n  }\n\n  #cancelRaf(id: number): void {\n    if (typeof window.cancelAnimationFrame === \"function\") window.cancelAnimationFrame(id);\n    else window.clearTimeout(id);\n  }\n}\n"]}

package/dist/controllers/tree_view_controller.d.ts

@@ -0,0 +1,135 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible single-select tree view.
+ *
+ * Markup contract (identifier: `stimeo--tree-view`):
+ *   <ul data-controller="stimeo--tree-view" role="tree" aria-label="Files">
+ *     <li role="treeitem" aria-expanded="false" aria-selected="false" tabindex="0"
+ *         data-stimeo--tree-view-target="item"
+ *         data-action="keydown->stimeo--tree-view#onKeydown
+ *                      click->stimeo--tree-view#onClick">
+ *       <span>src</span>
+ *       <button type="button" tabindex="-1" aria-hidden="true"
+ *               data-action="click->stimeo--tree-view#toggle"></button>
+ *       <ul role="group" data-stimeo--tree-view-target="group" hidden>
+ *         <li role="treeitem" aria-selected="false" tabindex="-1"
+ *             data-stimeo--tree-view-target="item" data-action="…">…</li>
+ *       </ul>
+ *     </li>
+ *   </ul>
+ *
+ * Implements the WAI-ARIA APG **Tree View** (single-select) pattern. Parent/child
+ * structure is read from the DOM nesting (`treeitem` → child `group`). The whole
+ * tree is one Tab stop (roving tabindex); arrows navigate visible items, expand /
+ * collapse, and move between parent and child.
+ *
+ * Behavior provided:
+ * - `ArrowDown`/`ArrowUp` move between visible items; `Home`/`End` jump to the
+ *   first / last visible item; printable characters typeahead by label prefix
+ *   (`aria-label` first, else the item's own text), with a repeated character
+ *   cycling through the items that start with it.
+ * - `ArrowRight` expands a collapsed parent or steps into its first child;
+ *   `ArrowLeft` collapses an expanded parent or steps to the parent item.
+ * - `Enter`/`Space`/click select the item (single selection via `aria-selected`);
+ *   an `aria-disabled="true"` item stays focusable but cannot be selected.
+ * - `aria-expanded` and each child `group`'s `hidden` stay in sync, dispatching
+ *   `stimeo--tree-view:toggle`; selection dispatches `stimeo--tree-view:select`.
+ * - The optional `toggle` action expands / collapses the nearest item, so a
+ *   chevron gives pointer users the reach that `ArrowRight` gives the keyboard.
+ *
+ * Contract notes:
+ * - A child container is resolved by `role="group"`, not by the target: the
+ *   `group` target is what `stimeo check`'s accessibility rule anchors on, which
+ *   is why the contract still declares it.
+ * - Nested interactive controls ({@link NESTED_INTERACTIVE}) and IME composition
+ *   keys are left alone; a click on a child `group`'s own box (its indentation
+ *   band) selects nothing rather than the parent row.
+ * - A key a descendant already consumed (`event.defaultPrevented`) is yielded,
+ *   so a composed widget inside a row never causes a double move.
+ *
+ * Consumer contract — the item host:
+ * - **Host `role="treeitem"` on a non-interactive element** (`li`, `div`), never
+ *   on {@link NESTED_INTERACTIVE}. APG's *Navigation Treeview* does host it on a
+ *   link, but that variant activates on `Enter`, which this pattern has already
+ *   spent on selection; a link host is therefore out of contract and would need
+ *   `Enter` / click / `select` redefined first.
+ * - An out-of-contract host makes `onKeydown` and `onClick` stand down
+ *   **entirely** — no movement, no selection, no `select` — rather than respond
+ *   partially. `stimeo check` cannot flag it: the rule schema states which
+ *   attributes are required and cannot forbid an element shape.
+ *
+ * Consumer contract — controls nested inside a row:
+ * - Keep them out of the Tab sequence (`tabindex="-1"`); the tree is one Tab
+ *   stop and writes `tabindex` on nothing but its own item targets.
+ * - Moving focus *into* a control (to start an inline rename) is the consumer's
+ *   call — the tree never focuses one.
+ * - When the edit or action ends, focus the `treeitem` itself. The roving
+ *   position never moved, so that alone restores the keyboard path.
+ * - The tree consumes none of the control's events, by two mechanisms:
+ *   {@link NESTED_INTERACTIVE} names controls by *element shape*, the
+ *   `defaultPrevented` yield covers widgets no selector can name.
+ */
+declare class TreeViewController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static actions: readonly ["onClick", "onKeydown", "toggle"];
+    static events: readonly ["select", "toggle"];
+    readonly itemTargets: HTMLElement[];
+    /**
+     * Reconciles authored expansion state and establishes the single tab stop.
+     * Idempotent, so a Turbo cache restore / morph re-runs it safely (re-adding
+     * the same listener reference is a no-op per the DOM spec).
+     */
+    connect(): void;
+    /** Detaches the focus trackers, drops the typeahead buffer and its timer. */
+    disconnect(): void;
+    /**
+     * Re-normalizes the tab stop when a `treeitem` is added at runtime, so an
+     * appended item carrying `tabindex="0"` cannot turn the tree into two Tab
+     * stops. Skipped before `connect()`: Stimulus registers the initial targets
+     * first, and `connect()` owns the initial tab-stop policy.
+     */
+    itemTargetConnected(): void;
+    /**
+     * Restores the roving invariants when a `treeitem` leaves at runtime — a Turbo
+     * Stream `remove`, a morph, or plain DOM surgery. The mirror of
+     * {@link TreeViewController.itemTargetConnected}: without it, removing the row
+     * that held `tabindex="0"` leaves every survivor at `-1`, i.e. a tree with
+     * **no** Tab stop, and drops DOM focus to `<body>` when the removed subtree
+     * held it.
+     *
+     * The replacement is the nearest surviving *visible* item in the pre-removal
+     * order — the one after the gap, else the one before it — which is the row
+     * `ArrowDown` would have reached. Removing a non-active item changes nothing.
+     * When no visible item survives, a tree with zero Tab stops is the correct end
+     * state.
+     *
+     * Focus is only *restored*, never *stolen*: DOM focus moves solely when it was
+     * inside the removed subtree and the document has nowhere left to put it.
+     */
+    itemTargetDisconnected(item: HTMLElement): void;
+    /**
+     * Routes tree keyboard interaction. Because `treeitem`s nest, only the handler
+     * on the nearest item to the event target acts; the same keydown bubbling to an
+     * ancestor item's handler is ignored to avoid double moves / selections. Keys
+     * from a nested interactive control (or an IME composition) are left untouched.
+     */
+    onKeydown(event: KeyboardEvent): void;
+    /** Selects the clicked item (nearest to the target only). */
+    onClick(event: Event): void;
+    /**
+     * Expands or collapses the `treeitem` nearest to the event target. Optional:
+     * wire it on a chevron control so pointer users can reach child nodes, which
+     * otherwise only `ArrowRight` / `ArrowLeft` can do. A leaf item is a no-op.
+     *
+     * The toggled row then takes focus and the tab stop, matching what the keyboard
+     * path guarantees. Without it, a browser that focuses buttons on mousedown leaves
+     * focus on the clicked chevron: arrows would stop working until focus returns to a
+     * row, and a decorative `aria-hidden` chevron would hold focus. The synchronous
+     * `stimeo--tree-view:toggle` event is observed before this final focus hand-off.
+     */
+    toggle(event: Event): void;
+}
+
+export { TreeViewController };