stimeo-ui 0.1.0-alpha.1

package/dist/controllers/countdown_controller.d.ts

@@ -0,0 +1,93 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless countdown/timer behavior built on the live-region `role="timer"`
+ * practice (no dedicated APG pattern).
+ *
+ * Markup contract (identifier: `stimeo--countdown`):
+ *   <div data-controller="stimeo--countdown" role="timer" aria-live="off"
+ *        data-stimeo--countdown-deadline-value="2026-12-31T23:59:59+09:00"
+ *        data-action="countdown:pause->stimeo--countdown#pause
+ *                     countdown:resume->stimeo--countdown#resume">
+ *     <span data-stimeo--countdown-target="days">0</span>
+ *     <span data-stimeo--countdown-target="hours">00</span>
+ *     <span data-stimeo--countdown-target="minutes">00</span>
+ *     <span data-stimeo--countdown-target="seconds">00</span>
+ *   </div>
+ *
+ * Computes the time remaining to `deadline` (or elapsed since it, in
+ * `direction="up"`), formats it into the day/hour/minute/second slots, and ticks
+ * on `interval`. `aria-live="off"` is recommended so the timer is not announced
+ * every second; only the milestone (completion) is surfaced — via the optional
+ * `status` live region when a `completeLabel` is provided, or the `complete`
+ * event for the consumer to handle.
+ *
+ * @remarks
+ * Behavior only — slot text is updated, not styled. Pause/resume shifts an
+ * internal time anchor so the displayed amount is preserved across a pause. The
+ * interval is owned by {@link SafeInterval} and torn down on `disconnect()`
+ * (Turbo navigation included).
+ */
+declare class CountdownController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        deadline: {
+            type: StringConstructor;
+            default: string;
+        };
+        interval: {
+            type: NumberConstructor;
+            default: number;
+        };
+        direction: {
+            type: StringConstructor;
+            default: string;
+        };
+        autostart: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        completeLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["pause", "reset", "resume", "start"];
+    static events: readonly ["complete", "tick"];
+    readonly daysTarget: HTMLElement;
+    readonly hoursTarget: HTMLElement;
+    readonly minutesTarget: HTMLElement;
+    readonly secondsTarget: HTMLElement;
+    readonly statusTarget: HTMLElement;
+    readonly hasDaysTarget: boolean;
+    readonly hasHoursTarget: boolean;
+    readonly hasMinutesTarget: boolean;
+    readonly hasSecondsTarget: boolean;
+    readonly hasStatusTarget: boolean;
+    deadlineValue: string;
+    intervalValue: number;
+    directionValue: string;
+    autostartValue: boolean;
+    completeLabelValue: string;
+    connect(): void;
+    disconnect(): void;
+    /** Starts (or restarts after pause) ticking toward the deadline. */
+    start(): void;
+    /** Pauses ticking, preserving the currently displayed amount. */
+    pause(): void;
+    /** Resumes from a pause, continuing from the preserved amount. */
+    resume(): void;
+    /**
+     * Re-syncs to the deadline and clears any pause offset, **preserving the current
+     * run state**: a running timer keeps counting down from the reset amount, while a
+     * paused (or completed) one resets the displayed amount but stays paused until the
+     * user resumes — it never silently restarts. The run state is read from the DOM,
+     * not re-derived from the declarative `autostart` Value (which only governs the
+     * initial state on connect); re-deriving it would override a user's pause, the same
+     * anti-pattern the Turbo-lifecycle guide warns about.
+     */
+    reset(): void;
+}
+
+export { CountdownController };

package/dist/controllers/countdown_controller.js

