stimeo-ui 0.16.0 → 0.17.0

data/dist/controllers/count_up_controller.js

@@ -1,8 +1,5 @@
 import { Controller } from '@hotwired/stimulus';
 
-// src/controllers/count_up_controller.ts
-
-// src/utils/authored_integer.ts
 var TOKEN_BODY = /\d[\d.,'’’    _]*\d|\d/;
 var SIGN_OPENER = /[\s([]/;
 function authoredInteger(text) {
@@ -24,29 +21,75 @@ function authoredInteger(text) {
   return signed ? -magnitude || 0 : magnitude;
 }
 
-// src/utils/reduced_motion.ts
+var NUMBER_BOUNDS = {
+  finite: { finite: true },
+  positive: { finite: true, exclusiveMin: 0 }};
+function matchesNumberBounds(value, bounds) {
+  if (!Number.isFinite(value)) {
+    const direction = value === Infinity ? "positive" : value === -Infinity ? "negative" : null;
+    if (direction === null) return false;
+    if (bounds.allowInfinity !== "both" && bounds.allowInfinity !== direction) return false;
+  }
+  if (bounds.min !== void 0 && value < bounds.min) return false;
+  if (bounds.max !== void 0 && value > bounds.max) return false;
+  if (bounds.exclusiveMin !== void 0 && value <= bounds.exclusiveMin) return false;
+  if (bounds.integer && !Number.isInteger(value)) return false;
+  if (bounds.allowedValues !== void 0 && !bounds.allowedValues.includes(value)) return false;
+  return true;
+}
+
+function readNumber(raw, fallback, bounds) {
+  return matchesNumberBounds(raw, bounds) ? raw : fallback;
+}
+
+var NumberValueReader = class {
+  #lastRejected = /* @__PURE__ */ new Map();
+  read(owner, name, raw, fallback, bounds) {
+    const resolved = readNumber(raw, fallback, bounds);
+    if (matchesNumberBounds(raw, bounds)) {
+      this.#lastRejected.delete(name);
+      return resolved;
+    }
+    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;
+    const literal = owner.element.getAttribute(attribute);
+    if (literal === null) {
+      this.#lastRejected.delete(name);
+      return resolved;
+    }
+    if (this.#lastRejected.get(name) !== literal) {
+      this.#lastRejected.set(name, literal);
+      console.warn(
+        `Stimeo UI: "${owner.identifier}" has an invalid number Value "${name}" declaration ${JSON.stringify(literal)}; using ${fallback}.`
+      );
+    }
+    return resolved;
+  }
+};
+
 function prefersReducedMotion() {
   return typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
 }
 
-// src/controllers/count_up_controller.ts
 var DEFAULT_DURATION = 1200;
-var CountUpController = class extends Controller {
+var CountUpController = class _CountUpController extends Controller {
+  #numbers = new NumberValueReader();
   static values = {
     duration: { type: Number, default: DEFAULT_DURATION },
     from: { type: Number, default: 0 },
     once: { type: Boolean, default: true }
   };
+  static valueConstraints = {
+    duration: NUMBER_BOUNDS.positive,
+    from: NUMBER_BOUNDS.finite
+  };
   static actions = ["start"];
   static events = ["end"];
   #frame = null;
-  /** The animation length, with a declaration outside its domain read as the default. */
   get #duration() {
-    return Number.isFinite(this.durationValue) && this.durationValue > 0 ? this.durationValue : DEFAULT_DURATION;
+    return this.#safeDuration;
   }
-  /** The starting value, with a declaration that is not a finite number read as zero. */
   get #from() {
-    return Number.isFinite(this.fromValue) ? this.fromValue : 0;
+    return this.#safeFrom;
   }
   connect() {
     const ticker = this.#ownedTicker();
@@ -58,10 +101,6 @@ var CountUpController = class extends Controller {
   disconnect() {
     if (this.#frame !== null) this.#settle();
   }
-  /**
-   * Starts the animation (typically from `stimeo--intersection:enter` via
-   * `data-action`). No-ops while running, and after a finished run when `once`.
-   */
   start() {
     if (this.#frame !== null) return;
     if (this.onceValue && this.element.hasAttribute("data-count-up-done")) return;
@@ -76,9 +115,10 @@ var CountUpController = class extends Controller {
     }
     const ticker = this.#wrap(node, authored);
     const from = this.#from;
+    const duration = this.#duration;
     const started = performance.now();
     const step = (now) => {
-      const t = Math.min((now - started) / this.#duration, 1);
+      const t = Math.min((now - started) / duration, 1);
       const eased = 1 - (1 - t) ** 3;
       ticker.textContent = String(Math.round(from + (target - from) * eased));
       if (t < 1) {
@@ -90,7 +130,6 @@ var CountUpController = class extends Controller {
     };
     this.#frame = requestAnimationFrame(step);
   }
-  /** The first text node that displays a number, or null when the host has none. */
   #numericNode() {
     const walker = document.createTreeWalker(this.element, NodeFilter.SHOW_TEXT);
     let node = walker.nextNode();
@@ -99,11 +138,9 @@ var CountUpController = class extends Controller {
     }
     return node;
   }
-  /** The wrapper this controller published, if one outlived its run. */
   #ownedTicker() {
     return this.element.querySelector("[data-count-up-label]");
   }
-  /** Publishes the ticking number inside a named wrapper, replacing `node`. */
   #wrap(node, authored) {
     const ticker = document.createElement("span");
     ticker.setAttribute("data-count-up-label", "true");
@@ -113,11 +150,9 @@ var CountUpController = class extends Controller {
     ticker.append(node);
     return ticker;
   }
-  /** Puts `text` back where the wrapper stood, leaving the rest of the host alone. */
   #unwrap(ticker, text) {
     ticker.replaceWith(document.createTextNode(text ?? ticker.textContent ?? ""));
   }
-  /** Ends the run: cancels the frame and restores the authored presentation. */
   #settle() {
     if (this.#frame !== null) cancelAnimationFrame(this.#frame);
     this.#frame = null;
@@ -125,8 +160,25 @@ var CountUpController = class extends Controller {
     if (ticker !== null) this.#unwrap(ticker, ticker.getAttribute("aria-label"));
     this.element.setAttribute("data-count-up-done", "true");
   }
+  get #safeDuration() {
+    return this.#numbers.read(
+      this,
+      "duration",
+      this.durationValue,
+      _CountUpController.values.duration.default,
+      _CountUpController.valueConstraints.duration
+    );
+  }
+  get #safeFrom() {
+    return this.#numbers.read(
+      this,
+      "from",
+      this.fromValue,
+      _CountUpController.values.from.default,
+      _CountUpController.valueConstraints.from
+    );
+  }
 };
 
 export { CountUpController };
-//# sourceMappingURL=count_up_controller.js.map
 //# sourceMappingURL=count_up_controller.js.map