stimeo-ui 0.1.0-alpha.1

package/dist/controllers/transition_controller.js

@@ -0,0 +1,203 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/transition_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/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: "" },
+    enterFrom: { type: String, default: "" },
+    enterTo: { type: String, default: "" },
+    leave: { type: String, default: "" },
+    leaveFrom: { type: String, default: "" },
+    leaveTo: { type: String, default: "" },
+    timeout: { type: Number, default: 0 }
+  };
+  static actions = ["enter", "leave", "toggle"];
+  static events = ["entered", "left"];
+  #timers = new SafeTimeout();
+  #rafId = null;
+  #endListener = null;
+  connect() {
+    this.#strip();
+    this.element.setAttribute("data-transition-state", this.element.hidden ? "left" : "entered");
+  }
+  disconnect() {
+    this.#cancel();
+  }
+  /** Shows the element with the enter transition. */
+  enter() {
+    this.#run("enter");
+  }
+  /** Hides the element with the leave transition. */
+  leave() {
+    this.#run("leave");
+  }
+  /** Reverses the current direction (enter when hidden/leaving, else leave). */
+  toggle() {
+    const state = this.element.getAttribute("data-transition-state");
+    if (state === "entered" || state === "entering") this.leave();
+    else this.enter();
+  }
+  #run(kind) {
+    this.#cancel();
+    const isEnter = kind === "enter";
+    if (isEnter) this.element.hidden = false;
+    this.element.setAttribute("data-transition-state", isEnter ? "entering" : "leaving");
+    if (this.#prefersReducedMotion()) {
+      this.#finish(kind);
+      return;
+    }
+    const base = isEnter ? this.enterValue : this.leaveValue;
+    const from = isEnter ? this.enterFromValue : this.leaveFromValue;
+    const to = isEnter ? this.enterToValue : this.leaveToValue;
+    this.#add(base, from);
+    this.#rafId = this.#raf(() => {
+      this.#rafId = null;
+      this.#remove(from);
+      this.#add(to);
+      this.#awaitEnd(() => this.#finish(kind));
+    });
+  }
+  /** 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");
+      this.dispatch("entered", { detail: {} });
+    } else {
+      this.element.hidden = true;
+      this.element.setAttribute("data-transition-state", "left");
+      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.#strip();
+  }
+  #add(...lists) {
+    const tokens = lists.flatMap(tokensOf);
+    if (tokens.length > 0) this.element.classList.add(...tokens);
+  }
+  #remove(...lists) {
+    const tokens = lists.flatMap(tokensOf);
+    if (tokens.length > 0) this.element.classList.remove(...tokens);
+  }
+  /** Removes every stage class so no half-applied state lingers. */
+  #strip() {
+    this.#remove(
+      this.enterValue,
+      this.enterFromValue,
+      this.enterToValue,
+      this.leaveValue,
+      this.leaveFromValue,
+      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());
+    }
+    return window.setTimeout(callback, 0);
+  }
+  #cancelRaf(id) {
+    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 };
+//# sourceMappingURL=transition_controller.js.map
+//# sourceMappingURL=transition_controller.js.map

package/dist/controllers/transition_controller.js.map

@@ -0,0 +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"]}