stimeo-ui 0.1.0-alpha.1

package/dist/controllers/network_status_controller.d.ts

@@ -0,0 +1,49 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless online/offline banner behavior built on the live-region practice (no
+ * dedicated APG pattern).
+ *
+ * Markup contract (identifier: `stimeo--network-status`):
+ *   <div data-controller="stimeo--network-status">
+ *     <div role="alert" hidden data-stimeo--network-status-target="offline">
+ *       You are offline.
+ *     </div>
+ *     <div role="status" hidden data-stimeo--network-status-target="online">
+ *       Back online.
+ *     </div>
+ *   </div>
+ *
+ * Reads `navigator.onLine` on connect and subscribes to the `window`
+ * `online`/`offline` events, toggling the matching banner. The offline banner is
+ * `role="alert"` (assertive) because losing connectivity is urgent; the recovery
+ * banner is `role="status"` (polite).
+ *
+ * @remarks
+ * Behavior only. `navigator.onLine` is the browser's *guess* — it does not
+ * guarantee server reachability, which stays the consumer's job. To make the
+ * announcement reliable across assistive tech (merely un-hiding a static banner
+ * is flaky), the controller re-writes the banner's text on each transition,
+ * guarded so an unchanged state never re-announces. The event listeners and the
+ * auto-hide timer are removed/cleared on `disconnect()` (Turbo included).
+ */
+declare class NetworkStatusController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        onlineAutoHide: {
+            type: NumberConstructor;
+            default: number;
+        };
+    };
+    static events: readonly ["change"];
+    readonly offlineTarget: HTMLElement;
+    readonly onlineTarget: HTMLElement;
+    readonly hasOfflineTarget: boolean;
+    readonly hasOnlineTarget: boolean;
+    onlineAutoHideValue: number;
+    connect(): void;
+    disconnect(): void;
+}
+
+export { NetworkStatusController };

package/dist/controllers/network_status_controller.js