@@ -0,0 +1,202 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/countdown_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 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/countdown_controller.ts
+var CountdownController = class extends Controller {
+  static targets = ["days", "hours", "minutes", "seconds", "status"];
+  static values = {
+    deadline: { type: String, default: "" },
+    interval: { type: Number, default: 1e3 },
+    direction: { type: String, default: "down" },
+    autostart: { type: Boolean, default: true },
+    completeLabel: { type: String, default: "" }
+  };
+  static actions = ["pause", "reset", "resume", "start"];
+  static events = ["complete", "tick"];
+  #intervals = new SafeInterval();
+  #intervalId = null;
+  /** Epoch-ms anchor: the deadline (down) or the count-up origin (up). */
+  #reference = 0;
+  /** Amount (ms) captured at pause, so resume can restore the same display. */
+  #pausedAmount = 0;
+  connect() {
+    this.#initReference();
+    this.#render(this.#currentAmount());
+    if (this.autostartValue && this.#isValidDeadline) {
+      this.start();
+    } else {
+      this.element.setAttribute("data-state", "paused");
+    }
+  }
+  disconnect() {
+    this.#intervals.clearAll();
+    this.#intervalId = null;
+  }
+  /** Starts (or restarts after pause) ticking toward the deadline. */
+  start() {
+    if (this.#state === "running" || !this.#isValidDeadline) return;
+    if (this.#isDown && this.#currentAmount() <= 0) {
+      this.#complete();
+      return;
+    }
+    this.#runInterval();
+  }
+  /** Pauses ticking, preserving the currently displayed amount. */
+  pause() {
+    if (this.#state !== "running") return;
+    this.#pausedAmount = this.#currentAmount();
+    this.#teardownInterval();
+    this.element.setAttribute("data-state", "paused");
+  }
+  /** Resumes from a pause, continuing from the preserved amount. */
+  resume() {
+    if (this.#state !== "paused" || !this.#isValidDeadline) return;
+    const now = Date.now();
+    this.#reference = this.#isDown ? now + this.#pausedAmount : now - this.#pausedAmount;
+    this.start();
+  }
+  /**
+   * Re-syncs to the deadline and clears any pause offset, **preserving the current
+   * run state**: a running timer keeps counting down from the reset amount, while a
+   * paused (or completed) one resets the displayed amount but stays paused until the
+   * user resumes — it never silently restarts. The run state is read from the DOM,
+   * not re-derived from the declarative `autostart` Value (which only governs the
+   * initial state on connect); re-deriving it would override a user's pause, the same
+   * anti-pattern the Turbo-lifecycle guide warns about.
+   */
+  reset() {
+    const wasRunning = this.#state === "running";
+    this.#teardownInterval();
+    this.#initReference();
+    const amount = this.#currentAmount();
+    this.#render(amount);
+    if (this.hasStatusTarget) this.statusTarget.textContent = "";
+    this.element.setAttribute("data-state", "paused");
+    if (wasRunning && this.#isValidDeadline) {
+      this.#pausedAmount = 0;
+      this.start();
+    } else {
+      this.#pausedAmount = amount;
+    }
+  }
+  /** Schedules the repeating tick and marks the timer running. */
+  #runInterval() {
+    this.element.setAttribute("data-state", "running");
+    this.#intervalId = this.#intervals.set(() => this.#tick(), this.intervalValue);
+  }
+  /** Cancels the repeating tick, if any. */
+  #teardownInterval() {
+    if (this.#intervalId !== null) {
+      this.#intervals.clear(this.#intervalId);
+      this.#intervalId = null;
+    }
+  }
+  /** Recomputes, renders, emits `tick`, and completes when a countdown hits 0. */
+  #tick() {
+    const amount = this.#currentAmount();
+    this.#render(amount);
+    this.dispatch("tick", {
+      detail: { remaining: amount, direction: this.#isDown ? "down" : "up" }
+    });
+    if (this.#isDown && this.#reference - Date.now() <= 0) {
+      this.#complete();
+    }
+  }
+  /** Stops at zero, marks completion, announces it, and emits `complete`. */
+  #complete() {
+    this.#teardownInterval();
+    this.#render(0);
+    this.element.setAttribute("data-state", "complete");
+    if (this.hasStatusTarget && this.completeLabelValue.length > 0) {
+      this.statusTarget.textContent = this.completeLabelValue;
+    }
+    this.dispatch("complete", { detail: {} });
+  }
+  /** Sets the time anchor from the `deadline` value. */
+  #initReference() {
+    this.#reference = Date.parse(this.deadlineValue);
+  }
+  /** Remaining (down) or elapsed (up) ms, never negative. */
+  #currentAmount() {
+    if (!this.#isValidDeadline) return 0;
+    const now = Date.now();
+    const raw = this.#isDown ? this.#reference - now : now - this.#reference;
+    return Math.max(0, raw);
+  }
+  /** Writes the amount into the day/hour/minute/second slots. */
+  #render(amount) {
+    const totalSeconds = Math.floor(amount / 1e3);
+    const days = Math.floor(totalSeconds / 86400);
+    const hours = Math.floor(totalSeconds % 86400 / 3600);
+    const minutes = Math.floor(totalSeconds % 3600 / 60);
+    const seconds = totalSeconds % 60;
+    if (this.hasDaysTarget) this.daysTarget.textContent = String(days);
+    if (this.hasHoursTarget) this.hoursTarget.textContent = this.#pad(hours);
+    if (this.hasMinutesTarget) this.minutesTarget.textContent = this.#pad(minutes);
+    if (this.hasSecondsTarget) this.secondsTarget.textContent = this.#pad(seconds);
+  }
+  /** Zero-pads a unit to two digits. */
+  #pad(unit) {
+    return String(unit).padStart(2, "0");
+  }
+  get #isDown() {
+    return this.directionValue !== "up";
+  }
+  get #isValidDeadline() {
+    return !Number.isNaN(this.#reference);
+  }
+  /** Current lifecycle phase as reflected on `data-state`. */
+  get #state() {
+    return this.element.getAttribute("data-state") ?? "paused";
+  }
+};
+
+export { CountdownController };
+//# sourceMappingURL=countdown_controller.js.map
+//# sourceMappingURL=countdown_controller.js.map

