stimeo-ui 0.1.0-alpha.1

package/dist/controllers/direct_upload_controller.d.ts

@@ -0,0 +1,77 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless progress UI for ActiveStorage Direct Uploads: subscribes to the
+ * `direct-upload:*` events and renders a per-file progress row (no dedicated APG
+ * pattern; the rows follow the `role="progressbar"` practice). The companion to
+ * {@link "file-dropzone"}, which leaves transport out of scope.
+ *
+ * Markup contract (identifier: `stimeo--direct-upload`):
+ *   <div data-controller="stimeo--direct-upload">
+ *     <div data-stimeo--direct-upload-target="list"></div>
+ *     <template data-stimeo--direct-upload-target="row">
+ *       <div role="progressbar" aria-valuemin="0" aria-valuemax="100">
+ *         <span data-field="name"></span><span data-field="percent"></span>
+ *       </div>
+ *     </template>
+ *     <span data-stimeo--direct-upload-target="status" aria-live="polite"></span>
+ *   </div>
+ *
+ * For each upload it clones the `row` template into `list`, then updates
+ * `aria-valuenow`, the `[data-field="percent"]` text, and the
+ * `--stimeo-upload-progress` custom property as `direct-upload:progress` arrives,
+ * and flips `data-upload-state` to `done` / `error`. Completion and failure are
+ * announced into the optional `status` live region using the consumer-provided
+ * `doneLabel` / `errorLabel` (so copy stays localizable); per-tick progress is not
+ * announced (the progressbar's `aria-valuenow` conveys it) to avoid flooding.
+ *
+ * @remarks
+ * Behavior only — no bars are drawn. The `direct-upload:*` listeners live on
+ * `document` (the events bubble there) and are removed on `disconnect()` (Turbo
+ * navigation included), along with any pending removal timers, so a callback that
+ * arrives after teardown never touches a detached row. With multiple upload widgets
+ * on one page, set `scope` to a selector for the owning form/root so each widget
+ * only handles its own uploads.
+ */
+declare class DirectUploadController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        announce: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        removeOnDone: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        doneLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        errorLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        scope: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static events: readonly ["progress", "done", "error"];
+    readonly listTarget: HTMLElement;
+    readonly rowTarget: HTMLTemplateElement;
+    readonly statusTarget: HTMLElement;
+    readonly hasListTarget: boolean;
+    readonly hasRowTarget: boolean;
+    readonly hasStatusTarget: boolean;
+    announceValue: boolean;
+    removeOnDoneValue: boolean;
+    doneLabelValue: string;
+    errorLabelValue: string;
+    scopeValue: string;
+    connect(): void;
+    disconnect(): void;
+}
+
+export { DirectUploadController };

package/dist/controllers/direct_upload_controller.js