@@ -0,0 +1,126 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/network_status_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/network_status_controller.ts
+var NetworkStatusController = class extends Controller {
+  static targets = ["offline", "online"];
+  static values = {
+    onlineAutoHide: { type: Number, default: 0 }
+  };
+  static events = ["change"];
+  #timers = new SafeTimeout();
+  /** Last known connectivity; guards against duplicate-state re-announcements. */
+  #online = true;
+  /** Banner text captured from the markup so transitions can re-write it. */
+  #offlineMessage = "";
+  #onlineMessage = "";
+  #handleOnline = () => this.#update(true);
+  #handleOffline = () => this.#update(false);
+  connect() {
+    this.#offlineMessage = this.hasOfflineTarget ? (this.offlineTarget.textContent ?? "").trim() : "";
+    this.#onlineMessage = this.hasOnlineTarget ? (this.onlineTarget.textContent ?? "").trim() : "";
+    if (this.hasOfflineTarget) this.offlineTarget.hidden = true;
+    if (this.hasOnlineTarget) this.onlineTarget.hidden = true;
+    this.#online = navigator.onLine;
+    this.element.setAttribute("data-state", this.#online ? "online" : "offline");
+    if (!this.#online) this.#showOffline();
+    window.addEventListener("online", this.#handleOnline);
+    window.addEventListener("offline", this.#handleOffline);
+  }
+  disconnect() {
+    window.removeEventListener("online", this.#handleOnline);
+    window.removeEventListener("offline", this.#handleOffline);
+    this.#timers.clearAll();
+  }
+  /** Applies a connectivity transition, guarded against duplicate states. */
+  #update(online) {
+    if (online === this.#online) return;
+    this.#online = online;
+    this.element.setAttribute("data-state", online ? "online" : "offline");
+    if (online) {
+      this.#showOnline();
+    } else {
+      this.#showOffline();
+    }
+    this.dispatch("change", { detail: { online } });
+  }
+  /** Shows the offline banner and hides the recovery banner. */
+  #showOffline() {
+    this.#timers.clearAll();
+    if (this.hasOnlineTarget) this.onlineTarget.hidden = true;
+    if (this.hasOfflineTarget) {
+      this.offlineTarget.textContent = this.#offlineMessage;
+      this.offlineTarget.hidden = false;
+    }
+  }
+  /** Shows the recovery banner, optionally auto-hiding it after `onlineAutoHide`. */
+  #showOnline() {
+    if (this.hasOfflineTarget) this.offlineTarget.hidden = true;
+    if (!this.hasOnlineTarget) return;
+    this.onlineTarget.textContent = this.#onlineMessage;
+    this.onlineTarget.hidden = false;
+    if (this.onlineAutoHideValue > 0) {
+      this.#timers.set(() => {
+        this.onlineTarget.hidden = true;
+      }, this.onlineAutoHideValue);
+    }
+  }
+};
+
+export { NetworkStatusController };
+//# sourceMappingURL=network_status_controller.js.map
+//# sourceMappingURL=network_status_controller.js.map

package/dist/controllers/network_status_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/network_status_controller.ts"],"names":[],"mappings":"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","file":"network_status_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/**\n * Headless online/offline banner behavior built on the live-region practice (no\n * dedicated APG pattern).\n *\n * Markup contract (identifier: `stimeo--network-status`):\n *   <div data-controller=\"stimeo--network-status\">\n *     <div role=\"alert\" hidden data-stimeo--network-status-target=\"offline\">\n *       You are offline.\n *     </div>\n *     <div role=\"status\" hidden data-stimeo--network-status-target=\"online\">\n *       Back online.\n *     </div>\n *   </div>\n *\n * Reads `navigator.onLine` on connect and subscribes to the `window`\n * `online`/`offline` events, toggling the matching banner. The offline banner is\n * `role=\"alert\"` (assertive) because losing connectivity is urgent; the recovery\n * banner is `role=\"status\"` (polite).\n *\n * @remarks\n * Behavior only. `navigator.onLine` is the browser's *guess* — it does not\n * guarantee server reachability, which stays the consumer's job. To make the\n * announcement reliable across assistive tech (merely un-hiding a static banner\n * is flaky), the controller re-writes the banner's text on each transition,\n * guarded so an unchanged state never re-announces. The event listeners and the\n * auto-hide timer are removed/cleared on `disconnect()` (Turbo included).\n */\nexport class NetworkStatusController extends Controller<HTMLElement> {\n  static override targets = [\"offline\", \"online\"];\n  static override values = {\n    onlineAutoHide: { type: Number, default: 0 },\n  };\n  static events = [\"change\"] as const;\n\n  declare readonly offlineTarget: HTMLElement;\n  declare readonly onlineTarget: HTMLElement;\n  declare readonly hasOfflineTarget: boolean;\n  declare readonly hasOnlineTarget: boolean;\n\n  declare onlineAutoHideValue: number;\n\n  readonly #timers = new SafeTimeout();\n\n  /** Last known connectivity; guards against duplicate-state re-announcements. */\n  #online = true;\n  /** Banner text captured from the markup so transitions can re-write it. */\n  #offlineMessage = \"\";\n  #onlineMessage = \"\";\n\n  readonly #handleOnline = (): void => this.#update(true);\n  readonly #handleOffline = (): void => this.#update(false);\n\n  override connect(): void {\n    this.#offlineMessage = this.hasOfflineTarget\n      ? (this.offlineTarget.textContent ?? \"\").trim()\n      : \"\";\n    this.#onlineMessage = this.hasOnlineTarget ? (this.onlineTarget.textContent ?? \"\").trim() : \"\";\n\n    // Normalize initial visibility so a missing `hidden` in the markup cannot\n    // strand a stale banner (e.g. an offline notice showing while online).\n    if (this.hasOfflineTarget) this.offlineTarget.hidden = true;\n    if (this.hasOnlineTarget) this.onlineTarget.hidden = true;\n\n    this.#online = navigator.onLine;\n    // On connect, surface only the offline state; do not flash a \"back online\"\n    // banner just because the page loaded while connected.\n    this.element.setAttribute(\"data-state\", this.#online ? \"online\" : \"offline\");\n    if (!this.#online) this.#showOffline();\n\n    window.addEventListener(\"online\", this.#handleOnline);\n    window.addEventListener(\"offline\", this.#handleOffline);\n  }\n\n  override disconnect(): void {\n    window.removeEventListener(\"online\", this.#handleOnline);\n    window.removeEventListener(\"offline\", this.#handleOffline);\n    this.#timers.clearAll();\n  }\n\n  /** Applies a connectivity transition, guarded against duplicate states. */\n  #update(online: boolean): void {\n    if (online === this.#online) return;\n    this.#online = online;\n    this.element.setAttribute(\"data-state\", online ? \"online\" : \"offline\");\n    if (online) {\n      this.#showOnline();\n    } else {\n      this.#showOffline();\n    }\n    this.dispatch(\"change\", { detail: { online } });\n  }\n\n  /** Shows the offline banner and hides the recovery banner. */\n  #showOffline(): void {\n    this.#timers.clearAll();\n    if (this.hasOnlineTarget) this.onlineTarget.hidden = true;\n    if (this.hasOfflineTarget) {\n      this.offlineTarget.textContent = this.#offlineMessage;\n      this.offlineTarget.hidden = false;\n    }\n  }\n\n  /** Shows the recovery banner, optionally auto-hiding it after `onlineAutoHide`. */\n  #showOnline(): void {\n    if (this.hasOfflineTarget) this.offlineTarget.hidden = true;\n    if (!this.hasOnlineTarget) return;\n    this.onlineTarget.textContent = this.#onlineMessage;\n    this.onlineTarget.hidden = false;\n    if (this.onlineAutoHideValue > 0) {\n      this.#timers.set(() => {\n        this.onlineTarget.hidden = true;\n      }, this.onlineAutoHideValue);\n    }\n  }\n}\n"]}

package/dist/controllers/number_input_controller.d.ts

@@ -0,0 +1,93 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible number / spin-button behavior.
+ *
+ * Markup contract (identifier: `stimeo--number-input`):
+ *   <div data-controller="stimeo--number-input"
+ *        data-stimeo--number-input-min-value="0"
+ *        data-stimeo--number-input-max-value="100"
+ *        data-stimeo--number-input-step-value="1">
+ *     <button type="button" aria-label="Decrease" tabindex="-1"
+ *             data-stimeo--number-input-target="decrement"
+ *             data-action="click->stimeo--number-input#decrement">−</button>
+ *     <input type="number" min="0" max="100" step="1" value="0"
+ *            data-stimeo--number-input-target="input"
+ *            data-action="change->stimeo--number-input#onInput
+ *                         keydown->stimeo--number-input#onKeydown" />
+ *     <button type="button" aria-label="Increase" tabindex="-1"
+ *             data-stimeo--number-input-target="increment"
+ *             data-action="click->stimeo--number-input#increment">+</button>
+ *   </div>
+ *
+ * Implements the WAI-ARIA APG **Spinbutton** pattern. The arrow/step logic is
+ * fully owned by the controller (not delegated to the browser's native number
+ * stepping) so the behavior is identical for a native `<input type="number">` and
+ * a custom `role="spinbutton"` host, and deterministic under happy-dom.
+ *
+ * @remarks
+ * Behavior only — the consumer styles the field and buttons. The input is the
+ * sole Tab stop; the buttons are `tabindex="-1"` and keep focus on the input
+ * (pointerdown is suppressed), so stepping never moves focus away.
+ *
+ * Behavior provided:
+ * - `ArrowUp`/`ArrowDown` step by `step`; `PageUp`/`PageDown` by `pageStep`
+ *   (default `step × 10`); `Home`/`End` jump to a finite `min`/`max`.
+ * - Increment/decrement buttons step too, and are `disabled` at the bounds (focus
+ *   is returned to the input before a focused button is disabled).
+ * - **Press-and-hold auto-repeat**: holding a step button steps once, then after a
+ *   short delay repeats until release, the bound is reached, or the element
+ *   disconnects. The `click` binding stays the single-step path (a quick click, a
+ *   synthesized/programmatic click, or assistive activation), so a normal click
+ *   never double-steps — the trailing click after a hold is swallowed.
+ * - Typed input is clamped and snapped to the step grid on `change`;
+ *   `stimeo--number-input:change` is dispatched on every committed change.
+ */
+declare class NumberInputController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        min: {
+            type: NumberConstructor;
+            default: number;
+        };
+        max: {
+            type: NumberConstructor;
+            default: number;
+        };
+        step: {
+            type: NumberConstructor;
+            default: number;
+        };
+        pageStep: {
+            type: NumberConstructor;
+            default: number;
+        };
+    };
+    static actions: readonly ["decrement", "increment", "onInput", "onKeydown"];
+    static events: readonly ["change"];
+    readonly inputTarget: HTMLInputElement;
+    readonly hasInputTarget: boolean;
+    readonly incrementTarget: HTMLButtonElement;
+    readonly hasIncrementTarget: boolean;
+    readonly decrementTarget: HTMLButtonElement;
+    readonly hasDecrementTarget: boolean;
+    minValue: number;
+    maxValue: number;
+    stepValue: number;
+    pageStepValue: number;
+    /** Normalizes any initial value and wires the focus/hold pointer guards. */
+    connect(): void;
+    /** Releases the pointer guards and tears down every pending timer and hold state. */
+    disconnect(): void;
+    /** Increases by one step. Bound via `data-action` (click). */
+    increment(): void;
+    /** Decreases by one step. Bound via `data-action` (click). */
+    decrement(): void;
+    /** Clamps and snaps a typed value. Bound via `data-action` (change). */
+    onInput(): void;
+    /** Keyboard stepping per the APG spinbutton model. */
+    onKeydown(event: KeyboardEvent): void;
+}
+
+export { NumberInputController };