package/dist/controllers/countdown_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/countdown_controller.ts"],"names":[],"mappings":"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","file":"countdown_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 { SafeInterval } from \"../utils/safe_timeout\";\n\n/**\n * Headless countdown/timer behavior built on the live-region `role=\"timer\"`\n * practice (no dedicated APG pattern).\n *\n * Markup contract (identifier: `stimeo--countdown`):\n *   <div data-controller=\"stimeo--countdown\" role=\"timer\" aria-live=\"off\"\n *        data-stimeo--countdown-deadline-value=\"2026-12-31T23:59:59+09:00\"\n *        data-action=\"countdown:pause->stimeo--countdown#pause\n *                     countdown:resume->stimeo--countdown#resume\">\n *     <span data-stimeo--countdown-target=\"days\">0</span>\n *     <span data-stimeo--countdown-target=\"hours\">00</span>\n *     <span data-stimeo--countdown-target=\"minutes\">00</span>\n *     <span data-stimeo--countdown-target=\"seconds\">00</span>\n *   </div>\n *\n * Computes the time remaining to `deadline` (or elapsed since it, in\n * `direction=\"up\"`), formats it into the day/hour/minute/second slots, and ticks\n * on `interval`. `aria-live=\"off\"` is recommended so the timer is not announced\n * every second; only the milestone (completion) is surfaced — via the optional\n * `status` live region when a `completeLabel` is provided, or the `complete`\n * event for the consumer to handle.\n *\n * @remarks\n * Behavior only — slot text is updated, not styled. Pause/resume shifts an\n * internal time anchor so the displayed amount is preserved across a pause. The\n * interval is owned by {@link SafeInterval} and torn down on `disconnect()`\n * (Turbo navigation included).\n */\nexport class CountdownController extends Controller<HTMLElement> {\n  static override targets = [\"days\", \"hours\", \"minutes\", \"seconds\", \"status\"];\n  static override values = {\n    deadline: { type: String, default: \"\" },\n    interval: { type: Number, default: 1000 },\n    direction: { type: String, default: \"down\" },\n    autostart: { type: Boolean, default: true },\n    completeLabel: { type: String, default: \"\" },\n  };\n  static actions = [\"pause\", \"reset\", \"resume\", \"start\"] as const;\n  static events = [\"complete\", \"tick\"] as const;\n\n  declare readonly daysTarget: HTMLElement;\n  declare readonly hoursTarget: HTMLElement;\n  declare readonly minutesTarget: HTMLElement;\n  declare readonly secondsTarget: HTMLElement;\n  declare readonly statusTarget: HTMLElement;\n  declare readonly hasDaysTarget: boolean;\n  declare readonly hasHoursTarget: boolean;\n  declare readonly hasMinutesTarget: boolean;\n  declare readonly hasSecondsTarget: boolean;\n  declare readonly hasStatusTarget: boolean;\n\n  declare deadlineValue: string;\n  declare intervalValue: number;\n  declare directionValue: string;\n  declare autostartValue: boolean;\n  declare completeLabelValue: string;\n\n  readonly #intervals = new SafeInterval();\n  #intervalId: number | null = null;\n\n  /** Epoch-ms anchor: the deadline (down) or the count-up origin (up). */\n  #reference = 0;\n  /** Amount (ms) captured at pause, so resume can restore the same display. */\n  #pausedAmount = 0;\n\n  override connect(): void {\n    this.#initReference();\n    this.#render(this.#currentAmount());\n    if (this.autostartValue && this.#isValidDeadline) {\n      this.start();\n    } else {\n      this.element.setAttribute(\"data-state\", \"paused\");\n    }\n  }\n\n  override disconnect(): void {\n    this.#intervals.clearAll();\n    this.#intervalId = null;\n  }\n\n  /** Starts (or restarts after pause) ticking toward the deadline. */\n  start(): void {\n    if (this.#state === \"running\" || !this.#isValidDeadline) return;\n    if (this.#isDown && this.#currentAmount() <= 0) {\n      this.#complete();\n      return;\n    }\n    this.#runInterval();\n  }\n\n  /** Pauses ticking, preserving the currently displayed amount. */\n  pause(): void {\n    if (this.#state !== \"running\") return;\n    this.#pausedAmount = this.#currentAmount();\n    this.#teardownInterval();\n    this.element.setAttribute(\"data-state\", \"paused\");\n  }\n\n  /** Resumes from a pause, continuing from the preserved amount. */\n  resume(): void {\n    if (this.#state !== \"paused\" || !this.#isValidDeadline) return;\n    const now = Date.now();\n    this.#reference = this.#isDown ? now + this.#pausedAmount : now - this.#pausedAmount;\n    this.start();\n  }\n\n  /**\n   * Re-syncs to the deadline and clears any pause offset, **preserving the current\n   * run state**: a running timer keeps counting down from the reset amount, while a\n   * paused (or completed) one resets the displayed amount but stays paused until the\n   * user resumes — it never silently restarts. The run state is read from the DOM,\n   * not re-derived from the declarative `autostart` Value (which only governs the\n   * initial state on connect); re-deriving it would override a user's pause, the same\n   * anti-pattern the Turbo-lifecycle guide warns about.\n   */\n  reset(): void {\n    const wasRunning = this.#state === \"running\";\n    this.#teardownInterval();\n    this.#initReference();\n    const amount = this.#currentAmount();\n    this.#render(amount);\n    // A prior complete() may have written a completion message into the status live\n    // region; clear it so a reset timer does not keep showing (and announcing to a\n    // screen reader) the stale \"finished\" text.\n    if (this.hasStatusTarget) this.statusTarget.textContent = \"\";\n    // teardownInterval() leaves data-state untouched; drop any lingering \"running\" to a\n    // resting \"paused\" so start() (a no-op while \"running\") can re-arm when we resume.\n    this.element.setAttribute(\"data-state\", \"paused\");\n    if (wasRunning && this.#isValidDeadline) {\n      // Was counting down: re-arm and keep running from the reset amount.\n      this.#pausedAmount = 0;\n      this.start();\n    } else {\n      // Was paused/complete: hold at the reset amount and wait for the user to resume.\n      // Remember the amount so resume() restores it instead of snapping the anchor to 0.\n      this.#pausedAmount = amount;\n    }\n  }\n\n  /** Schedules the repeating tick and marks the timer running. */\n  #runInterval(): void {\n    this.element.setAttribute(\"data-state\", \"running\");\n    this.#intervalId = this.#intervals.set(() => this.#tick(), this.intervalValue);\n  }\n\n  /** Cancels the repeating tick, if any. */\n  #teardownInterval(): void {\n    if (this.#intervalId !== null) {\n      this.#intervals.clear(this.#intervalId);\n      this.#intervalId = null;\n    }\n  }\n\n  /** Recomputes, renders, emits `tick`, and completes when a countdown hits 0. */\n  #tick(): void {\n    const amount = this.#currentAmount();\n    this.#render(amount);\n    // `remaining` is the displayed amount (time left when counting down, elapsed\n    // when counting up); `direction` lets consumers disambiguate the two.\n    this.dispatch(\"tick\", {\n      detail: { remaining: amount, direction: this.#isDown ? \"down\" : \"up\" },\n    });\n    if (this.#isDown && this.#reference - Date.now() <= 0) {\n      this.#complete();\n    }\n  }\n\n  /** Stops at zero, marks completion, announces it, and emits `complete`. */\n  #complete(): void {\n    this.#teardownInterval();\n    this.#render(0);\n    this.element.setAttribute(\"data-state\", \"complete\");\n    if (this.hasStatusTarget && this.completeLabelValue.length > 0) {\n      this.statusTarget.textContent = this.completeLabelValue;\n    }\n    this.dispatch(\"complete\", { detail: {} });\n  }\n\n  /** Sets the time anchor from the `deadline` value. */\n  #initReference(): void {\n    this.#reference = Date.parse(this.deadlineValue);\n  }\n\n  /** Remaining (down) or elapsed (up) ms, never negative. */\n  #currentAmount(): number {\n    if (!this.#isValidDeadline) return 0;\n    const now = Date.now();\n    const raw = this.#isDown ? this.#reference - now : now - this.#reference;\n    return Math.max(0, raw);\n  }\n\n  /** Writes the amount into the day/hour/minute/second slots. */\n  #render(amount: number): void {\n    const totalSeconds = Math.floor(amount / 1000);\n    const days = Math.floor(totalSeconds / 86400);\n    const hours = Math.floor((totalSeconds % 86400) / 3600);\n    const minutes = Math.floor((totalSeconds % 3600) / 60);\n    const seconds = totalSeconds % 60;\n\n    if (this.hasDaysTarget) this.daysTarget.textContent = String(days);\n    if (this.hasHoursTarget) this.hoursTarget.textContent = this.#pad(hours);\n    if (this.hasMinutesTarget) this.minutesTarget.textContent = this.#pad(minutes);\n    if (this.hasSecondsTarget) this.secondsTarget.textContent = this.#pad(seconds);\n  }\n\n  /** Zero-pads a unit to two digits. */\n  #pad(unit: number): string {\n    return String(unit).padStart(2, \"0\");\n  }\n\n  get #isDown(): boolean {\n    return this.directionValue !== \"up\";\n  }\n\n  get #isValidDeadline(): boolean {\n    return !Number.isNaN(this.#reference);\n  }\n\n  /** Current lifecycle phase as reflected on `data-state`. */\n  get #state(): string {\n    return this.element.getAttribute(\"data-state\") ?? \"paused\";\n  }\n}\n"]}

