stimeo-ui 0.2.0 → 0.2.1

package/dist/controllers/carousel_controller.d.ts

@@ -0,0 +1,100 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible **Carousel** (slideshow) behavior.
+ *
+ * Markup contract (identifier: `stimeo--carousel`):
+ *   <section data-controller="stimeo--carousel" aria-roledescription="carousel"
+ *            aria-label="Featured"
+ *            data-stimeo--carousel-autoplay-value="false"
+ *            data-stimeo--carousel-interval-value="5000"
+ *            data-stimeo--carousel-loop-value="true"
+ *            data-action="mouseenter->stimeo--carousel#pause
+ *                         mouseleave->stimeo--carousel#resume
+ *                         focusin->stimeo--carousel#pause
+ *                         focusout->stimeo--carousel#resume">
+ *     <button data-stimeo--carousel-target="playToggle"
+ *             data-action="stimeo--carousel#togglePlay">…</button>
+ *     <div data-stimeo--carousel-target="viewport">
+ *       <div role="tabpanel" data-stimeo--carousel-target="slide">…</div>
+ *       <div role="tabpanel" data-stimeo--carousel-target="slide" hidden>…</div>
+ *     </div>
+ *     <button data-stimeo--carousel-target="prev" data-action="stimeo--carousel#prev">‹</button>
+ *     <button data-stimeo--carousel-target="next" data-action="stimeo--carousel#next">›</button>
+ *     <div role="tablist">
+ *       <button role="tab" data-stimeo--carousel-target="picker"
+ *               data-action="stimeo--carousel#goto
+ *                            keydown->stimeo--carousel#onPickerKeydown"></button>
+ *     </div>
+ *   </section>
+ *
+ * Implements the WAI-ARIA APG **Carousel** (tabbed) pattern. The current slide is
+ * exposed through `data-state` (`active`/`inactive`) and the `hidden` attribute on
+ * inactive slides (removing them from focus order); the matching picker carries
+ * `aria-selected` and the single roving `tabindex`. The play/pause toggle's
+ * `aria-pressed` mirrors the autoplay state.
+ *
+ * @remarks
+ * Behavior only — transitions, layout, and visuals are the consumer's CSS.
+ * Autoplay honors WCAG 2.2.2: it suspends while the pointer is over the carousel
+ * and **hard-stops** when keyboard focus enters (it does not silently resume on
+ * focus out — the user must press play), so motion never surprises a keyboard
+ * user. The interval is cleared on `disconnect()` (Turbo navigation included).
+ * Picker arrow keys move focus only (manual activation); slide changes never steal
+ * focus from the control the user operated.
+ */
+declare class CarouselController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        autoplay: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        interval: {
+            type: NumberConstructor;
+            default: number;
+        };
+        loop: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+    };
+    static actions: readonly ["goto", "next", "onPickerKeydown", "pause", "prev", "resume", "togglePlay"];
+    static events: readonly ["change", "pause", "play"];
+    readonly slideTargets: HTMLElement[];
+    readonly pickerTargets: HTMLElement[];
+    readonly playToggleTarget: HTMLElement;
+    readonly hasPlayToggleTarget: boolean;
+    autoplayValue: boolean;
+    intervalValue: number;
+    loopValue: boolean;
+    /** Renders the initial slide and starts autoplay when requested. */
+    connect(): void;
+    /** Clears the autoplay interval so it never fires after teardown. */
+    disconnect(): void;
+    /** Advances to the next slide. Bound via `data-action`. */
+    next(): void;
+    /** Returns to the previous slide. Bound via `data-action`. */
+    prev(): void;
+    /** Jumps to the slide whose picker was activated (click / Enter / Space). */
+    goto(event: Event): void;
+    /** Toggles autoplay on the user's explicit request and syncs the timer. */
+    togglePlay(): void;
+    /**
+     * Suspends autoplay. Hover (`mouseenter`) is a temporary suspension that resumes
+     * on leave; keyboard focus (`focusin`) is a hard stop that turns autoplay off so
+     * it cannot resume without an explicit play (WCAG 2.2.2).
+     */
+    pause(event?: Event): void;
+    /**
+     * Lifts a hover suspension (`mouseleave`) and resumes autoplay if it is still
+     * on. A `focusout` does nothing here: the focus pause was a hard stop, so the
+     * user must press play to restart.
+     */
+    resume(event?: Event): void;
+    /** Picker roving: arrows move focus only; Home/End activate first/last slide. */
+    onPickerKeydown(event: KeyboardEvent): void;
+}
+
+export { CarouselController };