package/dist/controllers/number_input_controller.js

@@ -0,0 +1,306 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/number_input_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);
+  }
+};
+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/number_input_controller.ts
+var NumberInputController = class _NumberInputController extends Controller {
+  static targets = ["input", "increment", "decrement"];
+  static values = {
+    min: { type: Number, default: Number.NEGATIVE_INFINITY },
+    max: { type: Number, default: Number.POSITIVE_INFINITY },
+    step: { type: Number, default: 1 },
+    pageStep: { type: Number, default: 0 }
+  };
+  static actions = ["decrement", "increment", "onInput", "onKeydown"];
+  static events = ["change"];
+  /** Delay (ms) a button must be held before auto-repeat starts. */
+  static #HOLD_DELAY_MS = 400;
+  /** Interval (ms) between auto-repeat steps once a hold has started. */
+  static #HOLD_REPEAT_MS = 80;
+  /**
+   * Window (ms) after a hold ends during which the trailing synthetic `click` is
+   * swallowed. A safety net for the (rare) case where that click never arrives
+   * (e.g. the pointer was released off the button): the flag self-clears instead
+   * of poisoning the next legitimate click.
+   */
+  static #SUPPRESS_RESET_MS = 250;
+  /** Aborts the pointer listeners on disconnect so none outlive the element. */
+  #guards = null;
+  /** Timers for the hold delay and the suppress-reset safety net. */
+  #holdTimeouts = new SafeTimeout();
+  /** The running auto-repeat interval (one at a time). */
+  #holdIntervals = new SafeInterval();
+  /** True while a hold is armed/running, making `#stopHold` idempotent. */
+  #holdActive = false;
+  /** True once a hold actually produced a repeated step (vs. a quick click). */
+  #repeatedDuringHold = false;
+  /** True when the next `click` is the trailing one after a hold and must be ignored. */
+  #suppressNextClick = false;
+  /** Normalizes any initial value and wires the focus/hold pointer guards. */
+  connect() {
+    if (!this.hasInputTarget) return;
+    if (this.inputTarget.value.trim() !== "") {
+      this.#write(this.#normalize(this.#currentValue()));
+    } else {
+      this.#updateButtons(this.#currentValue());
+    }
+    this.#guards = new AbortController();
+    const { signal } = this.#guards;
+    if (this.hasIncrementTarget) this.#wireButton(this.incrementTarget, this.stepValue, signal);
+    if (this.hasDecrementTarget) this.#wireButton(this.decrementTarget, -this.stepValue, signal);
+    window.addEventListener("pointerup", this.#stopHold, { signal });
+    window.addEventListener("pointercancel", this.#stopHold, { signal });
+    window.addEventListener("blur", this.#stopHold, { signal });
+  }
+  /** Releases the pointer guards and tears down every pending timer and hold state. */
+  disconnect() {
+    this.#guards?.abort();
+    this.#guards = null;
+    this.#holdActive = false;
+    this.#repeatedDuringHold = false;
+    this.#suppressNextClick = false;
+    this.#holdTimeouts.clearAll();
+    this.#holdIntervals.clearAll();
+  }
+  /** Increases by one step. Bound via `data-action` (click). */
+  increment() {
+    if (this.#consumeSuppressedClick()) return;
+    this.#commit(this.#currentValue() + this.stepValue);
+    this.inputTarget.focus();
+  }
+  /** Decreases by one step. Bound via `data-action` (click). */
+  decrement() {
+    if (this.#consumeSuppressedClick()) return;
+    this.#commit(this.#currentValue() - this.stepValue);
+    this.inputTarget.focus();
+  }
+  /** Clamps and snaps a typed value. Bound via `data-action` (change). */
+  onInput() {
+    if (this.inputTarget.value.trim() === "") return;
+    this.#commit(this.#currentValue());
+  }
+  /** Keyboard stepping per the APG spinbutton model. */
+  onKeydown(event) {
+    const page = this.pageStepValue > 0 ? this.pageStepValue : this.stepValue * 10;
+    let next = null;
+    switch (event.key) {
+      case "ArrowUp":
+        next = this.#currentValue() + this.stepValue;
+        break;
+      case "ArrowDown":
+        next = this.#currentValue() - this.stepValue;
+        break;
+      case "PageUp":
+        next = this.#currentValue() + page;
+        break;
+      case "PageDown":
+        next = this.#currentValue() - page;
+        break;
+      case "Home":
+        if (!Number.isFinite(this.minValue)) return;
+        next = this.minValue;
+        break;
+      case "End":
+        if (!Number.isFinite(this.maxValue)) return;
+        next = this.maxValue;
+        break;
+      default:
+        return;
+    }
+    event.preventDefault();
+    this.#commit(next);
+  }
+  /**
+   * Wires a step button: `pointerdown` keeps focus on the input and arms the
+   * hold; leaving the button while held stops it (the global listeners cover
+   * release/cancel/blur).
+   */
+  #wireButton(button, delta, signal) {
+    button.addEventListener("pointerdown", (event) => this.#armHold(event, button, delta), {
+      signal
+    });
+    button.addEventListener("pointerleave", this.#stopHold, { signal });
+  }
+  /** Starts a hold: focus the input, then schedule the first repeat after a delay. */
+  #armHold(event, button, delta) {
+    const pointerButton = event.button;
+    if (typeof pointerButton === "number" && pointerButton !== 0) return;
+    if (button.disabled) return;
+    event.preventDefault();
+    this.inputTarget.focus();
+    this.#stopHold();
+    this.#holdActive = true;
+    this.#repeatedDuringHold = false;
+    this.#suppressNextClick = false;
+    this.#holdTimeouts.set(() => {
+      if (!this.#commit(this.#currentValue() + delta)) {
+        this.#stopHold();
+        return;
+      }
+      this.#repeatedDuringHold = true;
+      this.#holdIntervals.set(() => {
+        if (!this.#commit(this.#currentValue() + delta)) this.#stopHold();
+      }, _NumberInputController.#HOLD_REPEAT_MS);
+    }, _NumberInputController.#HOLD_DELAY_MS);
+  }
+  /**
+   * Stops the current hold (idempotent). When the hold actually repeated, the
+   * trailing synthetic `click` must be ignored, so it is suppressed until the
+   * click consumes it or a short safety-net timeout clears it.
+   */
+  #stopHold = () => {
+    if (!this.#holdActive) return;
+    this.#holdActive = false;
+    this.#holdTimeouts.clearAll();
+    this.#holdIntervals.clearAll();
+    if (this.#repeatedDuringHold) {
+      this.#suppressNextClick = true;
+      this.#holdTimeouts.set(() => {
+        this.#suppressNextClick = false;
+      }, _NumberInputController.#SUPPRESS_RESET_MS);
+    }
+  };
+  /** Consumes a pending trailing-click suppression; returns true if the click was swallowed. */
+  #consumeSuppressedClick() {
+    if (!this.#suppressNextClick) return false;
+    this.#suppressNextClick = false;
+    this.#holdTimeouts.clearAll();
+    return true;
+  }
+  /**
+   * Normalizes `raw`, reflects it, and dispatches `change` only when the
+   * displayed value actually changes.
+   *
+   * @returns Whether the value changed (drives the auto-repeat's bound stop).
+   */
+  #commit(raw) {
+    const value = this.#normalize(raw);
+    const changed = this.inputTarget.value !== String(value);
+    this.#write(value);
+    if (changed) this.dispatch("change", { detail: { value } });
+    return changed;
+  }
+  /** Reflects `value` on the input (and ARIA for non-native hosts) and the buttons. */
+  #write(value) {
+    this.inputTarget.value = String(value);
+    if (this.inputTarget.getAttribute("role") === "spinbutton") {
+      this.inputTarget.setAttribute("aria-valuenow", String(value));
+      if (Number.isFinite(this.minValue)) {
+        this.inputTarget.setAttribute("aria-valuemin", String(this.minValue));
+      }
+      if (Number.isFinite(this.maxValue)) {
+        this.inputTarget.setAttribute("aria-valuemax", String(this.maxValue));
+      }
+    }
+    this.#updateButtons(value);
+  }
+  /** Disables a step button at its bound, returning focus to the input first. */
+  #updateButtons(value) {
+    if (this.hasIncrementTarget) this.#toggleButton(this.incrementTarget, value < this.maxValue);
+    if (this.hasDecrementTarget) this.#toggleButton(this.decrementTarget, value > this.minValue);
+  }
+  /**
+   * Enables or disables a step button at its bound, never disabling one while it
+   * holds focus. Owns only the `disabled` it sets itself via a marker
+   * (`data-number-input-disabled`, like `conditional-fields`/`submit-once`), so an
+   * author-disabled button (e.g. the whole control disabled) is never re-enabled.
+   */
+  #toggleButton(button, enabled) {
+    if (enabled) {
+      if (button.hasAttribute("data-number-input-disabled")) {
+        button.disabled = false;
+        button.removeAttribute("data-number-input-disabled");
+      }
+      return;
+    }
+    if (button.disabled) return;
+    if (document.activeElement === button) this.inputTarget.focus();
+    button.disabled = true;
+    button.setAttribute("data-number-input-disabled", "");
+  }
+  /** The current numeric value, falling back to a finite min (else 0) when blank. */
+  #currentValue() {
+    const parsed = Number(this.inputTarget.value);
+    if (Number.isFinite(parsed) && this.inputTarget.value.trim() !== "") return parsed;
+    return Number.isFinite(this.minValue) ? this.minValue : 0;
+  }
+  /** Clamps to `[min, max]` and snaps to the step grid anchored at a finite min (else 0). */
+  #normalize(raw) {
+    const clamped = Math.min(this.maxValue, Math.max(this.minValue, raw));
+    if (this.stepValue <= 0) return clamped;
+    const base = Number.isFinite(this.minValue) ? this.minValue : 0;
+    const stepped = Math.round((clamped - base) / this.stepValue) * this.stepValue + base;
+    return Math.min(this.maxValue, Math.max(this.minValue, stepped));
+  }
+};
+
+export { NumberInputController };
+//# sourceMappingURL=number_input_controller.js.map
+//# sourceMappingURL=number_input_controller.js.map