@@ -0,0 +1,212 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/direct_upload_controller.ts
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeTimeout = class extends TimerRegistry {
+  /**
+   * Schedules `callback` after `delay` ms and returns the timer id.
+   *
+   * The id is removed from the registry automatically when the timeout fires,
+   * so {@link TimerRegistry.size | size} reflects only still-pending timers.
+   */
+  set(callback, delay) {
+    const id = this.schedule(() => {
+      this.ids.delete(id);
+      callback();
+    }, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setTimeout(callback, delay);
+  }
+  cancel(id) {
+    window.clearTimeout(id);
+  }
+};
+
+// src/controllers/direct_upload_controller.ts
+var REMOVE_DELAY = 4e3;
+var DirectUploadController = class extends Controller {
+  static targets = ["list", "row", "status"];
+  static values = {
+    announce: { type: Boolean, default: true },
+    removeOnDone: { type: Boolean, default: false },
+    doneLabel: { type: String, default: "" },
+    errorLabel: { type: String, default: "" },
+    scope: { type: String, default: "" }
+  };
+  static events = ["progress", "done", "error"];
+  #timeouts = new SafeTimeout();
+  #rows = /* @__PURE__ */ new Map();
+  #onInitialize = (event) => {
+    if (!this.#inScope(event)) return;
+    const detail = this.#detail(event);
+    this.#rowFor(detail.id, detail.file?.name ?? "");
+  };
+  #onProgress = (event) => {
+    if (!this.#inScope(event)) return;
+    const detail = this.#detail(event);
+    this.#updateProgress(this.#key(detail.id), Math.round(detail.progress ?? 0));
+  };
+  #onError = (event) => {
+    if (!this.#inScope(event)) return;
+    const detail = this.#detail(event);
+    this.#fail(this.#key(detail.id), detail.error ?? "");
+  };
+  #onEnd = (event) => {
+    if (!this.#inScope(event)) return;
+    const detail = this.#detail(event);
+    this.#complete(this.#key(detail.id), detail.file?.name ?? "");
+  };
+  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);
+  }
+  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.#timeouts.clearAll();
+    this.#rows.clear();
+  }
+  /** 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}%`);
+    this.#syncAggregate();
+    this.dispatch("progress", { detail: { id, percent: clamped } });
+  }
+  /** Marks a row done, announces it, and emits `done`. */
+  #complete(id, name = "") {
+    const row = this.#rowFor(id, name);
+    if (row === null) return;
+    row.setAttribute("data-upload-state", "done");
+    this.#announce(this.doneLabelValue, 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;
+    row.setAttribute("data-upload-state", "error");
+    this.#announce(this.errorLabelValue, row);
+    this.dispatch("error", { detail: { id, error } });
+  }
+  /** Returns an existing row or clones one from the template. */
+  #rowFor(id, name) {
+    const key = this.#key(id);
+    const existing = this.#rows.get(key);
+    if (existing !== void 0) return existing;
+    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");
+    clone.setAttribute("data-upload-state", "uploading");
+    clone.style.setProperty("--stimeo-upload-progress", "0%");
+    this.listTarget.appendChild(clone);
+    this.#rows.set(key, clone);
+    return clone;
+  }
+  #removeRow(id) {
+    const row = this.#rows.get(id);
+    if (row === void 0) return;
+    row.remove();
+    this.#rows.delete(id);
+    this.#syncAggregate();
+  }
+  /** Reflects the average progress across rows on the controller element. */
+  #syncAggregate() {
+    if (this.#rows.size === 0) {
+      this.element.removeAttribute("data-upload-progress");
+      return;
+    }
+    let total = 0;
+    for (const row of this.#rows.values()) {
+      total += Number(row.getAttribute("aria-valuenow") ?? "0");
+    }
+    const overall = Math.round(total / this.#rows.size);
+    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);
+  }
+  #field(row, name) {
+    return row.querySelector(`[data-field="${name}"]`);
+  }
+  #setField(row, name, text) {
+    const field = this.#field(row, name);
+    if (field !== null) field.textContent = text;
+  }
+  #detail(event) {
+    return event.detail ?? {};
+  }
+  /**
+   * 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.
+   */
+  #inScope(event) {
+    if (this.scopeValue.length === 0) return true;
+    const target = event.target;
+    return target instanceof Element && target.closest(this.scopeValue) !== null;
+  }
+  #key(id) {
+    return String(id ?? "");
+  }
+};
+
+export { DirectUploadController };
+//# sourceMappingURL=direct_upload_controller.js.map
+//# sourceMappingURL=direct_upload_controller.js.map

package/dist/controllers/direct_upload_controller.js.map

@@ -0,0 +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"]}

package/dist/controllers/dirty_form_controller.d.ts

@@ -0,0 +1,52 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless "unsaved changes" guard for a form (no dedicated APG pattern; supports
+ * WCAG 2.2 error-prevention 3.3.4 / 3.3.6 by preventing accidental data loss).
+ *
+ * Markup contract (identifier: `stimeo--dirty-form`):
+ *   <form data-controller="stimeo--dirty-form">
+ *     …fields…
+ *   </form>
+ *
+ * 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).
+ *
+ * @remarks
+ * Behavior only — it renders no confirmation UI (pair with a Confirm Bridge) and
+ * does not persist input (pair with Persist). The dirty baseline is read from the
+ * DOM on `connect()` (no module-scope state) — which also clears a stale
+ * `data-dirty` left in a Turbo cache snapshot, since the restored values are the
+ * new baseline — `beforeunload` is wired only while dirty, and every listener is
+ * removed on `disconnect()` (Turbo navigation included) so a stale guard never
+ * outlives the form.
+ */
+declare class DirtyFormController extends Controller<HTMLFormElement> {
+    #private;
+    static values: {
+        message: {
+            type: StringConstructor;
+            default: string;
+        };
+        confirmBridge: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+    };
+    static actions: readonly ["markClean"];
+    static events: readonly ["dirty", "guard"];
+    messageValue: string;
+    confirmBridgeValue: boolean;
+    connect(): void;
+    disconnect(): void;
+    /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */
+    markClean(): void;
+}
+
+export { DirtyFormController };

