stimeo-ui 0.4.0 → 0.6.0

package/dist/controllers/checkbox_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/checkbox_controller.ts"],"names":[],"mappings":"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","file":"checkbox_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/** Aggregate selection state of a parent/child checkbox group. */\ntype CheckboxState = \"all\" | \"partial\" | \"none\";\n\n/**\n * Headless, accessible checkbox behavior (including the tri-state / parent-child\n * \"select all\" pattern).\n *\n * Markup contract (identifier: `stimeo--checkbox`):\n *   <fieldset data-controller=\"stimeo--checkbox\" role=\"group\" aria-labelledby=\"all-label\">\n *     <label id=\"all-label\">\n *       <input type=\"checkbox\" data-stimeo--checkbox-target=\"parent\"\n *              data-action=\"change->stimeo--checkbox#onParentChange\" /> Select all\n *     </label>\n *     <label><input type=\"checkbox\" data-stimeo--checkbox-target=\"child\"\n *              data-action=\"change->stimeo--checkbox#onChildChange\" /> Item A</label>\n *     <!-- more children -->\n *   </fieldset>\n *\n * Implements the WAI-ARIA APG **Checkbox** pattern. Native `<input type=\"checkbox\">`\n * is used throughout (so Space toggle, focus order, and `mixed` exposure are the\n * browser's); the controller adds what HTML cannot express: the parent's\n * `indeterminate` property (announced as `mixed`) derived from its children, and\n * the cascade from a parent toggle to its children.\n *\n * @remarks\n * Behavior only — the check mark and any \"mixed\" affordance are the consumer's\n * CSS (keyed off `:checked` / `:indeterminate` / `data-state`). A lone tri-state\n * checkbox can use just `parent` and drive `indeterminate` externally.\n *\n * Behavior provided:\n * - Parent toggle checks/unchecks every child and clears its own `indeterminate`.\n * - A child change recomputes the parent: all → checked, none → unchecked,\n *   some → `indeterminate`.\n * - The aggregate (`all` / `partial` / `none`) is mirrored to `data-state` on the\n *   root, and `stimeo--checkbox:change` is dispatched on every change.\n */\nexport class CheckboxController extends Controller<HTMLElement> {\n  static override targets = [\"parent\", \"child\"];\n  static actions = [\"onChildChange\", \"onParentChange\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly parentTarget: HTMLInputElement;\n  declare readonly hasParentTarget: boolean;\n  declare readonly childTargets: HTMLInputElement[];\n\n  /** Reflects the initial aggregate (e.g. from server-rendered child states). */\n  override connect(): void {\n    if (this.childTargets.length > 0) {\n      this.#syncFromChildren(false);\n    } else {\n      this.element.setAttribute(\"data-state\", this.#aggregate());\n    }\n  }\n\n  /** Cascades the parent's state to every child. Bound via `data-action` (change). */\n  onParentChange(): void {\n    if (!this.hasParentTarget) return;\n    const checked = this.parentTarget.checked;\n    for (const child of this.childTargets) {\n      child.checked = checked;\n    }\n    this.parentTarget.indeterminate = false;\n    const state: CheckboxState = checked ? \"all\" : \"none\";\n    this.element.setAttribute(\"data-state\", state);\n    this.dispatch(\"change\", { detail: { checked, indeterminate: false, state } });\n  }\n\n  /** Recomputes the parent from its children. Bound via `data-action` (change). */\n  onChildChange(): void {\n    this.#syncFromChildren(true);\n  }\n\n  /**\n   * Derives the parent's `checked`/`indeterminate` and the root `data-state` from\n   * the children, optionally dispatching `change`.\n   */\n  #syncFromChildren(dispatch: boolean): void {\n    const state = this.#aggregate();\n    if (this.hasParentTarget) {\n      this.parentTarget.checked = state === \"all\";\n      this.parentTarget.indeterminate = state === \"partial\";\n    }\n    this.element.setAttribute(\"data-state\", state);\n    if (dispatch) {\n      this.dispatch(\"change\", {\n        detail: {\n          checked: this.hasParentTarget ? this.parentTarget.checked : state === \"all\",\n          indeterminate: this.hasParentTarget ? this.parentTarget.indeterminate : false,\n          state,\n        },\n      });\n    }\n  }\n\n  /**\n   * Computes the aggregate state. With children it counts them; with none it\n   * reads the parent so a lone tri-state checkbox still reports a state without\n   * its externally-set `indeterminate` being clobbered.\n   */\n  #aggregate(): CheckboxState {\n    const children = this.childTargets;\n    if (children.length === 0) {\n      if (this.hasParentTarget && this.parentTarget.indeterminate) return \"partial\";\n      return this.hasParentTarget && this.parentTarget.checked ? \"all\" : \"none\";\n    }\n    const checked = children.filter((child) => child.checked).length;\n    if (checked === 0) return \"none\";\n    if (checked === children.length) return \"all\";\n    return \"partial\";\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/microtask_coalescer.ts","../../src/controllers/checkbox_controller.ts"],"names":[],"mappings":"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","file":"checkbox_controller.js","sourcesContent":["/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\n\n/** Aggregate selection state of a parent/child checkbox group. */\ntype CheckboxState = \"all\" | \"partial\" | \"none\";\n\n/**\n * Headless, accessible checkbox behavior (including the tri-state / parent-child\n * \"select all\" pattern).\n *\n * Markup contract (identifier: `stimeo--checkbox`):\n *   <fieldset data-controller=\"stimeo--checkbox\" role=\"group\" aria-labelledby=\"all-label\">\n *     <label id=\"all-label\">\n *       <input type=\"checkbox\" data-stimeo--checkbox-target=\"parent\"\n *              data-action=\"change->stimeo--checkbox#onParentChange\" /> Select all\n *     </label>\n *     <label><input type=\"checkbox\" data-stimeo--checkbox-target=\"child\"\n *              data-action=\"change->stimeo--checkbox#onChildChange\" /> Item A</label>\n *     <!-- more children -->\n *   </fieldset>\n *\n * Implements the WAI-ARIA APG **Checkbox** pattern. Native `<input type=\"checkbox\">`\n * is used throughout (so Space toggle, focus order, and `mixed` exposure are the\n * browser's); the controller adds what HTML cannot express: the parent's\n * `indeterminate` property (announced as `mixed`) derived from its children, and\n * the cascade from a parent toggle to its children.\n *\n * @remarks\n * Behavior only — the check mark and any \"mixed\" affordance are the consumer's\n * CSS (keyed off `:checked` / `:indeterminate` / `data-state`). The `parent`\n * target is optional: a child-only group still exposes its aggregate on the root,\n * while a lone tri-state checkbox can use just `parent` and drive\n * `indeterminate` externally — with no `child` target the parent's own `checked`\n * and `indeterminate` stay the consumer's, because only children are\n * authoritative over them. At most one `parent` may be present.\n *\n * Behavior provided:\n * - Parent toggle checks/unchecks every child and clears its own `indeterminate`.\n *   All child targets, including disabled ones, participate; omit the target to\n *   exclude an input. The cascade does not synthesize native child `change`\n *   events — one aggregate custom event describes the action.\n * - A child change recomputes the parent: all → checked, none → unchecked,\n *   some → `indeterminate`.\n * - The aggregate (`all` / `partial` / `none`) is mirrored to `data-state` on the\n *   root. Dynamic targets, checked-attribute changes, Turbo morphs, and native\n *   form resets are reconciled from the children. Callers that assign the live\n *   `checked` property directly must dispatch `change`, because property writes\n *   are not observable by a `MutationObserver`.\n * - `stimeo--checkbox:change` is dispatched for the two public change actions;\n *   `stimeo--checkbox:reconcile` is dispatched instead when a reconciliation —\n *   not the user — moves the aggregate. Both carry `{ checked: boolean,\n *   indeterminate: boolean, state: \"all\" | \"partial\" | \"none\" }` and describe\n *   the aggregate even without a parent. Neither fires on connect.\n */\nexport class CheckboxController extends Controller<HTMLElement> {\n  static override targets = [\"parent\", \"child\"];\n  static actions = [\"onChildChange\", \"onParentChange\"] as const;\n  static events = [\"change\", \"reconcile\"] as const;\n\n  declare readonly parentTarget: HTMLInputElement;\n  declare readonly parentTargets: HTMLInputElement[];\n  declare readonly hasParentTarget: boolean;\n  declare readonly childTargets: HTMLInputElement[];\n\n  /** Collapses every lifecycle signal from one DOM update into one derived pass. */\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileFromChildren());\n  /** Aggregate this root last settled on, so a derived repair is reported once. */\n  #committedState: CheckboxState | null = null;\n  /** Watches authored checked-attribute changes on retained target elements. */\n  readonly #checkedObserver = new MutationObserver((records) => {\n    if (records.some((record) => this.#isManagedCheckbox(record.target))) {\n      this.#reconcile.schedule();\n    }\n  });\n\n  /** Reflects the initial aggregate and starts retained-DOM reconciliation. */\n  override connect(): void {\n    this.#reconcile.activate();\n    this.#syncFromChildren();\n    this.#checkedObserver.observe(this.element, {\n      attributes: true,\n      attributeFilter: [\"checked\"],\n      subtree: true,\n    });\n    this.element.addEventListener(\"turbo:morph-element\", this.#onMorph);\n    document.addEventListener(\"reset\", this.#onReset, true);\n  }\n\n  /** Releases the observer, global reset listener, and every pending reconciliation. */\n  override disconnect(): void {\n    this.#reconcile.cancel();\n    this.#checkedObserver.disconnect();\n    this.element.removeEventListener(\"turbo:morph-element\", this.#onMorph);\n    document.removeEventListener(\"reset\", this.#onReset, true);\n  }\n\n  /** Reconciles the aggregate for a parent added or replaced at runtime. */\n  parentTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles the aggregate after a parent target leaves the group. */\n  parentTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles the aggregate for a child added at runtime. */\n  childTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles the aggregate after a child leaves the group. */\n  childTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Cascades the parent's state to every child. Bound via `data-action` (change). */\n  onParentChange(): void {\n    if (!this.hasParentTarget) return;\n    const checked = this.parentTarget.checked;\n    for (const child of this.childTargets) {\n      child.checked = checked;\n    }\n    this.#reflect(checked ? \"all\" : \"none\", true);\n    const detail = this.#settledDetail();\n    if (detail) this.dispatch(\"change\", { detail });\n  }\n\n  /** Recomputes the parent from its children. Bound via `data-action` (change). */\n  onChildChange(): void {\n    this.#syncFromChildren();\n    const detail = this.#settledDetail();\n    if (detail) this.dispatch(\"change\", { detail });\n  }\n\n  /**\n   * Announces an aggregate this pass derived rather than the user. `change` stays\n   * reserved for the two public actions, so automation never reads a repair as an edit.\n   */\n  #reconcileFromChildren(): void {\n    const previous = this.#committedState;\n    this.#syncFromChildren();\n    if (this.#committedState === previous) return;\n    const detail = this.#settledDetail();\n    if (detail) this.dispatch(\"reconcile\", { detail });\n  }\n\n  /**\n   * Derives the parent's `checked`/`indeterminate` and the root `data-state` from\n   * the children. Writing state and reporting it are separate so the caller — not\n   * a flag threaded through the write — decides which event describes the cause.\n   */\n  #syncFromChildren(): void {\n    // A childless root reads its aggregate off the parent itself, so writing the\n    // derived value back would clear a `checked` the consumer drives alongside\n    // `indeterminate`. Only the children are authoritative over the parent.\n    this.#reflect(this.#aggregate(), this.childTargets.length > 0);\n  }\n\n  /**\n   * Reflects one aggregate state.\n   *\n   * @param writeParent - whether the state is authoritative over the `parent`\n   * target's own `checked` / `indeterminate`.\n   */\n  #reflect(state: CheckboxState, writeParent: boolean): void {\n    if (writeParent && this.hasParentTarget) {\n      this.parentTarget.checked = state === \"all\";\n      this.parentTarget.indeterminate = state === \"partial\";\n    }\n    this.element.setAttribute(\"data-state\", state);\n    this.#committedState = state;\n  }\n\n  /** The settled aggregate as event detail, or `null` before anything has settled. */\n  #settledDetail(): { checked: boolean; indeterminate: boolean; state: CheckboxState } | null {\n    const state = this.#committedState;\n    if (state === null) return null;\n    return { checked: state === \"all\", indeterminate: state === \"partial\", state };\n  }\n\n  /** Reconciles retained targets after Turbo has finished morphing their live state. */\n  readonly #onMorph = (): void => {\n    this.#reconcile.schedule();\n  };\n\n  /** Reconciles after a non-cancelled reset restores any managed checkbox. */\n  readonly #onReset = (event: Event): void => {\n    const form = event.target;\n    if (!(form instanceof HTMLFormElement) || !this.#hasCheckboxOwnedBy(form)) return;\n    queueMicrotask(() => {\n      if (!event.defaultPrevented) this.#reconcile.schedule();\n    });\n  };\n\n  /** Whether a form owns at least one current parent or child target. */\n  #hasCheckboxOwnedBy(form: HTMLFormElement): boolean {\n    return [...this.parentTargets, ...this.childTargets].some((checkbox) => checkbox.form === form);\n  }\n\n  /** Whether an observed attribute mutation belongs to this controller's target set. */\n  #isManagedCheckbox(node: Node): boolean {\n    return (\n      this.parentTargets.some((checkbox) => checkbox === node) ||\n      this.childTargets.some((checkbox) => checkbox === node)\n    );\n  }\n\n  /**\n   * Computes the aggregate state. With children it counts them; with none it\n   * reads the parent so a lone tri-state checkbox still reports a state without\n   * its externally-set `indeterminate` being clobbered.\n   */\n  #aggregate(): CheckboxState {\n    const children = this.childTargets;\n    if (children.length === 0) {\n      if (this.hasParentTarget && this.parentTarget.indeterminate) return \"partial\";\n      return this.hasParentTarget && this.parentTarget.checked ? \"all\" : \"none\";\n    }\n    const checked = children.filter((child) => child.checked).length;\n    if (checked === 0) return \"none\";\n    if (checked === children.length) return \"all\";\n    return \"partial\";\n  }\n}\n"]}