package/dist/controllers/carousel_controller.js

@@ -0,0 +1,272 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/carousel_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;
+  return (next + length) % length;
+}
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeInterval = class extends TimerRegistry {
+  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */
+  set(callback, delay) {
+    const id = this.schedule(callback, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setInterval(callback, delay);
+  }
+  cancel(id) {
+    window.clearInterval(id);
+  }
+};
+
+// src/controllers/carousel_controller.ts
+var CarouselController = class extends Controller {
+  static targets = ["slide", "viewport", "prev", "next", "picker", "playToggle"];
+  static values = {
+    autoplay: { type: Boolean, default: false },
+    interval: { type: Number, default: 5e3 },
+    loop: { type: Boolean, default: true }
+  };
+  static actions = [
+    "goto",
+    "next",
+    "onPickerKeydown",
+    "pause",
+    "prev",
+    "resume",
+    "togglePlay"
+  ];
+  static events = ["change", "pause", "play"];
+  #roving = new RovingTabindex(() => this.pickerTargets);
+  #intervals = new SafeInterval();
+  /** Index of the visible slide. */
+  #index = 0;
+  /** User intent to autoplay (toggled by the play button / focus hard-stop). */
+  #playing = false;
+  /** Pointer is hovering the carousel: a temporary, auto-resuming suspension. */
+  #pointerPaused = false;
+  /** Id of the live autoplay interval, or null when stopped. */
+  #timerId = null;
+  /** Renders the initial slide and starts autoplay when requested. */
+  connect() {
+    const preselected = this.pickerTargets.findIndex(
+      (picker) => picker.getAttribute("aria-selected") === "true"
+    );
+    this.#index = preselected === -1 ? 0 : preselected;
+    this.#playing = this.#initialPlaying();
+    this.#render({ focus: false });
+    this.#syncTimer();
+  }
+  /**
+   * Resolves the starting autoplay intent. The play toggle's `aria-pressed` is the
+   * source of truth **when present**, so a Turbo Drive cache restore / morph that
+   * re-runs `connect()` against existing DOM does not silently resume autoplay the
+   * user had stopped (e.g. by focusing into the carousel). Only when no toggle
+   * carries `aria-pressed` does it fall back to the declarative `autoplay` value.
+   */
+  #initialPlaying() {
+    if (this.hasPlayToggleTarget && this.playToggleTarget.hasAttribute("aria-pressed")) {
+      return this.playToggleTarget.getAttribute("aria-pressed") === "true";
+    }
+    return this.autoplayValue;
+  }
+  /** Clears the autoplay interval so it never fires after teardown. */
+  disconnect() {
+    this.#intervals.clearAll();
+    this.#timerId = null;
+  }
+  /** Advances to the next slide. Bound via `data-action`. */
+  next() {
+    this.#select(this.#step(1), { focus: false });
+  }
+  /** Returns to the previous slide. Bound via `data-action`. */
+  prev() {
+    this.#select(this.#step(-1), { focus: false });
+  }
+  /** Jumps to the slide whose picker was activated (click / Enter / Space). */
+  goto(event) {
+    const target = event.currentTarget;
+    const index = this.pickerTargets.indexOf(target);
+    if (index !== -1) this.#select(index, { focus: false });
+  }
+  /** Toggles autoplay on the user's explicit request and syncs the timer. */
+  togglePlay() {
+    this.#playing = !this.#playing;
+    this.#syncTimer();
+  }
+  /**
+   * Suspends autoplay. Hover (`mouseenter`) is a temporary suspension that resumes
+   * on leave; keyboard focus (`focusin`) is a hard stop that turns autoplay off so
+   * it cannot resume without an explicit play (WCAG 2.2.2).
+   */
+  pause(event) {
+    if (event?.type.startsWith("focus")) {
+      this.#playing = false;
+    } else {
+      this.#pointerPaused = true;
+    }
+    this.#syncTimer();
+  }
+  /**
+   * Lifts a hover suspension (`mouseleave`) and resumes autoplay if it is still
+   * on. A `focusout` does nothing here: the focus pause was a hard stop, so the
+   * user must press play to restart.
+   */
+  resume(event) {
+    if (event?.type.startsWith("focus")) return;
+    this.#pointerPaused = false;
+    this.#syncTimer();
+  }
+  /** Picker roving: arrows move focus only; Home/End activate first/last slide. */
+  onPickerKeydown(event) {
+    const current = this.pickerTargets.indexOf(event.currentTarget);
+    if (current === -1) return;
+    const length = this.pickerTargets.length;
+    switch (event.key) {
+      case "ArrowRight":
+      case "ArrowDown":
+        event.preventDefault();
+        this.#roving.setActive(rovingMove(current, length, 1), { focus: true });
+        return;
+      case "ArrowLeft":
+      case "ArrowUp":
+        event.preventDefault();
+        this.#roving.setActive(rovingMove(current, length, -1), { focus: true });
+        return;
+      case "Home":
+        event.preventDefault();
+        this.#select(0, { focus: true });
+        return;
+      case "End":
+        event.preventDefault();
+        this.#select(length - 1, { focus: true });
+        return;
+    }
+  }
+  /** Resolves the index one step away from the current one, honoring `loop`. */
+  #step(delta) {
+    const total = this.slideTargets.length;
+    if (total === 0) return 0;
+    const next = this.#index + delta;
+    if (this.loopValue) return (next + total) % total;
+    return Math.min(total - 1, Math.max(0, next));
+  }
+  /**
+   * Changes the active slide, updates state hooks, and emits `change` — but only
+   * when the index actually changes, so a `next`/`prev` clamped at the end (or an
+   * autoplay tick at a non-looping boundary) re-renders without a spurious event
+   * (matching the "emit on real change" policy of flash/masonry/bulk-select).
+   */
+  #select(index, { focus }) {
+    const changed = index !== this.#index;
+    this.#index = index;
+    this.#render({ focus });
+    this.#syncTimer();
+    if (changed) this.dispatch("change", { detail: { index, total: this.slideTargets.length } });
+  }
+  /** Reflects `this.#index` onto slides and pickers (state hooks + roving). */
+  #render({ focus }) {
+    this.slideTargets.forEach((slide, i) => {
+      const active = i === this.#index;
+      slide.setAttribute("data-state", active ? "active" : "inactive");
+      slide.hidden = !active;
+    });
+    this.pickerTargets.forEach((picker, i) => {
+      picker.setAttribute("aria-selected", i === this.#index ? "true" : "false");
+    });
+    this.#roving.setActive(this.#index, { focus });
+  }
+  /**
+   * Drives the autoplay interval toward the desired state. Autoplay should run
+   * only when the user wants it (`playing`), the pointer is not hovering, and more
+   * than one slide exists. Transitions emit `play`/`pause` and keep the toggle's
+   * `aria-pressed` in sync.
+   */
+  #syncTimer() {
+    if (!this.loopValue && this.#index >= this.slideTargets.length - 1) {
+      this.#playing = false;
+    }
+    const shouldRun = this.#playing && !this.#pointerPaused && this.slideTargets.length > 1;
+    if (shouldRun && this.#timerId === null) {
+      this.#timerId = this.#intervals.set(() => this.next(), this.intervalValue);
+      this.dispatch("play");
+    } else if (!shouldRun && this.#timerId !== null) {
+      this.#intervals.clear(this.#timerId);
+      this.#timerId = null;
+      this.dispatch("pause");
+    }
+    if (this.hasPlayToggleTarget) {
+      this.playToggleTarget.setAttribute("aria-pressed", this.#playing ? "true" : "false");
+    }
+  }
+};
+
+export { CarouselController };
+//# sourceMappingURL=carousel_controller.js.map
+//# sourceMappingURL=carousel_controller.js.map

