stimeo-ui 0.16.0 → 0.18.0

package/dist/controllers/count_up_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/authored_integer.ts","../../src/utils/reduced_motion.ts","../../src/controllers/count_up_controller.ts"],"names":[],"mappings":"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","file":"count_up_controller.js","sourcesContent":["/** Digits plus the characters that may separate them inside one number. */\nconst TOKEN_BODY = /\\d[\\d.,'’’    _]*\\d|\\d/;\n/** A `-` opens a token only against one of these on its left. */\nconst SIGN_OPENER = /[\\s([]/;\n\n/**\n * Reads the integer that a human-formatted string displays.\n *\n * Takes the first numeric token, drops group separators, and truncates any\n * fractional part toward zero — so `\"1,200 users\"`, `\"$1,299.99\"` and\n * `\"1.299,99\"` read 1200, 1299 and 1299 without asking the platform which\n * locale is in play. A separator counts as grouping only where the digits that\n * follow it form a run of exactly three and the leading run could head a\n * grouped number; anything else is the decimal point, and the digits after it\n * are the fraction.\n *\n * `-` counts as a sign only where it opens the token — at the start of the\n * string, or after whitespace or an opening bracket — so a hyphen inside a\n * label (`\"Sign-ups: 1,200\"`, `\"Top-10 users\"`) never becomes one.\n *\n * `\"1.200\"` is genuinely ambiguous (1200 grouped, 1.2 with a decimal point) and\n * reads as 1200: display numbers group far more often than they carry a\n * fraction in exactly three digits.\n *\n * Returns `null` when the string holds no digits at all. What that means is the\n * caller's to decide — starting nothing, or falling back to a base value.\n */\nexport function authoredInteger(text: string): number | null {\n  const firstDigit = /\\d/.exec(text);\n  if (firstDigit === null) return null;\n\n  const at = firstDigit.index;\n  const signed =\n    at > 0 && text[at - 1] === \"-\" && (at === 1 || SIGN_OPENER.test(text[at - 2] as string));\n\n  const body = TOKEN_BODY.exec(text.slice(at)) as RegExpExecArray;\n  const runs = body[0].split(/\\D+/);\n  const separators = body[0].match(/\\D+/g) ?? [];\n\n  // The leading run heads a grouped number only when it is short enough to be a\n  // group itself and carries no leading zero; \"0.500\" and \"012,3\" are decimals.\n  const lead = runs[0] as string;\n  const heads = lead.length <= 3 && !lead.startsWith(\"0\");\n  let digits = lead;\n  for (let i = 1; heads && i < runs.length; i += 1) {\n    if (separators[i - 1]?.length !== 1 || runs[i]?.length !== 3) break;\n    digits += runs[i];\n  }\n\n  const magnitude = Number.parseInt(digits, 10);\n  return signed ? -magnitude || 0 : magnitude;\n}\n","/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers.\n *\n * This one-liner keeps the media query string and the environment guard\n * single-sourced across them. The preference is intentionally re-read on every\n * call — the controllers check it at each animation/scroll start (WCAG 2.2\n * **2.3.3**), so flipping the OS setting takes effect immediately without any\n * listener or cache bookkeeping here.\n */\n\n/**\n * Whether the user currently requests reduced motion.\n *\n * @returns `true` when `(prefers-reduced-motion: reduce)` matches; `false`\n * otherwise, including environments without `window.matchMedia` (treated as\n * \"no preference\").\n */\nexport function prefersReducedMotion(): boolean {\n  return (\n    typeof window.matchMedia === \"function\" &&\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n  );\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { authoredInteger } from \"../utils/authored_integer\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\n\n/** The animation length used when `duration` falls outside its domain. */\nconst DEFAULT_DURATION = 1200;\n\n/**\n * Headless **count-up**: animates a number from `from` up to the value already\n * in the DOM — typically started the moment the element scrolls into view by\n * composing with the `stimeo--intersection` primitive (the classic \"animate\n * when visible\"). Distinct from `stimeo--countdown` (time-based). Core\n * (zero dependencies).\n *\n * Markup contract (identifier: `stimeo--count-up`):\n *   <span data-controller=\"stimeo--intersection stimeo--count-up\"\n *         data-stimeo--intersection-once-value=\"true\"\n *         data-action=\"stimeo--intersection:enter->stimeo--count-up#start\">1200</span>\n *\n * The **final number stays authored in the markup** (SEO / no-JS / SR read the\n * real value); `start` animates the displayed text from `from` to it over\n * `duration` ms with an ease-out curve, then restores the exact authored text.\n * With `once` (default) later starts are ignored (`data-count-up-done` records\n * a finished run across Turbo cache restores).\n *\n * Only the text node holding the number is animated, so sibling markup — a unit\n * in a `<small>`, a label in a `<b>` — is left where the author put it.\n *\n * `end` dispatches `{ value }`.\n *\n * @remarks\n * Behavior only — no formatting is imposed: the authored text is read for the\n * integer it displays and restored verbatim at the end; intermediate frames\n * render plain integers. Accessibility: when the user prefers reduced motion the\n * animation is skipped entirely (the value just stays final — WCAG 2.3.3).\n * During a run the ticking number is wrapped in a `role=\"img\"` element named\n * with the authored text, which is where a name is allowed to live — the host\n * keeps whatever semantics it had, so a `<dd>` stays a definition. That wrapper\n * doubles as the interrupted-run record `connect()` restores from after a Turbo\n * cache snapshot taken mid-animation. The animation frame is canceled on\n * `disconnect()` (Turbo navigation included) and the authored text restored.\n */\nexport class CountUpController extends Controller<HTMLElement> {\n  static override values = {\n    duration: { type: Number, default: DEFAULT_DURATION },\n    from: { type: Number, default: 0 },\n    once: { type: Boolean, default: true },\n  };\n  static actions = [\"start\"] as const;\n  static events = [\"end\"] as const;\n\n  declare durationValue: number;\n  declare fromValue: number;\n  declare onceValue: boolean;\n\n  #frame: number | null = null;\n\n  /** The animation length, with a declaration outside its domain read as the default. */\n  get #duration(): number {\n    return Number.isFinite(this.durationValue) && this.durationValue > 0\n      ? this.durationValue\n      : DEFAULT_DURATION;\n  }\n\n  /** The starting value, with a declaration that is not a finite number read as zero. */\n  get #from(): number {\n    return Number.isFinite(this.fromValue) ? this.fromValue : 0;\n  }\n\n  override connect(): void {\n    // Turbo snapshots the page BEFORE the body swap, so a cached page can hold\n    // a mid-animation frame (disconnect()'s settle runs too late for it). The\n    // wrapper this controller owns flags the interrupted run and carries the\n    // authored text in the name it published.\n    const ticker = this.#ownedTicker();\n    if (ticker === null) return;\n    const authored = ticker.getAttribute(\"aria-label\");\n    this.#unwrap(ticker, authored);\n    if (authored !== null) this.element.setAttribute(\"data-count-up-done\", \"true\");\n  }\n\n  override disconnect(): void {\n    // A run cannot survive the element: settle instantly so the cached\n    // snapshot holds the real value, never a mid-animation frame.\n    if (this.#frame !== null) this.#settle();\n  }\n\n  /**\n   * Starts the animation (typically from `stimeo--intersection:enter` via\n   * `data-action`). No-ops while running, and after a finished run when `once`.\n   */\n  start(): void {\n    if (this.#frame !== null) return;\n    if (this.onceValue && this.element.hasAttribute(\"data-count-up-done\")) return;\n\n    const node = this.#numericNode();\n    if (node === null) return;\n    const authored = node.data;\n    const target = authoredInteger(authored) as number;\n\n    // Reduced motion: no ticking, just the final value (WCAG 2.3.3).\n    if (prefersReducedMotion()) {\n      this.element.setAttribute(\"data-count-up-done\", \"true\");\n      this.dispatch(\"end\", { detail: { value: target } });\n      return;\n    }\n\n    // A name may not live on every host — a `<span>` prohibits one, and a role\n    // that permits naming would cost a `<dd>` its own semantics — so the ticking\n    // number gets a wrapper that permits naming, and the name carries the\n    // authored text AT should hear instead of the ticks.\n    const ticker = this.#wrap(node, authored);\n    const from = this.#from;\n    const started = performance.now();\n    const step = (now: number): void => {\n      const t = Math.min((now - started) / this.#duration, 1);\n      const eased = 1 - (1 - t) ** 3; // ease-out cubic\n      ticker.textContent = String(Math.round(from + (target - from) * eased));\n      if (t < 1) {\n        this.#frame = requestAnimationFrame(step);\n      } else {\n        this.#settle();\n        this.dispatch(\"end\", { detail: { value: target } });\n      }\n    };\n    this.#frame = requestAnimationFrame(step);\n  }\n\n  /** The first text node that displays a number, or null when the host has none. */\n  #numericNode(): Text | null {\n    const walker = document.createTreeWalker(this.element, NodeFilter.SHOW_TEXT);\n    let node = walker.nextNode() as Text | null;\n    while (node !== null && authoredInteger(node.data) === null) {\n      node = walker.nextNode() as Text | null;\n    }\n    return node;\n  }\n\n  /** The wrapper this controller published, if one outlived its run. */\n  #ownedTicker(): HTMLElement | null {\n    return this.element.querySelector<HTMLElement>(\"[data-count-up-label]\");\n  }\n\n  /** Publishes the ticking number inside a named wrapper, replacing `node`. */\n  #wrap(node: Text, authored: string): HTMLElement {\n    const ticker = document.createElement(\"span\");\n    ticker.setAttribute(\"data-count-up-label\", \"true\");\n    ticker.setAttribute(\"role\", \"img\");\n    ticker.setAttribute(\"aria-label\", authored);\n    node.replaceWith(ticker);\n    ticker.append(node);\n    return ticker;\n  }\n\n  /** Puts `text` back where the wrapper stood, leaving the rest of the host alone. */\n  #unwrap(ticker: HTMLElement, text: string | null): void {\n    ticker.replaceWith(document.createTextNode(text ?? ticker.textContent ?? \"\"));\n  }\n\n  /** Ends the run: cancels the frame and restores the authored presentation. */\n  #settle(): void {\n    if (this.#frame !== null) cancelAnimationFrame(this.#frame);\n    this.#frame = null;\n    const ticker = this.#ownedTicker();\n    if (ticker !== null) this.#unwrap(ticker, ticker.getAttribute(\"aria-label\"));\n    this.element.setAttribute(\"data-count-up-done\", \"true\");\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/authored_integer.ts","../../src/utils/number_bounds.ts","../../src/utils/coerce.ts","../../src/utils/number_value.ts","../../src/utils/reduced_motion.ts","../../src/controllers/count_up_controller.ts"],"names":[],"mappings":"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","file":"count_up_controller.js","sourcesContent":["/** Digits plus the characters that may separate them inside one number. */\nconst TOKEN_BODY = /\\d[\\d.,'’’    _]*\\d|\\d/;\n/** A `-` opens a token only against one of these on its left. */\nconst SIGN_OPENER = /[\\s([]/;\n\n/**\n * Reads the integer that a human-formatted string displays.\n *\n * Takes the first numeric token, drops group separators, and truncates any\n * fractional part toward zero — so `\"1,200 users\"`, `\"$1,299.99\"` and\n * `\"1.299,99\"` read 1200, 1299 and 1299 without asking the platform which\n * locale is in play. A separator counts as grouping only where the digits that\n * follow it form a run of exactly three and the leading run could head a\n * grouped number; anything else is the decimal point, and the digits after it\n * are the fraction.\n *\n * `-` counts as a sign only where it opens the token — at the start of the\n * string, or after whitespace or an opening bracket — so a hyphen inside a\n * label (`\"Sign-ups: 1,200\"`, `\"Top-10 users\"`) never becomes one.\n *\n * `\"1.200\"` is genuinely ambiguous (1200 grouped, 1.2 with a decimal point) and\n * reads as 1200: display numbers group far more often than they carry a\n * fraction in exactly three digits.\n *\n * Returns `null` when the string holds no digits at all. What that means is the\n * caller's to decide — starting nothing, or falling back to a base value.\n */\nexport function authoredInteger(text: string): number | null {\n  const firstDigit = /\\d/.exec(text);\n  if (firstDigit === null) return null;\n\n  const at = firstDigit.index;\n  const signed =\n    at > 0 && text[at - 1] === \"-\" && (at === 1 || SIGN_OPENER.test(text[at - 2] as string));\n\n  const body = TOKEN_BODY.exec(text.slice(at)) as RegExpExecArray;\n  const runs = body[0].split(/\\D+/);\n  const separators = body[0].match(/\\D+/g) ?? [];\n\n  // The leading run heads a grouped number only when it is short enough to be a\n  // group itself and carries no leading zero; \"0.500\" and \"012,3\" are decimals.\n  const lead = runs[0] as string;\n  const heads = lead.length <= 3 && !lead.startsWith(\"0\");\n  let digits = lead;\n  for (let i = 1; heads && i < runs.length; i += 1) {\n    if (separators[i - 1]?.length !== 1 || runs[i]?.length !== 3) break;\n    digits += runs[i];\n  }\n\n  const magnitude = Number.parseInt(digits, 10);\n  return signed ? -magnitude || 0 : magnitude;\n}\n","import { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/** Semantic constraints on an already decoded number, independent of the DOM. */\nexport interface NumberBounds {\n  /** Finite numbers are required, including when this field is omitted. */\n  readonly finite?: true;\n  /** Inclusive lower endpoint. */\n  readonly min?: number;\n  /** Inclusive upper endpoint. */\n  readonly max?: number;\n  /** Exclusive lower endpoint. */\n  readonly exclusiveMin?: number;\n  /** Require a number without a fractional part. */\n  readonly integer?: boolean;\n  /** Exact decoded numbers accepted by a discrete contract. */\n  readonly allowedValues?: readonly number[];\n  /** JSON-safe exceptions to finite-number checking for unbounded endpoints. */\n  readonly allowInfinity?: \"negative\" | \"positive\" | \"both\";\n}\n\n/** One constraint for each Number Value, including shorthand declarations. */\nexport type NumberValueConstraints<Values> = {\n  readonly [Key in keyof Values as Values[Key] extends\n    | NumberConstructor\n    | { type: NumberConstructor }\n    ? Key\n    : never]: NumberBounds;\n};\n\n/** Reusable semantic domains; fractional inputs remain fractional unless excluded. */\nexport const NUMBER_BOUNDS = {\n  finite: { finite: true },\n  nonNegative: { finite: true, min: 0 },\n  positive: { finite: true, exclusiveMin: 0 },\n  nonNegativeInteger: { finite: true, min: 0, integer: true },\n  positiveInteger: { finite: true, exclusiveMin: 0, integer: true },\n  lowerBound: { finite: true, allowInfinity: \"negative\" },\n  upperBound: { finite: true, allowInfinity: \"positive\" },\n  timer: { finite: true, min: 0, max: MAX_TIMER_DELAY_MS },\n  positiveTimer: { finite: true, exclusiveMin: 0, max: MAX_TIMER_DELAY_MS },\n} as const satisfies Record<string, NumberBounds>;\n\n/**\n * Checks all declared bounds without rounding, clamping, or coercing the input.\n * Infinity exceptions relax only finite checking; every other bound still applies.\n */\nexport function matchesNumberBounds(value: number, bounds: NumberBounds): boolean {\n  if (!Number.isFinite(value)) {\n    const direction = value === Infinity ? \"positive\" : value === -Infinity ? \"negative\" : null;\n    if (direction === null) return false;\n    if (bounds.allowInfinity !== \"both\" && bounds.allowInfinity !== direction) return false;\n  }\n  if (bounds.min !== undefined && value < bounds.min) return false;\n  if (bounds.max !== undefined && value > bounds.max) return false;\n  if (bounds.exclusiveMin !== undefined && value <= bounds.exclusiveMin) return false;\n  if (bounds.integer && !Number.isInteger(value)) return false;\n  if (bounds.allowedValues !== undefined && !bounds.allowedValues.includes(value)) return false;\n  return true;\n}\n\n/** Decodes a Number Value literal; action params use their own JSON decoder. */\nexport function decodeNumberValue(raw: string): number {\n  return Number(raw.replace(/_/g, \"\"));\n}\n","/**\n * Numeric coercion for controllers that accept a number through a Value, an action\n * param, or an event detail.\n *\n * Stimulus decodes action params as JSON when possible and leaves other text\n * untouched. CustomEvent detail can also supply a number or numeric string.\n * The reader accepts those two types while rejecting blank and non-finite input.\n */\n\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** Numeric update input, accepting decoded action params before CustomEvent detail. */\nexport type NumericValueEvent = Event & {\n  params?: { amount?: unknown };\n  detail?: { value?: unknown };\n};\n\n/** Reads the nullish action-param/detail precedence without falling back from invalid input. */\nexport function eventNumber(event: NumericValueEvent): number | null {\n  return toFiniteNumber(event.params?.amount ?? event.detail?.value);\n}\n\n/**\n * Reads a finite number or nonblank numeric string; other input returns `null`.\n * Blank strings cannot silently reset a value to zero.\n */\nexport function toFiniteNumber(raw: unknown): number | null {\n  if (typeof raw !== \"number\" && typeof raw !== \"string\") return null;\n  if (typeof raw === \"string\" && raw.trim().length === 0) return null;\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Returns an accepted decoded Number Value or the caller's fallback unchanged.\n * The caller owns the fallback contract; this reader does not parse or write a Value.\n */\nexport function readNumber(raw: number, fallback: number, bounds: NumberBounds): number {\n  return matchesNumberBounds(raw, bounds) ? raw : fallback;\n}\n","import { readNumber } from \"./coerce\";\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** The instance identity carried by a Number Value read. */\nexport interface NumberValueOwner {\n  readonly identifier: string;\n  readonly element: Element;\n}\n\n/** Reads current declarations at the point of use without rewriting their attributes. */\nexport class NumberValueReader {\n  /** The last rejected literal per Value; no history grows for an unchanged instance. */\n  readonly #lastRejected = new Map<string, string>();\n\n  /** Resolves the declared number using its own fallback and shared class contract. */\n  read(\n    owner: NumberValueOwner,\n    name: string,\n    raw: number,\n    fallback: number,\n    bounds: NumberBounds,\n  ): number {\n    const resolved = readNumber(raw, fallback, bounds);\n    if (matchesNumberBounds(raw, bounds)) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;\n    const literal = owner.element.getAttribute(attribute);\n    if (literal === null) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    if (this.#lastRejected.get(name) !== literal) {\n      this.#lastRejected.set(name, literal);\n      console.warn(\n        `Stimeo UI: \"${owner.identifier}\" has an invalid number Value \"${name}\" declaration ${JSON.stringify(literal)}; using ${fallback}.`,\n      );\n    }\n    return resolved;\n  }\n}\n","/**\n * Shared `prefers-reduced-motion` lookup for the motion-aware controllers.\n *\n * This one-liner keeps the media query string and the environment guard\n * single-sourced across them. The preference is intentionally re-read on every\n * call — the controllers check it at each animation/scroll start (WCAG 2.2\n * **2.3.3**), so flipping the OS setting takes effect immediately without any\n * listener or cache bookkeeping here.\n */\n\n/**\n * Whether the user currently requests reduced motion.\n *\n * @returns `true` when `(prefers-reduced-motion: reduce)` matches; `false`\n * otherwise, including environments without `window.matchMedia` (treated as\n * \"no preference\").\n */\nexport function prefersReducedMotion(): boolean {\n  return (\n    typeof window.matchMedia === \"function\" &&\n    window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n  );\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { authoredInteger } from \"../utils/authored_integer\";\nimport { NUMBER_BOUNDS, type NumberValueConstraints } from \"../utils/number_bounds\";\nimport { NumberValueReader } from \"../utils/number_value\";\nimport { prefersReducedMotion } from \"../utils/reduced_motion\";\n\n/** The animation length used when `duration` falls outside its domain. */\nconst DEFAULT_DURATION = 1200;\n\n/**\n * Headless **count-up**: animates a number from `from` up to the value already\n * in the DOM — typically started the moment the element scrolls into view by\n * composing with the `stimeo--intersection` primitive (the classic \"animate\n * when visible\"). Distinct from `stimeo--countdown` (time-based). Core\n * (zero dependencies).\n *\n * Markup contract (identifier: `stimeo--count-up`):\n *   <span data-controller=\"stimeo--intersection stimeo--count-up\"\n *         data-stimeo--intersection-once-value=\"true\"\n *         data-action=\"stimeo--intersection:enter->stimeo--count-up#start\">1200</span>\n *\n * The **final number stays authored in the markup** (SEO / no-JS / SR read the\n * real value); `start` animates the displayed text from `from` to it over\n * `duration` ms with an ease-out curve, then restores the exact authored text.\n * With `once` (default) later starts are ignored (`data-count-up-done` records\n * a finished run across Turbo cache restores). `from` and `duration` are read as\n * a run starts: a running animation keeps the values it began with, the next run\n * reads the new ones, and a change on its own starts nothing.\n *\n * Only the text node holding the number is animated, so sibling markup — a unit\n * in a `<small>`, a label in a `<b>` — is left where the author put it.\n *\n * `end` dispatches `{ value }`.\n *\n * @remarks\n * Behavior only — no formatting is imposed: the authored text is read for the\n * integer it displays and restored verbatim at the end; intermediate frames\n * render plain integers. Accessibility: when the user prefers reduced motion the\n * animation is skipped entirely (the value just stays final — WCAG 2.3.3).\n * During a run the ticking number is wrapped in a `role=\"img\"` element named\n * with the authored text, which is where a name is allowed to live — the host\n * keeps whatever semantics it had, so a `<dd>` stays a definition. That wrapper\n * doubles as the interrupted-run record `connect()` restores from after a Turbo\n * cache snapshot taken mid-animation. The animation frame is canceled on\n * `disconnect()` (Turbo navigation included) and the authored text restored.\n */\nexport class CountUpController extends Controller<HTMLElement> {\n  /** Numeric read boundaries share one reader for this controller instance. */\n  readonly #numbers = new NumberValueReader();\n\n  static override values = {\n    duration: { type: Number, default: DEFAULT_DURATION },\n    from: { type: Number, default: 0 },\n    once: { type: Boolean, default: true },\n  };\n\n  static valueConstraints = {\n    duration: NUMBER_BOUNDS.positive,\n    from: NUMBER_BOUNDS.finite,\n  } satisfies NumberValueConstraints<typeof CountUpController.values>;\n  static actions = [\"start\"] as const;\n  static events = [\"end\"] as const;\n\n  declare durationValue: number;\n  declare fromValue: number;\n  declare onceValue: boolean;\n\n  #frame: number | null = null;\n\n  /** The animation length, with a declaration outside its domain read as the default. */\n  get #duration(): number {\n    return this.#safeDuration;\n  }\n\n  /** The starting value, with a declaration that is not a finite number read as zero. */\n  get #from(): number {\n    return this.#safeFrom;\n  }\n\n  override connect(): void {\n    // Turbo snapshots the page BEFORE the body swap, so a cached page can hold\n    // a mid-animation frame (disconnect()'s settle runs too late for it). The\n    // wrapper this controller owns flags the interrupted run and carries the\n    // authored text in the name it published.\n    const ticker = this.#ownedTicker();\n    if (ticker === null) return;\n    const authored = ticker.getAttribute(\"aria-label\");\n    this.#unwrap(ticker, authored);\n    if (authored !== null) this.element.setAttribute(\"data-count-up-done\", \"true\");\n  }\n\n  override disconnect(): void {\n    // Cancel the live run and restore the element's authored text.\n    if (this.#frame !== null) this.#settle();\n  }\n\n  /**\n   * Starts the animation (typically from `stimeo--intersection:enter` via\n   * `data-action`). No-ops while running, and after a finished run when `once`.\n   * The run keeps the `from` and `duration` read here to its last frame.\n   */\n  start(): void {\n    if (this.#frame !== null) return;\n    if (this.onceValue && this.element.hasAttribute(\"data-count-up-done\")) return;\n\n    const node = this.#numericNode();\n    if (node === null) return;\n    const authored = node.data;\n    const target = authoredInteger(authored) as number;\n\n    // Reduced motion: no ticking, just the final value (WCAG 2.3.3).\n    if (prefersReducedMotion()) {\n      this.element.setAttribute(\"data-count-up-done\", \"true\");\n      this.dispatch(\"end\", { detail: { value: target } });\n      return;\n    }\n\n    // A name may not live on every host — a `<span>` prohibits one, and a role\n    // that permits naming would cost a `<dd>` its own semantics — so the ticking\n    // number gets a wrapper that permits naming, and the name carries the\n    // authored text AT should hear instead of the ticks.\n    const ticker = this.#wrap(node, authored);\n    const from = this.#from;\n    const duration = this.#duration;\n    const started = performance.now();\n    const step = (now: number): void => {\n      const t = Math.min((now - started) / duration, 1);\n      const eased = 1 - (1 - t) ** 3; // ease-out cubic\n      ticker.textContent = String(Math.round(from + (target - from) * eased));\n      if (t < 1) {\n        this.#frame = requestAnimationFrame(step);\n      } else {\n        this.#settle();\n        this.dispatch(\"end\", { detail: { value: target } });\n      }\n    };\n    this.#frame = requestAnimationFrame(step);\n  }\n\n  /** The first text node that displays a number, or null when the host has none. */\n  #numericNode(): Text | null {\n    const walker = document.createTreeWalker(this.element, NodeFilter.SHOW_TEXT);\n    let node = walker.nextNode() as Text | null;\n    while (node !== null && authoredInteger(node.data) === null) {\n      node = walker.nextNode() as Text | null;\n    }\n    return node;\n  }\n\n  /** The wrapper this controller published, if one outlived its run. */\n  #ownedTicker(): HTMLElement | null {\n    return this.element.querySelector<HTMLElement>(\"[data-count-up-label]\");\n  }\n\n  /** Publishes the ticking number inside a named wrapper, replacing `node`. */\n  #wrap(node: Text, authored: string): HTMLElement {\n    const ticker = document.createElement(\"span\");\n    ticker.setAttribute(\"data-count-up-label\", \"true\");\n    ticker.setAttribute(\"role\", \"img\");\n    ticker.setAttribute(\"aria-label\", authored);\n    node.replaceWith(ticker);\n    ticker.append(node);\n    return ticker;\n  }\n\n  /** Puts `text` back where the wrapper stood, leaving the rest of the host alone. */\n  #unwrap(ticker: HTMLElement, text: string | null): void {\n    ticker.replaceWith(document.createTextNode(text ?? ticker.textContent ?? \"\"));\n  }\n\n  /** Ends the run: cancels the frame and restores the authored presentation. */\n  #settle(): void {\n    if (this.#frame !== null) cancelAnimationFrame(this.#frame);\n    this.#frame = null;\n    const ticker = this.#ownedTicker();\n    if (ticker !== null) this.#unwrap(ticker, ticker.getAttribute(\"aria-label\"));\n    this.element.setAttribute(\"data-count-up-done\", \"true\");\n  }\n  /** Current `duration` declaration resolved against its numeric contract. */\n  get #safeDuration(): number {\n    return this.#numbers.read(\n      this,\n      \"duration\",\n      this.durationValue,\n      CountUpController.values.duration.default,\n      CountUpController.valueConstraints.duration,\n    );\n  }\n\n  /** Current `from` declaration resolved against its numeric contract. */\n  get #safeFrom(): number {\n    return this.#numbers.read(\n      this,\n      \"from\",\n      this.fromValue,\n      CountUpController.values.from.default,\n      CountUpController.valueConstraints.from,\n    );\n  }\n}\n"]}