package/dist/controllers/clipboard_controller.js

@@ -2,6 +2,13 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/clipboard_controller.ts
 
+// src/utils/default_attribute.ts
+function setDefaultAttribute(element, name, value) {
+  if (element.hasAttribute(name)) return false;
+  element.setAttribute(name, value);
+  return true;
+}
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -75,9 +82,7 @@ var ClipboardController = class extends Controller {
    */
   #resetTimerId = null;
   connect() {
-    if (!this.element.hasAttribute("data-state")) {
-      this.element.setAttribute("data-state", "idle");
-    }
+    setDefaultAttribute(this.element, "data-state", "idle");
   }
   disconnect() {
     this.#timers.clearAll();

package/dist/controllers/clipboard_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/clipboard_controller.ts"],"names":[],"mappings":"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","file":"clipboard_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 copy-to-clipboard behavior with a live-region completion notice.\n *\n * Markup contract (identifier: `stimeo--clipboard`):\n *   <div data-controller=\"stimeo--clipboard\"\n *        data-stimeo--clipboard-feedback-duration-value=\"2000\">\n *     <input type=\"text\" value=\"https://example.com\" readonly\n *            data-stimeo--clipboard-target=\"source\">\n *     <button type=\"button\" data-stimeo--clipboard-target=\"button\"\n *             data-action=\"stimeo--clipboard#copy\">Copy</button>\n *     <span role=\"status\" aria-live=\"polite\"\n *           data-stimeo--clipboard-target=\"feedback\"></span>\n *   </div>\n *\n * No dedicated APG pattern; this follows the Button + live-region practice. The\n * copy uses the standard `navigator.clipboard` API (no extra dependency); when\n * it is unavailable or rejects, the failure is surfaced rather than silently\n * swallowed, and never communicated by icon alone — the `role=\"status\"` region\n * carries text so screen readers announce the outcome.\n *\n * @remarks\n * Behavior only — icon swaps and styling are the consumer's, keyed off\n * `data-state` (`idle` / `copied` / `error`). The completion notice clears\n * itself after `feedbackDuration`; that timer is torn down on disconnect (Turbo)\n * via {@link SafeTimeout}.\n */\nexport class ClipboardController extends Controller<HTMLElement> {\n  static override targets = [\"source\", \"button\", \"feedback\"];\n  static override values = {\n    text: { type: String, default: \"\" },\n    feedbackDuration: { type: Number, default: 2000 },\n    copiedLabel: { type: String, default: \"Copied\" },\n    errorLabel: { type: String, default: \"Copy failed\" },\n  };\n  static actions = [\"copy\"] as const;\n  static events = [\"copy\"] as const;\n\n  declare readonly sourceTarget: HTMLElement;\n  declare readonly buttonTarget: HTMLElement;\n  declare readonly feedbackTarget: HTMLElement;\n  declare readonly hasSourceTarget: boolean;\n  declare readonly hasButtonTarget: boolean;\n  declare readonly hasFeedbackTarget: boolean;\n\n  declare textValue: string;\n  declare feedbackDurationValue: number;\n  declare copiedLabelValue: string;\n  declare errorLabelValue: string;\n\n  /** Auto-clear timer for the completion notice; torn down on disconnect. */\n  #timers = new SafeTimeout();\n\n  /**\n   * The pending auto-clear timer id, or `null` when none is scheduled. Tracked so\n   * a rapid second copy cancels the first window instead of letting a stale timer\n   * reset the freshly-shown notice early.\n   */\n  #resetTimerId: number | null = null;\n\n  override connect(): void {\n    if (!this.element.hasAttribute(\"data-state\")) {\n      this.element.setAttribute(\"data-state\", \"idle\");\n    }\n  }\n\n  override disconnect(): void {\n    this.#timers.clearAll();\n  }\n\n  /**\n   * Copies the resolved text and reports the outcome. Bound via `data-action`\n   * (click). Always dispatches `stimeo--clipboard:copy` with `{ success, text }`\n   * — including on failure — so consumers can react either way.\n   */\n  async copy(): Promise<void> {\n    const text = this.#resolveText();\n    let success = false;\n    try {\n      if (!navigator.clipboard?.writeText) throw new Error(\"Clipboard API unavailable\");\n      await navigator.clipboard.writeText(text);\n      success = true;\n    } catch {\n      success = false;\n    }\n\n    this.#reportResult(success);\n    this.dispatch(\"copy\", { detail: { success, text } });\n  }\n\n  /**\n   * The text to copy: the explicit `text` value when set, otherwise the source\n   * target's current value (inputs/textareas) or text content.\n   */\n  #resolveText(): string {\n    if (this.textValue.length > 0) return this.textValue;\n    if (!this.hasSourceTarget) return \"\";\n    const source = this.sourceTarget;\n    if (source instanceof HTMLInputElement || source instanceof HTMLTextAreaElement) {\n      return source.value;\n    }\n    return source.textContent ?? \"\";\n  }\n\n  /** Reflects the result on `data-state`, announces it, and schedules a reset. */\n  #reportResult(success: boolean): void {\n    this.element.setAttribute(\"data-state\", success ? \"copied\" : \"error\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = success ? this.copiedLabelValue : this.errorLabelValue;\n    }\n\n    // Cancel any in-flight reset so consecutive copies restart the full window\n    // rather than having the earlier timer clear the new notice prematurely.\n    if (this.#resetTimerId !== null) {\n      this.#timers.clear(this.#resetTimerId);\n      this.#resetTimerId = null;\n    }\n    if (this.feedbackDurationValue > 0) {\n      this.#resetTimerId = this.#timers.set(() => {\n        this.#resetTimerId = null;\n        this.#reset();\n      }, this.feedbackDurationValue);\n    }\n  }\n\n  /** Returns to the idle state and clears the completion notice. */\n  #reset(): void {\n    this.element.setAttribute(\"data-state\", \"idle\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = \"\";\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/default_attribute.ts","../../src/utils/safe_timeout.ts","../../src/controllers/clipboard_controller.ts"],"names":[],"mappings":"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","file":"clipboard_controller.js","sourcesContent":["/**\n * Adds an attribute default without displacing an authored value.\n *\n * Attribute presence — including an authored empty string — is the ownership\n * boundary. The return value lets a caller remember that it supplied the\n * default when that caller must later restore the authored state.\n *\n * @param element - Element that owns the attribute\n * @param name - Attribute name\n * @param value - Value to write only when the attribute is absent\n * @returns Whether this call added the attribute\n */\nexport function setDefaultAttribute(element: Element, name: string, value: string): boolean {\n  if (element.hasAttribute(name)) return false;\n  element.setAttribute(name, value);\n  return true;\n}\n","/**\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 { setDefaultAttribute } from \"../utils/default_attribute\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless copy-to-clipboard behavior with a live-region completion notice.\n *\n * Markup contract (identifier: `stimeo--clipboard`):\n *   <div data-controller=\"stimeo--clipboard\"\n *        data-stimeo--clipboard-feedback-duration-value=\"2000\">\n *     <input type=\"text\" value=\"https://example.com\" readonly\n *            data-stimeo--clipboard-target=\"source\">\n *     <button type=\"button\" data-stimeo--clipboard-target=\"button\"\n *             data-action=\"stimeo--clipboard#copy\">Copy</button>\n *     <span role=\"status\" aria-live=\"polite\"\n *           data-stimeo--clipboard-target=\"feedback\"></span>\n *   </div>\n *\n * No dedicated APG pattern; this follows the Button + live-region practice. The\n * copy uses the standard `navigator.clipboard` API (no extra dependency); when\n * it is unavailable or rejects, the failure is surfaced rather than silently\n * swallowed, and never communicated by icon alone — the `role=\"status\"` region\n * carries text so screen readers announce the outcome.\n *\n * @remarks\n * Behavior only — icon swaps and styling are the consumer's, keyed off\n * `data-state` (`idle` / `copied` / `error`). The completion notice clears\n * itself after `feedbackDuration`; that timer is torn down on disconnect (Turbo)\n * via {@link SafeTimeout}.\n */\nexport class ClipboardController extends Controller<HTMLElement> {\n  static override targets = [\"source\", \"button\", \"feedback\"];\n  static override values = {\n    text: { type: String, default: \"\" },\n    feedbackDuration: { type: Number, default: 2000 },\n    copiedLabel: { type: String, default: \"Copied\" },\n    errorLabel: { type: String, default: \"Copy failed\" },\n  };\n  static actions = [\"copy\"] as const;\n  static events = [\"copy\"] as const;\n\n  declare readonly sourceTarget: HTMLElement;\n  declare readonly buttonTarget: HTMLElement;\n  declare readonly feedbackTarget: HTMLElement;\n  declare readonly hasSourceTarget: boolean;\n  declare readonly hasButtonTarget: boolean;\n  declare readonly hasFeedbackTarget: boolean;\n\n  declare textValue: string;\n  declare feedbackDurationValue: number;\n  declare copiedLabelValue: string;\n  declare errorLabelValue: string;\n\n  /** Auto-clear timer for the completion notice; torn down on disconnect. */\n  #timers = new SafeTimeout();\n\n  /**\n   * The pending auto-clear timer id, or `null` when none is scheduled. Tracked so\n   * a rapid second copy cancels the first window instead of letting a stale timer\n   * reset the freshly-shown notice early.\n   */\n  #resetTimerId: number | null = null;\n\n  override connect(): void {\n    setDefaultAttribute(this.element, \"data-state\", \"idle\");\n  }\n\n  override disconnect(): void {\n    this.#timers.clearAll();\n  }\n\n  /**\n   * Copies the resolved text and reports the outcome. Bound via `data-action`\n   * (click). Always dispatches `stimeo--clipboard:copy` with `{ success, text }`\n   * — including on failure — so consumers can react either way.\n   */\n  async copy(): Promise<void> {\n    const text = this.#resolveText();\n    let success = false;\n    try {\n      if (!navigator.clipboard?.writeText) throw new Error(\"Clipboard API unavailable\");\n      await navigator.clipboard.writeText(text);\n      success = true;\n    } catch {\n      success = false;\n    }\n\n    this.#reportResult(success);\n    this.dispatch(\"copy\", { detail: { success, text } });\n  }\n\n  /**\n   * The text to copy: the explicit `text` value when set, otherwise the source\n   * target's current value (inputs/textareas) or text content.\n   */\n  #resolveText(): string {\n    if (this.textValue.length > 0) return this.textValue;\n    if (!this.hasSourceTarget) return \"\";\n    const source = this.sourceTarget;\n    if (source instanceof HTMLInputElement || source instanceof HTMLTextAreaElement) {\n      return source.value;\n    }\n    return source.textContent ?? \"\";\n  }\n\n  /** Reflects the result on `data-state`, announces it, and schedules a reset. */\n  #reportResult(success: boolean): void {\n    this.element.setAttribute(\"data-state\", success ? \"copied\" : \"error\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = success ? this.copiedLabelValue : this.errorLabelValue;\n    }\n\n    // Cancel any in-flight reset so consecutive copies restart the full window\n    // rather than having the earlier timer clear the new notice prematurely.\n    if (this.#resetTimerId !== null) {\n      this.#timers.clear(this.#resetTimerId);\n      this.#resetTimerId = null;\n    }\n    if (this.feedbackDurationValue > 0) {\n      this.#resetTimerId = this.#timers.set(() => {\n        this.#resetTimerId = null;\n        this.#reset();\n      }, this.feedbackDurationValue);\n    }\n  }\n\n  /** Returns to the idle state and clears the completion notice. */\n  #reset(): void {\n    this.element.setAttribute(\"data-state\", \"idle\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = \"\";\n    }\n  }\n}\n"]}