package/dist/controllers/carousel_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/roving_tabindex.ts","../../src/utils/safe_timeout.ts","../../src/controllers/carousel_controller.ts"],"names":[],"mappings":"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","file":"carousel_controller.js","sourcesContent":["/**\n * Low-level roving-tabindex primitive shared by composite-widget controllers.\n *\n * The APG roving-tabindex pattern keeps a composite widget a single Tab stop:\n * exactly one item is in the Tab sequence (`tabindex=\"0\"`) while the rest are\n * removed from it (`tabindex=\"-1\"`), and the arrow keys move both DOM focus and\n * that single tabbable position together. {@link RovingTabindex} owns *only* that\n * mechanical bookkeeping — \"which one item is tabbable, and move focus there\".\n *\n * It is intentionally **policy-free**. Orientation, wrapping vs. clamping,\n * selection-follows-focus, typeahead, and `Home`/`End` semantics differ per APG\n * pattern (Radio Group, Toolbar, Rating, …); folding them into one helper would\n * flatten those widgets to a lowest common denominator and lose each pattern's\n * correctness. Those decisions therefore stay in each controller, which calls\n * {@link RovingTabindex.setActive} with an index it computed itself (optionally\n * via the pure {@link rovingMove} helper).\n *\n * @remarks\n * Items are read lazily through a getter so a controller can add or remove\n * targets (Stimulus re-scans the DOM) without re-wiring this helper.\n */\nexport class RovingTabindex {\n  /** Returns the current ordered item elements; called on every operation. */\n  readonly #getItems: () => HTMLElement[];\n\n  /**\n   * @param getItems - Returns the current ordered item elements. Called on every\n   *   operation so the live target list is always used.\n   */\n  constructor(getItems: () => HTMLElement[]) {\n    this.#getItems = getItems;\n  }\n\n  /** Index of the currently tabbable item (`tabindex=\"0\"`), or `-1` if none. */\n  get activeIndex(): number {\n    return this.#getItems().findIndex((item) => item.tabIndex === 0);\n  }\n\n  /**\n   * Makes exactly the item at `index` tabbable (`tabindex=\"0\"`) and removes every\n   * other item from the Tab sequence (`tabindex=\"-1\"`). An out-of-range `index`\n   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express\n   * \"nothing is currently tabbable\".\n   *\n   * @param index - Position of the item to make tabbable.\n   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.\n   */\n  setActive(index: number, { focus = false }: { focus?: boolean } = {}): void {\n    const items = this.#getItems();\n    items.forEach((item, i) => {\n      item.tabIndex = i === index ? 0 : -1;\n    });\n    if (focus) items[index]?.focus();\n  }\n}\n\n/** Edge behavior for {@link rovingMove}: cycle past the ends, or stop at them. */\nexport type RovingWrap = \"wrap\" | \"clamp\";\n\n/**\n * Pure helper that resolves the target index for a one-step directional move.\n *\n * Keyboard/orientation mapping stays in the caller: it decides that a key means\n * `delta` `+1` (next) or `-1` (previous) and whether the widget should `\"wrap\"`\n * (Radio Group, Toolbar) or `\"clamp\"` at the ends.\n *\n * @param current - The index focus is moving from.\n * @param length - Number of items in the set.\n * @param delta - `+1` to move to the next item, `-1` for the previous.\n * @param wrap - `\"wrap\"` cycles around the ends; `\"clamp\"` stops at them.\n * @returns The resolved index, or `-1` when there are no items.\n */\nexport function rovingMove(\n  current: number,\n  length: number,\n  delta: number,\n  wrap: RovingWrap,\n): number {\n  if (length === 0) return -1;\n  const next = current + delta;\n  if (wrap === \"wrap\") return (next + length) % length;\n  return Math.min(length - 1, Math.max(0, next));\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { RovingTabindex, rovingMove } from \"../utils/roving_tabindex\";\nimport { SafeInterval } from \"../utils/safe_timeout\";\n\n/**\n * Headless, accessible **Carousel** (slideshow) behavior.\n *\n * Markup contract (identifier: `stimeo--carousel`):\n *   <section data-controller=\"stimeo--carousel\" aria-roledescription=\"carousel\"\n *            aria-label=\"Featured\"\n *            data-stimeo--carousel-autoplay-value=\"false\"\n *            data-stimeo--carousel-interval-value=\"5000\"\n *            data-stimeo--carousel-loop-value=\"true\"\n *            data-action=\"mouseenter->stimeo--carousel#pause\n *                         mouseleave->stimeo--carousel#resume\n *                         focusin->stimeo--carousel#pause\n *                         focusout->stimeo--carousel#resume\">\n *     <button data-stimeo--carousel-target=\"playToggle\"\n *             data-action=\"stimeo--carousel#togglePlay\">…</button>\n *     <div data-stimeo--carousel-target=\"viewport\">\n *       <div role=\"tabpanel\" data-stimeo--carousel-target=\"slide\">…</div>\n *       <div role=\"tabpanel\" data-stimeo--carousel-target=\"slide\" hidden>…</div>\n *     </div>\n *     <button data-stimeo--carousel-target=\"prev\" data-action=\"stimeo--carousel#prev\">‹</button>\n *     <button data-stimeo--carousel-target=\"next\" data-action=\"stimeo--carousel#next\">›</button>\n *     <div role=\"tablist\">\n *       <button role=\"tab\" data-stimeo--carousel-target=\"picker\"\n *               data-action=\"stimeo--carousel#goto\n *                            keydown->stimeo--carousel#onPickerKeydown\"></button>\n *     </div>\n *   </section>\n *\n * Implements the WAI-ARIA APG **Carousel** (tabbed) pattern. The current slide is\n * exposed through `data-state` (`active`/`inactive`) and the `hidden` attribute on\n * inactive slides (removing them from focus order); the matching picker carries\n * `aria-selected` and the single roving `tabindex`. The play/pause toggle's\n * `aria-pressed` mirrors the autoplay state.\n *\n * @remarks\n * Behavior only — transitions, layout, and visuals are the consumer's CSS.\n * Autoplay honors WCAG 2.2.2: it suspends while the pointer is over the carousel\n * and **hard-stops** when keyboard focus enters (it does not silently resume on\n * focus out — the user must press play), so motion never surprises a keyboard\n * user. The interval is cleared on `disconnect()` (Turbo navigation included).\n * Picker arrow keys move focus only (manual activation); slide changes never steal\n * focus from the control the user operated.\n */\nexport class CarouselController extends Controller<HTMLElement> {\n  static override targets = [\"slide\", \"viewport\", \"prev\", \"next\", \"picker\", \"playToggle\"];\n  static override values = {\n    autoplay: { type: Boolean, default: false },\n    interval: { type: Number, default: 5000 },\n    loop: { type: Boolean, default: true },\n  };\n  static actions = [\n    \"goto\",\n    \"next\",\n    \"onPickerKeydown\",\n    \"pause\",\n    \"prev\",\n    \"resume\",\n    \"togglePlay\",\n  ] as const;\n  static events = [\"change\", \"pause\", \"play\"] as const;\n\n  declare readonly slideTargets: HTMLElement[];\n  declare readonly pickerTargets: HTMLElement[];\n  declare readonly playToggleTarget: HTMLElement;\n  declare readonly hasPlayToggleTarget: boolean;\n  declare autoplayValue: boolean;\n  declare intervalValue: number;\n  declare loopValue: boolean;\n\n  readonly #roving = new RovingTabindex(() => this.pickerTargets);\n  readonly #intervals = new SafeInterval();\n  /** Index of the visible slide. */\n  #index = 0;\n  /** User intent to autoplay (toggled by the play button / focus hard-stop). */\n  #playing = false;\n  /** Pointer is hovering the carousel: a temporary, auto-resuming suspension. */\n  #pointerPaused = false;\n  /** Id of the live autoplay interval, or null when stopped. */\n  #timerId: number | null = null;\n\n  /** Renders the initial slide and starts autoplay when requested. */\n  override connect(): void {\n    const preselected = this.pickerTargets.findIndex(\n      (picker) => picker.getAttribute(\"aria-selected\") === \"true\",\n    );\n    this.#index = preselected === -1 ? 0 : preselected;\n    this.#playing = this.#initialPlaying();\n    this.#render({ focus: false });\n    this.#syncTimer();\n  }\n\n  /**\n   * Resolves the starting autoplay intent. The play toggle's `aria-pressed` is the\n   * source of truth **when present**, so a Turbo Drive cache restore / morph that\n   * re-runs `connect()` against existing DOM does not silently resume autoplay the\n   * user had stopped (e.g. by focusing into the carousel). Only when no toggle\n   * carries `aria-pressed` does it fall back to the declarative `autoplay` value.\n   */\n  #initialPlaying(): boolean {\n    if (this.hasPlayToggleTarget && this.playToggleTarget.hasAttribute(\"aria-pressed\")) {\n      return this.playToggleTarget.getAttribute(\"aria-pressed\") === \"true\";\n    }\n    return this.autoplayValue;\n  }\n\n  /** Clears the autoplay interval so it never fires after teardown. */\n  override disconnect(): void {\n    this.#intervals.clearAll();\n    this.#timerId = null;\n  }\n\n  /** Advances to the next slide. Bound via `data-action`. */\n  next(): void {\n    this.#select(this.#step(1), { focus: false });\n  }\n\n  /** Returns to the previous slide. Bound via `data-action`. */\n  prev(): void {\n    this.#select(this.#step(-1), { focus: false });\n  }\n\n  /** Jumps to the slide whose picker was activated (click / Enter / Space). */\n  goto(event: Event): void {\n    const target = event.currentTarget as HTMLElement;\n    const index = this.pickerTargets.indexOf(target);\n    if (index !== -1) this.#select(index, { focus: false });\n  }\n\n  /** Toggles autoplay on the user's explicit request and syncs the timer. */\n  togglePlay(): void {\n    this.#playing = !this.#playing;\n    this.#syncTimer();\n  }\n\n  /**\n   * Suspends autoplay. Hover (`mouseenter`) is a temporary suspension that resumes\n   * on leave; keyboard focus (`focusin`) is a hard stop that turns autoplay off so\n   * it cannot resume without an explicit play (WCAG 2.2.2).\n   */\n  pause(event?: Event): void {\n    if (event?.type.startsWith(\"focus\")) {\n      this.#playing = false;\n    } else {\n      this.#pointerPaused = true;\n    }\n    this.#syncTimer();\n  }\n\n  /**\n   * Lifts a hover suspension (`mouseleave`) and resumes autoplay if it is still\n   * on. A `focusout` does nothing here: the focus pause was a hard stop, so the\n   * user must press play to restart.\n   */\n  resume(event?: Event): void {\n    if (event?.type.startsWith(\"focus\")) return;\n    this.#pointerPaused = false;\n    this.#syncTimer();\n  }\n\n  /** Picker roving: arrows move focus only; Home/End activate first/last slide. */\n  onPickerKeydown(event: KeyboardEvent): void {\n    const current = this.pickerTargets.indexOf(event.currentTarget as HTMLElement);\n    if (current === -1) return;\n\n    const length = this.pickerTargets.length;\n    switch (event.key) {\n      case \"ArrowRight\":\n      case \"ArrowDown\":\n        event.preventDefault();\n        this.#roving.setActive(rovingMove(current, length, 1, \"wrap\"), { focus: true });\n        return;\n      case \"ArrowLeft\":\n      case \"ArrowUp\":\n        event.preventDefault();\n        this.#roving.setActive(rovingMove(current, length, -1, \"wrap\"), { focus: true });\n        return;\n      case \"Home\":\n        event.preventDefault();\n        this.#select(0, { focus: true });\n        return;\n      case \"End\":\n        event.preventDefault();\n        this.#select(length - 1, { focus: true });\n        return;\n      default:\n    }\n  }\n\n  /** Resolves the index one step away from the current one, honoring `loop`. */\n  #step(delta: number): number {\n    const total = this.slideTargets.length;\n    if (total === 0) return 0;\n    const next = this.#index + delta;\n    if (this.loopValue) return (next + total) % total;\n    return Math.min(total - 1, Math.max(0, next));\n  }\n\n  /**\n   * Changes the active slide, updates state hooks, and emits `change` — but only\n   * when the index actually changes, so a `next`/`prev` clamped at the end (or an\n   * autoplay tick at a non-looping boundary) re-renders without a spurious event\n   * (matching the \"emit on real change\" policy of flash/masonry/bulk-select).\n   */\n  #select(index: number, { focus }: { focus: boolean }): void {\n    const changed = index !== this.#index;\n    this.#index = index;\n    this.#render({ focus });\n    // Re-evaluate autoplay after every move so reaching the non-looping end stops\n    // the timer (see `#syncTimer`); idempotent for moves that don't cross a boundary.\n    this.#syncTimer();\n    if (changed) this.dispatch(\"change\", { detail: { index, total: this.slideTargets.length } });\n  }\n\n  /** Reflects `this.#index` onto slides and pickers (state hooks + roving). */\n  #render({ focus }: { focus: boolean }): void {\n    this.slideTargets.forEach((slide, i) => {\n      const active = i === this.#index;\n      slide.setAttribute(\"data-state\", active ? \"active\" : \"inactive\");\n      slide.hidden = !active;\n    });\n    this.pickerTargets.forEach((picker, i) => {\n      picker.setAttribute(\"aria-selected\", i === this.#index ? \"true\" : \"false\");\n    });\n    this.#roving.setActive(this.#index, { focus });\n  }\n\n  /**\n   * Drives the autoplay interval toward the desired state. Autoplay should run\n   * only when the user wants it (`playing`), the pointer is not hovering, and more\n   * than one slide exists. Transitions emit `play`/`pause` and keep the toggle's\n   * `aria-pressed` in sync.\n   */\n  #syncTimer(): void {\n    // A non-looping carousel sitting on its last slide has nothing left to advance\n    // to, so autoplay turns itself off (a hard stop, like the focus pause): the\n    // timer is cleared, `aria-pressed` flips to false, and a manual step back will\n    // not silently restart it without an explicit play.\n    if (!this.loopValue && this.#index >= this.slideTargets.length - 1) {\n      this.#playing = false;\n    }\n    const shouldRun = this.#playing && !this.#pointerPaused && this.slideTargets.length > 1;\n\n    if (shouldRun && this.#timerId === null) {\n      this.#timerId = this.#intervals.set(() => this.next(), this.intervalValue);\n      this.dispatch(\"play\");\n    } else if (!shouldRun && this.#timerId !== null) {\n      this.#intervals.clear(this.#timerId);\n      this.#timerId = null;\n      this.dispatch(\"pause\");\n    }\n\n    if (this.hasPlayToggleTarget) {\n      this.playToggleTarget.setAttribute(\"aria-pressed\", this.#playing ? \"true\" : \"false\");\n    }\n  }\n}\n"]}

package/dist/controllers/clipboard_controller.d.ts

@@ -0,0 +1,72 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless copy-to-clipboard behavior with a live-region completion notice.
+ *
+ * Markup contract (identifier: `stimeo--clipboard`):
+ *   <div data-controller="stimeo--clipboard"
+ *        data-stimeo--clipboard-feedback-duration-value="2000">
+ *     <input type="text" value="https://example.com" readonly
+ *            data-stimeo--clipboard-target="source">
+ *     <button type="button" data-stimeo--clipboard-target="button"
+ *             data-action="stimeo--clipboard#copy">Copy</button>
+ *     <span role="status" aria-live="polite"
+ *           data-stimeo--clipboard-target="feedback"></span>
+ *   </div>
+ *
+ * No dedicated APG pattern; this follows the Button + live-region practice. The
+ * copy uses the standard `navigator.clipboard` API (no extra dependency); when
+ * it is unavailable or rejects, the failure is surfaced rather than silently
+ * swallowed, and never communicated by icon alone — the `role="status"` region
+ * carries text so screen readers announce the outcome.
+ *
+ * @remarks
+ * Behavior only — icon swaps and styling are the consumer's, keyed off
+ * `data-state` (`idle` / `copied` / `error`). The completion notice clears
+ * itself after `feedbackDuration`; that timer is torn down on disconnect (Turbo)
+ * via {@link SafeTimeout}.
+ */
+declare class ClipboardController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        text: {
+            type: StringConstructor;
+            default: string;
+        };
+        feedbackDuration: {
+            type: NumberConstructor;
+            default: number;
+        };
+        copiedLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        errorLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["copy"];
+    static events: readonly ["copy"];
+    readonly sourceTarget: HTMLElement;
+    readonly buttonTarget: HTMLElement;
+    readonly feedbackTarget: HTMLElement;
+    readonly hasSourceTarget: boolean;
+    readonly hasButtonTarget: boolean;
+    readonly hasFeedbackTarget: boolean;
+    textValue: string;
+    feedbackDurationValue: number;
+    copiedLabelValue: string;
+    errorLabelValue: string;
+    connect(): void;
+    disconnect(): void;
+    /**
+     * Copies the resolved text and reports the outcome. Bound via `data-action`
+     * (click). Always dispatches `stimeo--clipboard:copy` with `{ success, text }`
+     * — including on failure — so consumers can react either way.
+     */
+    copy(): Promise<void>;
+}
+
+export { ClipboardController };