package/dist/controllers/countdown_controller.d.ts

@@ -25,7 +25,7 @@ import { Controller } from '@hotwired/stimulus';
  * same thing twice.
  *
  * The slot is shared with the consumer. Completion writes the label in force and
- * marks it with `data-<identifier>-owns-status`, whose value is that text; while
+ * records `["text", original, written]` in `data-<identifier>-owns-status`; while
  * the slot still shows that text and nothing else, the controller keeps it on the
  * current `completeLabel` and takes it back once the timer leaves the complete
  * state — `reset`, `start()` counting on from it, or a completion the new reading
@@ -34,7 +34,7 @@ import { Controller } from '@hotwired/stimulus';
  * again.
  * An empty label puts no text there, so it never displaces what the slot already
  * holds; completing with one claims an empty slot — no text and no element — with
- * an empty marker, which owns the slot whenever it is empty. Text the consumer put
+ * a record of the empty string, which owns the slot whenever it is empty. Text the consumer put
  * there stays theirs while it is there, and so does a slot they put an element in,
  * whatever its text: the label is neither followed into it nor taken back out of
  * it, and its marker stays, until the element is gone. Only a completion with a
@@ -53,7 +53,10 @@ import { Controller } from '@hotwired/stimulus';
  * source of truth — `autostart` only decides the state of a timer whose markup does
  * not carry one. The interval is owned by `SafeInterval` and torn down on
  * `disconnect()` (Turbo navigation included); nothing else needs carrying across,
