stimeo-ui 0.16.0 → 0.17.0

package/dist/controllers/clipboard_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/before_cache_reset.ts","../../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 * Sends one message to the page's shared `stimeo--announcer`.\n *\n * A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes *after* assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n *\n * The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n *\n * Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n *\n * @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n */\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n  const text = message.trim();\n  if (text.length === 0) return;\n  window.dispatchEvent(\n    new CustomEvent(\"stimeo--announcer:announce\", {\n      detail: { message: text, assertive: options.assertive === true },\n    }),\n  );\n}\n\n/**\n * Fills `{name}` placeholders in an announcement template from `values`.\n *\n * The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n */\nexport function fillTemplate(template: string, values: Record<string, string | number>): string {\n  return template.replace(/\\{([a-zA-Z][a-zA-Z0-9]*)\\}/g, (match, name: string) => {\n    const replacement = values[name];\n    return replacement === undefined ? match : String(replacement);\n  });\n}\n","/**\n * Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n *\n * **`disconnect()` cannot do this job, for two independent reasons.** Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n *\n * Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. *What* to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way.\n *\n * **Rewind state, not appearance.** The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n *\n * Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\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 #beforeCache = new BeforeCacheReset(() => this.#rewind());\n *\n * connect()    { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n */\nexport class BeforeCacheReset {\n  /** Every subscribed instance, iterated by the one shared document listener. */\n  static readonly #subscribers = new Set<BeforeCacheReset>();\n\n  /** The shared listener; installed while at least one instance is subscribed. */\n  static readonly #onBeforeCache = (): void => {\n    for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n  };\n\n  readonly #rewind: () => void;\n\n  /** @param rewind - the pass that returns this controller's state to its initial form. */\n  constructor(rewind: () => void) {\n    this.#rewind = rewind;\n  }\n\n  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */\n  activate(): void {\n    const first = BeforeCacheReset.#subscribers.size === 0;\n    BeforeCacheReset.#subscribers.add(this);\n    if (first) {\n      document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n    }\n  }\n\n  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */\n  deactivate(): void {\n    BeforeCacheReset.#subscribers.delete(this);\n    if (BeforeCacheReset.#subscribers.size > 0) return;\n    document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n  }\n}\n","/**\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 * Largest delay a timer can hold: the platform stores it in a 32-bit signed\n * integer, and anything larger overflows to `1`, so a delay meant to be far in\n * the future fires almost immediately. A declared delay above this bound names\n * no delay at all, and a controller reading one falls back to its default.\n */\nexport const MAX_TIMER_DELAY_MS = 2_147_483_647;\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 { announce } from \"../utils/announce\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { setDefaultAttribute } from \"../utils/default_attribute\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * The `data-state` values this controller writes itself. Any other value on the\n * attribute was authored by the consumer and is left alone.\n */\nconst TRANSIENT_STATES = new Set([\"copied\", \"error\"]);\n\n/**\n * Headless copy-to-clipboard behavior with a completion slot and a screen-reader\n * announcement.\n *\n * Markup contract (identifier: `stimeo--clipboard`):\n *   <div data-controller=\"stimeo--clipboard\"\n *        data-stimeo--clipboard-feedback-duration-value=\"2000\"\n *        data-stimeo--clipboard-announce-copied-text-value=\"Copied to clipboard\"\n *        data-stimeo--clipboard-announce-error-text-value=\"Copy failed\">\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=\"click->stimeo--clipboard#copy\">Copy</button>\n *     <span data-stimeo--clipboard-target=\"feedback\"></span>\n *   </div>\n *\n * No dedicated APG pattern; this follows the Button practice plus a status message\n * ({@link https://www.w3.org/WAI/WCAG22/Understanding/status-changes.html | WCAG 2.2 SC 4.1.3}).\n * The copy uses the standard `navigator.clipboard` API (no extra dependency); every\n * failure mode — an API the browser withholds outside a secure context as much as a\n * rejected permission — settles the same way, as `data-state=\"error\"` plus the\n * `copy` event's `success: false`.\n *\n * Targets: `source` (the text to copy, when `text` is not set), `button` (the\n * control that triggers `copy`), `feedback` (the **visible** completion slot).\n *\n * Values: `text` (copy this instead of reading `source`), `feedbackDuration` (ms the\n * completion state is held; `0` or less arms no timer, so it stands until the next\n * copy — a reconnect and the before-cache rewind still clear it), `copiedLabel` /\n * `errorLabel` (what the visible slot shows), `announceCopiedText` /\n * `announceErrorText` (what assistive tech hears; empty announces nothing).\n *\n * @remarks\n * Behavior only — icon swaps and styling are the consumer's, keyed off `data-state`\n * (`idle` / `copied` / `error`).\n *\n * **The `feedback` slot must not carry live-region semantics.** Announcing is the\n * page's shared `stimeo--announcer` job: it is seated before the change it reads,\n * which a slot filled on demand cannot be, and it already collapses a repeat of the\n * same wording so a second copy is still heard. A `role=\"status\"` on the slot as\n * well would say everything twice.\n *\n * `copied` and `error` are transient: the timer that clears them belongs to one\n * connection, so a fresh `connect()` that finds either — a restored snapshot, an\n * in-page move — returns to `idle`, and the state is rewound before Turbo caches\n * the page (`BeforeCacheReset`). The rewind is silent: it discards nothing a\n * reconnect does not derive again.\n *\n * A `copiedLabel` / `errorLabel` changed on the live element while its result is\n * shown rewrites the slot — only while the slot still reads the label the copy wrote\n * — without announcing, dispatching or moving the return to idle. Stimulus reports no\n * change when a label attribute whose value was empty is removed, so the slot keeps\n * the empty label until the next copy. `feedbackDuration` and the announcement texts\n * belong to one copy, so a change to them applies from the next.\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    announceCopiedText: { type: String, default: \"\" },\n    announceErrorText: { type: String, default: \"\" },\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  declare announceCopiedTextValue: string;\n  declare announceErrorTextValue: string;\n\n  /**\n   * The pending return to idle — the only timer this controller schedules, so\n   * `clearAll()` is exactly \"drop the auto-clear\" and needs no id of its own.\n   */\n  readonly #timers = new SafeTimeout();\n\n  /** Returns the completion state to idle for the snapshot Turbo takes. */\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n\n  /**\n   * Whether this connection is still live. `copy()` suspends on the Clipboard API,\n   * and a teardown that lands while it is suspended must win: the continuation\n   * would otherwise write to an element nobody owns and arm a timer past the\n   * `clearAll()` that was supposed to be the last word. Stimulus also runs the label\n   * callbacks ahead of `connect()`, while this is still false: a result restored with\n   * the markup is `connect()`'s to settle, not theirs.\n   */\n  #connected = false;\n\n  override connect(): void {\n    this.#connected = true;\n    this.#adopt();\n    this.#beforeCache.activate();\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#beforeCache.deactivate();\n    this.#timers.clearAll();\n  }\n\n  /**\n   * Follows a `copiedLabel` swapped in place while a successful copy is shown.\n   *\n   * Render only: nothing is announced or dispatched, and the return to idle keeps the\n   * deadline the copy set. The slot changes only while `data-state` is `copied` and it\n   * still reads the previous label — the one the copy wrote there — so text someone\n   * else put in the slot stays. Stimulus also runs this ahead of `connect()`, which\n   * settles a result restored with the markup itself, so nothing is written then.\n   */\n  copiedLabelValueChanged(label: string, previous: string | undefined): void {\n    this.#followLabel(\"copied\", label, previous);\n  }\n\n  /**\n   * Follows an `errorLabel` swapped in place while a failed copy is shown, on the same\n   * terms as {@link ClipboardController.copiedLabelValueChanged}: only while\n   * `data-state` is `error` and the slot still reads the previous label.\n   */\n  errorLabelValueChanged(label: string, previous: string | undefined): void {\n    this.#followLabel(\"error\", label, previous);\n  }\n\n  /**\n   * Copies the resolved text and reports the outcome. Bound via `data-action`\n   * (click). Dispatches `stimeo--clipboard:copy` with `{ success, text, message }`\n   * once per completed attempt — including on failure — so consumers can react\n   * either way. `message` is the authored label for that outcome, so a part that\n   * shows wording — `stimeo--clipboard:copy->stimeo--toast#show` — needs nothing\n   * else; wiring both that and the announcer reads the same result twice.\n   * An attempt whose connection ended while it was in flight reports nothing.\n   */\n  async copy(): Promise<void> {\n    const text = this.#resolveText();\n    let success = false;\n    try {\n      await navigator.clipboard.writeText(text);\n      success = true;\n    } catch {\n      success = false;\n    }\n    if (!this.#connected) return;\n\n    this.#reportResult(success);\n    const message = success ? this.copiedLabelValue : this.errorLabelValue;\n    this.dispatch(\"copy\", { detail: { success, text, message } });\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  /**\n   * Reads the current state back from the DOM.\n   *\n   * A `copied` or `error` found at connect time is this controller's own output\n   * from a connection that is gone, and so is the timer that would have cleared it\n   * — nothing else would ever return the element to `idle`. Any other authored\n   * value belongs to the consumer and only a missing attribute takes the default.\n   */\n  #adopt(): void {\n    if (this.#inTransientState()) {\n      this.#reset();\n      return;\n    }\n    setDefaultAttribute(this.element, \"data-state\", \"idle\");\n  }\n\n  /** Whether `data-state` currently holds one of the values this controller writes. */\n  #inTransientState(): boolean {\n    const state = this.element.getAttribute(\"data-state\");\n    return state !== null && TRANSIENT_STATES.has(state);\n  }\n\n  /**\n   * Returns the completion state to idle for the snapshot Turbo is about to take,\n   * so a page reached with the Back button does not report a copy that happened\n   * before the navigation. Only a state this controller wrote is rewound — an\n   * authored one is the consumer's and has to survive into the snapshot, exactly as\n   * `connect()` leaves it alone. State only — no `copy` is dispatched, which would\n   * claim a fresh copy ran.\n   */\n  #rewind(): void {\n    if (!this.#inTransientState()) return;\n    this.#timers.clearAll();\n    this.#reset();\n  }\n\n  /**\n   * Reflects the result, announces it, and schedules the return to idle.\n   *\n   * @stimeoRenderRoot\n   */\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    this.#announceResult(success);\n    this.#scheduleReset();\n  }\n\n  /**\n   * Reads the result out through the shared announcer.\n   *\n   * @stimeoRuntimeOnly `announceCopiedText` / `announceErrorText` word the one announcement a copy\n   *   makes.\n   */\n  #announceResult(success: boolean): void {\n    announce(success ? this.announceCopiedTextValue : this.announceErrorTextValue);\n  }\n\n  /**\n   * Arms the return to idle for the result just shown.\n   *\n   * @stimeoRuntimeOnly `feedbackDuration` is the delay of the one timer this call arms, and the\n   *   reset that timer runs reads no Value.\n   */\n  #scheduleReset(): void {\n    // Drop any in-flight reset so consecutive copies restart the full window\n    // rather than having the earlier timer clear the new result prematurely.\n    this.#timers.clearAll();\n    if (this.feedbackDurationValue > 0) {\n      this.#timers.set(() => this.#reset(), this.feedbackDurationValue);\n    }\n  }\n\n  /**\n   * Rewrites the slot to `label` while `state` is shown and the slot still reads\n   * `previous`, the label this controller wrote for that result.\n   */\n  #followLabel(state: \"copied\" | \"error\", label: string, previous: string | undefined): void {\n    if (!this.#connected) return;\n    if (this.element.getAttribute(\"data-state\") !== state || !this.hasFeedbackTarget) return;\n    if (this.feedbackTarget.textContent !== previous) return;\n    this.feedbackTarget.textContent = label;\n  }\n\n  /** Returns to the idle state and empties the completion slot. */\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/announce.ts","../../src/utils/default_attribute.ts","../../src/utils/listener_set.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/morph_render_watcher.ts","../../src/utils/timer_bounds.ts","../../src/utils/number_bounds.ts","../../src/utils/coerce.ts","../../src/utils/number_value.ts","../../src/utils/safe_timeout.ts","../../src/controllers/clipboard_controller.ts"],"names":[],"mappings":"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","file":"clipboard_controller.js","sourcesContent":["/**\n * Sends one message to the page's shared `stimeo--announcer`.\n *\n * A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes *after* assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n *\n * The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n *\n * Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n *\n * @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n */\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n  const text = message.trim();\n  if (text.length === 0) return;\n  window.dispatchEvent(\n    new CustomEvent(\"stimeo--announcer:announce\", {\n      detail: { message: text, assertive: options.assertive === true },\n    }),\n  );\n}\n\n/**\n * Fills `{name}` placeholders in an announcement template from `values`.\n *\n * The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n */\nexport function fillTemplate(template: string, values: Record<string, string | number>): string {\n  return template.replace(/\\{([a-zA-Z][a-zA-Z0-9]*)\\}/g, (match, name: string) => {\n    const replacement = values[name];\n    return replacement === undefined ? match : String(replacement);\n  });\n}\n","/**\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 * Owns every listener a controller attaches for one connected lifetime and\n * releases them together, so an event name is spelled once and the release\n * cannot drift from the registration.\n *\n * Detaching by hand repeats three things at the release site — the type, the\n * handler reference and the capture flag — and any one of them drifting leaves\n * a listener alive on an element the controller no longer drives. Aborting the\n * signal a registration was created with releases it whatever it was made of,\n * so the release site names nothing.\n *\n * One set per lifetime, held as a field and never rebuilt. {@link\n * ListenerSet.dispose} is the only thing that closes a generation, and it opens\n * the next one in the same step, so the lifecycle hooks can call `add` and\n * `dispose` in any order any number of times, and no `add` ever meets an\n * already aborted signal — a DOM that registers a listener on such a signal\n * would keep it forever. Rebuilding the set instead would leak:\n * `addEventListener` matches an existing registration on target, type, callback\n * and capture alone, so re-adding the same handler while the first registration\n * is live is discarded, and that live registration keeps the signal it was\n * attached with — a set built by a second `connect()` can never release what it\n * appears to own.\n *\n * Scope is the registration only. Timers, observers, leases and the order they\n * are unwound in stay with the controller, which places `dispose()` in its\n * cleanup sequence. A receiver that changes at runtime (a\n * swapped target) is rebound by calling `dispose()` and then `add()` again from\n * the rebind, not by a second set.\n *\n * The set must own every registration of a tuple it holds: a listener the same\n * target already carries for the same type, callback and capture flag keeps the\n * right to remove it, and this set's `add` for that tuple is discarded. A\n * subscription shared between instances behind a participant count, or one that\n * lives for less than the connection, keeps its own pair of calls.\n *\n * @example\n * ```ts\n * readonly #listeners = new ListenerSet();\n *\n * connect(): void {\n *   this.#listeners.add(this.element, \"submit\", this.#onNativeSubmit, { capture: true });\n *   this.#listeners.add(this.element, \"turbo:submit-start\", this.#onSubmitStart);\n *   this.#listeners.add(this.element, \"turbo:submit-end\", this.#onSubmitEnd);\n * }\n *\n * disconnect(): void {\n *   this.#listeners.dispose();\n * }\n * ```\n */\nexport class ListenerSet {\n  /** The generation every `add` joins until the next `dispose()`. */\n  #abort = new AbortController();\n\n  /**\n   * Attaches `handler` to the open generation, exactly as the caller spelled it.\n   *\n   * The set supplies the signal, so `options` carries everything else the DOM\n   * accepts — `capture` included, which has to match at release time and no\n   * longer has a second place to drift from.\n   */\n  add(\n    target: EventTarget,\n    type: string,\n    handler: EventListener,\n    options?: Omit<AddEventListenerOptions, \"signal\">,\n  ): void {\n    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });\n  }\n\n  /**\n   * Releases every listener of the open generation, synchronously, and opens the\n   * next one. Idempotent, and safe before anything has been added.\n   */\n  dispose(): void {\n    this.#abort.abort();\n    this.#abort = new AbortController();\n  }\n}\n","/**\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 * @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 { ListenerSet } from \"./listener_set\";\nimport { MicrotaskCoalescer } from \"./microtask_coalescer\";\n\n/**\n * Coalesces retained-element morphs and explicit lifecycle requests into one pass.\n *\n * Observe the controller's element after its initial state is settled. Morphs on\n * that element and bubbling morphs on its descendants share the same microtask\n * as {@link schedule}. The callback repairs derived output; the controller owns\n * any logical transition reporting. {@link disconnect} releases the listener and\n * cancels pending work, including work from an earlier connected lifetime.\n */\nexport class MorphRenderWatcher {\n  readonly #listeners = new ListenerSet();\n  readonly #pass: MicrotaskCoalescer;\n  #element: Element | null = null;\n  readonly #onMorph = (): void => this.#pass.schedule();\n\n  /** @param run - the single pass that repairs the settled controller's output. */\n  constructor(run: () => void) {\n    this.#pass = new MicrotaskCoalescer(run);\n  }\n\n  /** Opens observation; observing the same element again preserves queued work. */\n  observe(element: Element): void {\n    if (this.#element === element) return;\n    this.disconnect();\n    this.#element = element;\n    this.#pass.activate();\n    this.#listeners.add(element, \"turbo:morph-element\", this.#onMorph);\n  }\n\n  /** Requests one pass; requests outside an observed lifetime are ignored. */\n  schedule(): void {\n    this.#pass.schedule();\n  }\n\n  /** Releases observation and pending work synchronously; safe to repeat. */\n  disconnect(): void {\n    this.#listeners.dispose();\n    this.#pass.cancel();\n    this.#element = null;\n  }\n}\n","/**\n * Largest delay a timer can hold: the platform stores it in a 32-bit signed\n * integer, and anything larger overflows to `1`, so a delay meant to be far in\n * the future fires almost immediately. A declared delay above this bound names\n * no delay at all, and a controller reading one falls back to its default.\n */\nexport const MAX_TIMER_DELAY_MS = 2_147_483_647;\n","import { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/** Semantic constraints on an already decoded number, independent of the DOM. */\nexport interface NumberBounds {\n  /** Finite numbers are required, including when this field is omitted. */\n  readonly finite?: true;\n  /** Inclusive lower endpoint. */\n  readonly min?: number;\n  /** Inclusive upper endpoint. */\n  readonly max?: number;\n  /** Exclusive lower endpoint. */\n  readonly exclusiveMin?: number;\n  /** Require a number without a fractional part. */\n  readonly integer?: boolean;\n  /** Exact decoded numbers accepted by a discrete contract. */\n  readonly allowedValues?: readonly number[];\n  /** JSON-safe exceptions to finite-number checking for unbounded endpoints. */\n  readonly allowInfinity?: \"negative\" | \"positive\" | \"both\";\n}\n\n/** One constraint for each Number Value, including shorthand declarations. */\nexport type NumberValueConstraints<Values> = {\n  readonly [Key in keyof Values as Values[Key] extends\n    | NumberConstructor\n    | { type: NumberConstructor }\n    ? Key\n    : never]: NumberBounds;\n};\n\n/** Reusable semantic domains; fractional inputs remain fractional unless excluded. */\nexport const NUMBER_BOUNDS = {\n  finite: { finite: true },\n  nonNegative: { finite: true, min: 0 },\n  positive: { finite: true, exclusiveMin: 0 },\n  nonNegativeInteger: { finite: true, min: 0, integer: true },\n  positiveInteger: { finite: true, exclusiveMin: 0, integer: true },\n  lowerBound: { finite: true, allowInfinity: \"negative\" },\n  upperBound: { finite: true, allowInfinity: \"positive\" },\n  timer: { finite: true, min: 0, max: MAX_TIMER_DELAY_MS },\n  positiveTimer: { finite: true, exclusiveMin: 0, max: MAX_TIMER_DELAY_MS },\n} as const satisfies Record<string, NumberBounds>;\n\n/**\n * Checks all declared bounds without rounding, clamping, or coercing the input.\n * Infinity exceptions relax only finite checking; every other bound still applies.\n */\nexport function matchesNumberBounds(value: number, bounds: NumberBounds): boolean {\n  if (!Number.isFinite(value)) {\n    const direction = value === Infinity ? \"positive\" : value === -Infinity ? \"negative\" : null;\n    if (direction === null) return false;\n    if (bounds.allowInfinity !== \"both\" && bounds.allowInfinity !== direction) return false;\n  }\n  if (bounds.min !== undefined && value < bounds.min) return false;\n  if (bounds.max !== undefined && value > bounds.max) return false;\n  if (bounds.exclusiveMin !== undefined && value <= bounds.exclusiveMin) return false;\n  if (bounds.integer && !Number.isInteger(value)) return false;\n  if (bounds.allowedValues !== undefined && !bounds.allowedValues.includes(value)) return false;\n  return true;\n}\n\n/** Decodes a Number Value literal; action params use their own JSON decoder. */\nexport function decodeNumberValue(raw: string): number {\n  return Number(raw.replace(/_/g, \"\"));\n}\n","/**\n * Numeric coercion for controllers that accept a number through a Value, an action\n * param, or an event detail.\n *\n * Stimulus decodes action params as JSON when possible and leaves other text\n * untouched. CustomEvent detail can also supply a number or numeric string.\n * The reader accepts those two types while rejecting blank and non-finite input.\n */\n\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/**\n * Reads a finite number or nonblank numeric string; other input returns `null`.\n * Blank strings cannot silently reset a value to zero.\n */\nexport function toFiniteNumber(raw: unknown): number | null {\n  if (typeof raw !== \"number\" && typeof raw !== \"string\") return null;\n  if (typeof raw === \"string\" && raw.trim().length === 0) return null;\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Returns an accepted decoded Number Value or the caller's fallback unchanged.\n * The caller owns the fallback contract; this reader does not parse or write a Value.\n */\nexport function readNumber(raw: number, fallback: number, bounds: NumberBounds): number {\n  return matchesNumberBounds(raw, bounds) ? raw : fallback;\n}\n","import { readNumber } from \"./coerce\";\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** The instance identity carried by a Number Value read. */\nexport interface NumberValueOwner {\n  readonly identifier: string;\n  readonly element: Element;\n}\n\n/** Reads current declarations at the point of use without rewriting their attributes. */\nexport class NumberValueReader {\n  /** The last rejected literal per Value; no history grows for an unchanged instance. */\n  readonly #lastRejected = new Map<string, string>();\n\n  /** Resolves the declared number using its own fallback and shared class contract. */\n  read(\n    owner: NumberValueOwner,\n    name: string,\n    raw: number,\n    fallback: number,\n    bounds: NumberBounds,\n  ): number {\n    const resolved = readNumber(raw, fallback, bounds);\n    if (matchesNumberBounds(raw, bounds)) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;\n    const literal = owner.element.getAttribute(attribute);\n    if (literal === null) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    if (this.#lastRejected.get(name) !== literal) {\n      this.#lastRejected.set(name, literal);\n      console.warn(\n        `Stimeo UI: \"${owner.identifier}\" has an invalid number Value \"${name}\" declaration ${JSON.stringify(literal)}; using ${fallback}.`,\n      );\n    }\n    return resolved;\n  }\n}\n","/**\n * 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\nexport { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\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 { announce } from \"../utils/announce\";\nimport { setDefaultAttribute } from \"../utils/default_attribute\";\nimport { MorphRenderWatcher } from \"../utils/morph_render_watcher\";\nimport { NUMBER_BOUNDS, type NumberValueConstraints } from \"../utils/number_bounds\";\nimport { NumberValueReader } from \"../utils/number_value\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * The `data-state` values this controller writes itself. Any other value on the\n * attribute was authored by the consumer and is left alone.\n */\nconst TRANSIENT_STATES = new Set([\"copied\", \"error\"]);\n\n/**\n * Headless copy-to-clipboard behavior with a completion slot and a screen-reader\n * announcement.\n *\n * Markup contract (identifier: `stimeo--clipboard`):\n *   <div data-controller=\"stimeo--clipboard\"\n *        data-stimeo--clipboard-feedback-duration-value=\"2000\"\n *        data-stimeo--clipboard-announce-copied-text-value=\"Copied to clipboard\"\n *        data-stimeo--clipboard-announce-error-text-value=\"Copy failed\">\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=\"click->stimeo--clipboard#copy\">Copy</button>\n *     <span data-stimeo--clipboard-target=\"feedback\"></span>\n *   </div>\n *\n * No dedicated APG pattern; this follows the Button practice plus a status message\n * ({@link https://www.w3.org/WAI/WCAG22/Understanding/status-changes.html | WCAG 2.2 SC 4.1.3}).\n * The copy uses the standard `navigator.clipboard` API (no extra dependency); every\n * failure mode — an API the browser withholds outside a secure context as much as a\n * rejected permission — settles the same way, as `data-state=\"error\"` plus the\n * `copy` event's `success: false`.\n *\n * Targets: `source` (the text to copy, when `text` is not set), `button` (the\n * control that triggers `copy`), `feedback` (the **visible** completion slot).\n *\n * Values: `text` (copy this instead of reading `source`), `feedbackDuration` (ms the\n * completion state is held; `0` or less arms no timer, so it stands until the next\n * copy — a reconnect still clears it), `copiedLabel` /\n * `errorLabel` (what the visible slot shows), `announceCopiedText` /\n * `announceErrorText` (what assistive tech hears; empty announces nothing).\n *\n * @remarks\n * Behavior only — icon swaps and styling are the consumer's, keyed off `data-state`\n * (`idle` / `copied` / `error`).\n *\n * **The `feedback` slot must not carry live-region semantics.** Announcing is the\n * page's shared `stimeo--announcer` job: it is seated before the change it reads,\n * which a slot filled on demand cannot be, and it already collapses a repeat of the\n * same wording so a second copy is still heard. A `role=\"status\"` on the slot as\n * well would say everything twice.\n *\n * `copied` and `error` are transient: the timer that clears them belongs to one\n * connection, so a fresh `connect()` that finds either — a page Turbo restores from its\n * cache, an in-page move — returns to `idle`, silently. `turbo:before-cache` changes\n * nothing: Turbo also dispatches it on pages that stay (a promoted frame navigation, a\n * `popstate` without Turbo state, a refresh of a cached URL), where the result is still\n * on screen and its return to idle still due. Returning to `idle` empties only a slot that\n * still shows the wording a copy wrote there; a slot the page swapped in, rewrote, or put\n * an element into keeps what it holds.\n *\n * A `copiedLabel` / `errorLabel` changed on the live element while its result is\n * shown rewrites the slot — only while the slot still reads the label the copy wrote\n * — without announcing, dispatching or moving the return to idle. Stimulus reports no\n * change when a label attribute whose value was empty is removed, so the slot keeps\n * the empty label until the next copy. `feedbackDuration` and the announcement texts\n * belong to one copy, so a change to them applies from the next.\n */\nexport class ClipboardController extends Controller<HTMLElement> {\n  /** Numeric read boundaries share one reader for this controller instance. */\n  readonly #numbers = new NumberValueReader();\n\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    announceCopiedText: { type: String, default: \"\" },\n    announceErrorText: { type: String, default: \"\" },\n  };\n\n  static valueConstraints = {\n    feedbackDuration: NUMBER_BOUNDS.timer,\n  } satisfies NumberValueConstraints<typeof ClipboardController.values>;\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 feedbackTargets: 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  declare announceCopiedTextValue: string;\n  declare announceErrorTextValue: string;\n\n  /**\n   * The pending return to idle — the only timer this controller schedules, so\n   * `clearAll()` is exactly \"drop the auto-clear\" and needs no id of its own.\n   */\n  readonly #timers = new SafeTimeout();\n\n  /**\n   * Whether this connection is still live. `copy()` suspends on the Clipboard API,\n   * and a teardown that lands while it is suspended must win: the continuation\n   * would otherwise write to an element nobody owns and arm a timer past the\n   * `clearAll()` that was supposed to be the last word. Stimulus also runs the label\n   * callbacks ahead of `connect()`, while this is still false: a result restored with\n   * the markup is `connect()`'s to settle, not theirs.\n   */\n  #connected = false;\n  #result: boolean | null = null;\n  #feedback: { element: HTMLElement; original: string; text: string } | null = null;\n  /**\n   * Every feedback this controller wrote a result's wording into, with that wording. It\n   * outlives a connection, so an in-page move still knows what it wrote.\n   */\n  readonly #written = new Map<HTMLElement, string>();\n  readonly #morphRender = new MorphRenderWatcher(() => this.#renderResult());\n\n  override connect(): void {\n    this.#connected = true;\n    this.#adopt();\n    this.#result = null;\n    this.#feedback = this.hasFeedbackTarget\n      ? {\n          element: this.feedbackTarget,\n          original: this.feedbackTarget.textContent ?? \"\",\n          text: this.feedbackTarget.textContent ?? \"\",\n        }\n      : null;\n    this.#morphRender.observe(this.element);\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.#morphRender.disconnect();\n    this.#timers.clearAll();\n  }\n\n  /**\n   * Follows a `copiedLabel` swapped in place while a successful copy is shown.\n   *\n   * Render only: nothing is announced or dispatched, and the return to idle keeps the\n   * deadline the copy set. The slot changes only while `data-state` is `copied` and it\n   * still reads the previous label — the one the copy wrote there — so text someone\n   * else put in the slot stays. Stimulus also runs this ahead of `connect()`, which\n   * settles a result restored with the markup itself, so nothing is written then.\n   */\n  copiedLabelValueChanged(label: string, previous: string | undefined): void {\n    this.#followLabel(\"copied\", label, previous);\n  }\n\n  /**\n   * Follows an `errorLabel` swapped in place while a failed copy is shown, on the same\n   * terms as {@link ClipboardController.copiedLabelValueChanged}: only while\n   * `data-state` is `error` and the slot still reads the previous label.\n   */\n  errorLabelValueChanged(label: string, previous: string | undefined): void {\n    this.#followLabel(\"error\", label, previous);\n  }\n\n  /**\n   * Copies the resolved text and reports the outcome. Bound via `data-action`\n   * (click). Dispatches `stimeo--clipboard:copy` with `{ success, text, message }`\n   * once per completed attempt — including on failure — so consumers can react\n   * either way. `message` is the authored label for that outcome, so a part that\n   * shows wording — `stimeo--clipboard:copy->stimeo--toast#show` — needs nothing\n   * else; wiring both that and the announcer reads the same result twice.\n   * An attempt whose connection ended while it was in flight reports nothing.\n   */\n  async copy(): Promise<void> {\n    const text = this.#resolveText();\n    let success = false;\n    try {\n      await navigator.clipboard.writeText(text);\n      success = true;\n    } catch {\n      success = false;\n    }\n    if (!this.#connected) return;\n\n    this.#reportResult(success);\n    const message = success ? this.copiedLabelValue : this.errorLabelValue;\n    this.dispatch(\"copy\", { detail: { success, text, message } });\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  /**\n   * Reads the current state back from the DOM.\n   *\n   * A `copied` or `error` found at connect time is this controller's own output\n   * from a connection that is gone, and so is the timer that would have cleared it\n   * — nothing else would ever return the element to `idle`. Any other authored\n   * value belongs to the consumer and only a missing attribute takes the default.\n   */\n  #adopt(): void {\n    if (this.#inTransientState()) {\n      const restored = this.#written.size === 0;\n      this.#reset();\n      // A fresh instance on restored markup has no write on record: the first feedback\n      // holds the restored result's wording, which goes with the result.\n      if (restored && this.hasFeedbackTarget) this.feedbackTarget.textContent = \"\";\n      return;\n    }\n    setDefaultAttribute(this.element, \"data-state\", \"idle\");\n  }\n\n  /** Whether `data-state` currently holds one of the values this controller writes. */\n  #inTransientState(): boolean {\n    const state = this.element.getAttribute(\"data-state\");\n    return state !== null && TRANSIENT_STATES.has(state);\n  }\n\n  /**\n   * Reflects the result, announces it, and schedules the return to idle.\n   */\n  #reportResult(success: boolean): void {\n    this.#result = success;\n    this.#renderResult(true);\n    this.#announceResult(success);\n    this.#scheduleReset();\n  }\n\n  /**\n   * Repairs a held result without repeating its announcement or extending its deadline.\n   * @stimeoRenderRoot\n   */\n  #renderResult(force = false): void {\n    if (this.#result === null) {\n      setDefaultAttribute(this.element, \"data-state\", \"idle\");\n      return;\n    }\n    this.element.setAttribute(\"data-state\", this.#result ? \"copied\" : \"error\");\n    if (!this.hasFeedbackTarget) return;\n    const element = this.feedbackTarget;\n    const held = this.#feedback;\n    if (\n      !force &&\n      (!held ||\n        element !== held.element ||\n        element.firstElementChild !== null ||\n        (element.textContent !== held.text && element.textContent !== held.original))\n    )\n      return;\n    const text = this.#result ? this.copiedLabelValue : this.errorLabelValue;\n    this.#feedback = {\n      element,\n      original: held?.element === element ? held.original : (element.textContent ?? \"\"),\n      text,\n    };\n    element.textContent = text;\n    this.#written.set(element, text);\n  }\n\n  /**\n   * Reads the result out through the shared announcer.\n   *\n   * @stimeoRuntimeOnly `announceCopiedText` / `announceErrorText` word the one announcement a copy\n   *   makes.\n   */\n  #announceResult(success: boolean): void {\n    announce(success ? this.announceCopiedTextValue : this.announceErrorTextValue);\n  }\n\n  /**\n   * Arms the return to idle for the result just shown.\n   *\n   * @stimeoRuntimeOnly `feedbackDuration` is the delay of the one timer this call arms, and the\n   *   reset that timer runs reads no Value.\n   */\n  #scheduleReset(): void {\n    // Drop any in-flight reset so consecutive copies restart the full window\n    // rather than having the earlier timer clear the new result prematurely.\n    this.#timers.clearAll();\n    if (this.#safeFeedbackDuration > 0) {\n      this.#timers.set(() => this.#reset(), this.#safeFeedbackDuration);\n    }\n  }\n\n  /**\n   * Rewrites the slot to `label` while `state` is shown and the slot still reads\n   * `previous`, the label this controller wrote for that result.\n   */\n  #followLabel(state: \"copied\" | \"error\", label: string, previous: string | undefined): void {\n    if (!this.#connected) return;\n    if (this.element.getAttribute(\"data-state\") !== state || !this.hasFeedbackTarget) return;\n    if (this.feedbackTarget.textContent !== previous) return;\n    this.feedbackTarget.textContent = label;\n    this.#written.set(this.feedbackTarget, label);\n    if (this.#feedback?.element === this.feedbackTarget) this.#feedback.text = label;\n  }\n\n  /**\n   * Returns to the idle state and empties each feedback this controller wrote into that is\n   * still a feedback target showing the wording written there and nothing else. A slot the\n   * page swapped in, rewrote, or put an element into keeps what it holds.\n   */\n  #reset(): void {\n    this.#result = null;\n    this.element.setAttribute(\"data-state\", \"idle\");\n    for (const [element, text] of this.#written) {\n      if (!this.feedbackTargets.includes(element)) continue;\n      if (element.firstElementChild === null && element.textContent === text) {\n        element.textContent = \"\";\n      }\n    }\n    this.#written.clear();\n  }\n  /** Current `feedbackDuration` declaration resolved against its numeric contract. */\n  get #safeFeedbackDuration(): number {\n    return this.#numbers.read(\n      this,\n      \"feedbackDuration\",\n      this.feedbackDurationValue,\n      ClipboardController.values.feedbackDuration.default,\n      ClipboardController.valueConstraints.feedbackDuration,\n    );\n  }\n}\n"]}

package/dist/controllers/collapsible_controller.d.ts

@@ -57,7 +57,9 @@ declare class CollapsibleController extends Controller<HTMLElement> {
     static actions: readonly ["toggle"];
     static events: readonly ["close", "open"];
     readonly triggerTarget: HTMLElement;
+    readonly triggerTargets: HTMLElement[];
     readonly contentTarget: HTMLElement;
+    readonly contentTargets: HTMLElement[];
     readonly expandedLabelTargets: HTMLElement[];
     readonly collapsedLabelTargets: HTMLElement[];
     readonly hasTriggerTarget: boolean;
@@ -72,21 +74,31 @@ declare class CollapsibleController extends Controller<HTMLElement> {
      * user opened *or* closed survives a back-navigation, even when the declarative
      * `open` Value disagrees. An already-open region remains open without a
      * close/reopen cycle. The Value only seeds a genuinely fresh render where no
-     * state attribute is present yet; any opening animation in that case belongs to
-     * the consumer's CSS.
+     * state attribute is present yet, and a declaration rewritten after connect moves
+     * nothing; any opening animation in the seeded case belongs to the consumer's CSS.
      */
     connect(): void;
     disconnect(): void;
     /** Reconciles a replacement trigger target with the content's live state. */
     triggerTargetConnected(trigger: HTMLElement): void;
+    /**
+     * Gives a trigger that no longer resolves as one its own values back, even after
+     * `disconnect()` (a dropped identifier leaves it on the page), and while connected
+     * reconciles the trigger that stays. One that still resolves keeps its state.
+     */
+    triggerTargetDisconnected(trigger: HTMLElement): void;
     /** Settles a label that arrived after the state it belongs to was written. */
     expandedLabelTargetConnected(): void;
     /** Settles a label that arrived after the state it belongs to was written. */
     collapsedLabelTargetConnected(): void;
     /** Reconciles a replacement content target with the disclosure's live state. */
     contentTargetConnected(content: HTMLElement): void;
-    /** Cancels a wait tied to a content target that was removed or replaced. */
-    contentTargetDisconnected(): void;
+    /**
+     * Cancels a wait tied to a departing content, gives one that no longer resolves its
+     * own values back, even after `disconnect()`, and while connected reconciles the
+     * content that stays.
+     */
+    contentTargetDisconnected(content: HTMLElement): void;
     /** Toggles the region open/closed. Bound via `data-action` (click). */
     toggle(event?: Event): void;
 }