package/dist/controllers/dialog_controller.d.ts

@@ -0,0 +1,57 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible modal dialog behavior.
+ *
+ * Markup contract (identifier: `stimeo--dialog`):
+ *   <div data-controller="stimeo--dialog">
+ *     <button data-stimeo--dialog-target="trigger"
+ *             data-action="stimeo--dialog#open">Open</button>
+ *     <div data-stimeo--dialog-target="dialog" role="dialog" aria-modal="true"
+ *          aria-labelledby="title" hidden>
+ *       <h2 id="title">…</h2>
+ *       <button data-action="stimeo--dialog#close">Close</button>
+ *     </div>
+ *   </div>
+ *
+ * Implements the WAI-ARIA APG **Dialog (Modal)** pattern: focus moves into the
+ * dialog on open and is trapped within it, `Escape` closes it, background scroll
+ * is locked, and focus returns to the trigger on close.
+ *
+ * @remarks
+ * Behavior only. The sole visual side effect is locking `document.body`'s scroll
+ * while open (the minimum required by the pattern); all other styling is the
+ * consumer's. Clicking the dialog backdrop (the dialog target itself, outside
+ * its content) also closes it.
+ *
+ * The modal lifecycle — focus trap, scroll lock, background `inert`, focus
+ * restore, and teardown reversal — is delegated to the shared {@link FocusTrap}
+ * primitive (also used by alert-dialog and drawer). This controller only owns
+ * *when* to open/close and the dialog-specific backdrop click.
+ */
+declare class DialogController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static actions: readonly ["close", "closeOnBackdrop", "open"];
+    readonly triggerTarget: HTMLElement;
+    readonly dialogTarget: HTMLElement;
+    readonly hasTriggerTarget: boolean;
+    readonly hasDialogTarget: boolean;
+    /** Starts closed (idempotently reflects the closed state on the markup). */
+    connect(): void;
+    /**
+     * Reverts the modal side effects (scroll lock, background `inert`, keydown
+     * listener) if the controller is torn down while open (e.g. a Turbo navigation
+     * replaces the page while the dialog is showing). Focus is not restored on
+     * teardown.
+     */
+    disconnect(): void;
+    /** Opens the dialog, traps focus, and locks background scroll. */
+    open(): void;
+    /** Closes the dialog, restores scroll, and returns focus to the opener. */
+    close(): void;
+    /** Closes when the backdrop (the dialog target itself) is clicked. */
+    closeOnBackdrop(event: MouseEvent): void;
+}
+
+export { DialogController };