package/dist/controllers/collapsible_controller.d.ts

@@ -22,7 +22,7 @@ import { Controller } from '@hotwired/stimulus';
  * The controller keeps the open lifecycle ordered so `hidden` (effectively
  * `display:none`) never blocks measurement or the transition:
  * - **Open**: drop `hidden` → measure the natural height into
- *   `--stimeo-collapsible-content-height` → set `data-state="open"`.
+ *   `--stimeo--collapsible-content-height` → set `data-state="open"`.
  * - **Close**: set `data-state="closed"` (CSS shrinks the height) → re-apply
  *   `hidden` once the transition settles. With no transition (or reduced motion,
  *   which the consumer's CSS expresses as a zero duration) it is applied

package/dist/controllers/collapsible_controller.js

@@ -297,7 +297,10 @@ var CollapsibleController = class extends Controller {
   #applyContent(content, open, waitForCloseTransition) {
     if (open) {
       content.hidden = false;
-      content.style.setProperty("--stimeo-collapsible-content-height", `${content.scrollHeight}px`);
+      content.style.setProperty(
+        "--stimeo--collapsible-content-height",
+        `${content.scrollHeight}px`
+      );
       content.setAttribute("data-state", "open");
       return;
     }

package/dist/controllers/collapsible_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/utils/transition_completion.ts","../../src/controllers/collapsible_controller.ts"],"names":[],"mappings":"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","file":"collapsible_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 { SafeTimeout } from \"./safe_timeout\";\n\n/** Computed transition fields needed to determine when an element has settled. */\nexport type TransitionStyle = Pick<\n  CSSStyleDeclaration,\n  \"transitionProperty\" | \"transitionDuration\" | \"transitionDelay\"\n>;\n\n/** Parsed transition property paired with its effective duration and delay. */\ninterface TransitionTiming {\n  property: string;\n  totalMs: number;\n}\n\n/** Parses a CSS `<time>` into milliseconds, returning `0` for malformed values. */\nfunction timeMs(value: string): number {\n  const trimmed = value.trim();\n  const amount = Number.parseFloat(trimmed);\n  if (!Number.isFinite(amount)) return 0;\n  if (trimmed.endsWith(\"ms\")) return amount;\n  if (trimmed.endsWith(\"s\")) return amount * 1000;\n  return 0;\n}\n\n/** Splits a computed comma-separated CSS list into normalized, non-empty items. */\nfunction cssList(value: string): string[] {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * Pairs transition properties, durations, and delays using CSS list repetition.\n *\n * The `transition-property` list determines the number of transitions. Shorter\n * duration/delay lists repeat, while extra values are ignored. A negative delay\n * shortens the remaining wall-clock time, and a non-positive total is settled.\n */\nfunction transitionTimings(style: TransitionStyle): TransitionTiming[] {\n  const properties = cssList(style.transitionProperty);\n  const durations = cssList(style.transitionDuration).map(timeMs);\n  const delays = cssList(style.transitionDelay).map(timeMs);\n  const effectiveProperties =\n    properties.length > 0\n      ? properties\n      : Array.from({ length: Math.max(durations.length, delays.length, 1) }, () => \"all\");\n  const effectiveDurations = durations.length > 0 ? durations : [0];\n  const effectiveDelays = delays.length > 0 ? delays : [0];\n\n  return effectiveProperties\n    .filter((property) => property !== \"none\")\n    .map((property, index) => ({\n      property,\n      totalMs: Math.max(\n        0,\n        (effectiveDurations[index % effectiveDurations.length] ?? 0) +\n          (effectiveDelays[index % effectiveDelays.length] ?? 0),\n      ),\n    }));\n}\n\n/** Maximum total over already-parsed timings (0 when the list is empty). */\nfunction maxTotalMs(timings: TransitionTiming[]): number {\n  return timings.reduce((max, { totalMs }) => Math.max(max, totalMs), 0);\n}\n\n/** Maximum effective transition duration plus delay, in milliseconds. */\nexport function maxTransitionTotalMs(style: TransitionStyle): number {\n  return maxTotalMs(transitionTimings(style));\n}\n\n/** Optional tuning for a single {@link TransitionCompletion.wait} call. */\nexport interface TransitionWaitOptions {\n  /**\n   * Positive wall-clock override (ms) for the bounded fallback, replacing the\n   * auto-computed `max + 50ms` timer verbatim. It also keeps the wait armed for\n   * a computed 0ms transition (no synchronous completion): the consumer asserts\n   * a transition budget that computed styles cannot see. Non-positive and\n   * non-finite (`NaN` / `Infinity`) values are ignored.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Owns one cancellable wait for an element's CSS transitions to settle.\n *\n * When available, active CSS transitions provide their expanded property names.\n * Tracking those names lets shorthand declarations settle from their longhand\n * terminal events. A terminal event from an interrupted phase is ignored while a\n * replacement transition for the same property is still active. Because that set\n * is sampled when the wait is armed, a property whose transition only starts a\n * frame later would otherwise be settled over; the still-running set is therefore\n * re-read before completing and adopted when it is not yet empty. Without Web\n * Animations data, explicit transition properties retain the declared-property\n * behavior and the ambiguous `transition-property: all` form waits until the\n * computed maximum wall-clock time. A `max + 50ms` timeout is always armed\n * because browsers emit no terminal event when a property never transitions, an\n * ancestor disappears, or rendering is otherwise interrupted; a consumer with\n * better knowledge can replace that fallback via\n * {@link TransitionWaitOptions.timeoutMs}.\n */\nexport class TransitionCompletion {\n  readonly #timers = new SafeTimeout();\n  #element: HTMLElement | null = null;\n  #complete: (() => void) | null = null;\n  #pendingProperties: Set<string> | null = null;\n  #deadline = 0;\n\n  /**\n   * Replaces any prior wait and invokes `complete` synchronously for a 0ms\n   * transition (including when `getComputedStyle` is unavailable).\n   *\n   * With a positive `options.timeoutMs` the synchronous fast-path is skipped and\n   * the override replaces the auto-computed fallback (see {@link TransitionWaitOptions}).\n   */\n  wait(element: HTMLElement, complete: () => void, options: TransitionWaitOptions = {}): void {\n    this.cancel();\n\n    const requested = options.timeoutMs ?? 0;\n    const override = Number.isFinite(requested) && requested > 0 ? requested : 0;\n    // A non-browser / partial-DOM environment cannot report a computable\n    // transition, which is indistinguishable from a 0ms one.\n    const timings =\n      typeof window.getComputedStyle === \"function\"\n        ? transitionTimings(window.getComputedStyle(element))\n        : [];\n    const maximum = maxTotalMs(timings);\n    if (maximum <= 0 && override <= 0) {\n      complete();\n      return;\n    }\n\n    this.#element = element;\n    this.#complete = complete;\n    this.#deadline = Date.now() + maximum;\n    const activeProperties = this.#activeTransitionProperties(element);\n    this.#pendingProperties =\n      activeProperties.size > 0 ? activeProperties : this.#explicitPendingProperties(timings);\n    element.addEventListener(\"transitionend\", this.#onTerminal);\n    element.addEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#timers.set(() => this.#finish(), override > 0 ? override : maximum + 50);\n  }\n\n  /** Cancels the pending wait without invoking its completion callback. */\n  cancel(): void {\n    this.#complete = null;\n    this.#teardown();\n  }\n\n  /**\n   * Handles terminal events from the observed element only.\n   *\n   * For explicit property lists, every declared positive-time property must\n   * settle. For `all`, no reliable property set exists, so an event can finish\n   * only after the computed maximum time; the safety timeout owns the usual path.\n   */\n  readonly #onTerminal = (event: Event): void => {\n    if (event.target !== this.#element) return;\n    const transitionEvent = event as TransitionEvent;\n    // A pseudo-element's transition is reported with its originating element\n    // as `target`; it must not settle the element's own transition.\n    if (transitionEvent.pseudoElement) return;\n\n    if (this.#pendingProperties) {\n      const propertyName = transitionEvent.propertyName;\n      const active = this.#activeTransitionProperties(this.#element);\n      // An interrupted transition queues its cancel event before the replacement\n      // phase starts, but dispatch can happen after the new wait is armed. The\n      // replacement is then the active transition for this property, so the stale\n      // terminal event must not settle the new phase.\n      if (active.has(propertyName)) return;\n      if (!this.#pendingProperties.delete(propertyName)) return;\n      if (this.#pendingProperties.size > 0) return;\n      // The tracked set is an arm-time snapshot, so a transition the phase starts\n      // one frame later is absent from it. Re-reading the still-running set before\n      // settling adopts those stragglers instead of completing over them; the\n      // fallback timer stays armed, so this cannot extend the wait unboundedly.\n      if (active.size > 0) {\n        this.#pendingProperties = active;\n        return;\n      }\n      this.#finish();\n      return;\n    }\n\n    if (Date.now() >= this.#deadline) this.#finish();\n  };\n\n  /**\n   * Returns active CSS transition properties expanded to the names reported by\n   * terminal events. CSS animations and pseudo-element effects are excluded.\n   */\n  #activeTransitionProperties(element: HTMLElement | null): Set<string> {\n    if (!element || typeof element.getAnimations !== \"function\") return new Set();\n\n    try {\n      const properties = element.getAnimations().flatMap((animation) => {\n        if (animation.playState === \"idle\" || animation.playState === \"finished\") return [];\n        const effect = animation.effect as KeyframeEffect | null;\n        // A pseudo-element effect names the originating element as its target, so\n        // `target` alone cannot separate it. Its terminal events are ignored, so\n        // tracking its properties would only strand the wait on the fallback.\n        if (effect?.pseudoElement) return [];\n        const target = effect?.target;\n        if (target && target !== element) return [];\n        const property = (animation as Partial<CSSTransition>).transitionProperty;\n        return typeof property === \"string\" && property.length > 0 ? [property] : [];\n      });\n      return new Set(properties);\n    } catch {\n      // Partial DOM implementations can expose getAnimations without supporting\n      // it. The declared-property tracker and bounded timer remain safe fallbacks.\n      return new Set();\n    }\n  }\n\n  /** Returns explicit positive-time properties, or `null` for the ambiguous `all`. */\n  #explicitPendingProperties(timings: TransitionTiming[]): Set<string> | null {\n    if (timings.some(({ property }) => property === \"all\")) return null;\n    const pending = new Set(\n      timings.filter(({ totalMs }) => totalMs > 0).map(({ property }) => property),\n    );\n    // An empty set is only reachable through a timeout override (a 0ms transition\n    // otherwise completes synchronously). With nothing to track, fall back to the\n    // deadline rule so any terminal event can settle the wait, exactly like `all`.\n    return pending.size > 0 ? pending : null;\n  }\n\n  /** Completes exactly once, releasing listeners and the fallback before the callback. */\n  #finish(): void {\n    const complete = this.#complete;\n    if (!complete) return;\n    this.#complete = null;\n    this.#teardown();\n    complete();\n  }\n\n  /** Releases the exact element listeners and timer owned by the current wait. */\n  #teardown(): void {\n    this.#timers.clearAll();\n    this.#element?.removeEventListener(\"transitionend\", this.#onTerminal);\n    this.#element?.removeEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#element = null;\n    this.#pendingProperties = null;\n    this.#deadline = 0;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { TransitionCompletion } from \"../utils/transition_completion\";\n\n/**\n * Headless, accessible single-disclosure (collapsible) behavior.\n *\n * Markup contract (identifier: `stimeo--collapsible`):\n *   <div data-controller=\"stimeo--collapsible\">\n *     <button data-stimeo--collapsible-target=\"trigger\"\n *             data-action=\"stimeo--collapsible#toggle\"\n *             aria-expanded=\"false\" aria-controls=\"more\">Show details</button>\n *     <div id=\"more\" data-stimeo--collapsible-target=\"content\"\n *          data-state=\"closed\" hidden>…</div>\n *   </div>\n *\n * Implements the WAI-ARIA APG **Disclosure** pattern for a single inline region.\n * Unlike {@link AccordionController} it manages exactly one trigger/content pair\n * with no sibling coordination, and unlike a dropdown the content expands in\n * flow and never closes on an outside click.\n *\n * @remarks\n * Behavior only — the consumer owns the height transition and all decoration.\n * The controller keeps the open lifecycle ordered so `hidden` (effectively\n * `display:none`) never blocks measurement or the transition:\n * - **Open**: drop `hidden` → measure the natural height into\n *   `--stimeo-collapsible-content-height` → set `data-state=\"open\"`.\n * - **Close**: set `data-state=\"closed\"` (CSS shrinks the height) → re-apply\n *   `hidden` once the transition settles. With no transition (or reduced motion,\n *   which the consumer's CSS expresses as a zero duration) it is applied\n *   immediately; an owned fallback covers missing terminal events.\n */\nexport class CollapsibleController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"content\"];\n  static override values = {\n    open: { type: Boolean, default: false },\n  };\n  static actions = [\"toggle\"] as const;\n\n  declare readonly triggerTarget: HTMLElement;\n  declare readonly contentTarget: HTMLElement;\n  declare readonly hasTriggerTarget: boolean;\n  declare readonly hasContentTarget: boolean;\n\n  declare openValue: boolean;\n\n  /** Owns the cancellable close-transition wait and its bounded fallback. */\n  readonly #transition = new TransitionCompletion();\n  /** Distinguishes dynamic target churn from the callbacks that precede `connect()`. */\n  #connected = false;\n\n  /**\n   * Establishes the initial open/closed state without waiting for a close transition.\n   *\n   * The DOM is the source of truth on reconnect (Turbo cache restore / morph): an\n   * **explicit** state attribute — `aria-expanded=\"true\"`/`\"false\"` (or, with no\n   * trigger, `data-state=\"open\"`/`\"closed\"`) — is honored verbatim so a region the\n   * user opened *or* closed survives a back-navigation, even when the declarative\n   * `open` Value disagrees. An already-open region remains open without a\n   * close/reopen cycle. The Value only seeds a genuinely fresh render where no\n   * state attribute is present yet; any opening animation in that case belongs to\n   * the consumer's CSS. Mirrors `sidebar`'s `#restoreCollapsed`.\n   */\n  override connect(): void {\n    this.#connected = true;\n    this.#apply(this.#initialOpen(), false);\n  }\n\n  /** Resolves the connect-time state: explicit DOM state wins, else the `open` Value. */\n  #initialOpen(): boolean {\n    if (this.hasTriggerTarget) {\n      const expanded = this.triggerTarget.getAttribute(\"aria-expanded\");\n      if (expanded === \"true\") return true;\n      if (expanded === \"false\") return false;\n    } else if (this.hasContentTarget) {\n      const state = this.contentTarget.getAttribute(\"data-state\");\n      if (state === \"open\") return true;\n      if (state === \"closed\") return false;\n    }\n    return this.openValue;\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#transition.cancel();\n  }\n\n  /** Reconciles a replacement trigger target with the content's live state. */\n  triggerTargetConnected(trigger: HTMLElement): void {\n    if (!this.#connected || !this.hasContentTarget) return;\n    trigger.setAttribute(\n      \"aria-expanded\",\n      this.contentTarget.getAttribute(\"data-state\") === \"open\" ? \"true\" : \"false\",\n    );\n  }\n\n  /** Reconciles a replacement content target with the disclosure's live state. */\n  contentTargetConnected(content: HTMLElement): void {\n    if (!this.#connected) return;\n    this.#transition.cancel();\n    const open = this.hasTriggerTarget\n      ? this.triggerTarget.getAttribute(\"aria-expanded\") === \"true\"\n      : content.getAttribute(\"data-state\") === \"open\";\n    this.#applyContent(content, open, false);\n  }\n\n  /** Cancels a wait tied to a content target that was removed or replaced. */\n  contentTargetDisconnected(): void {\n    this.#transition.cancel();\n  }\n\n  /** Toggles the region open/closed. Bound via `data-action` (click). */\n  toggle(): void {\n    this.#apply(!this.#isOpen, true);\n  }\n\n  /**\n   * Whether the region is logically open. Read from `aria-expanded` (not the\n   * content's `hidden`) so a click *during* a close transition — when `hidden`\n   * is still deferred — correctly reopens instead of re-closing.\n   */\n  get #isOpen(): boolean {\n    if (this.hasTriggerTarget) {\n      return this.triggerTarget.getAttribute(\"aria-expanded\") === \"true\";\n    }\n    return this.hasContentTarget && this.contentTarget.getAttribute(\"data-state\") === \"open\";\n  }\n\n  /**\n   * Drives the disclosure to `open`, syncing the trigger's `aria-expanded` and\n   * the content's `hidden` / `data-state` / height variable in an order where\n   * `hidden` never blocks measurement or the transition.\n   *\n   * @param open - Target state.\n   * @param waitForCloseTransition - When `false` (initial `connect`) the close\n   *   path applies `hidden` immediately. This flag does not suppress consumer CSS\n   *   on the open path.\n   */\n  #apply(open: boolean, waitForCloseTransition: boolean): void {\n    if (this.hasTriggerTarget) {\n      this.triggerTarget.setAttribute(\"aria-expanded\", open ? \"true\" : \"false\");\n    }\n    if (!this.hasContentTarget) return;\n\n    const content = this.contentTarget;\n    this.#transition.cancel();\n    this.#applyContent(content, open, waitForCloseTransition);\n  }\n\n  /** Reflects one content target without relying on a later target lookup. */\n  #applyContent(content: HTMLElement, open: boolean, waitForCloseTransition: boolean): void {\n    if (open) {\n      content.hidden = false;\n      // Measure the natural height only once it is laid out (hidden removed) so\n      // the consumer's `height` transition has a concrete target to animate to.\n      content.style.setProperty(\"--stimeo-collapsible-content-height\", `${content.scrollHeight}px`);\n      content.setAttribute(\"data-state\", \"open\");\n      return;\n    }\n\n    content.setAttribute(\"data-state\", \"closed\");\n    if (waitForCloseTransition) {\n      this.#applyHiddenAfterTransition(content);\n    } else {\n      content.hidden = true;\n    }\n  }\n\n  /**\n   * Re-applies `hidden` once the close transition settles. Guarded against a\n   * reopen mid-transition; the shared waiter also guarantees a bounded fallback\n   * when the browser emits no terminal transition event.\n   */\n  #applyHiddenAfterTransition(content: HTMLElement): void {\n    this.#transition.wait(content, () => {\n      if (content.getAttribute(\"data-state\") === \"closed\") {\n        content.hidden = true;\n      }\n    });\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/utils/transition_completion.ts","../../src/controllers/collapsible_controller.ts"],"names":[],"mappings":"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","file":"collapsible_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 { SafeTimeout } from \"./safe_timeout\";\n\n/** Computed transition fields needed to determine when an element has settled. */\nexport type TransitionStyle = Pick<\n  CSSStyleDeclaration,\n  \"transitionProperty\" | \"transitionDuration\" | \"transitionDelay\"\n>;\n\n/** Parsed transition property paired with its effective duration and delay. */\ninterface TransitionTiming {\n  property: string;\n  totalMs: number;\n}\n\n/** Parses a CSS `<time>` into milliseconds, returning `0` for malformed values. */\nfunction timeMs(value: string): number {\n  const trimmed = value.trim();\n  const amount = Number.parseFloat(trimmed);\n  if (!Number.isFinite(amount)) return 0;\n  if (trimmed.endsWith(\"ms\")) return amount;\n  if (trimmed.endsWith(\"s\")) return amount * 1000;\n  return 0;\n}\n\n/** Splits a computed comma-separated CSS list into normalized, non-empty items. */\nfunction cssList(value: string): string[] {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * Pairs transition properties, durations, and delays using CSS list repetition.\n *\n * The `transition-property` list determines the number of transitions. Shorter\n * duration/delay lists repeat, while extra values are ignored. A negative delay\n * shortens the remaining wall-clock time, and a non-positive total is settled.\n */\nfunction transitionTimings(style: TransitionStyle): TransitionTiming[] {\n  const properties = cssList(style.transitionProperty);\n  const durations = cssList(style.transitionDuration).map(timeMs);\n  const delays = cssList(style.transitionDelay).map(timeMs);\n  const effectiveProperties =\n    properties.length > 0\n      ? properties\n      : Array.from({ length: Math.max(durations.length, delays.length, 1) }, () => \"all\");\n  const effectiveDurations = durations.length > 0 ? durations : [0];\n  const effectiveDelays = delays.length > 0 ? delays : [0];\n\n  return effectiveProperties\n    .filter((property) => property !== \"none\")\n    .map((property, index) => ({\n      property,\n      totalMs: Math.max(\n        0,\n        (effectiveDurations[index % effectiveDurations.length] ?? 0) +\n          (effectiveDelays[index % effectiveDelays.length] ?? 0),\n      ),\n    }));\n}\n\n/** Maximum total over already-parsed timings (0 when the list is empty). */\nfunction maxTotalMs(timings: TransitionTiming[]): number {\n  return timings.reduce((max, { totalMs }) => Math.max(max, totalMs), 0);\n}\n\n/** Maximum effective transition duration plus delay, in milliseconds. */\nexport function maxTransitionTotalMs(style: TransitionStyle): number {\n  return maxTotalMs(transitionTimings(style));\n}\n\n/** Optional tuning for a single {@link TransitionCompletion.wait} call. */\nexport interface TransitionWaitOptions {\n  /**\n   * Positive wall-clock override (ms) for the bounded fallback, replacing the\n   * auto-computed `max + 50ms` timer verbatim. It also keeps the wait armed for\n   * a computed 0ms transition (no synchronous completion): the consumer asserts\n   * a transition budget that computed styles cannot see. Non-positive and\n   * non-finite (`NaN` / `Infinity`) values are ignored.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Owns one cancellable wait for an element's CSS transitions to settle.\n *\n * When available, active CSS transitions provide their expanded property names.\n * Tracking those names lets shorthand declarations settle from their longhand\n * terminal events. A terminal event from an interrupted phase is ignored while a\n * replacement transition for the same property is still active. Because that set\n * is sampled when the wait is armed, a property whose transition only starts a\n * frame later would otherwise be settled over; the still-running set is therefore\n * re-read before completing and adopted when it is not yet empty. Without Web\n * Animations data, explicit transition properties retain the declared-property\n * behavior and the ambiguous `transition-property: all` form waits until the\n * computed maximum wall-clock time. A `max + 50ms` timeout is always armed\n * because browsers emit no terminal event when a property never transitions, an\n * ancestor disappears, or rendering is otherwise interrupted; a consumer with\n * better knowledge can replace that fallback via\n * {@link TransitionWaitOptions.timeoutMs}.\n */\nexport class TransitionCompletion {\n  readonly #timers = new SafeTimeout();\n  #element: HTMLElement | null = null;\n  #complete: (() => void) | null = null;\n  #pendingProperties: Set<string> | null = null;\n  #deadline = 0;\n\n  /**\n   * Replaces any prior wait and invokes `complete` synchronously for a 0ms\n   * transition (including when `getComputedStyle` is unavailable).\n   *\n   * With a positive `options.timeoutMs` the synchronous fast-path is skipped and\n   * the override replaces the auto-computed fallback (see {@link TransitionWaitOptions}).\n   */\n  wait(element: HTMLElement, complete: () => void, options: TransitionWaitOptions = {}): void {\n    this.cancel();\n\n    const requested = options.timeoutMs ?? 0;\n    const override = Number.isFinite(requested) && requested > 0 ? requested : 0;\n    // A non-browser / partial-DOM environment cannot report a computable\n    // transition, which is indistinguishable from a 0ms one.\n    const timings =\n      typeof window.getComputedStyle === \"function\"\n        ? transitionTimings(window.getComputedStyle(element))\n        : [];\n    const maximum = maxTotalMs(timings);\n    if (maximum <= 0 && override <= 0) {\n      complete();\n      return;\n    }\n\n    this.#element = element;\n    this.#complete = complete;\n    this.#deadline = Date.now() + maximum;\n    const activeProperties = this.#activeTransitionProperties(element);\n    this.#pendingProperties =\n      activeProperties.size > 0 ? activeProperties : this.#explicitPendingProperties(timings);\n    element.addEventListener(\"transitionend\", this.#onTerminal);\n    element.addEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#timers.set(() => this.#finish(), override > 0 ? override : maximum + 50);\n  }\n\n  /** Cancels the pending wait without invoking its completion callback. */\n  cancel(): void {\n    this.#complete = null;\n    this.#teardown();\n  }\n\n  /**\n   * Handles terminal events from the observed element only.\n   *\n   * For explicit property lists, every declared positive-time property must\n   * settle. For `all`, no reliable property set exists, so an event can finish\n   * only after the computed maximum time; the safety timeout owns the usual path.\n   */\n  readonly #onTerminal = (event: Event): void => {\n    if (event.target !== this.#element) return;\n    const transitionEvent = event as TransitionEvent;\n    // A pseudo-element's transition is reported with its originating element\n    // as `target`; it must not settle the element's own transition.\n    if (transitionEvent.pseudoElement) return;\n\n    if (this.#pendingProperties) {\n      const propertyName = transitionEvent.propertyName;\n      const active = this.#activeTransitionProperties(this.#element);\n      // An interrupted transition queues its cancel event before the replacement\n      // phase starts, but dispatch can happen after the new wait is armed. The\n      // replacement is then the active transition for this property, so the stale\n      // terminal event must not settle the new phase.\n      if (active.has(propertyName)) return;\n      if (!this.#pendingProperties.delete(propertyName)) return;\n      if (this.#pendingProperties.size > 0) return;\n      // The tracked set is an arm-time snapshot, so a transition the phase starts\n      // one frame later is absent from it. Re-reading the still-running set before\n      // settling adopts those stragglers instead of completing over them; the\n      // fallback timer stays armed, so this cannot extend the wait unboundedly.\n      if (active.size > 0) {\n        this.#pendingProperties = active;\n        return;\n      }\n      this.#finish();\n      return;\n    }\n\n    if (Date.now() >= this.#deadline) this.#finish();\n  };\n\n  /**\n   * Returns active CSS transition properties expanded to the names reported by\n   * terminal events. CSS animations and pseudo-element effects are excluded.\n   */\n  #activeTransitionProperties(element: HTMLElement | null): Set<string> {\n    if (!element || typeof element.getAnimations !== \"function\") return new Set();\n\n    try {\n      const properties = element.getAnimations().flatMap((animation) => {\n        if (animation.playState === \"idle\" || animation.playState === \"finished\") return [];\n        const effect = animation.effect as KeyframeEffect | null;\n        // A pseudo-element effect names the originating element as its target, so\n        // `target` alone cannot separate it. Its terminal events are ignored, so\n        // tracking its properties would only strand the wait on the fallback.\n        if (effect?.pseudoElement) return [];\n        const target = effect?.target;\n        if (target && target !== element) return [];\n        const property = (animation as Partial<CSSTransition>).transitionProperty;\n        return typeof property === \"string\" && property.length > 0 ? [property] : [];\n      });\n      return new Set(properties);\n    } catch {\n      // Partial DOM implementations can expose getAnimations without supporting\n      // it. The declared-property tracker and bounded timer remain safe fallbacks.\n      return new Set();\n    }\n  }\n\n  /** Returns explicit positive-time properties, or `null` for the ambiguous `all`. */\n  #explicitPendingProperties(timings: TransitionTiming[]): Set<string> | null {\n    if (timings.some(({ property }) => property === \"all\")) return null;\n    const pending = new Set(\n      timings.filter(({ totalMs }) => totalMs > 0).map(({ property }) => property),\n    );\n    // An empty set is only reachable through a timeout override (a 0ms transition\n    // otherwise completes synchronously). With nothing to track, fall back to the\n    // deadline rule so any terminal event can settle the wait, exactly like `all`.\n    return pending.size > 0 ? pending : null;\n  }\n\n  /** Completes exactly once, releasing listeners and the fallback before the callback. */\n  #finish(): void {\n    const complete = this.#complete;\n    if (!complete) return;\n    this.#complete = null;\n    this.#teardown();\n    complete();\n  }\n\n  /** Releases the exact element listeners and timer owned by the current wait. */\n  #teardown(): void {\n    this.#timers.clearAll();\n    this.#element?.removeEventListener(\"transitionend\", this.#onTerminal);\n    this.#element?.removeEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#element = null;\n    this.#pendingProperties = null;\n    this.#deadline = 0;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { TransitionCompletion } from \"../utils/transition_completion\";\n\n/**\n * Headless, accessible single-disclosure (collapsible) behavior.\n *\n * Markup contract (identifier: `stimeo--collapsible`):\n *   <div data-controller=\"stimeo--collapsible\">\n *     <button data-stimeo--collapsible-target=\"trigger\"\n *             data-action=\"stimeo--collapsible#toggle\"\n *             aria-expanded=\"false\" aria-controls=\"more\">Show details</button>\n *     <div id=\"more\" data-stimeo--collapsible-target=\"content\"\n *          data-state=\"closed\" hidden>…</div>\n *   </div>\n *\n * Implements the WAI-ARIA APG **Disclosure** pattern for a single inline region.\n * Unlike {@link AccordionController} it manages exactly one trigger/content pair\n * with no sibling coordination, and unlike a dropdown the content expands in\n * flow and never closes on an outside click.\n *\n * @remarks\n * Behavior only — the consumer owns the height transition and all decoration.\n * The controller keeps the open lifecycle ordered so `hidden` (effectively\n * `display:none`) never blocks measurement or the transition:\n * - **Open**: drop `hidden` → measure the natural height into\n *   `--stimeo--collapsible-content-height` → set `data-state=\"open\"`.\n * - **Close**: set `data-state=\"closed\"` (CSS shrinks the height) → re-apply\n *   `hidden` once the transition settles. With no transition (or reduced motion,\n *   which the consumer's CSS expresses as a zero duration) it is applied\n *   immediately; an owned fallback covers missing terminal events.\n */\nexport class CollapsibleController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"content\"];\n  static override values = {\n    open: { type: Boolean, default: false },\n  };\n  static actions = [\"toggle\"] as const;\n\n  declare readonly triggerTarget: HTMLElement;\n  declare readonly contentTarget: HTMLElement;\n  declare readonly hasTriggerTarget: boolean;\n  declare readonly hasContentTarget: boolean;\n\n  declare openValue: boolean;\n\n  /** Owns the cancellable close-transition wait and its bounded fallback. */\n  readonly #transition = new TransitionCompletion();\n  /** Distinguishes dynamic target churn from the callbacks that precede `connect()`. */\n  #connected = false;\n\n  /**\n   * Establishes the initial open/closed state without waiting for a close transition.\n   *\n   * The DOM is the source of truth on reconnect (Turbo cache restore / morph): an\n   * **explicit** state attribute — `aria-expanded=\"true\"`/`\"false\"` (or, with no\n   * trigger, `data-state=\"open\"`/`\"closed\"`) — is honored verbatim so a region the\n   * user opened *or* closed survives a back-navigation, even when the declarative\n   * `open` Value disagrees. An already-open region remains open without a\n   * close/reopen cycle. The Value only seeds a genuinely fresh render where no\n   * state attribute is present yet; any opening animation in that case belongs to\n   * the consumer's CSS. Mirrors `sidebar`'s `#restoreCollapsed`.\n   */\n  override connect(): void {\n    this.#connected = true;\n    this.#apply(this.#initialOpen(), false);\n  }\n\n  /** Resolves the connect-time state: explicit DOM state wins, else the `open` Value. */\n  #initialOpen(): boolean {\n    if (this.hasTriggerTarget) {\n      const expanded = this.triggerTarget.getAttribute(\"aria-expanded\");\n      if (expanded === \"true\") return true;\n      if (expanded === \"false\") return false;\n    } else if (this.hasContentTarget) {\n      const state = this.contentTarget.getAttribute(\"data-state\");\n      if (state === \"open\") return true;\n      if (state === \"closed\") return false;\n    }\n    return this.openValue;\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#transition.cancel();\n  }\n\n  /** Reconciles a replacement trigger target with the content's live state. */\n  triggerTargetConnected(trigger: HTMLElement): void {\n    if (!this.#connected || !this.hasContentTarget) return;\n    trigger.setAttribute(\n      \"aria-expanded\",\n      this.contentTarget.getAttribute(\"data-state\") === \"open\" ? \"true\" : \"false\",\n    );\n  }\n\n  /** Reconciles a replacement content target with the disclosure's live state. */\n  contentTargetConnected(content: HTMLElement): void {\n    if (!this.#connected) return;\n    this.#transition.cancel();\n    const open = this.hasTriggerTarget\n      ? this.triggerTarget.getAttribute(\"aria-expanded\") === \"true\"\n      : content.getAttribute(\"data-state\") === \"open\";\n    this.#applyContent(content, open, false);\n  }\n\n  /** Cancels a wait tied to a content target that was removed or replaced. */\n  contentTargetDisconnected(): void {\n    this.#transition.cancel();\n  }\n\n  /** Toggles the region open/closed. Bound via `data-action` (click). */\n  toggle(): void {\n    this.#apply(!this.#isOpen, true);\n  }\n\n  /**\n   * Whether the region is logically open. Read from `aria-expanded` (not the\n   * content's `hidden`) so a click *during* a close transition — when `hidden`\n   * is still deferred — correctly reopens instead of re-closing.\n   */\n  get #isOpen(): boolean {\n    if (this.hasTriggerTarget) {\n      return this.triggerTarget.getAttribute(\"aria-expanded\") === \"true\";\n    }\n    return this.hasContentTarget && this.contentTarget.getAttribute(\"data-state\") === \"open\";\n  }\n\n  /**\n   * Drives the disclosure to `open`, syncing the trigger's `aria-expanded` and\n   * the content's `hidden` / `data-state` / height variable in an order where\n   * `hidden` never blocks measurement or the transition.\n   *\n   * @param open - Target state.\n   * @param waitForCloseTransition - When `false` (initial `connect`) the close\n   *   path applies `hidden` immediately. This flag does not suppress consumer CSS\n   *   on the open path.\n   */\n  #apply(open: boolean, waitForCloseTransition: boolean): void {\n    if (this.hasTriggerTarget) {\n      this.triggerTarget.setAttribute(\"aria-expanded\", open ? \"true\" : \"false\");\n    }\n    if (!this.hasContentTarget) return;\n\n    const content = this.contentTarget;\n    this.#transition.cancel();\n    this.#applyContent(content, open, waitForCloseTransition);\n  }\n\n  /** Reflects one content target without relying on a later target lookup. */\n  #applyContent(content: HTMLElement, open: boolean, waitForCloseTransition: boolean): void {\n    if (open) {\n      content.hidden = false;\n      // Measure the natural height only once it is laid out (hidden removed) so\n      // the consumer's `height` transition has a concrete target to animate to.\n      content.style.setProperty(\n        \"--stimeo--collapsible-content-height\",\n        `${content.scrollHeight}px`,\n      );\n      content.setAttribute(\"data-state\", \"open\");\n      return;\n    }\n\n    content.setAttribute(\"data-state\", \"closed\");\n    if (waitForCloseTransition) {\n      this.#applyHiddenAfterTransition(content);\n    } else {\n      content.hidden = true;\n    }\n  }\n\n  /**\n   * Re-applies `hidden` once the close transition settles. Guarded against a\n   * reopen mid-transition; the shared waiter also guarantees a bounded fallback\n   * when the browser emits no terminal transition event.\n   */\n  #applyHiddenAfterTransition(content: HTMLElement): void {\n    this.#transition.wait(content, () => {\n      if (content.getAttribute(\"data-state\") === \"closed\") {\n        content.hidden = true;\n      }\n    });\n  }\n}\n"]}

