stimeo-ui 0.6.0 → 0.7.0

package/dist/controllers/direct_upload_controller.js

@@ -2,6 +2,52 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/direct_upload_controller.ts
 
+// src/utils/announce.ts
+function announce(message, options = {}) {
+  const text = message.trim();
+  if (text.length === 0) return;
+  window.dispatchEvent(
+    new CustomEvent("stimeo--announcer:announce", {
+      detail: { message: text, assertive: options.assertive === true }
+    })
+  );
+}
+function fillTemplate(template, values) {
+  return template.replace(/\{([a-zA-Z][a-zA-Z0-9]*)\}/g, (match, name) => {
+    const replacement = values[name];
+    return replacement === void 0 ? match : String(replacement);
+  });
+}
+
+// src/utils/before_cache_reset.ts
+var BeforeCacheReset = class _BeforeCacheReset {
+  /** Every subscribed instance, iterated by the one shared document listener. */
+  static #subscribers = /* @__PURE__ */ new Set();
+  /** The shared listener; installed while at least one instance is subscribed. */
+  static #onBeforeCache = () => {
+    for (const subscriber of _BeforeCacheReset.#subscribers) subscriber.#rewind();
+  };
+  #rewind;
+  /** @param rewind - the pass that returns this controller's state to its initial form. */
+  constructor(rewind) {
+    this.#rewind = rewind;
+  }
+  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */
+  activate() {
+    const first = _BeforeCacheReset.#subscribers.size === 0;
+    _BeforeCacheReset.#subscribers.add(this);
+    if (first) {
+      document.addEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+    }
+  }
+  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */
+  deactivate() {
+    _BeforeCacheReset.#subscribers.delete(this);
+    if (_BeforeCacheReset.#subscribers.size > 0) return;
+    document.removeEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+  }
+};
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -58,101 +104,165 @@ var SafeTimeout = class extends TimerRegistry {
 // src/controllers/direct_upload_controller.ts
 var REMOVE_DELAY = 4e3;
 var DirectUploadController = class extends Controller {
-  static targets = ["list", "row", "status"];
+  static targets = ["list", "row"];
   static values = {
-    announce: { type: Boolean, default: true },
     removeOnDone: { type: Boolean, default: false },
-    doneLabel: { type: String, default: "" },
-    errorLabel: { type: String, default: "" },
+    announceDoneText: { type: String, default: "" },
+    announceErrorText: { type: String, default: "" },
     scope: { type: String, default: "" }
   };
   static events = ["progress", "done", "error"];
   #timeouts = new SafeTimeout();
   #rows = /* @__PURE__ */ new Map();
+  #beforeCache = new BeforeCacheReset(() => this.#reset());
+  /** The validated `scope` selector; a broken declaration falls back to `""`. */
+  #scopeSelector = "";
   #onInitialize = (event) => {
     if (!this.#inScope(event)) return;
     const detail = this.#detail(event);
-    this.#rowFor(detail.id, detail.file?.name ?? "");
+    this.#rowFor(detail.id, this.#name(detail));
   };
   #onProgress = (event) => {
     if (!this.#inScope(event)) return;
     const detail = this.#detail(event);
-    this.#updateProgress(this.#key(detail.id), Math.round(detail.progress ?? 0));
+    this.#updateProgress(this.#key(detail.id), detail.progress ?? 0, this.#name(detail));
   };
   #onError = (event) => {
     if (!this.#inScope(event)) return;
     const detail = this.#detail(event);
-    this.#fail(this.#key(detail.id), detail.error ?? "");
+    const rendered = this.#fail(this.#key(detail.id), detail.error ?? "", this.#name(detail));
+    if (rendered) event.preventDefault();
   };
   #onEnd = (event) => {
     if (!this.#inScope(event)) return;
     const detail = this.#detail(event);
-    this.#complete(this.#key(detail.id), detail.file?.name ?? "");
+    this.#complete(this.#key(detail.id), this.#name(detail));
   };
   connect() {
     document.addEventListener("direct-upload:initialize", this.#onInitialize);
     document.addEventListener("direct-upload:progress", this.#onProgress);
     document.addEventListener("direct-upload:error", this.#onError);
     document.addEventListener("direct-upload:end", this.#onEnd);
+    this.#beforeCache.activate();
+    this.#rescheduleRemovals();
   }
   disconnect() {
     document.removeEventListener("direct-upload:initialize", this.#onInitialize);
     document.removeEventListener("direct-upload:progress", this.#onProgress);
     document.removeEventListener("direct-upload:error", this.#onError);
     document.removeEventListener("direct-upload:end", this.#onEnd);
+    this.#beforeCache.deactivate();
     this.#timeouts.clearAll();
-    this.#rows.clear();
+  }
+  /** Validates `scope` once so the per-event path never parses or throws. */
+  scopeValueChanged() {
+    const selector = this.scopeValue;
+    if (selector.length > 0) {
+      try {
+        this.element.matches(selector);
+        this.#scopeSelector = selector;
+        return;
+      } catch {
+      }
+    }
+    this.#scopeSelector = "";
   }
   /** Updates a row's progress and the aggregate, emitting `progress`. */
-  #updateProgress(id, percent) {
-    const row = this.#rowFor(id);
-    if (row === null) return;
-    const clamped = Math.max(0, Math.min(100, percent));
-    row.setAttribute("aria-valuenow", String(clamped));
-    row.setAttribute("aria-valuetext", `${clamped}%`);
-    row.style.setProperty("--stimeo--upload-progress", `${clamped}%`);
-    this.#setField(row, "percent", `${clamped}%`);
+  #updateProgress(id, percent, name) {
+    const row = this.#rowFor(id, name);
+    if (row === null || this.#isSettled(row)) return;
+    const clamped = this.#applyProgress(row, percent);
     this.#syncAggregate();
     this.dispatch("progress", { detail: { id, percent: clamped } });
   }
-  /** Marks a row done, announces it, and emits `done`. */
-  #complete(id, name = "") {
+  /** Marks a not-yet-settled row done at 100%, announces it, and emits `done`. */
+  #complete(id, name) {
     const row = this.#rowFor(id, name);
-    if (row === null) return;
+    if (row === null || this.#isSettled(row)) return;
     row.setAttribute("data-upload-state", "done");
-    this.#announce(this.doneLabelValue, row);
+    this.#applyProgress(row, 100);
+    this.#syncAggregate();
+    this.#announce(this.announceDoneTextValue, name, row);
     this.dispatch("done", { detail: { id } });
     if (this.removeOnDoneValue) {
       this.#timeouts.set(() => this.#removeRow(id), REMOVE_DELAY);
     }
   }
-  /** Marks a row failed, announces it, and emits `error`. */
-  #fail(id, error) {
-    const row = this.#rowFor(id);
-    if (row === null) return;
+  /**
+   * Marks a not-yet-settled row failed, announces it, and emits `error`.
+   * Returns whether the failure is rendered by this widget (used to decide the
+   * `direct-upload:error` default), which also holds when the row already
+   * displays an earlier failure.
+   */
+  #fail(id, error, name) {
+    const row = this.#rowFor(id, name);
+    if (row === null) return false;
+    if (this.#isSettled(row)) return row.getAttribute("data-upload-state") === "error";
     row.setAttribute("data-upload-state", "error");
-    this.#announce(this.errorLabelValue, row);
+    this.#announce(this.announceErrorTextValue, name, row);
     this.dispatch("error", { detail: { id, error } });
+    return true;
   }
-  /** Returns an existing row or clones one from the template. */
+  /** Whether the row reached a terminal state; settled rows are never rewritten. */
+  #isSettled(row) {
+    const state = row.getAttribute("data-upload-state");
+    return state === "done" || state === "error";
+  }
+  /** Re-arms `removeOnDone` for completed rows after a reconnect. */
+  #rescheduleRemovals() {
+    if (!this.removeOnDoneValue) return;
+    this.#prune();
+    for (const [id, row] of this.#rows) {
+      if (row.getAttribute("data-upload-state") === "done") {
+        this.#timeouts.set(() => this.#removeRow(id), REMOVE_DELAY);
+      }
+    }
+  }
+  /** Returns the live row for `id`, creating (and labeling) one on first sight. */
   #rowFor(id, name) {
     const key = this.#key(id);
     const existing = this.#rows.get(key);
-    if (existing !== void 0) return existing;
+    if (existing !== void 0) {
+      if (this.#tracksRow(existing)) {
+        this.#applyName(existing, name);
+        return existing;
+      }
+      existing.remove();
+      this.#rows.delete(key);
+    }
     if (!this.hasRowTarget || !this.hasListTarget) return null;
     const clone = this.rowTarget.content.firstElementChild?.cloneNode(true);
     if (!(clone instanceof HTMLElement)) return null;
-    if (name !== void 0 && name.length > 0) {
-      this.#setField(clone, "name", name);
-      clone.setAttribute("aria-label", name);
-    }
-    clone.setAttribute("aria-valuenow", "0");
+    this.#applyName(clone, name);
     clone.setAttribute("data-upload-state", "uploading");
-    clone.style.setProperty("--stimeo--upload-progress", "0%");
+    this.#applyProgress(clone, 0);
     this.listTarget.appendChild(clone);
     this.#rows.set(key, clone);
+    this.#syncAggregate();
     return clone;
   }
+  /**
+   * Writes the event's file name into `[data-field="name"]` and, unless the row
+   * already carries a non-blank `aria-label` — authored on the template or
+   * applied by an earlier event — makes it the accessible name too. The visible
+   * name never depends on the label: an authored label keeps its wording while
+   * the field still shows which file this row tracks.
+   */
+  #applyName(row, name) {
+    if (name.length === 0) return;
+    this.#setField(row, "name", name);
+    if ((row.getAttribute("aria-label") ?? "").trim().length > 0) return;
+    row.setAttribute("aria-label", name);
+  }
+  /** Writes one progress value to every per-row hook; returns the clamped percent. */
+  #applyProgress(row, percent) {
+    const clamped = Math.max(0, Math.min(100, Math.round(percent)));
+    row.setAttribute("aria-valuenow", String(clamped));
+    row.setAttribute("aria-valuetext", `${clamped}%`);
+    row.style.setProperty("--stimeo--upload-progress", `${clamped}%`);
+    this.#setField(row, "percent", `${clamped}%`);
+    return clamped;
+  }
   #removeRow(id) {
     const row = this.#rows.get(id);
     if (row === void 0) return;
@@ -160,10 +270,15 @@ var DirectUploadController = class extends Controller {
     this.#rows.delete(id);
     this.#syncAggregate();
   }
-  /** Reflects the average progress across rows on the controller element. */
+  /**
+   * Reflects the average progress across live rows on the controller element,
+   * withdrawing both hooks once no rows remain.
+   */
   #syncAggregate() {
+    this.#prune();
     if (this.#rows.size === 0) {
       this.element.removeAttribute("data-upload-progress");
+      this.element.style.removeProperty("--stimeo--upload-progress");
       return;
     }
     let total = 0;
@@ -174,11 +289,48 @@ var DirectUploadController = class extends Controller {
     this.element.setAttribute("data-upload-progress", String(overall));
     this.element.style.setProperty("--stimeo--upload-progress", `${overall}%`);
   }
-  /** Writes a consumer label (with `%{name}` substituted) to the status region. */
-  #announce(label, row) {
-    if (!this.announceValue || !this.hasStatusTarget || label.length === 0) return;
-    const name = this.#field(row, "name")?.textContent ?? "";
-    this.statusTarget.textContent = label.replace("%{name}", name);
+  /**
+   * Whether a bookkept row is still this widget's live UI: connected, and — when
+   * a `list` target is present — inside the *current* one, so re-pointing the
+   * target attribute at a new element retires rows kept alive in the old list.
+   */
+  #tracksRow(row) {
+    if (!row.isConnected) return false;
+    return !this.hasListTarget || this.listTarget.contains(row);
+  }
+  /**
+   * Retires rows that left the live UI (list swap, external removal). A retired
+   * clone is removed outright — generated rows only ever live under the current
+   * `list`, so the before-cache rewind never has an untracked leftover to miss.
+   */
+  #prune() {
+    for (const [id, row] of this.#rows) {
+      if (this.#tracksRow(row)) continue;
+      row.remove();
+      this.#rows.delete(id);
+    }
+  }
+  /**
+   * Returns the widget to its pre-upload state just before Turbo caches the
+   * page, so the snapshot never replays rows for uploads that cannot resume.
+   */
+  #reset() {
+    for (const row of this.#rows.values()) row.remove();
+    this.#rows.clear();
+    this.#timeouts.clearAll();
+    this.#syncAggregate();
+  }
+  /**
+   * Sends one consumer-worded message to the page's shared announcer. `{name}`
+   * resolves to the row's displayed name first — the event that settles an
+   * upload may omit the file although an earlier event already named the row —
+   * then the event's own name, then the accessible name (which an authored
+   * label owns, so it is the last resort, not the primary source).
+   */
+  #announce(template, name, row) {
+    const stored = this.#field(row, "name")?.textContent ?? "";
+    const label = stored.length > 0 ? stored : name.length > 0 ? name : row.getAttribute("aria-label") ?? "";
+    announce(fillTemplate(template, { name: label }));
   }
   #field(row, name) {
     return row.querySelector(`[data-field="${name}"]`);
@@ -190,17 +342,21 @@ var DirectUploadController = class extends Controller {
   #detail(event) {
     return event.detail ?? {};
   }
+  /** The file name every ActiveStorage `direct-upload:*` event carries. */
+  #name(detail) {
+    return detail.file?.name ?? "";
+  }
   /**
    * Whether an event belongs to this controller. With `scope` set, only events
    * whose target (the file input) sits inside an element matching `scope` are
-   * handled, so several upload widgets on one page do not cross-populate. Resolved
-   * with `closest()` from the target itself, so the chatty `progress` stream never
-   * pays a document-wide query. Empty `scope` handles all.
+   * handled, so several upload widgets on one page do not cross-populate.
+   * Resolved with `closest()` from the target itself, so the chatty `progress`
+   * stream never pays a document-wide query. Empty `scope` handles all.
    */
   #inScope(event) {
-    if (this.scopeValue.length === 0) return true;
+    if (this.#scopeSelector.length === 0) return true;
     const target = event.target;
-    return target instanceof Element && target.closest(this.scopeValue) !== null;
+    return target instanceof Element && target.closest(this.#scopeSelector) !== null;
   }
   #key(id) {
     return String(id ?? "");

package/dist/controllers/direct_upload_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/direct_upload_controller.ts"],"names":[],"mappings":"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","file":"direct_upload_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/** Detail shapes for the ActiveStorage `direct-upload:*` events. */\ninterface UploadDetail {\n  id?: string | number;\n  file?: { name?: string };\n  progress?: number;\n  error?: string;\n}\n\n/** Delay (ms) before a completed row is removed when `removeOnDone` is set. */\nconst REMOVE_DELAY = 4000;\n\n/**\n * Headless progress UI for ActiveStorage Direct Uploads: subscribes to the\n * `direct-upload:*` events and renders a per-file progress row (no dedicated APG\n * pattern; the rows follow the `role=\"progressbar\"` practice). The companion to\n * {@link \"file-dropzone\"}, which leaves transport out of scope.\n *\n * Markup contract (identifier: `stimeo--direct-upload`):\n *   <div data-controller=\"stimeo--direct-upload\">\n *     <div data-stimeo--direct-upload-target=\"list\"></div>\n *     <template data-stimeo--direct-upload-target=\"row\">\n *       <div role=\"progressbar\" aria-valuemin=\"0\" aria-valuemax=\"100\">\n *         <span data-field=\"name\"></span><span data-field=\"percent\"></span>\n *       </div>\n *     </template>\n *     <span data-stimeo--direct-upload-target=\"status\" aria-live=\"polite\"></span>\n *   </div>\n *\n * For each upload it clones the `row` template into `list`, then updates\n * `aria-valuenow`, the `[data-field=\"percent\"]` text, and the\n * `--stimeo--upload-progress` custom property as `direct-upload:progress` arrives,\n * and flips `data-upload-state` to `done` / `error`. Completion and failure are\n * announced into the optional `status` live region using the consumer-provided\n * `doneLabel` / `errorLabel` (so copy stays localizable); per-tick progress is not\n * announced (the progressbar's `aria-valuenow` conveys it) to avoid flooding.\n *\n * @remarks\n * Behavior only — no bars are drawn. The `direct-upload:*` listeners live on\n * `document` (the events bubble there) and are removed on `disconnect()` (Turbo\n * navigation included), along with any pending removal timers, so a callback that\n * arrives after teardown never touches a detached row. With multiple upload widgets\n * on one page, set `scope` to a selector for the owning form/root so each widget\n * only handles its own uploads.\n */\nexport class DirectUploadController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"row\", \"status\"];\n  static override values = {\n    announce: { type: Boolean, default: true },\n    removeOnDone: { type: Boolean, default: false },\n    doneLabel: { type: String, default: \"\" },\n    errorLabel: { type: String, default: \"\" },\n    scope: { type: String, default: \"\" },\n  };\n  static events = [\"progress\", \"done\", \"error\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly rowTarget: HTMLTemplateElement;\n  declare readonly statusTarget: HTMLElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasRowTarget: boolean;\n  declare readonly hasStatusTarget: boolean;\n\n  declare announceValue: boolean;\n  declare removeOnDoneValue: boolean;\n  declare doneLabelValue: string;\n  declare errorLabelValue: string;\n  declare scopeValue: string;\n\n  readonly #timeouts = new SafeTimeout();\n  readonly #rows = new Map<string, HTMLElement>();\n\n  readonly #onInitialize = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#rowFor(detail.id, detail.file?.name ?? \"\");\n  };\n\n  readonly #onProgress = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#updateProgress(this.#key(detail.id), Math.round(detail.progress ?? 0));\n  };\n\n  readonly #onError = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#fail(this.#key(detail.id), detail.error ?? \"\");\n  };\n\n  readonly #onEnd = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#complete(this.#key(detail.id), detail.file?.name ?? \"\");\n  };\n\n  override connect(): void {\n    document.addEventListener(\"direct-upload:initialize\", this.#onInitialize);\n    document.addEventListener(\"direct-upload:progress\", this.#onProgress);\n    document.addEventListener(\"direct-upload:error\", this.#onError);\n    document.addEventListener(\"direct-upload:end\", this.#onEnd);\n  }\n\n  override disconnect(): void {\n    document.removeEventListener(\"direct-upload:initialize\", this.#onInitialize);\n    document.removeEventListener(\"direct-upload:progress\", this.#onProgress);\n    document.removeEventListener(\"direct-upload:error\", this.#onError);\n    document.removeEventListener(\"direct-upload:end\", this.#onEnd);\n    this.#timeouts.clearAll();\n    this.#rows.clear();\n  }\n\n  /** Updates a row's progress and the aggregate, emitting `progress`. */\n  #updateProgress(id: string, percent: number): void {\n    const row = this.#rowFor(id);\n    if (row === null) return;\n    const clamped = Math.max(0, Math.min(100, percent));\n    row.setAttribute(\"aria-valuenow\", String(clamped));\n    row.setAttribute(\"aria-valuetext\", `${clamped}%`);\n    row.style.setProperty(\"--stimeo--upload-progress\", `${clamped}%`);\n    this.#setField(row, \"percent\", `${clamped}%`);\n    this.#syncAggregate();\n    this.dispatch(\"progress\", { detail: { id, percent: clamped } });\n  }\n\n  /** Marks a row done, announces it, and emits `done`. */\n  #complete(id: string, name = \"\"): void {\n    // Lazily resolve like `#fail`/`#updateProgress` so an `end` that arrives\n    // without a prior `initialize`/`progress` (no row yet) still records the\n    // completion instead of silently dropping it; the file name (when the event\n    // carries one) gives the freshly-created row an accessible label.\n    const row = this.#rowFor(id, name);\n    if (row === null) return;\n    row.setAttribute(\"data-upload-state\", \"done\");\n    this.#announce(this.doneLabelValue, row);\n    this.dispatch(\"done\", { detail: { id } });\n    if (this.removeOnDoneValue) {\n      this.#timeouts.set(() => this.#removeRow(id), REMOVE_DELAY);\n    }\n  }\n\n  /** Marks a row failed, announces it, and emits `error`. */\n  #fail(id: string, error: string): void {\n    const row = this.#rowFor(id);\n    if (row === null) return;\n    row.setAttribute(\"data-upload-state\", \"error\");\n    this.#announce(this.errorLabelValue, row);\n    this.dispatch(\"error\", { detail: { id, error } });\n  }\n\n  /** Returns an existing row or clones one from the template. */\n  #rowFor(id: string | number | undefined, name?: string): HTMLElement | null {\n    const key = this.#key(id);\n    const existing = this.#rows.get(key);\n    if (existing !== undefined) return existing;\n    if (!this.hasRowTarget || !this.hasListTarget) return null;\n    const clone = this.rowTarget.content.firstElementChild?.cloneNode(true);\n    if (!(clone instanceof HTMLElement)) return null;\n    if (name !== undefined && name.length > 0) {\n      this.#setField(clone, \"name\", name);\n      // Give the progressbar an accessible name (per-file).\n      clone.setAttribute(\"aria-label\", name);\n    }\n    clone.setAttribute(\"aria-valuenow\", \"0\");\n    clone.setAttribute(\"data-upload-state\", \"uploading\");\n    clone.style.setProperty(\"--stimeo--upload-progress\", \"0%\");\n    this.listTarget.appendChild(clone);\n    this.#rows.set(key, clone);\n    return clone;\n  }\n\n  #removeRow(id: string): void {\n    const row = this.#rows.get(id);\n    if (row === undefined) return;\n    row.remove();\n    this.#rows.delete(id);\n    this.#syncAggregate();\n  }\n\n  /** Reflects the average progress across rows on the controller element. */\n  #syncAggregate(): void {\n    if (this.#rows.size === 0) {\n      this.element.removeAttribute(\"data-upload-progress\");\n      return;\n    }\n    let total = 0;\n    for (const row of this.#rows.values()) {\n      total += Number(row.getAttribute(\"aria-valuenow\") ?? \"0\");\n    }\n    const overall = Math.round(total / this.#rows.size);\n    this.element.setAttribute(\"data-upload-progress\", String(overall));\n    this.element.style.setProperty(\"--stimeo--upload-progress\", `${overall}%`);\n  }\n\n  /** Writes a consumer label (with `%{name}` substituted) to the status region. */\n  #announce(label: string, row: HTMLElement): void {\n    if (!this.announceValue || !this.hasStatusTarget || label.length === 0) return;\n    const name = this.#field(row, \"name\")?.textContent ?? \"\";\n    this.statusTarget.textContent = label.replace(\"%{name}\", name);\n  }\n\n  #field(row: HTMLElement, name: string): HTMLElement | null {\n    return row.querySelector<HTMLElement>(`[data-field=\"${name}\"]`);\n  }\n\n  #setField(row: HTMLElement, name: string, text: string): void {\n    const field = this.#field(row, name);\n    if (field !== null) field.textContent = text;\n  }\n\n  #detail(event: Event): UploadDetail {\n    return (event as CustomEvent<UploadDetail>).detail ?? {};\n  }\n\n  /**\n   * Whether an event belongs to this controller. With `scope` set, only events\n   * whose target (the file input) sits inside an element matching `scope` are\n   * handled, so several upload widgets on one page do not cross-populate. Resolved\n   * with `closest()` from the target itself, so the chatty `progress` stream never\n   * pays a document-wide query. Empty `scope` handles all.\n   */\n  #inScope(event: Event): boolean {\n    if (this.scopeValue.length === 0) return true;\n    const target = event.target;\n    return target instanceof Element && target.closest(this.scopeValue) !== null;\n  }\n\n  #key(id: string | number | undefined): string {\n    return String(id ?? \"\");\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/before_cache_reset.ts","../../src/utils/safe_timeout.ts","../../src/controllers/direct_upload_controller.ts"],"names":[],"mappings":"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","file":"direct_upload_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 (the `MicrotaskCoalescer` split).\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 * 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 { announce, fillTemplate } from \"../utils/announce\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/** Detail shapes for the ActiveStorage `direct-upload:*` events. */\ninterface UploadDetail {\n  id?: string | number;\n  file?: { name?: string };\n  progress?: number;\n  error?: string;\n}\n\n/** Delay (ms) before a completed row is removed when `removeOnDone` is set. */\nconst REMOVE_DELAY = 4000;\n\n/**\n * Headless progress UI for ActiveStorage Direct Uploads: subscribes to the\n * `direct-upload:*` events and renders a per-file progress row (no dedicated APG\n * pattern; the rows follow the `role=\"progressbar\"` practice). The companion to\n * {@link \"file-dropzone\"}, which leaves transport out of scope.\n *\n * Markup contract (identifier: `stimeo--direct-upload`):\n *   <div data-controller=\"stimeo--direct-upload\"\n *        data-stimeo--direct-upload-announce-done-text-value=\"{name} uploaded\"\n *        data-stimeo--direct-upload-announce-error-text-value=\"{name} failed\">\n *     <div data-stimeo--direct-upload-target=\"list\"></div>\n *     <template data-stimeo--direct-upload-target=\"row\">\n *       <div role=\"progressbar\" aria-valuemin=\"0\" aria-valuemax=\"100\">\n *         <span data-field=\"name\"></span><span data-field=\"percent\"></span>\n *       </div>\n *     </template>\n *   </div>\n *\n * For each upload it clones the `row` template into `list`, then keeps\n * `aria-valuenow` / `aria-valuetext`, the `[data-field=\"percent\"]` text, and the\n * `--stimeo--upload-progress` custom property (0–100, rounded and clamped) in\n * sync as `direct-upload:progress` arrives. The file name carried by the events\n * fills `[data-field=\"name\"]` and becomes the row's `aria-label` unless the\n * template already authors one. The aggregate across live rows is mirrored on\n * the controller element as `data-upload-progress` plus the same custom\n * property, recomputed whenever a row is added, updated, or removed, and\n * withdrawn entirely once no rows remain.\n *\n * A row leaves `uploading` exactly once: `direct-upload:error` settles it as\n * `error`, and `direct-upload:end` — which ActiveStorage fires after success\n * *and* failure — completes only rows not already settled, pinning them at 100%\n * and flipping `data-upload-state` to `done`. Later events never rewrite a\n * settled row, so a failure survives the `end` that follows it.\n *\n * Completion and failure are handed to the page's shared `stimeo--announcer` as\n * one polite message each, worded by the consumer via `announceDoneText` /\n * `announceErrorText` (`{name}` expands to the file name; empty templates stay\n * silent, keeping announcements opt-in and i18n-neutral). Per-tick progress is\n * not announced — the progressbar's `aria-valuenow` conveys it — to avoid\n * flooding. A failure this controller has rendered also cancels the\n * `direct-upload:error` default, which suppresses ActiveStorage's native\n * `alert()`; when no row could be rendered the alert stays as the fallback.\n *\n * Events dispatched on the controller element (all bubble):\n * - `stimeo--direct-upload:progress` dispatches `{ id: string, percent: number }`\n *   on each progress update, after clamping.\n * - `stimeo--direct-upload:done` dispatches `{ id: string }` when an upload\n *   completes successfully.\n * - `stimeo--direct-upload:error` dispatches `{ id: string, error: string }`\n *   when an upload fails.\n *\n * @remarks\n * Behavior only — no bars are drawn. The `direct-upload:*` listeners live on\n * `document` (the events bubble there) and are removed on `disconnect()` (Turbo\n * navigation included), along with any pending removal timers, so a callback\n * that arrives after teardown never touches a detached row. Rows are transient\n * UI: just before Turbo caches the page they are removed and the aggregate is\n * withdrawn, so a restored snapshot starts pristine instead of replaying stale\n * rows (a dead upload cannot resume after restoration). The live DOM stays the\n * source of truth — a row removed or replaced outside this controller is\n * forgotten and rebuilt on the next event for its id, and a clone stranded\n * outside the current `list` (a re-pointed target) is removed outright, so\n * generated rows only ever live there.\n *\n * With multiple upload widgets on one page, set `scope` to a selector for the\n * owning form/root so each widget only handles its own uploads. A `scope` that\n * does not parse as a selector falls back to the default (handle all) instead\n * of throwing from the event handlers, so one broken declaration cannot silence\n * the widget.\n */\nexport class DirectUploadController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"row\"];\n  static override values = {\n    removeOnDone: { type: Boolean, default: false },\n    announceDoneText: { type: String, default: \"\" },\n    announceErrorText: { type: String, default: \"\" },\n    scope: { type: String, default: \"\" },\n  };\n  static events = [\"progress\", \"done\", \"error\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly rowTarget: HTMLTemplateElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasRowTarget: boolean;\n\n  declare removeOnDoneValue: boolean;\n  declare announceDoneTextValue: string;\n  declare announceErrorTextValue: string;\n  declare scopeValue: string;\n\n  readonly #timeouts = new SafeTimeout();\n  readonly #rows = new Map<string, HTMLElement>();\n  readonly #beforeCache = new BeforeCacheReset(() => this.#reset());\n\n  /** The validated `scope` selector; a broken declaration falls back to `\"\"`. */\n  #scopeSelector = \"\";\n\n  readonly #onInitialize = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#rowFor(detail.id, this.#name(detail));\n  };\n\n  readonly #onProgress = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#updateProgress(this.#key(detail.id), detail.progress ?? 0, this.#name(detail));\n  };\n\n  readonly #onError = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    const rendered = this.#fail(this.#key(detail.id), detail.error ?? \"\", this.#name(detail));\n    // ActiveStorage alert()s the raw error unless the event is cancelled. A\n    // failure this widget displays is handled, so the blocking duplicate is\n    // suppressed; an unrendered failure keeps the alert as its only signal.\n    if (rendered) event.preventDefault();\n  };\n\n  readonly #onEnd = (event: Event): void => {\n    if (!this.#inScope(event)) return;\n    const detail = this.#detail(event);\n    this.#complete(this.#key(detail.id), this.#name(detail));\n  };\n\n  override connect(): void {\n    document.addEventListener(\"direct-upload:initialize\", this.#onInitialize);\n    document.addEventListener(\"direct-upload:progress\", this.#onProgress);\n    document.addEventListener(\"direct-upload:error\", this.#onError);\n    document.addEventListener(\"direct-upload:end\", this.#onEnd);\n    this.#beforeCache.activate();\n    // An in-page move runs disconnect() → connect() on the same instance, and\n    // teardown cancelled any pending removals; completed rows re-earn theirs.\n    this.#rescheduleRemovals();\n  }\n\n  override disconnect(): void {\n    document.removeEventListener(\"direct-upload:initialize\", this.#onInitialize);\n    document.removeEventListener(\"direct-upload:progress\", this.#onProgress);\n    document.removeEventListener(\"direct-upload:error\", this.#onError);\n    document.removeEventListener(\"direct-upload:end\", this.#onEnd);\n    this.#beforeCache.deactivate();\n    this.#timeouts.clearAll();\n    // `#rows` is kept: `disconnect()` also fires on an in-page move, where the\n    // rows travel with the element and the next event should keep updating\n    // them. Stale entries self-heal via `#prune`, and the Turbo-cache path\n    // clears everything in `#reset()`.\n  }\n\n  /** Validates `scope` once so the per-event path never parses or throws. */\n  scopeValueChanged(): void {\n    const selector = this.scopeValue;\n    if (selector.length > 0) {\n      try {\n        this.element.matches(selector);\n        this.#scopeSelector = selector;\n        return;\n      } catch {\n        // Unparsable selector: fall through to the default below.\n      }\n    }\n    this.#scopeSelector = \"\";\n  }\n\n  /** Updates a row's progress and the aggregate, emitting `progress`. */\n  #updateProgress(id: string, percent: number, name: string): void {\n    const row = this.#rowFor(id, name);\n    if (row === null || this.#isSettled(row)) return;\n    const clamped = this.#applyProgress(row, percent);\n    this.#syncAggregate();\n    this.dispatch(\"progress\", { detail: { id, percent: clamped } });\n  }\n\n  /** Marks a not-yet-settled row done at 100%, announces it, and emits `done`. */\n  #complete(id: string, name: string): void {\n    // Resolve lazily like `#fail`/`#updateProgress` so an `end` that arrives\n    // without a prior `initialize`/`progress` (no row yet) still records the\n    // completion instead of silently dropping it.\n    const row = this.#rowFor(id, name);\n    if (row === null || this.#isSettled(row)) return;\n    row.setAttribute(\"data-upload-state\", \"done\");\n    this.#applyProgress(row, 100);\n    this.#syncAggregate();\n    this.#announce(this.announceDoneTextValue, name, row);\n    this.dispatch(\"done\", { detail: { id } });\n    if (this.removeOnDoneValue) {\n      this.#timeouts.set(() => this.#removeRow(id), REMOVE_DELAY);\n    }\n  }\n\n  /**\n   * Marks a not-yet-settled row failed, announces it, and emits `error`.\n   * Returns whether the failure is rendered by this widget (used to decide the\n   * `direct-upload:error` default), which also holds when the row already\n   * displays an earlier failure.\n   */\n  #fail(id: string, error: string, name: string): boolean {\n    const row = this.#rowFor(id, name);\n    if (row === null) return false;\n    if (this.#isSettled(row)) return row.getAttribute(\"data-upload-state\") === \"error\";\n    row.setAttribute(\"data-upload-state\", \"error\");\n    this.#announce(this.announceErrorTextValue, name, row);\n    this.dispatch(\"error\", { detail: { id, error } });\n    return true;\n  }\n\n  /** Whether the row reached a terminal state; settled rows are never rewritten. */\n  #isSettled(row: HTMLElement): boolean {\n    const state = row.getAttribute(\"data-upload-state\");\n    return state === \"done\" || state === \"error\";\n  }\n\n  /** Re-arms `removeOnDone` for completed rows after a reconnect. */\n  #rescheduleRemovals(): void {\n    if (!this.removeOnDoneValue) return;\n    this.#prune();\n    for (const [id, row] of this.#rows) {\n      if (row.getAttribute(\"data-upload-state\") === \"done\") {\n        this.#timeouts.set(() => this.#removeRow(id), REMOVE_DELAY);\n      }\n    }\n  }\n\n  /** Returns the live row for `id`, creating (and labeling) one on first sight. */\n  #rowFor(id: string | number | undefined, name: string): HTMLElement | null {\n    const key = this.#key(id);\n    const existing = this.#rows.get(key);\n    if (existing !== undefined) {\n      if (this.#tracksRow(existing)) {\n        this.#applyName(existing, name);\n        return existing;\n      }\n      // Removed, replaced, or no longer inside the current list: retire the\n      // clone (removing it is a no-op when something else already did) and\n      // rebuild from the live DOM.\n      existing.remove();\n      this.#rows.delete(key);\n    }\n    if (!this.hasRowTarget || !this.hasListTarget) return null;\n    const clone = this.rowTarget.content.firstElementChild?.cloneNode(true);\n    if (!(clone instanceof HTMLElement)) return null;\n    this.#applyName(clone, name);\n    clone.setAttribute(\"data-upload-state\", \"uploading\");\n    this.#applyProgress(clone, 0);\n    this.listTarget.appendChild(clone);\n    this.#rows.set(key, clone);\n    this.#syncAggregate();\n    return clone;\n  }\n\n  /**\n   * Writes the event's file name into `[data-field=\"name\"]` and, unless the row\n   * already carries a non-blank `aria-label` — authored on the template or\n   * applied by an earlier event — makes it the accessible name too. The visible\n   * name never depends on the label: an authored label keeps its wording while\n   * the field still shows which file this row tracks.\n   */\n  #applyName(row: HTMLElement, name: string): void {\n    if (name.length === 0) return;\n    this.#setField(row, \"name\", name);\n    // A whitespace-only label computes to no accessible name, so only a\n    // non-blank one counts as authored.\n    if ((row.getAttribute(\"aria-label\") ?? \"\").trim().length > 0) return;\n    row.setAttribute(\"aria-label\", name);\n  }\n\n  /** Writes one progress value to every per-row hook; returns the clamped percent. */\n  #applyProgress(row: HTMLElement, percent: number): number {\n    const clamped = Math.max(0, Math.min(100, Math.round(percent)));\n    row.setAttribute(\"aria-valuenow\", String(clamped));\n    row.setAttribute(\"aria-valuetext\", `${clamped}%`);\n    row.style.setProperty(\"--stimeo--upload-progress\", `${clamped}%`);\n    this.#setField(row, \"percent\", `${clamped}%`);\n    return clamped;\n  }\n\n  #removeRow(id: string): void {\n    const row = this.#rows.get(id);\n    if (row === undefined) return;\n    row.remove();\n    this.#rows.delete(id);\n    this.#syncAggregate();\n  }\n\n  /**\n   * Reflects the average progress across live rows on the controller element,\n   * withdrawing both hooks once no rows remain.\n   */\n  #syncAggregate(): void {\n    this.#prune();\n    if (this.#rows.size === 0) {\n      this.element.removeAttribute(\"data-upload-progress\");\n      this.element.style.removeProperty(\"--stimeo--upload-progress\");\n      return;\n    }\n    let total = 0;\n    for (const row of this.#rows.values()) {\n      total += Number(row.getAttribute(\"aria-valuenow\") ?? \"0\");\n    }\n    const overall = Math.round(total / this.#rows.size);\n    this.element.setAttribute(\"data-upload-progress\", String(overall));\n    this.element.style.setProperty(\"--stimeo--upload-progress\", `${overall}%`);\n  }\n\n  /**\n   * Whether a bookkept row is still this widget's live UI: connected, and — when\n   * a `list` target is present — inside the *current* one, so re-pointing the\n   * target attribute at a new element retires rows kept alive in the old list.\n   */\n  #tracksRow(row: HTMLElement): boolean {\n    if (!row.isConnected) return false;\n    return !this.hasListTarget || this.listTarget.contains(row);\n  }\n\n  /**\n   * Retires rows that left the live UI (list swap, external removal). A retired\n   * clone is removed outright — generated rows only ever live under the current\n   * `list`, so the before-cache rewind never has an untracked leftover to miss.\n   */\n  #prune(): void {\n    for (const [id, row] of this.#rows) {\n      if (this.#tracksRow(row)) continue;\n      row.remove();\n      this.#rows.delete(id);\n    }\n  }\n\n  /**\n   * Returns the widget to its pre-upload state just before Turbo caches the\n   * page, so the snapshot never replays rows for uploads that cannot resume.\n   */\n  #reset(): void {\n    for (const row of this.#rows.values()) row.remove();\n    this.#rows.clear();\n    this.#timeouts.clearAll();\n    this.#syncAggregate();\n  }\n\n  /**\n   * Sends one consumer-worded message to the page's shared announcer. `{name}`\n   * resolves to the row's displayed name first — the event that settles an\n   * upload may omit the file although an earlier event already named the row —\n   * then the event's own name, then the accessible name (which an authored\n   * label owns, so it is the last resort, not the primary source).\n   */\n  #announce(template: string, name: string, row: HTMLElement): void {\n    const stored = this.#field(row, \"name\")?.textContent ?? \"\";\n    const label =\n      stored.length > 0 ? stored : name.length > 0 ? name : (row.getAttribute(\"aria-label\") ?? \"\");\n    announce(fillTemplate(template, { name: label }));\n  }\n\n  #field(row: HTMLElement, name: string): HTMLElement | null {\n    return row.querySelector<HTMLElement>(`[data-field=\"${name}\"]`);\n  }\n\n  #setField(row: HTMLElement, name: string, text: string): void {\n    const field = this.#field(row, name);\n    if (field !== null) field.textContent = text;\n  }\n\n  #detail(event: Event): UploadDetail {\n    return (event as CustomEvent<UploadDetail>).detail ?? {};\n  }\n\n  /** The file name every ActiveStorage `direct-upload:*` event carries. */\n  #name(detail: UploadDetail): string {\n    return detail.file?.name ?? \"\";\n  }\n\n  /**\n   * Whether an event belongs to this controller. With `scope` set, only events\n   * whose target (the file input) sits inside an element matching `scope` are\n   * handled, so several upload widgets on one page do not cross-populate.\n   * Resolved with `closest()` from the target itself, so the chatty `progress`\n   * stream never pays a document-wide query. Empty `scope` handles all.\n   */\n  #inScope(event: Event): boolean {\n    if (this.#scopeSelector.length === 0) return true;\n    const target = event.target;\n    return target instanceof Element && target.closest(this.#scopeSelector) !== null;\n  }\n\n  #key(id: string | number | undefined): string {\n    return String(id ?? \"\");\n  }\n}\n"]}

package/dist/controllers/dirty_form_controller.d.ts

@@ -12,11 +12,17 @@ import { Controller } from '@hotwired/stimulus';
  * Snapshots the form's field values on connect, marks the form `data-dirty` once a
  * value changes, and — while dirty — guards both a full unload (`beforeunload`) and
  * a Turbo visit (`turbo:before-visit`). On a Turbo visit it dispatches a cancelable
- * `guard` event; if a consumer cancels it (or `confirmBridge` is set) the visit is
- * blocked, otherwise it falls back to a native `confirm(message)`. While a submit is
- * in flight the guard is suppressed (so a legitimate submit never prompts); the dirty
- * state is cleared only on a successful `turbo:submit-end`, and a failed submit
- * re-arms the guard. `markClean` clears it manually (e.g. after a custom save).
+ * `guard` event for each eligible form; if a consumer cancels one (or any form uses
+ * `confirmBridge`) the visit is blocked, otherwise the document falls back to one
+ * native `confirm(message)`, using the first eligible form in live DOM order. While a
+ * submit is in flight the guard is suppressed until another edit occurs (so a
+ * legitimate submit never prompts); the browser's `formdata` event captures the exact
+ * revision Turbo materializes, and a successful `turbo:submit-end` accepts only that
+ * revision, preserving any later edits as dirty. A failed submit re-arms the guard;
+ * `markClean` clears it manually (e.g. after a custom save), while `acceptRestore`
+ * adopts a restored draft only while no user edit is already dirty.
+ *
+ * `dirty` dispatches `{ dirty }`; `guard` dispatches `{ event }`.
  *
  * @remarks
  * Behavior only — it renders no confirmation UI (pair with a Confirm Bridge) and
@@ -39,7 +45,7 @@ declare class DirtyFormController extends Controller<HTMLFormElement> {
             default: boolean;
         };
     };
-    static actions: readonly ["markClean"];
+    static actions: readonly ["markClean", "acceptRestore"];
     static events: readonly ["dirty", "guard"];
     messageValue: string;
     confirmBridgeValue: boolean;
@@ -47,6 +53,8 @@ declare class DirtyFormController extends Controller<HTMLFormElement> {
     disconnect(): void;
     /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */
     markClean(): void;
+    /** Adopts restored values without erasing an already-dirty user revision. */
+    acceptRestore(): void;
 }
 
 export { DirtyFormController };