package/dist/controllers/dirty_form_controller.js

@@ -0,0 +1,128 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/dirty_form_controller.ts
+var DirtyFormController = class extends Controller {
+  static values = {
+    message: { type: String, default: "You have unsaved changes that will be lost." },
+    confirmBridge: { type: Boolean, default: false }
+  };
+  static actions = ["markClean"];
+  static events = ["dirty", "guard"];
+  #baseline = "";
+  #dirty = false;
+  #beforeunloadBound = false;
+  /** True between a form `submit` and its `turbo:submit-end`, suppressing the guard. */
+  #submitting = false;
+  #onFieldChange = () => {
+    this.#submitting = false;
+    this.#evaluate();
+  };
+  #onSubmit = () => {
+    this.#submitting = true;
+  };
+  #onBeforeVisit = (event) => {
+    this.#guardVisit(event);
+  };
+  #onSubmitEnd = (event) => {
+    this.#submitting = false;
+    const success = event.detail?.success;
+    if (success !== false) this.markClean();
+  };
+  #onBeforeUnload = (event) => {
+    if (!this.#dirty || this.#submitting) return;
+    event.preventDefault();
+    event.returnValue = this.messageValue;
+  };
+  connect() {
+    this.#baseline = this.#serialize();
+    this.element.removeAttribute("data-dirty");
+    this.element.addEventListener("input", this.#onFieldChange);
+    this.element.addEventListener("change", this.#onFieldChange);
+    this.element.addEventListener("submit", this.#onSubmit);
+    this.element.addEventListener("turbo:submit-end", this.#onSubmitEnd);
+    document.addEventListener("turbo:before-visit", this.#onBeforeVisit);
+  }
+  disconnect() {
+    this.element.removeEventListener("input", this.#onFieldChange);
+    this.element.removeEventListener("change", this.#onFieldChange);
+    this.element.removeEventListener("submit", this.#onSubmit);
+    this.element.removeEventListener("turbo:submit-end", this.#onSubmitEnd);
+    document.removeEventListener("turbo:before-visit", this.#onBeforeVisit);
+    this.#unbindBeforeUnload();
+  }
+  /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */
+  markClean() {
+    this.#baseline = this.#serialize();
+    this.#setDirty(false);
+  }
+  /** Recomputes dirty against the baseline and flips state when it changes. */
+  #evaluate() {
+    this.#setDirty(this.#serialize() !== this.#baseline);
+  }
+  #setDirty(dirty) {
+    if (dirty === this.#dirty) return;
+    this.#dirty = dirty;
+    if (dirty) {
+      this.element.setAttribute("data-dirty", "true");
+      this.#bindBeforeUnload();
+    } else {
+      this.element.removeAttribute("data-dirty");
+      this.#unbindBeforeUnload();
+    }
+    this.dispatch("dirty", { detail: { dirty } });
+  }
+  /** Guards a Turbo visit while dirty: consumer cancel → confirmBridge → confirm. */
+  #guardVisit(event) {
+    if (!this.#dirty || this.#submitting) return;
+    const guard = this.dispatch("guard", { detail: { event }, cancelable: true });
+    if (guard.defaultPrevented) {
+      event.preventDefault();
+      return;
+    }
+    if (this.confirmBridgeValue) {
+      event.preventDefault();
+      return;
+    }
+    if (!window.confirm(this.messageValue)) {
+      event.preventDefault();
+    }
+  }
+  #bindBeforeUnload() {
+    if (this.#beforeunloadBound) return;
+    window.addEventListener("beforeunload", this.#onBeforeUnload);
+    this.#beforeunloadBound = true;
+  }
+  #unbindBeforeUnload() {
+    if (!this.#beforeunloadBound) return;
+    window.removeEventListener("beforeunload", this.#onBeforeUnload);
+    this.#beforeunloadBound = false;
+  }
+  /** Stable serialization of the form's controls for change detection. */
+  #serialize() {
+    const parts = [];
+    for (const el of Array.from(this.element.elements)) {
+      const name = this.#nameOf(el);
+      if (name === null) continue;
+      if (el instanceof HTMLInputElement && (el.type === "checkbox" || el.type === "radio")) {
+        parts.push(`${name}:${el.checked ? 1 : 0}`);
+      } else if (el instanceof HTMLSelectElement) {
+        const value = el.multiple ? Array.from(el.selectedOptions).map((o) => o.value).join(",") : el.value;
+        parts.push(`${name}:${value}`);
+      } else if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+        parts.push(`${name}:${el.value}`);
+      }
+    }
+    return parts.join("|");
+  }
+  /** A stable key for a control, or null for elements without value semantics. */
+  #nameOf(el) {
+    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement || el instanceof HTMLSelectElement) {
+      return el.name || el.id || "";
+    }
+    return null;
+  }
+};
+
+export { DirtyFormController };
+//# sourceMappingURL=dirty_form_controller.js.map
+//# sourceMappingURL=dirty_form_controller.js.map

package/dist/controllers/dirty_form_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/dirty_form_controller.ts"],"names":[],"mappings":"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","file":"dirty_form_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless \"unsaved changes\" guard for a form (no dedicated APG pattern; supports\n * WCAG 2.2 error-prevention 3.3.4 / 3.3.6 by preventing accidental data loss).\n *\n * Markup contract (identifier: `stimeo--dirty-form`):\n *   <form data-controller=\"stimeo--dirty-form\">\n *     …fields…\n *   </form>\n *\n * Snapshots the form's field values on connect, marks the form `data-dirty` once a\n * value changes, and — while dirty — guards both a full unload (`beforeunload`) and\n * a Turbo visit (`turbo:before-visit`). On a Turbo visit it dispatches a cancelable\n * `guard` event; if a consumer cancels it (or `confirmBridge` is set) the visit is\n * blocked, otherwise it falls back to a native `confirm(message)`. While a submit is\n * in flight the guard is suppressed (so a legitimate submit never prompts); the dirty\n * state is cleared only on a successful `turbo:submit-end`, and a failed submit\n * re-arms the guard. `markClean` clears it manually (e.g. after a custom save).\n *\n * @remarks\n * Behavior only — it renders no confirmation UI (pair with a Confirm Bridge) and\n * does not persist input (pair with Persist). The dirty baseline is read from the\n * DOM on `connect()` (no module-scope state) — which also clears a stale\n * `data-dirty` left in a Turbo cache snapshot, since the restored values are the\n * new baseline — `beforeunload` is wired only while dirty, and every listener is\n * removed on `disconnect()` (Turbo navigation included) so a stale guard never\n * outlives the form.\n */\nexport class DirtyFormController extends Controller<HTMLFormElement> {\n  static override values = {\n    message: { type: String, default: \"You have unsaved changes that will be lost.\" },\n    confirmBridge: { type: Boolean, default: false },\n  };\n  static actions = [\"markClean\"] as const;\n  static events = [\"dirty\", \"guard\"] as const;\n\n  declare messageValue: string;\n  declare confirmBridgeValue: boolean;\n\n  #baseline = \"\";\n  #dirty = false;\n  #beforeunloadBound = false;\n  /** True between a form `submit` and its `turbo:submit-end`, suppressing the guard. */\n  #submitting = false;\n\n  readonly #onFieldChange = (): void => {\n    // Any edit means the user is actively working again, so a prior submit that\n    // never resolved (e.g. one cancelled client-side, with no turbo:submit-end)\n    // must not keep the guard suppressed.\n    this.#submitting = false;\n    this.#evaluate();\n  };\n\n  readonly #onSubmit = (): void => {\n    // A real submit is leaving on purpose: suppress the guard for the in-flight\n    // request. We do NOT clear the baseline yet — a failed submit must stay dirty.\n    this.#submitting = true;\n  };\n\n  readonly #onBeforeVisit = (event: Event): void => {\n    this.#guardVisit(event);\n  };\n\n  readonly #onSubmitEnd = (event: Event): void => {\n    this.#submitting = false;\n    const success = (event as CustomEvent<{ success?: boolean }>).detail?.success;\n    // Only a successful submit clears the dirty state; a failure re-arms the guard.\n    if (success !== false) this.markClean();\n  };\n\n  readonly #onBeforeUnload = (event: BeforeUnloadEvent): void => {\n    if (!this.#dirty || this.#submitting) return;\n    event.preventDefault();\n    // Legacy requirement: a non-empty returnValue triggers the native prompt.\n    event.returnValue = this.messageValue;\n  };\n\n  override connect(): void {\n    this.#baseline = this.#serialize();\n    // Re-baselining means the restored values ARE the clean state, so a stale\n    // data-dirty captured in a Turbo cache snapshot mid-edit must not linger\n    // (the guard would not fire, but consumer CSS would keep claiming \"unsaved\").\n    this.element.removeAttribute(\"data-dirty\");\n    this.element.addEventListener(\"input\", this.#onFieldChange);\n    this.element.addEventListener(\"change\", this.#onFieldChange);\n    this.element.addEventListener(\"submit\", this.#onSubmit);\n    this.element.addEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    document.addEventListener(\"turbo:before-visit\", this.#onBeforeVisit);\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"input\", this.#onFieldChange);\n    this.element.removeEventListener(\"change\", this.#onFieldChange);\n    this.element.removeEventListener(\"submit\", this.#onSubmit);\n    this.element.removeEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    document.removeEventListener(\"turbo:before-visit\", this.#onBeforeVisit);\n    this.#unbindBeforeUnload();\n  }\n\n  /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */\n  markClean(): void {\n    this.#baseline = this.#serialize();\n    this.#setDirty(false);\n  }\n\n  /** Recomputes dirty against the baseline and flips state when it changes. */\n  #evaluate(): void {\n    this.#setDirty(this.#serialize() !== this.#baseline);\n  }\n\n  #setDirty(dirty: boolean): void {\n    if (dirty === this.#dirty) return;\n    this.#dirty = dirty;\n    if (dirty) {\n      this.element.setAttribute(\"data-dirty\", \"true\");\n      this.#bindBeforeUnload();\n    } else {\n      this.element.removeAttribute(\"data-dirty\");\n      this.#unbindBeforeUnload();\n    }\n    this.dispatch(\"dirty\", { detail: { dirty } });\n  }\n\n  /** Guards a Turbo visit while dirty: consumer cancel → confirmBridge → confirm. */\n  #guardVisit(event: Event): void {\n    if (!this.#dirty || this.#submitting) return;\n    const guard = this.dispatch(\"guard\", { detail: { event }, cancelable: true });\n    if (guard.defaultPrevented) {\n      event.preventDefault();\n      return;\n    }\n    if (this.confirmBridgeValue) {\n      // Defer the actual prompt to a consumer-wired Confirm Bridge (via the guard\n      // event); block the visit here so nothing navigates before it decides.\n      event.preventDefault();\n      return;\n    }\n    if (!window.confirm(this.messageValue)) {\n      event.preventDefault();\n    }\n  }\n\n  #bindBeforeUnload(): void {\n    if (this.#beforeunloadBound) return;\n    window.addEventListener(\"beforeunload\", this.#onBeforeUnload);\n    this.#beforeunloadBound = true;\n  }\n\n  #unbindBeforeUnload(): void {\n    if (!this.#beforeunloadBound) return;\n    window.removeEventListener(\"beforeunload\", this.#onBeforeUnload);\n    this.#beforeunloadBound = false;\n  }\n\n  /** Stable serialization of the form's controls for change detection. */\n  #serialize(): string {\n    const parts: string[] = [];\n    for (const el of Array.from(this.element.elements)) {\n      const name = this.#nameOf(el);\n      if (name === null) continue;\n      if (el instanceof HTMLInputElement && (el.type === \"checkbox\" || el.type === \"radio\")) {\n        parts.push(`${name}:${el.checked ? 1 : 0}`);\n      } else if (el instanceof HTMLSelectElement) {\n        // Single select: read `value` (robust); multi-select: join the selected values.\n        const value = el.multiple\n          ? Array.from(el.selectedOptions)\n              .map((o) => o.value)\n              .join(\",\")\n          : el.value;\n        parts.push(`${name}:${value}`);\n      } else if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {\n        parts.push(`${name}:${el.value}`);\n      }\n    }\n    return parts.join(\"|\");\n  }\n\n  /** A stable key for a control, or null for elements without value semantics. */\n  #nameOf(el: Element): string | null {\n    if (\n      el instanceof HTMLInputElement ||\n      el instanceof HTMLTextAreaElement ||\n      el instanceof HTMLSelectElement\n    ) {\n      return el.name || el.id || \"\";\n    }\n    return null;\n  }\n}\n"]}

package/dist/controllers/dropdown_controller.d.ts

@@ -0,0 +1,49 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible dropdown menu behavior.
+ *
+ * Markup contract (identifier: `stimeo--dropdown`):
+ *   <div data-controller="stimeo--dropdown">
+ *     <button data-stimeo--dropdown-target="trigger"
+ *             data-action="stimeo--dropdown#toggle">Menu</button>
+ *     <div data-stimeo--dropdown-target="menu">...</div>
+ *   </div>
+ *
+ * This is a **disclosure** pattern (WAI-ARIA APG): a button toggles the
+ * visibility of an adjacent region. It is intentionally *not* a full APG
+ * "menu" widget — there is no roving-tabindex arrow-key navigation.
+ *
+ * @remarks
+ * The library owns behavior only (ARIA state, keyboard, focus, outside-click).
+ * Visual styling is left entirely to the consumer's CSS.
+ *
+ * Behavior provided:
+ * - Click the trigger to toggle the menu (`aria-expanded` + `hidden` reflect state).
+ * - `Escape` closes the menu and returns focus to the trigger.
+ * - A click outside the controller element closes the menu.
+ */
+declare class DropdownController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static actions: readonly ["close", "open", "toggle"];
+    readonly triggerTarget: HTMLButtonElement;
+    readonly menuTarget: HTMLElement;
+    readonly hasMenuTarget: boolean;
+    readonly hasTriggerTarget: boolean;
+    /**
+     * Starts in the closed state and registers the document-level listeners that
+     * power outside-click and `Escape` handling.
+     */
+    connect(): void;
+    /** Removes the document-level listeners registered in {@link connect}. */
+    disconnect(): void;
+    /** Toggles the menu between open and closed. Bound via `data-action`. */
+    toggle(): void;
+    /** Reveals the menu and reflects the open state on the trigger. */
+    open(): void;
+    /** Hides the menu and reflects the closed state on the trigger. */
+    close(): void;
+}
+
+export { DropdownController };

package/dist/controllers/dropdown_controller.js

@@ -0,0 +1,66 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/dropdown_controller.ts
+var DropdownController = class extends Controller {
+  static targets = ["trigger", "menu"];
+  static actions = ["close", "open", "toggle"];
+  /** Closes the menu when a click lands outside the controller's element. */
+  #onOutsideClick = (event) => {
+    if (!this.element.contains(event.target)) {
+      this.close();
+    }
+  };
+  /** Closes the menu on `Escape` and restores focus to the trigger. */
+  #onKeydown = (event) => {
+    if (event.key === "Escape" && this.#isOpen) {
+      this.close();
+      if (this.hasTriggerTarget) this.triggerTarget.focus();
+    }
+  };
+  /**
+   * Starts in the closed state and registers the document-level listeners that
+   * power outside-click and `Escape` handling.
+   */
+  connect() {
+    this.close();
+    document.addEventListener("click", this.#onOutsideClick);
+    document.addEventListener("keydown", this.#onKeydown);
+  }
+  /** Removes the document-level listeners registered in {@link connect}. */
+  disconnect() {
+    document.removeEventListener("click", this.#onOutsideClick);
+    document.removeEventListener("keydown", this.#onKeydown);
+  }
+  /** Toggles the menu between open and closed. Bound via `data-action`. */
+  toggle() {
+    if (this.#isOpen) {
+      this.close();
+    } else {
+      this.open();
+    }
+  }
+  /** Reveals the menu and reflects the open state on the trigger. */
+  open() {
+    if (!this.hasMenuTarget) return;
+    this.menuTarget.hidden = false;
+    if (this.hasTriggerTarget) {
+      this.triggerTarget.setAttribute("aria-expanded", "true");
+    }
+  }
+  /** Hides the menu and reflects the closed state on the trigger. */
+  close() {
+    if (!this.hasMenuTarget) return;
+    this.menuTarget.hidden = true;
+    if (this.hasTriggerTarget) {
+      this.triggerTarget.setAttribute("aria-expanded", "false");
+    }
+  }
+  /** Whether the menu is currently visible. */
+  get #isOpen() {
+    return this.hasMenuTarget && !this.menuTarget.hidden;
+  }
+};
+
+export { DropdownController };
+//# sourceMappingURL=dropdown_controller.js.map
+//# sourceMappingURL=dropdown_controller.js.map