package/dist/controllers/color_picker_controller.d.ts

@@ -24,12 +24,12 @@ import { Controller } from '@hotwired/stimulus';
  * adjustment is keyboard- and screen-reader-operable. Each slider exposes
  * `aria-valuenow` and a human-readable `aria-valuetext` (e.g. "Hue 210 degrees");
  * the hex input stays two-way synced; the current color is published on the
- * preview and root as the `--stimeo-color` custom property and mirrored into a
+ * preview and root as the `--stimeo--color` custom property and mirrored into a
  * hidden form field.
  *
  * @remarks
  * Behavior only — the swatch/gradient visuals are the consumer's CSS/canvas, fed
- * by `--stimeo-color`. Only the consumer knows whether a channel track mirrors
+ * by `--stimeo--color`. Only the consumer knows whether a channel track mirrors
  * under RTL: set `logicalTrack` to declare that it does, and the pointer mapping
  * and horizontal arrow pair follow the writing direction. Left unset, nothing
  * here reads `direction`. A gradient has no logical `to` keyword, so mirroring
@@ -44,6 +44,11 @@ import { Controller } from '@hotwired/stimulus';
  * exactly bijective: a typed hex can normalize to a near (not identical) value
  * once the HSL sliders are touched. This keeps the model small and zero-dep; use a
  * dedicated color library on the consumer side if exact hex preservation matters.