package/dist/controllers/dialog_controller.js

@@ -0,0 +1,207 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/dialog_controller.ts
+
+// src/utils/focus_trap.ts
+var FOCUSABLE = 'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
+var FocusTrap = class {
+  /** The element focused before activation, restored on deactivation. */
+  #previouslyFocused = null;
+  /** The body's inline `overflow` before locking, restored on deactivation. */
+  #previousBodyOverflow = "";
+  /** Whether scroll was locked this activation (so it is only restored if applied). */
+  #scrollLocked = false;
+  /** Background siblings made `inert` while active, restored on deactivation. */
+  #inertedSiblings = [];
+  /** Whether the modal side effects are currently applied. */
+  #activeState = false;
+  /** Returns the trapped element; called on every operation for the live target. */
+  #getContainer;
+  /** Closing/focus hooks; see {@link FocusTrapOptions}. */
+  #options;
+  /**
+   * @param getContainer - Returns the trapped element. Called on every operation
+   *   so the live target is always used.
+   * @param options - Closing/focus hooks; see {@link FocusTrapOptions}.
+   */
+  constructor(getContainer, options = {}) {
+    this.#getContainer = getContainer;
+    this.#options = options;
+  }
+  /** Whether the trap is currently active. */
+  get active() {
+    return this.#activeState;
+  }
+  /**
+   * Applies the trap: records the current focus, optionally locks background scroll
+   * and makes background siblings `inert`, listens for `Tab`/`Escape`, and (unless
+   * `autoFocus` is off) moves focus inside. No-ops if already active.
+   */
+  activate() {
+    if (this.#activeState) return;
+    this.#activeState = true;
+    const active = document.activeElement;
+    this.#previouslyFocused = active instanceof HTMLElement && active !== document.body ? active : null;
+    if (this.#flag(this.#options.lockScroll, true)) {
+      this.#previousBodyOverflow = document.body.style.overflow;
+      document.body.style.overflow = "hidden";
+      this.#scrollLocked = true;
+    }
+    if (this.#flag(this.#options.isolate, true)) this.#isolateBackground();
+    document.addEventListener("keydown", this.#onKeydown);
+    if (this.#flag(this.#options.autoFocus, true)) this.#focusInitial();
+  }
+  /**
+   * Reverts every side effect applied by {@link activate}. No-ops if inactive, so
+   * a controller can call it defensively from both `close()` and `disconnect()`.
+   *
+   * @param restoreFocus - Move focus back to the opener (default `true`). Pass
+   *   `false` on teardown (`disconnect`), where yanking focus is undesirable.
+   */
+  deactivate({ restoreFocus = true } = {}) {
+    if (!this.#activeState) return;
+    this.#activeState = false;
+    document.removeEventListener("keydown", this.#onKeydown);
+    if (this.#scrollLocked) {
+      document.body.style.overflow = this.#previousBodyOverflow;
+      this.#scrollLocked = false;
+    }
+    this.#releaseBackground();
+    if (restoreFocus) {
+      const target = this.#previouslyFocused ?? this.#options.fallbackFocus?.() ?? null;
+      target?.focus();
+    }
+  }
+  /** Resolves a boolean-or-getter option, defaulting when it was not provided. */
+  #flag(option, fallback) {
+    if (option === void 0) return fallback;
+    return typeof option === "function" ? option() : option;
+  }
+  /** Handles `Escape` (delegated) and `Tab` (focus trap) while active. */
+  #onKeydown = (event) => {
+    if (event.key === "Escape") {
+      if (this.#options.onEscape) {
+        event.preventDefault();
+        this.#options.onEscape();
+      }
+      return;
+    }
+    if (event.key === "Tab") this.#trapTab(event);
+  };
+  /** Keeps `Tab` focus cycling within the container's focusable elements. */
+  #trapTab(event) {
+    const focusable = this.#focusableElements();
+    if (focusable.length === 0) {
+      event.preventDefault();
+      return;
+    }
+    const first = focusable[0];
+    const last = focusable[focusable.length - 1];
+    const active = document.activeElement;
+    if (!(active instanceof Node) || !this.#getContainer().contains(active)) {
+      event.preventDefault();
+      first?.focus();
+      return;
+    }
+    if (event.shiftKey && active === first) {
+      event.preventDefault();
+      last?.focus();
+    } else if (!event.shiftKey && active === last) {
+      event.preventDefault();
+      first?.focus();
+    }
+  }
+  /**
+   * Marks every element outside the container's subtree as `inert` so background
+   * content cannot be focused or reached by assistive technology, honoring the
+   * `aria-modal="true"` contract. An element that was *already* `inert` is left
+   * untracked so `#releaseBackground` does not wrongly clear it.
+   */
+  #isolateBackground() {
+    const container = this.#getContainer();
+    this.#inertedSiblings = [];
+    for (const sibling of Array.from(document.body.children)) {
+      if (!(sibling instanceof HTMLElement)) continue;
+      if (sibling.contains(container) || sibling.inert) continue;
+      sibling.inert = true;
+      this.#inertedSiblings.push(sibling);
+    }
+  }
+  /** Reverts the `inert` flags applied by `#isolateBackground`. */
+  #releaseBackground() {
+    for (const sibling of this.#inertedSiblings) {
+      sibling.inert = false;
+    }
+    this.#inertedSiblings = [];
+  }
+  /** Moves focus to the initial target, the first focusable, or the container. */
+  #focusInitial() {
+    const preferred = this.#options.initialFocus?.();
+    if (preferred) {
+      preferred.focus();
+      return;
+    }
+    const focusable = this.#focusableElements();
+    if (focusable[0]) {
+      focusable[0].focus();
+      return;
+    }
+    const container = this.#getContainer();
+    container.tabIndex = -1;
+    container.focus();
+  }
+  /** Collects the container's currently focusable descendants in DOM order. */
+  #focusableElements() {
+    return Array.from(this.#getContainer().querySelectorAll(FOCUSABLE)).filter(
+      (el) => !el.hidden
+    );
+  }
+};
+
+// src/controllers/dialog_controller.ts
+var DialogController = class extends Controller {
+  static targets = ["trigger", "dialog"];
+  static actions = ["close", "closeOnBackdrop", "open"];
+  /** Owns the modal side effects; Escape closes, focus falls back to the trigger. */
+  #trap = new FocusTrap(() => this.dialogTarget, {
+    onEscape: () => this.close(),
+    fallbackFocus: () => this.hasTriggerTarget ? this.triggerTarget : null
+  });
+  /** Starts closed (idempotently reflects the closed state on the markup). */
+  connect() {
+    if (this.hasDialogTarget) this.dialogTarget.hidden = true;
+  }
+  /**
+   * Reverts the modal side effects (scroll lock, background `inert`, keydown
+   * listener) if the controller is torn down while open (e.g. a Turbo navigation
+   * replaces the page while the dialog is showing). Focus is not restored on
+   * teardown.
+   */
+  disconnect() {
+    this.#trap.deactivate({ restoreFocus: false });
+  }
+  /** Opens the dialog, traps focus, and locks background scroll. */
+  open() {
+    if (!this.hasDialogTarget || this.#isOpen) return;
+    this.dialogTarget.hidden = false;
+    this.#trap.activate();
+  }
+  /** Closes the dialog, restores scroll, and returns focus to the opener. */
+  close() {
+    if (!this.hasDialogTarget || !this.#isOpen) return;
+    this.dialogTarget.hidden = true;
+    this.#trap.deactivate();
+  }
+  /** Closes when the backdrop (the dialog target itself) is clicked. */
+  closeOnBackdrop(event) {
+    if (event.target === this.dialogTarget) this.close();
+  }
+  /** Whether the dialog is currently visible. */
+  get #isOpen() {
+    return this.hasDialogTarget && !this.dialogTarget.hidden;
+  }
+};
+
+export { DialogController };
+//# sourceMappingURL=dialog_controller.js.map
+//# sourceMappingURL=dialog_controller.js.map