package/dist/controllers/number_input_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/number_input_controller.ts"],"names":[],"mappings":"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","file":"number_input_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, SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless, accessible number / spin-button behavior.\n *\n * Markup contract (identifier: `stimeo--number-input`):\n *   <div data-controller=\"stimeo--number-input\"\n *        data-stimeo--number-input-min-value=\"0\"\n *        data-stimeo--number-input-max-value=\"100\"\n *        data-stimeo--number-input-step-value=\"1\">\n *     <button type=\"button\" aria-label=\"Decrease\" tabindex=\"-1\"\n *             data-stimeo--number-input-target=\"decrement\"\n *             data-action=\"click->stimeo--number-input#decrement\">−</button>\n *     <input type=\"number\" min=\"0\" max=\"100\" step=\"1\" value=\"0\"\n *            data-stimeo--number-input-target=\"input\"\n *            data-action=\"change->stimeo--number-input#onInput\n *                         keydown->stimeo--number-input#onKeydown\" />\n *     <button type=\"button\" aria-label=\"Increase\" tabindex=\"-1\"\n *             data-stimeo--number-input-target=\"increment\"\n *             data-action=\"click->stimeo--number-input#increment\">+</button>\n *   </div>\n *\n * Implements the WAI-ARIA APG **Spinbutton** pattern. The arrow/step logic is\n * fully owned by the controller (not delegated to the browser's native number\n * stepping) so the behavior is identical for a native `<input type=\"number\">` and\n * a custom `role=\"spinbutton\"` host, and deterministic under happy-dom.\n *\n * @remarks\n * Behavior only — the consumer styles the field and buttons. The input is the\n * sole Tab stop; the buttons are `tabindex=\"-1\"` and keep focus on the input\n * (pointerdown is suppressed), so stepping never moves focus away.\n *\n * Behavior provided:\n * - `ArrowUp`/`ArrowDown` step by `step`; `PageUp`/`PageDown` by `pageStep`\n *   (default `step × 10`); `Home`/`End` jump to a finite `min`/`max`.\n * - Increment/decrement buttons step too, and are `disabled` at the bounds (focus\n *   is returned to the input before a focused button is disabled).\n * - **Press-and-hold auto-repeat**: holding a step button steps once, then after a\n *   short delay repeats until release, the bound is reached, or the element\n *   disconnects. The `click` binding stays the single-step path (a quick click, a\n *   synthesized/programmatic click, or assistive activation), so a normal click\n *   never double-steps — the trailing click after a hold is swallowed.\n * - Typed input is clamped and snapped to the step grid on `change`;\n *   `stimeo--number-input:change` is dispatched on every committed change.\n */\nexport class NumberInputController extends Controller<HTMLElement> {\n  static override targets = [\"input\", \"increment\", \"decrement\"];\n  static override values = {\n    min: { type: Number, default: Number.NEGATIVE_INFINITY },\n    max: { type: Number, default: Number.POSITIVE_INFINITY },\n    step: { type: Number, default: 1 },\n    pageStep: { type: Number, default: 0 },\n  };\n  static actions = [\"decrement\", \"increment\", \"onInput\", \"onKeydown\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly inputTarget: HTMLInputElement;\n  declare readonly hasInputTarget: boolean;\n  declare readonly incrementTarget: HTMLButtonElement;\n  declare readonly hasIncrementTarget: boolean;\n  declare readonly decrementTarget: HTMLButtonElement;\n  declare readonly hasDecrementTarget: boolean;\n  declare minValue: number;\n  declare maxValue: number;\n  declare stepValue: number;\n  declare pageStepValue: number;\n\n  /** Delay (ms) a button must be held before auto-repeat starts. */\n  static readonly #HOLD_DELAY_MS = 400;\n  /** Interval (ms) between auto-repeat steps once a hold has started. */\n  static readonly #HOLD_REPEAT_MS = 80;\n  /**\n   * Window (ms) after a hold ends during which the trailing synthetic `click` is\n   * swallowed. A safety net for the (rare) case where that click never arrives\n   * (e.g. the pointer was released off the button): the flag self-clears instead\n   * of poisoning the next legitimate click.\n   */\n  static readonly #SUPPRESS_RESET_MS = 250;\n\n  /** Aborts the pointer listeners on disconnect so none outlive the element. */\n  #guards: AbortController | null = null;\n  /** Timers for the hold delay and the suppress-reset safety net. */\n  readonly #holdTimeouts = new SafeTimeout();\n  /** The running auto-repeat interval (one at a time). */\n  readonly #holdIntervals = new SafeInterval();\n  /** True while a hold is armed/running, making `#stopHold` idempotent. */\n  #holdActive = false;\n  /** True once a hold actually produced a repeated step (vs. a quick click). */\n  #repeatedDuringHold = false;\n  /** True when the next `click` is the trailing one after a hold and must be ignored. */\n  #suppressNextClick = false;\n\n  /** Normalizes any initial value and wires the focus/hold pointer guards. */\n  override connect(): void {\n    if (!this.hasInputTarget) return;\n    if (this.inputTarget.value.trim() !== \"\") {\n      this.#write(this.#normalize(this.#currentValue()));\n    } else {\n      this.#updateButtons(this.#currentValue());\n    }\n    this.#guards = new AbortController();\n    const { signal } = this.#guards;\n    if (this.hasIncrementTarget) this.#wireButton(this.incrementTarget, this.stepValue, signal);\n    if (this.hasDecrementTarget) this.#wireButton(this.decrementTarget, -this.stepValue, signal);\n    // A pointer released or focus lost anywhere stops a running hold, even when\n    // the button stopped receiving its own pointerup (e.g. it became disabled at\n    // the bound, or the pointer was released off it).\n    window.addEventListener(\"pointerup\", this.#stopHold, { signal });\n    window.addEventListener(\"pointercancel\", this.#stopHold, { signal });\n    window.addEventListener(\"blur\", this.#stopHold, { signal });\n  }\n\n  /** Releases the pointer guards and tears down every pending timer and hold state. */\n  override disconnect(): void {\n    this.#guards?.abort();\n    this.#guards = null;\n    this.#holdActive = false;\n    this.#repeatedDuringHold = false;\n    this.#suppressNextClick = false;\n    this.#holdTimeouts.clearAll();\n    this.#holdIntervals.clearAll();\n  }\n\n  /** Increases by one step. Bound via `data-action` (click). */\n  increment(): void {\n    if (this.#consumeSuppressedClick()) return;\n    this.#commit(this.#currentValue() + this.stepValue);\n    this.inputTarget.focus();\n  }\n\n  /** Decreases by one step. Bound via `data-action` (click). */\n  decrement(): void {\n    if (this.#consumeSuppressedClick()) return;\n    this.#commit(this.#currentValue() - this.stepValue);\n    this.inputTarget.focus();\n  }\n\n  /** Clamps and snaps a typed value. Bound via `data-action` (change). */\n  onInput(): void {\n    if (this.inputTarget.value.trim() === \"\") return;\n    this.#commit(this.#currentValue());\n  }\n\n  /** Keyboard stepping per the APG spinbutton model. */\n  onKeydown(event: KeyboardEvent): void {\n    const page = this.pageStepValue > 0 ? this.pageStepValue : this.stepValue * 10;\n    let next: number | null = null;\n    switch (event.key) {\n      case \"ArrowUp\":\n        next = this.#currentValue() + this.stepValue;\n        break;\n      case \"ArrowDown\":\n        next = this.#currentValue() - this.stepValue;\n        break;\n      case \"PageUp\":\n        next = this.#currentValue() + page;\n        break;\n      case \"PageDown\":\n        next = this.#currentValue() - page;\n        break;\n      case \"Home\":\n        if (!Number.isFinite(this.minValue)) return;\n        next = this.minValue;\n        break;\n      case \"End\":\n        if (!Number.isFinite(this.maxValue)) return;\n        next = this.maxValue;\n        break;\n      default:\n        return;\n    }\n    event.preventDefault();\n    this.#commit(next);\n  }\n\n  /**\n   * Wires a step button: `pointerdown` keeps focus on the input and arms the\n   * hold; leaving the button while held stops it (the global listeners cover\n   * release/cancel/blur).\n   */\n  #wireButton(button: HTMLButtonElement, delta: number, signal: AbortSignal): void {\n    button.addEventListener(\"pointerdown\", (event) => this.#armHold(event, button, delta), {\n      signal,\n    });\n    button.addEventListener(\"pointerleave\", this.#stopHold, { signal });\n  }\n\n  /** Starts a hold: focus the input, then schedule the first repeat after a delay. */\n  #armHold(event: Event, button: HTMLButtonElement, delta: number): void {\n    // Ignore secondary buttons (right/middle) when the event exposes one.\n    const pointerButton = (event as PointerEvent).button;\n    if (typeof pointerButton === \"number\" && pointerButton !== 0) return;\n    if (button.disabled) return;\n    event.preventDefault(); // keep focus on the input rather than the button\n    this.inputTarget.focus();\n\n    this.#stopHold();\n    this.#holdActive = true;\n    this.#repeatedDuringHold = false;\n    this.#suppressNextClick = false;\n    this.#holdTimeouts.set(() => {\n      if (!this.#commit(this.#currentValue() + delta)) {\n        this.#stopHold();\n        return;\n      }\n      this.#repeatedDuringHold = true;\n      this.#holdIntervals.set(() => {\n        if (!this.#commit(this.#currentValue() + delta)) this.#stopHold();\n      }, NumberInputController.#HOLD_REPEAT_MS);\n    }, NumberInputController.#HOLD_DELAY_MS);\n  }\n\n  /**\n   * Stops the current hold (idempotent). When the hold actually repeated, the\n   * trailing synthetic `click` must be ignored, so it is suppressed until the\n   * click consumes it or a short safety-net timeout clears it.\n   */\n  readonly #stopHold = (): void => {\n    if (!this.#holdActive) return;\n    this.#holdActive = false;\n    this.#holdTimeouts.clearAll();\n    this.#holdIntervals.clearAll();\n    if (this.#repeatedDuringHold) {\n      this.#suppressNextClick = true;\n      this.#holdTimeouts.set(() => {\n        this.#suppressNextClick = false;\n      }, NumberInputController.#SUPPRESS_RESET_MS);\n    }\n  };\n\n  /** Consumes a pending trailing-click suppression; returns true if the click was swallowed. */\n  #consumeSuppressedClick(): boolean {\n    if (!this.#suppressNextClick) return false;\n    this.#suppressNextClick = false;\n    this.#holdTimeouts.clearAll();\n    return true;\n  }\n\n  /**\n   * Normalizes `raw`, reflects it, and dispatches `change` only when the\n   * displayed value actually changes.\n   *\n   * @returns Whether the value changed (drives the auto-repeat's bound stop).\n   */\n  #commit(raw: number): boolean {\n    const value = this.#normalize(raw);\n    const changed = this.inputTarget.value !== String(value);\n    this.#write(value);\n    if (changed) this.dispatch(\"change\", { detail: { value } });\n    return changed;\n  }\n\n  /** Reflects `value` on the input (and ARIA for non-native hosts) and the buttons. */\n  #write(value: number): void {\n    this.inputTarget.value = String(value);\n    if (this.inputTarget.getAttribute(\"role\") === \"spinbutton\") {\n      this.inputTarget.setAttribute(\"aria-valuenow\", String(value));\n      if (Number.isFinite(this.minValue)) {\n        this.inputTarget.setAttribute(\"aria-valuemin\", String(this.minValue));\n      }\n      if (Number.isFinite(this.maxValue)) {\n        this.inputTarget.setAttribute(\"aria-valuemax\", String(this.maxValue));\n      }\n    }\n    this.#updateButtons(value);\n  }\n\n  /** Disables a step button at its bound, returning focus to the input first. */\n  #updateButtons(value: number): void {\n    if (this.hasIncrementTarget) this.#toggleButton(this.incrementTarget, value < this.maxValue);\n    if (this.hasDecrementTarget) this.#toggleButton(this.decrementTarget, value > this.minValue);\n  }\n\n  /**\n   * Enables or disables a step button at its bound, never disabling one while it\n   * holds focus. Owns only the `disabled` it sets itself via a marker\n   * (`data-number-input-disabled`, like `conditional-fields`/`submit-once`), so an\n   * author-disabled button (e.g. the whole control disabled) is never re-enabled.\n   */\n  #toggleButton(button: HTMLButtonElement, enabled: boolean): void {\n    if (enabled) {\n      if (button.hasAttribute(\"data-number-input-disabled\")) {\n        button.disabled = false;\n        button.removeAttribute(\"data-number-input-disabled\");\n      }\n      return;\n    }\n    if (button.disabled) return; // already disabled (possibly by the author) — leave it\n    if (document.activeElement === button) this.inputTarget.focus();\n    button.disabled = true;\n    button.setAttribute(\"data-number-input-disabled\", \"\");\n  }\n\n  /** The current numeric value, falling back to a finite min (else 0) when blank. */\n  #currentValue(): number {\n    const parsed = Number(this.inputTarget.value);\n    if (Number.isFinite(parsed) && this.inputTarget.value.trim() !== \"\") return parsed;\n    return Number.isFinite(this.minValue) ? this.minValue : 0;\n  }\n\n  /** Clamps to `[min, max]` and snaps to the step grid anchored at a finite min (else 0). */\n  #normalize(raw: number): number {\n    const clamped = Math.min(this.maxValue, Math.max(this.minValue, raw));\n    if (this.stepValue <= 0) return clamped;\n    const base = Number.isFinite(this.minValue) ? this.minValue : 0;\n    const stepped = Math.round((clamped - base) / this.stepValue) * this.stepValue + base;\n    return Math.min(this.maxValue, Math.max(this.minValue, stepped));\n  }\n}\n"]}