+ *
+ * A color the user set through a slider or the hex input is reported as
+ * `stimeo--color-picker:change`. Toggling `alpha` at runtime can move the
+ * committed color without a user edit, and that arrives as
+ * `stimeo--color-picker:reconcile` with the same detail. Neither fires on connect.
  */
 declare class ColorPickerController extends Controller<HTMLElement> {
     #private;
@@ -63,7 +68,7 @@ declare class ColorPickerController extends Controller<HTMLElement> {
         };
     };
     static actions: readonly ["onHexInput", "onKeydown", "onPointerDown"];
-    static events: readonly ["change"];
+    static events: readonly ["change", "reconcile"];
     readonly sliderTargets: HTMLElement[];
     readonly hexTarget: HTMLInputElement;
     readonly hasHexTarget: boolean;
@@ -72,6 +77,7 @@ declare class ColorPickerController extends Controller<HTMLElement> {
     valueValue: string;
     alphaValue: boolean;
     logicalTrackValue: boolean;
+    /** Seeds the model from the initial hex value and renders every surface. */
     connect(): void;
     /** Cancels any active pointer drag so document listeners never leak. */
     disconnect(): void;

package/dist/controllers/color_picker_controller.js

@@ -59,7 +59,7 @@ var MicrotaskCoalescer = class {
 };
 
 // src/controllers/color_picker_controller.ts
-var COLOR_PROPERTY = "--stimeo-color";
+var COLOR_PROPERTY = "--stimeo--color";
 var CHANNEL_RANGE = {
   hue: [0, 360],
   saturation: [0, 100],
@@ -74,7 +74,7 @@ var ColorPickerController = class extends Controller {
     logicalTrack: { type: Boolean, default: false }
   };
   static actions = ["onHexInput", "onKeydown", "onPointerDown"];
-  static events = ["change"];
+  static events = ["change", "reconcile"];
   /** Whether the consumer declared a mirroring track and the direction mirrors it. */
   get #mirrored() {
     return this.logicalTrackValue && isRtl(this.element);
@@ -83,14 +83,14 @@ var ColorPickerController = class extends Controller {
   #color = { hue: 0, saturation: 0, lightness: 0, alpha: 100 };
   /** Aborts in-progress pointer-drag listeners on drag end / teardown. */
   #dragAbort = null;
-  /** Seeds the model from the initial hex value and renders every surface. */
+  /** Color the last repaint settled on, so a configuration-driven move is reported once. */
+  #committedHex = null;
   /**
    * Collapses a morph that swaps render inputs into one repaint, and refuses the
    * pass Stimulus delivers before `connect()`.
    */
-  #repaint = new MicrotaskCoalescer(() => {
-    this.#render();
-  });
+  #repaint = new MicrotaskCoalescer(() => this.#reconcileColor());
+  /** Seeds the model from the initial hex value and renders every surface. */
   connect() {
     this.#repaint.activate();
     const parsed = hexToHsla(this.valueValue);
@@ -181,14 +181,30 @@ var ColorPickerController = class extends Controller {
       return;
     }
     this.#color = this.alphaValue ? parsed : { ...parsed, alpha: 100 };
-    this.#render();
+    this.#commitColor();
   }
   /** Clamps and snaps one channel to an integer, then re-renders + emits change. */
   #setChannel(channel, raw, min, max) {
     this.#color[channel] = Math.round(Math.min(max, Math.max(min, raw)));
+    this.#commitColor();
+  }
+  /**
+   * Renders the model and reports a color the user actually moved. A key pressed
+   * at a bound, a pointer that lands on the step already showing, and a re-confirmed
+   * hex all leave the committed color where it was, so no `change` describes them.
+   */
+  #commitColor() {
+    const previous = this.#committedHex;
     this.#render();