package/dist/controllers/clipboard_controller.js

@@ -0,0 +1,144 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/clipboard_controller.ts
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeTimeout = class extends TimerRegistry {
+  /**
+   * Schedules `callback` after `delay` ms and returns the timer id.
+   *
+   * The id is removed from the registry automatically when the timeout fires,
+   * so {@link TimerRegistry.size | size} reflects only still-pending timers.
+   */
+  set(callback, delay) {
+    const id = this.schedule(() => {
+      this.ids.delete(id);
+      callback();
+    }, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setTimeout(callback, delay);
+  }
+  cancel(id) {
+    window.clearTimeout(id);
+  }
+};
+
+// src/controllers/clipboard_controller.ts
+var ClipboardController = class extends Controller {
+  static targets = ["source", "button", "feedback"];
+  static values = {
+    text: { type: String, default: "" },
+    feedbackDuration: { type: Number, default: 2e3 },
+    copiedLabel: { type: String, default: "Copied" },
+    errorLabel: { type: String, default: "Copy failed" }
+  };
+  static actions = ["copy"];
+  static events = ["copy"];
+  /** Auto-clear timer for the completion notice; torn down on disconnect. */
+  #timers = new SafeTimeout();
+  /**
+   * The pending auto-clear timer id, or `null` when none is scheduled. Tracked so
+   * a rapid second copy cancels the first window instead of letting a stale timer
+   * reset the freshly-shown notice early.
+   */
+  #resetTimerId = null;
+  connect() {
+    if (!this.element.hasAttribute("data-state")) {
+      this.element.setAttribute("data-state", "idle");
+    }
+  }
+  disconnect() {
+    this.#timers.clearAll();
+  }
+  /**
+   * Copies the resolved text and reports the outcome. Bound via `data-action`
+   * (click). Always dispatches `stimeo--clipboard:copy` with `{ success, text }`
+   * — including on failure — so consumers can react either way.
+   */
+  async copy() {
+    const text = this.#resolveText();
+    let success = false;
+    try {
+      if (!navigator.clipboard?.writeText) throw new Error("Clipboard API unavailable");
+      await navigator.clipboard.writeText(text);
+      success = true;
+    } catch {
+      success = false;
+    }
+    this.#reportResult(success);
+    this.dispatch("copy", { detail: { success, text } });
+  }
+  /**
+   * The text to copy: the explicit `text` value when set, otherwise the source
+   * target's current value (inputs/textareas) or text content.
+   */
+  #resolveText() {
+    if (this.textValue.length > 0) return this.textValue;
+    if (!this.hasSourceTarget) return "";
+    const source = this.sourceTarget;
+    if (source instanceof HTMLInputElement || source instanceof HTMLTextAreaElement) {
+      return source.value;
+    }
+    return source.textContent ?? "";
+  }
+  /** Reflects the result on `data-state`, announces it, and schedules a reset. */
+  #reportResult(success) {
+    this.element.setAttribute("data-state", success ? "copied" : "error");
+    if (this.hasFeedbackTarget) {
+      this.feedbackTarget.textContent = success ? this.copiedLabelValue : this.errorLabelValue;
+    }
+    if (this.#resetTimerId !== null) {
+      this.#timers.clear(this.#resetTimerId);
+      this.#resetTimerId = null;
+    }
+    if (this.feedbackDurationValue > 0) {
+      this.#resetTimerId = this.#timers.set(() => {
+        this.#resetTimerId = null;
+        this.#reset();
+      }, this.feedbackDurationValue);
+    }
+  }
+  /** Returns to the idle state and clears the completion notice. */
+  #reset() {
+    this.element.setAttribute("data-state", "idle");
+    if (this.hasFeedbackTarget) {
+      this.feedbackTarget.textContent = "";
+    }
+  }
+};
+
+export { ClipboardController };
+//# sourceMappingURL=clipboard_controller.js.map
+//# sourceMappingURL=clipboard_controller.js.map