package/dist/controllers/dialog_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/focus_trap.ts","../../src/controllers/dialog_controller.ts"],"names":[],"mappings":"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","file":"dialog_controller.js","sourcesContent":["/**\n * Modal focus-trap primitive shared by the modal-overlay controllers\n * (dialog / alert-dialog / drawer).\n *\n * The WAI-ARIA APG modal pattern is more than \"cycle Tab inside a box\": a modal\n * also locks background scroll, makes the rest of the page `inert` (so assistive\n * technology and pointer/Tab cannot reach it, honoring `aria-modal=\"true\"`),\n * sends focus inside on open, and restores it to the opener on close — and every\n * one of those side effects must be reverted if the element is torn down while\n * open (a Turbo navigation mid-dialog). {@link FocusTrap} owns that whole modal\n * lifecycle so each controller only decides *when* to open/close and *what*\n * \"close\" means.\n *\n * It is intentionally **policy-free about closing**. Escape semantics differ per\n * widget (a plain dialog just closes; an alert-dialog closes *as a cancel* with a\n * reason; a drawer runs an exit transition), so the trap merely forwards Escape\n * to an {@link FocusTrapOptions.onEscape | onEscape} callback and never decides on\n * its own what closing entails.\n *\n * @remarks\n * The container is read through a getter so a controller can hand over a Stimulus\n * target without worrying about when the trap instance is constructed relative to\n * `connect()`.\n */\n\n/**\n * Selector matching the elements considered focusable. Shared by the trap's Tab\n * cycling and by form-validation's invalid-focus delegation.\n */\nexport const FOCUSABLE =\n  'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\n/** Behavior hooks a controller supplies when constructing a {@link FocusTrap}. */\nexport interface FocusTrapOptions {\n  /**\n   * Called when `Escape` is pressed while the trap is active. When omitted,\n   * `Escape` is left alone (the trap never closes itself). The trap calls\n   * `preventDefault()` before invoking it.\n   */\n  onEscape?: () => void;\n  /**\n   * Returns the element to focus when the trap activates. When it returns `null`\n   * (or is omitted), the first focusable descendant is used, falling back to the\n   * container itself (made programmatically focusable with `tabindex=-1`).\n   */\n  initialFocus?: () => HTMLElement | null;\n  /**\n   * Returns the element to focus on deactivation when nothing was focused before\n   * the trap opened (e.g. the trigger). The element focused *before* opening\n   * always takes precedence.\n   */\n  fallbackFocus?: () => HTMLElement | null;\n  /**\n   * Lock background scroll (`body` overflow) while active. Defaults to `true` for\n   * the modal overlays; a lighter focus scope passes `false`. Read on `activate`.\n   */\n  lockScroll?: boolean | (() => boolean);\n  /**\n   * Make background siblings `inert` while active (the `aria-modal` isolation).\n   * Defaults to `true` for the modal overlays; a soft focus scope can opt out so\n   * the background stays reachable while `Tab` still cycles inside. Read on `activate`.\n   */\n  isolate?: boolean | (() => boolean);\n  /**\n   * Move focus inside on `activate`. Defaults to `true`; a focus scope that only\n   * wants the `Tab` boundary (no focus move) passes `false`. Read on `activate`.\n   */\n  autoFocus?: boolean | (() => boolean);\n}\n\n/**\n * Owns the modal side effects (scroll lock, background `inert`, focus trap, focus\n * restore) for a single container, applied on {@link activate} and reverted on\n * {@link deactivate}.\n */\nexport class FocusTrap {\n  /** The element focused before activation, restored on deactivation. */\n  #previouslyFocused: HTMLElement | null = null;\n  /** The body's inline `overflow` before locking, restored on deactivation. */\n  #previousBodyOverflow = \"\";\n  /** Whether scroll was locked this activation (so it is only restored if applied). */\n  #scrollLocked = false;\n  /** Background siblings made `inert` while active, restored on deactivation. */\n  #inertedSiblings: HTMLElement[] = [];\n  /** Whether the modal side effects are currently applied. */\n  #activeState = false;\n\n  /** Returns the trapped element; called on every operation for the live target. */\n  readonly #getContainer: () => HTMLElement;\n  /** Closing/focus hooks; see {@link FocusTrapOptions}. */\n  readonly #options: FocusTrapOptions;\n\n  /**\n   * @param getContainer - Returns the trapped element. Called on every operation\n   *   so the live target is always used.\n   * @param options - Closing/focus hooks; see {@link FocusTrapOptions}.\n   */\n  constructor(getContainer: () => HTMLElement, options: FocusTrapOptions = {}) {\n    this.#getContainer = getContainer;\n    this.#options = options;\n  }\n\n  /** Whether the trap is currently active. */\n  get active(): boolean {\n    return this.#activeState;\n  }\n\n  /**\n   * Applies the trap: records the current focus, optionally locks background scroll\n   * and makes background siblings `inert`, listens for `Tab`/`Escape`, and (unless\n   * `autoFocus` is off) moves focus inside. No-ops if already active.\n   */\n  activate(): void {\n    if (this.#activeState) return;\n    this.#activeState = true;\n    // Record the opener so it can be refocused on close. `<body>` (the default\n    // active element when nothing is focused) is treated as \"nothing\", so the\n    // fallback target — typically the trigger — wins in that case.\n    const active = document.activeElement;\n    this.#previouslyFocused =\n      active instanceof HTMLElement && active !== document.body ? active : null;\n    if (this.#flag(this.#options.lockScroll, true)) {\n      this.#previousBodyOverflow = document.body.style.overflow;\n      document.body.style.overflow = \"hidden\";\n      this.#scrollLocked = true;\n    }\n    if (this.#flag(this.#options.isolate, true)) this.#isolateBackground();\n    document.addEventListener(\"keydown\", this.#onKeydown);\n    if (this.#flag(this.#options.autoFocus, true)) this.#focusInitial();\n  }\n\n  /**\n   * Reverts every side effect applied by {@link activate}. No-ops if inactive, so\n   * a controller can call it defensively from both `close()` and `disconnect()`.\n   *\n   * @param restoreFocus - Move focus back to the opener (default `true`). Pass\n   *   `false` on teardown (`disconnect`), where yanking focus is undesirable.\n   */\n  deactivate({ restoreFocus = true }: { restoreFocus?: boolean } = {}): void {\n    if (!this.#activeState) return;\n    this.#activeState = false;\n    document.removeEventListener(\"keydown\", this.#onKeydown);\n    if (this.#scrollLocked) {\n      document.body.style.overflow = this.#previousBodyOverflow;\n      this.#scrollLocked = false;\n    }\n    this.#releaseBackground();\n    if (restoreFocus) {\n      const target = this.#previouslyFocused ?? this.#options.fallbackFocus?.() ?? null;\n      target?.focus();\n    }\n  }\n\n  /** Resolves a boolean-or-getter option, defaulting when it was not provided. */\n  #flag(option: boolean | (() => boolean) | undefined, fallback: boolean): boolean {\n    if (option === undefined) return fallback;\n    return typeof option === \"function\" ? option() : option;\n  }\n\n  /** Handles `Escape` (delegated) and `Tab` (focus trap) while active. */\n  readonly #onKeydown = (event: KeyboardEvent): void => {\n    if (event.key === \"Escape\") {\n      if (this.#options.onEscape) {\n        event.preventDefault();\n        this.#options.onEscape();\n      }\n      return;\n    }\n    if (event.key === \"Tab\") this.#trapTab(event);\n  };\n\n  /** Keeps `Tab` focus cycling within the container's focusable elements. */\n  #trapTab(event: KeyboardEvent): void {\n    const focusable = this.#focusableElements();\n    if (focusable.length === 0) {\n      event.preventDefault();\n      return;\n    }\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    const active = document.activeElement;\n\n    // If focus has somehow escaped the container, pull it back to the first item.\n    if (!(active instanceof Node) || !this.#getContainer().contains(active)) {\n      event.preventDefault();\n      first?.focus();\n      return;\n    }\n\n    if (event.shiftKey && active === first) {\n      event.preventDefault();\n      last?.focus();\n    } else if (!event.shiftKey && active === last) {\n      event.preventDefault();\n      first?.focus();\n    }\n  }\n\n  /**\n   * Marks every element outside the container's subtree as `inert` so background\n   * content cannot be focused or reached by assistive technology, honoring the\n   * `aria-modal=\"true\"` contract. An element that was *already* `inert` is left\n   * untracked so `#releaseBackground` does not wrongly clear it.\n   */\n  #isolateBackground(): void {\n    const container = this.#getContainer();\n    this.#inertedSiblings = [];\n    for (const sibling of Array.from(document.body.children)) {\n      if (!(sibling instanceof HTMLElement)) continue;\n      if (sibling.contains(container) || sibling.inert) continue;\n      sibling.inert = true;\n      this.#inertedSiblings.push(sibling);\n    }\n  }\n\n  /** Reverts the `inert` flags applied by `#isolateBackground`. */\n  #releaseBackground(): void {\n    for (const sibling of this.#inertedSiblings) {\n      sibling.inert = false;\n    }\n    this.#inertedSiblings = [];\n  }\n\n  /** Moves focus to the initial target, the first focusable, or the container. */\n  #focusInitial(): void {\n    const preferred = this.#options.initialFocus?.();\n    if (preferred) {\n      preferred.focus();\n      return;\n    }\n    const focusable = this.#focusableElements();\n    if (focusable[0]) {\n      focusable[0].focus();\n      return;\n    }\n    const container = this.#getContainer();\n    container.tabIndex = -1;\n    container.focus();\n  }\n\n  /** Collects the container's currently focusable descendants in DOM order. */\n  #focusableElements(): HTMLElement[] {\n    return Array.from(this.#getContainer().querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n      (el) => !el.hidden,\n    );\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { FocusTrap } from \"../utils/focus_trap\";\n\n/**\n * Headless, accessible modal dialog behavior.\n *\n * Markup contract (identifier: `stimeo--dialog`):\n *   <div data-controller=\"stimeo--dialog\">\n *     <button data-stimeo--dialog-target=\"trigger\"\n *             data-action=\"stimeo--dialog#open\">Open</button>\n *     <div data-stimeo--dialog-target=\"dialog\" role=\"dialog\" aria-modal=\"true\"\n *          aria-labelledby=\"title\" hidden>\n *       <h2 id=\"title\">…</h2>\n *       <button data-action=\"stimeo--dialog#close\">Close</button>\n *     </div>\n *   </div>\n *\n * Implements the WAI-ARIA APG **Dialog (Modal)** pattern: focus moves into the\n * dialog on open and is trapped within it, `Escape` closes it, background scroll\n * is locked, and focus returns to the trigger on close.\n *\n * @remarks\n * Behavior only. The sole visual side effect is locking `document.body`'s scroll\n * while open (the minimum required by the pattern); all other styling is the\n * consumer's. Clicking the dialog backdrop (the dialog target itself, outside\n * its content) also closes it.\n *\n * The modal lifecycle — focus trap, scroll lock, background `inert`, focus\n * restore, and teardown reversal — is delegated to the shared {@link FocusTrap}\n * primitive (also used by alert-dialog and drawer). This controller only owns\n * *when* to open/close and the dialog-specific backdrop click.\n */\nexport class DialogController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"dialog\"];\n  static actions = [\"close\", \"closeOnBackdrop\", \"open\"] as const;\n\n  declare readonly triggerTarget: HTMLElement;\n  declare readonly dialogTarget: HTMLElement;\n  declare readonly hasTriggerTarget: boolean;\n  declare readonly hasDialogTarget: boolean;\n\n  /** Owns the modal side effects; Escape closes, focus falls back to the trigger. */\n  readonly #trap = new FocusTrap(() => this.dialogTarget, {\n    onEscape: () => this.close(),\n    fallbackFocus: () => (this.hasTriggerTarget ? this.triggerTarget : null),\n  });\n\n  /** Starts closed (idempotently reflects the closed state on the markup). */\n  override connect(): void {\n    if (this.hasDialogTarget) this.dialogTarget.hidden = true;\n  }\n\n  /**\n   * Reverts the modal side effects (scroll lock, background `inert`, keydown\n   * listener) if the controller is torn down while open (e.g. a Turbo navigation\n   * replaces the page while the dialog is showing). Focus is not restored on\n   * teardown.\n   */\n  override disconnect(): void {\n    this.#trap.deactivate({ restoreFocus: false });\n  }\n\n  /** Opens the dialog, traps focus, and locks background scroll. */\n  open(): void {\n    if (!this.hasDialogTarget || this.#isOpen) return;\n    this.dialogTarget.hidden = false;\n    this.#trap.activate();\n  }\n\n  /** Closes the dialog, restores scroll, and returns focus to the opener. */\n  close(): void {\n    if (!this.hasDialogTarget || !this.#isOpen) return;\n    this.dialogTarget.hidden = true;\n    this.#trap.deactivate();\n  }\n\n  /** Closes when the backdrop (the dialog target itself) is clicked. */\n  closeOnBackdrop(event: MouseEvent): void {\n    if (event.target === this.dialogTarget) this.close();\n  }\n\n  /** Whether the dialog is currently visible. */\n  get #isOpen(): boolean {\n    return this.hasDialogTarget && !this.dialogTarget.hidden;\n  }\n}\n"]}