+    if (this.#committedHex !== previous) {
+      this.dispatch("change", { detail: this.#settledDetail() });
+    }
   }
-  /** Reflects the model onto sliders, the hex input, preview, and form field. */
+  /**
+   * Reflects the model onto sliders, the hex input, preview, and form field.
+   *
+   * @stimeoRenderRoot
+   */
   #render() {
     for (const slider of this.sliderTargets) {
       const channel = this.#channelOf(slider);
@@ -198,14 +214,28 @@ var ColorPickerController = class extends Controller {
       slider.setAttribute("aria-valuetext", valueText(channel, value));
     }
     const hex = this.#hexString();
+    this.#committedHex = hex;
     if (this.hasHexTarget) this.hexTarget.value = hex;
     for (const field of this.fieldTargets) field.value = hex;
     for (const preview of this.previewTargets) preview.style.setProperty(COLOR_PROPERTY, hex);
     this.element.style.setProperty(COLOR_PROPERTY, hex);
+  }
+  /**
+   * Repaints after `alpha` changed at runtime and reports a color this controller
+   * settled on. Disabling alpha drops it from the model, so the committed color can
+   * move without a user edit; `change` stays reserved for the picker's own actions.
+   */
+  #reconcileColor() {
+    const previous = this.#committedHex;
+    this.#render();
+    if (previous !== null && this.#committedHex !== previous) {
+      this.dispatch("reconcile", { detail: this.#settledDetail() });
+    }
+  }
+  /** The settled color as event detail, shared by both report paths. */
+  #settledDetail() {
     const rgb = hslToRgb(this.#color.hue, this.#color.saturation, this.#color.lightness);
-    this.dispatch("change", {
-      detail: { value: hex, rgba: { ...rgb, a: this.#color.alpha / 100 } }
-    });
+    return { value: this.#hexString(), rgba: { ...rgb, a: this.#color.alpha / 100 } };
   }
   /** The current color as `#RRGGBB`, or `#RRGGBBAA` when alpha is enabled. */
   #hexString() {