- * because every reading is re-derived from `deadline` and the wall clock.
+ * because every reading is re-derived from `deadline` and the wall clock. A change to
+ * `interval` while the timer runs re-arms the tick at the new period, keeping the run
+ * state, the reading and the completion; a paused or completed timer picks it up when
+ * it next runs.
  */
 declare class CountdownController extends Controller<HTMLElement> {
     #private;
@@ -84,6 +87,13 @@ declare class CountdownController extends Controller<HTMLElement> {
             default: string;
         };
     };
+    static valueConstraints: {
+        interval: {
+            readonly finite: true;
+            readonly exclusiveMin: 0;
+            readonly max: 2147483647;
+        };
+    };
     static actions: readonly ["pause", "reset", "resume", "start"];
     static events: readonly ["complete", "tick"];
     readonly daysTarget: HTMLElement;
@@ -91,6 +101,7 @@ declare class CountdownController extends Controller<HTMLElement> {
     readonly minutesTarget: HTMLElement;
     readonly secondsTarget: HTMLElement;
     readonly statusTarget: HTMLElement;
+    readonly statusTargets: HTMLElement[];
     readonly hasDaysTarget: boolean;
     readonly hasHoursTarget: boolean;
     readonly hasMinutesTarget: boolean;
@@ -104,6 +115,30 @@ declare class CountdownController extends Controller<HTMLElement> {
     announceTextValue: string;
     connect(): void;
     disconnect(): void;
+    /** Writes the reading on screen into a days slot that arrives at runtime. */
+    daysTargetConnected(): void;
+    /** Writes the reading on screen into the days slot that stays after another leaves. */
+    daysTargetDisconnected(): void;
+    /** Writes the reading on screen into an hours slot that arrives at runtime. */
+    hoursTargetConnected(): void;
+    /** Writes the reading on screen into the hours slot that stays after another leaves. */
+    hoursTargetDisconnected(): void;
+    /** Writes the reading on screen into a minutes slot that arrives at runtime. */
+    minutesTargetConnected(): void;
+    /** Writes the reading on screen into the minutes slot that stays after another leaves. */
+    minutesTargetDisconnected(): void;
+    /** Writes the reading on screen into a seconds slot that arrives at runtime. */
+    secondsTargetConnected(): void;
+    /** Writes the reading on screen into the seconds slot that stays after another leaves. */
+    secondsTargetDisconnected(): void;
+    /** Brings a status that arrives at runtime, when it shows this controller's text, in line. */
+    statusTargetConnected(): void;
+    /**
+     * Takes the claim off a status that no longer resolves, even after `disconnect()`, when
+     * it still shows this controller's text alone; the text stays. Brings the status that
+     * stays in line.
+     */
+    statusTargetDisconnected(status: HTMLElement): void;
     /** Re-derives the display when a morph swaps the deadline in place. */
     deadlineValueChanged(): void;
     /** Re-derives the display when a morph flips the counting direction in place. */
@@ -118,6 +153,15 @@ declare class CountdownController extends Controller<HTMLElement> {
      * left to `connect()`.
      */
     completeLabelValueChanged(): void;
+    /**
+     * Follows a tick period changed at runtime. A running countdown swaps its one interval
+     * for one at the new period, starting from now; its run state, reading, deadline and
+     * completion are untouched, and nothing ticks or repaints until the next period ends. A
+     * paused or completed countdown starts nothing and uses the new period when it next
+     * runs, and a declaration that resolves to the period already running changes nothing.
+     * Stimulus also calls this ahead of `connect()`, when no interval runs.
+     */
+    intervalValueChanged(): void;
     /**
      * Starts (or restarts after pause) ticking toward the deadline. Counting on from a
      * completion takes this controller's completion text back out of the status.