stimeo-ui 0.2.0 → 0.3.0

package/dist/controllers/file_dropzone_controller.js

@@ -0,0 +1,165 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/file_dropzone_controller.ts
+var FileDropzoneController = class extends Controller {
+  static targets = ["zone", "trigger", "input", "list", "item", "itemTemplate", "status"];
+  static values = {
+    maxSize: { type: Number, default: 0 },
+    maxFiles: { type: Number, default: 0 },
+    dragLabel: { type: String, default: "Drop files to add them" }
+  };
+  static actions = ["onChange", "onDragLeave", "onDragOver", "onDrop", "openDialog"];
+  static events = ["change", "reject"];
+  /** Selected files paired with their rendered item and any preview objectURL. */
+  #entries = [];
+  /** Wires file removal as a delegated listener on the list container. */
+  connect() {
+    if (this.hasListTarget) this.listTarget.addEventListener("click", this.#onItemClick);
+  }
+  /** Revokes any outstanding preview URLs so none leaks across navigations. */
+  disconnect() {
+    if (this.hasListTarget) this.listTarget.removeEventListener("click", this.#onItemClick);
+    for (const entry of this.#entries) {
+      if (entry.url) URL.revokeObjectURL(entry.url);
+    }
+    this.#entries.length = 0;
+  }
+  /** Opens the native file dialog. Bound via `data-action` (trigger click). */
+  openDialog() {
+    this.inputTarget.click();
+  }
+  /** Adds the files chosen through the native dialog. */
+  onChange() {
+    if (this.inputTarget.files) this.#addFiles(this.inputTarget.files);
+    this.inputTarget.value = "";
+  }
+  /** Marks the zone as a drop target and announces the affordance in words. */
+  onDragOver(event) {
+    event.preventDefault();
+    if (this.hasZoneTarget) this.zoneTarget.setAttribute("data-dragover", "");
+    this.#setStatus(this.dragLabelValue);
+  }
+  /** Clears the drag-over flag when the pointer leaves the zone. */
+  onDragLeave() {
+    if (this.hasZoneTarget) this.zoneTarget.removeAttribute("data-dragover");
+  }
+  /** Accepts dropped files, clearing the drag-over state. */
+  onDrop(event) {
+    event.preventDefault();
+    if (this.hasZoneTarget) this.zoneTarget.removeAttribute("data-dragover");
+    if (event.dataTransfer?.files) this.#addFiles(event.dataTransfer.files);
+  }
+  /**
+   * Removes the file whose remove button was clicked. Delegated on the list
+   * container rather than bound per item via `data-action`, so it works the instant
+   * an item is appended without waiting on Stimulus to wire a freshly created element.
+   */
+  #onItemClick = (event) => {
+    const button = event.target.closest("button");
+    if (!button || !this.hasListTarget || !this.listTarget.contains(button)) return;
+    const index = this.#entries.findIndex((entry) => entry.item.contains(button));
+    if (index !== -1) this.#removeAt(index);
+  };
+  /** Validates each incoming file and renders the accepted ones. */
+  #addFiles(files) {
+    let changed = false;
+    if (this.hasZoneTarget) this.zoneTarget.removeAttribute("data-stimeo--file-dropzone-invalid");
+    for (const file of Array.from(files)) {
+      const reason = this.#validate(file);
+      if (reason) {
+        if (this.hasZoneTarget) {
+          this.zoneTarget.setAttribute("data-stimeo--file-dropzone-invalid", "");
+        }
+        this.#setStatus(file.name);
+        this.dispatch("reject", { detail: { file, reason } });
+        continue;
+      }
+      this.#appendFile(file);
+      this.#setStatus(file.name);
+      changed = true;
+    }
+    if (changed) this.dispatch("change", { detail: { files: this.#files } });
+  }
+  /** Returns the rejection reason for `file`, or `null` when it is acceptable. */
+  #validate(file) {
+    const limit = this.#effectiveMaxFiles;
+    if (limit > 0 && this.#entries.length >= limit) return "count";
+    if (!this.#matchesAccept(file)) return "type";
+    if (this.maxSizeValue > 0 && file.size > this.maxSizeValue) return "size";
+    return null;
+  }
+  /** Builds one preview item (name, optional thumbnail, remove button). */
+  #appendFile(file) {
+    if (!this.hasItemTemplateTarget || !this.hasListTarget) return;
+    const fragment = this.itemTemplateTarget.content.cloneNode(true);
+    const item = fragment.querySelector('[data-stimeo--file-dropzone-target="item"]');
+    const name = fragment.querySelector('[data-file-dropzone-slot="name"]');
+    const thumb = fragment.querySelector('[data-file-dropzone-slot="thumb"]');
+    const button = fragment.querySelector("button");
+    if (!item) return;
+    if (name) name.textContent = file.name;
+    if (button) button.setAttribute("aria-label", `Remove ${file.name}`);
+    let url;
+    if (thumb && file.type.startsWith("image/")) {
+      url = URL.createObjectURL(file);
+      thumb.src = url;
+      thumb.alt = file.name;
+      thumb.hidden = false;
+    } else if (thumb) {
+      thumb.hidden = true;
+    }
+    this.listTarget.appendChild(fragment);
+    this.#entries.push({ file, item, url });
+  }
+  /** Removes entry `index`, revokes its preview, and re-homes focus. */
+  #removeAt(index) {
+    const entry = this.#entries[index];
+    if (!entry) return;
+    if (entry.url) URL.revokeObjectURL(entry.url);
+    entry.item.remove();
+    this.#entries.splice(index, 1);
+    this.#setStatus(entry.file.name);
+    this.dispatch("change", { detail: { files: this.#files } });
+    const buttons = this.#removeButtons;
+    if (buttons.length === 0) {
+      if (this.hasTriggerTarget) this.triggerTarget.focus();
+    } else {
+      (buttons[index] ?? buttons[buttons.length - 1])?.focus();
+    }
+  }
+  /** Whether `file` satisfies the input's `accept` list (empty accepts all). */
+  #matchesAccept(file) {
+    const accept = this.inputTarget.accept.trim();
+    if (accept === "") return true;
+    const name = file.name.toLowerCase();
+    const type = file.type.toLowerCase();
+    return accept.split(",").some((raw) => {
+      const token = raw.trim().toLowerCase();
+      if (token === "") return false;
+      if (token.startsWith(".")) return name.endsWith(token);
+      if (token.endsWith("/*")) return type.startsWith(token.slice(0, -1));
+      return type === token;
+    });
+  }
+  /** Updates the live region so assistive tech announces the change. */
+  #setStatus(text) {
+    if (this.hasStatusTarget) this.statusTarget.textContent = text;
+  }
+  /** Effective file cap: `maxFiles`, or 1 when the input is single-select. */
+  get #effectiveMaxFiles() {
+    if (this.maxFilesValue > 0) return this.maxFilesValue;
+    return this.inputTarget.multiple ? 0 : 1;
+  }
+  /** The remove buttons currently in the list, in order. */
+  get #removeButtons() {
+    return Array.from(this.listTarget.querySelectorAll("button"));
+  }
+  /** The accepted files in selection order. */
+  get #files() {
+    return this.#entries.map((entry) => entry.file);
+  }
+};
+
+export { FileDropzoneController };
+//# sourceMappingURL=file_dropzone_controller.js.map
+//# sourceMappingURL=file_dropzone_controller.js.map

package/dist/controllers/file_dropzone_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/file_dropzone_controller.ts"],"names":[],"mappings":"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","file":"file_dropzone_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, accessible file drag-and-drop / upload field.\n *\n * Markup contract (identifier: `stimeo--file-dropzone`):\n *   <div data-controller=\"stimeo--file-dropzone\"\n *        data-stimeo--file-dropzone-max-size-value=\"5242880\">\n *     <div data-stimeo--file-dropzone-target=\"zone\"\n *          data-action=\"dragover->stimeo--file-dropzone#onDragOver\n *                       dragleave->stimeo--file-dropzone#onDragLeave\n *                       drop->stimeo--file-dropzone#onDrop\">\n *       <button type=\"button\" data-stimeo--file-dropzone-target=\"trigger\"\n *               data-action=\"click->stimeo--file-dropzone#openDialog\">Choose…</button>\n *       <input type=\"file\" accept=\"image/*\" multiple class=\"visually-hidden\"\n *              data-stimeo--file-dropzone-target=\"input\"\n *              data-action=\"change->stimeo--file-dropzone#onChange\" />\n *     </div>\n *     <ul data-stimeo--file-dropzone-target=\"list\" aria-label=\"Selected files\"></ul>\n *     <span role=\"status\" aria-live=\"polite\" class=\"visually-hidden\"\n *           data-stimeo--file-dropzone-target=\"status\"></span>\n *     <template data-stimeo--file-dropzone-target=\"itemTemplate\">…</template>\n *   </div>\n *\n * There is no single APG pattern; the native `<input type=\"file\">` stays the\n * primary, keyboard-operable path and the drop zone is an enhancement, mapping to\n * WCAG 2.1.1, 2.4.7, 4.1.2, 4.1.3, and 1.4.1 (drag state is conveyed in words,\n * not color alone).\n *\n * Behavior provided:\n * - Click / keyboard via the `trigger` opens the native file dialog; drag-and-drop\n *   over the `zone` adds files (with a `data-dragover` flag and a spoken hint).\n * - Each file is validated against `accept`, `maxSize`, and the file count\n *   (`maxFiles`, or 1 when the input is not `multiple`); rejects fire\n *   `stimeo--file-dropzone:reject` and set `data-…-invalid`.\n * - Accepted files render from `itemTemplate` with a `Remove {name}` button and an\n *   image thumbnail (`objectURL`); every change dispatches\n *   `stimeo--file-dropzone:change` with the current `File[]`.\n * - Removing a file revokes its `objectURL` and moves focus to the next (else\n *   previous) remove button, falling back to the trigger; `disconnect()` revokes\n *   every outstanding `objectURL`.\n */\nexport class FileDropzoneController extends Controller<HTMLElement> {\n  static override targets = [\"zone\", \"trigger\", \"input\", \"list\", \"item\", \"itemTemplate\", \"status\"];\n  static override values = {\n    maxSize: { type: Number, default: 0 },\n    maxFiles: { type: Number, default: 0 },\n    dragLabel: { type: String, default: \"Drop files to add them\" },\n  };\n  static actions = [\"onChange\", \"onDragLeave\", \"onDragOver\", \"onDrop\", \"openDialog\"] as const;\n  static events = [\"change\", \"reject\"] as const;\n\n  declare readonly inputTarget: HTMLInputElement;\n  declare readonly listTarget: HTMLElement;\n  declare readonly triggerTarget: HTMLElement;\n  declare readonly itemTemplateTarget: HTMLTemplateElement;\n  declare readonly statusTarget: HTMLElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasTriggerTarget: boolean;\n  declare readonly hasItemTemplateTarget: boolean;\n  declare readonly hasStatusTarget: boolean;\n  declare readonly hasZoneTarget: boolean;\n  declare readonly zoneTarget: HTMLElement;\n\n  declare maxSizeValue: number;\n  declare maxFilesValue: number;\n  declare dragLabelValue: string;\n\n  /** Selected files paired with their rendered item and any preview objectURL. */\n  readonly #entries: Array<{ file: File; item: HTMLElement; url?: string }> = [];\n\n  /** Wires file removal as a delegated listener on the list container. */\n  override connect(): void {\n    if (this.hasListTarget) this.listTarget.addEventListener(\"click\", this.#onItemClick);\n  }\n\n  /** Revokes any outstanding preview URLs so none leaks across navigations. */\n  override disconnect(): void {\n    if (this.hasListTarget) this.listTarget.removeEventListener(\"click\", this.#onItemClick);\n    for (const entry of this.#entries) {\n      if (entry.url) URL.revokeObjectURL(entry.url);\n    }\n    this.#entries.length = 0;\n  }\n\n  /** Opens the native file dialog. Bound via `data-action` (trigger click). */\n  openDialog(): void {\n    this.inputTarget.click();\n  }\n\n  /** Adds the files chosen through the native dialog. */\n  onChange(): void {\n    if (this.inputTarget.files) this.#addFiles(this.inputTarget.files);\n    // Clear so re-selecting the same file still fires `change`.\n    this.inputTarget.value = \"\";\n  }\n\n  /** Marks the zone as a drop target and announces the affordance in words. */\n  onDragOver(event: DragEvent): void {\n    event.preventDefault();\n    if (this.hasZoneTarget) this.zoneTarget.setAttribute(\"data-dragover\", \"\");\n    this.#setStatus(this.dragLabelValue);\n  }\n\n  /** Clears the drag-over flag when the pointer leaves the zone. */\n  onDragLeave(): void {\n    if (this.hasZoneTarget) this.zoneTarget.removeAttribute(\"data-dragover\");\n  }\n\n  /** Accepts dropped files, clearing the drag-over state. */\n  onDrop(event: DragEvent): void {\n    event.preventDefault();\n    if (this.hasZoneTarget) this.zoneTarget.removeAttribute(\"data-dragover\");\n    if (event.dataTransfer?.files) this.#addFiles(event.dataTransfer.files);\n  }\n\n  /**\n   * Removes the file whose remove button was clicked. Delegated on the list\n   * container rather than bound per item via `data-action`, so it works the instant\n   * an item is appended without waiting on Stimulus to wire a freshly created element.\n   */\n  readonly #onItemClick = (event: MouseEvent): void => {\n    const button = (event.target as HTMLElement).closest(\"button\");\n    if (!button || !this.hasListTarget || !this.listTarget.contains(button)) return;\n    const index = this.#entries.findIndex((entry) => entry.item.contains(button));\n    if (index !== -1) this.#removeAt(index);\n  };\n\n  /** Validates each incoming file and renders the accepted ones. */\n  #addFiles(files: FileList): void {\n    let changed = false;\n    if (this.hasZoneTarget) this.zoneTarget.removeAttribute(\"data-stimeo--file-dropzone-invalid\");\n    for (const file of Array.from(files)) {\n      const reason = this.#validate(file);\n      if (reason) {\n        if (this.hasZoneTarget) {\n          this.zoneTarget.setAttribute(\"data-stimeo--file-dropzone-invalid\", \"\");\n        }\n        this.#setStatus(file.name);\n        this.dispatch(\"reject\", { detail: { file, reason } });\n        continue;\n      }\n      this.#appendFile(file);\n      this.#setStatus(file.name);\n      changed = true;\n    }\n    if (changed) this.dispatch(\"change\", { detail: { files: this.#files } });\n  }\n\n  /** Returns the rejection reason for `file`, or `null` when it is acceptable. */\n  #validate(file: File): \"type\" | \"size\" | \"count\" | null {\n    const limit = this.#effectiveMaxFiles;\n    if (limit > 0 && this.#entries.length >= limit) return \"count\";\n    if (!this.#matchesAccept(file)) return \"type\";\n    if (this.maxSizeValue > 0 && file.size > this.maxSizeValue) return \"size\";\n    return null;\n  }\n\n  /** Builds one preview item (name, optional thumbnail, remove button). */\n  #appendFile(file: File): void {\n    if (!this.hasItemTemplateTarget || !this.hasListTarget) return;\n    const fragment = this.itemTemplateTarget.content.cloneNode(true) as DocumentFragment;\n    const item = fragment.querySelector<HTMLElement>('[data-stimeo--file-dropzone-target=\"item\"]');\n    const name = fragment.querySelector<HTMLElement>('[data-file-dropzone-slot=\"name\"]');\n    const thumb = fragment.querySelector<HTMLImageElement>('[data-file-dropzone-slot=\"thumb\"]');\n    const button = fragment.querySelector<HTMLButtonElement>(\"button\");\n    if (!item) return;\n    if (name) name.textContent = file.name;\n    if (button) button.setAttribute(\"aria-label\", `Remove ${file.name}`);\n\n    let url: string | undefined;\n    if (thumb && file.type.startsWith(\"image/\")) {\n      url = URL.createObjectURL(file);\n      thumb.src = url;\n      thumb.alt = file.name;\n      thumb.hidden = false;\n    } else if (thumb) {\n      thumb.hidden = true;\n    }\n\n    this.listTarget.appendChild(fragment);\n    this.#entries.push({ file, item, url });\n  }\n\n  /** Removes entry `index`, revokes its preview, and re-homes focus. */\n  #removeAt(index: number): void {\n    const entry = this.#entries[index];\n    if (!entry) return;\n    if (entry.url) URL.revokeObjectURL(entry.url);\n    entry.item.remove();\n    this.#entries.splice(index, 1);\n    this.#setStatus(entry.file.name);\n    this.dispatch(\"change\", { detail: { files: this.#files } });\n\n    const buttons = this.#removeButtons;\n    if (buttons.length === 0) {\n      if (this.hasTriggerTarget) this.triggerTarget.focus();\n    } else {\n      (buttons[index] ?? buttons[buttons.length - 1])?.focus();\n    }\n  }\n\n  /** Whether `file` satisfies the input's `accept` list (empty accepts all). */\n  #matchesAccept(file: File): boolean {\n    const accept = this.inputTarget.accept.trim();\n    if (accept === \"\") return true;\n    const name = file.name.toLowerCase();\n    const type = file.type.toLowerCase();\n    return accept.split(\",\").some((raw) => {\n      const token = raw.trim().toLowerCase();\n      if (token === \"\") return false;\n      if (token.startsWith(\".\")) return name.endsWith(token);\n      if (token.endsWith(\"/*\")) return type.startsWith(token.slice(0, -1));\n      return type === token;\n    });\n  }\n\n  /** Updates the live region so assistive tech announces the change. */\n  #setStatus(text: string): void {\n    if (this.hasStatusTarget) this.statusTarget.textContent = text;\n  }\n\n  /** Effective file cap: `maxFiles`, or 1 when the input is single-select. */\n  get #effectiveMaxFiles(): number {\n    if (this.maxFilesValue > 0) return this.maxFilesValue;\n    return this.inputTarget.multiple ? 0 : 1;\n  }\n\n  /** The remove buttons currently in the list, in order. */\n  get #removeButtons(): HTMLButtonElement[] {\n    return Array.from(this.listTarget.querySelectorAll<HTMLButtonElement>(\"button\"));\n  }\n\n  /** The accepted files in selection order. */\n  get #files(): File[] {\n    return this.#entries.map((entry) => entry.file);\n  }\n}\n"]}

package/dist/controllers/filter_controller.d.ts

@@ -0,0 +1,60 @@
+import { Controller } from '@hotwired/stimulus';
+
+/** A control whose "on" state contributes its token to the active filter set. */
+type FilterControl = HTMLElement;
+/**
+ * Headless faceted-filter behavior: shows or hides a collection of items based on the
+ * set of currently-active facet tokens, decoupled from how those tokens are toggled
+ * (native checkboxes/radios, or button toggles such as `stimeo--toggle-group`).
+ *
+ * Markup contract (identifier: `stimeo--filter`):
+ *   <div data-controller="stimeo--filter" data-stimeo--filter-match-value="all">
+ *     <!-- controls: each contributes its token while "on" (aria-pressed / checked) -->
+ *     <button type="button" aria-pressed="false" data-value="apg:dialog"
+ *             data-stimeo--filter-target="control">Dialog</button>
+ *     <!-- items: filtered in/out by their space-separated tokens -->
+ *     <li data-stimeo--filter-target="item"
+ *         data-stimeo--filter-tokens="apg:dialog overlay">…</li>
+ *     <!-- optional: a container hidden once it holds no visible item -->
+ *     <section data-stimeo--filter-target="group">…</section>
+ *     <!-- optional: an element revealed when nothing matches -->
+ *     <p data-stimeo--filter-target="empty" hidden>No matches</p>
+ *   </div>
+ *
+ * `match` decides how multiple active tokens combine: `all` (default — an item must
+ * carry every active token) or `any` (at least one). With no active token every item
+ * is shown. Items are toggled via `hidden`; groups with zero visible items and the
+ * `empty` element are kept in sync, and `stimeo--filter:change` is dispatched.
+ *
+ * @remarks
+ * Behavior only — the consumer owns all styling and the controls' own accessible
+ * state (e.g. `aria-pressed`). Visibility is re-derived from the live DOM on
+ * `connect()` (Morph/Turbo-safe) and on every native `change` that bubbles to the
+ * root; button toggles that emit no native `change` wire their event to the `apply`
+ * action (e.g. `stimeo--toggle-group:change->stimeo--filter#apply`).
+ */
+declare class FilterController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        match: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["apply", "clear"];
+    static events: readonly ["change"];
+    readonly itemTargets: HTMLElement[];
+    readonly controlTargets: FilterControl[];
+    readonly groupTargets: HTMLElement[];
+    readonly emptyTargets: HTMLElement[];
+    matchValue: string;
+    connect(): void;
+    disconnect(): void;
+    /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */
+    apply(): void;
+    /** Turns every control off (uncheck / aria-pressed="false") and re-applies. */
+    clear(): void;
+}
+
+export { FilterController };

package/dist/controllers/filter_controller.js

@@ -0,0 +1,86 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/filter_controller.ts
+var FilterController = class extends Controller {
+  static targets = ["item", "control", "group", "empty"];
+  static values = { match: { type: String, default: "all" } };
+  static actions = ["apply", "clear"];
+  static events = ["change"];
+  #onChange = () => {
+    this.apply();
+  };
+  connect() {
+    this.apply();
+    this.element.addEventListener("change", this.#onChange);
+  }
+  disconnect() {
+    this.element.removeEventListener("change", this.#onChange);
+  }
+  /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */
+  apply() {
+    const active = this.#activeTokens();
+    let visibleCount = 0;
+    for (const item of this.itemTargets) {
+      const visible = this.#matches(item, active);
+      item.hidden = !visible;
+      if (visible) visibleCount += 1;
+    }
+    for (const group of this.groupTargets) {
+      group.hidden = !this.#hasVisibleItem(group);
+    }
+    for (const empty of this.emptyTargets) {
+      empty.hidden = visibleCount > 0;
+    }
+    this.dispatch("change", {
+      detail: { active, visible: visibleCount, total: this.itemTargets.length }
+    });
+  }
+  /** Turns every control off (uncheck / aria-pressed="false") and re-applies. */
+  clear() {
+    for (const control of this.controlTargets) {
+      if (control instanceof HTMLInputElement) {
+        control.checked = false;
+      } else if (control.hasAttribute("aria-pressed")) {
+        control.setAttribute("aria-pressed", "false");
+      }
+    }
+    this.apply();
+  }
+  /** The tokens of every control currently "on" (checked or aria-pressed="true"). */
+  #activeTokens() {
+    const tokens = [];
+    for (const control of this.controlTargets) {
+      if (this.#isOn(control)) tokens.push(this.#tokenOf(control));
+    }
+    return tokens.filter(Boolean);
+  }
+  /** Whether a control is in its "on" state. */
+  #isOn(control) {
+    if (control instanceof HTMLInputElement) return control.checked;
+    return control.getAttribute("aria-pressed") === "true";
+  }
+  /** A control's token: explicit `data-stimeo--filter-token`, else `data-value` / value. */
+  #tokenOf(control) {
+    const explicit = control.getAttribute("data-stimeo--filter-token") ?? control.dataset.value;
+    if (explicit) return explicit;
+    return control instanceof HTMLInputElement ? control.value : "";
+  }
+  /** Whether an item satisfies the active token set per `match` (empty active → shown). */
+  #matches(item, active) {
+    if (active.length === 0) return true;
+    const tokens = this.#tokensOf(item);
+    return this.matchValue === "any" ? active.some((token) => tokens.includes(token)) : active.every((token) => tokens.includes(token));
+  }
+  /** An item's declared tokens (`data-stimeo--filter-tokens`, space-separated). */
+  #tokensOf(item) {
+    return (item.getAttribute("data-stimeo--filter-tokens") ?? "").split(/\s+/).filter(Boolean);
+  }
+  /** Whether a group still contains at least one non-hidden item. */
+  #hasVisibleItem(group) {
+    return this.itemTargets.some((item) => !item.hidden && group.contains(item));
+  }
+};
+
+export { FilterController };
+//# sourceMappingURL=filter_controller.js.map
+//# sourceMappingURL=filter_controller.js.map

package/dist/controllers/filter_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/filter_controller.ts"],"names":[],"mappings":"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","file":"filter_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/** A control whose \"on\" state contributes its token to the active filter set. */\ntype FilterControl = HTMLElement;\n\n/**\n * Headless faceted-filter behavior: shows or hides a collection of items based on the\n * set of currently-active facet tokens, decoupled from how those tokens are toggled\n * (native checkboxes/radios, or button toggles such as `stimeo--toggle-group`).\n *\n * Markup contract (identifier: `stimeo--filter`):\n *   <div data-controller=\"stimeo--filter\" data-stimeo--filter-match-value=\"all\">\n *     <!-- controls: each contributes its token while \"on\" (aria-pressed / checked) -->\n *     <button type=\"button\" aria-pressed=\"false\" data-value=\"apg:dialog\"\n *             data-stimeo--filter-target=\"control\">Dialog</button>\n *     <!-- items: filtered in/out by their space-separated tokens -->\n *     <li data-stimeo--filter-target=\"item\"\n *         data-stimeo--filter-tokens=\"apg:dialog overlay\">…</li>\n *     <!-- optional: a container hidden once it holds no visible item -->\n *     <section data-stimeo--filter-target=\"group\">…</section>\n *     <!-- optional: an element revealed when nothing matches -->\n *     <p data-stimeo--filter-target=\"empty\" hidden>No matches</p>\n *   </div>\n *\n * `match` decides how multiple active tokens combine: `all` (default — an item must\n * carry every active token) or `any` (at least one). With no active token every item\n * is shown. Items are toggled via `hidden`; groups with zero visible items and the\n * `empty` element are kept in sync, and `stimeo--filter:change` is dispatched.\n *\n * @remarks\n * Behavior only — the consumer owns all styling and the controls' own accessible\n * state (e.g. `aria-pressed`). Visibility is re-derived from the live DOM on\n * `connect()` (Morph/Turbo-safe) and on every native `change` that bubbles to the\n * root; button toggles that emit no native `change` wire their event to the `apply`\n * action (e.g. `stimeo--toggle-group:change->stimeo--filter#apply`).\n */\nexport class FilterController extends Controller<HTMLElement> {\n  static override targets = [\"item\", \"control\", \"group\", \"empty\"];\n  static override values = { match: { type: String, default: \"all\" } };\n  static actions = [\"apply\", \"clear\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly itemTargets: HTMLElement[];\n  declare readonly controlTargets: FilterControl[];\n  declare readonly groupTargets: HTMLElement[];\n  declare readonly emptyTargets: HTMLElement[];\n\n  declare matchValue: string;\n\n  readonly #onChange = (): void => {\n    this.apply();\n  };\n\n  override connect(): void {\n    this.apply();\n    this.element.addEventListener(\"change\", this.#onChange);\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"change\", this.#onChange);\n  }\n\n  /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */\n  apply(): void {\n    const active = this.#activeTokens();\n    let visibleCount = 0;\n    for (const item of this.itemTargets) {\n      const visible = this.#matches(item, active);\n      item.hidden = !visible;\n      if (visible) visibleCount += 1;\n    }\n\n    for (const group of this.groupTargets) {\n      group.hidden = !this.#hasVisibleItem(group);\n    }\n    for (const empty of this.emptyTargets) {\n      empty.hidden = visibleCount > 0;\n    }\n\n    this.dispatch(\"change\", {\n      detail: { active, visible: visibleCount, total: this.itemTargets.length },\n    });\n  }\n\n  /** Turns every control off (uncheck / aria-pressed=\"false\") and re-applies. */\n  clear(): void {\n    for (const control of this.controlTargets) {\n      if (control instanceof HTMLInputElement) {\n        control.checked = false;\n      } else if (control.hasAttribute(\"aria-pressed\")) {\n        control.setAttribute(\"aria-pressed\", \"false\");\n      }\n    }\n    this.apply();\n  }\n\n  /** The tokens of every control currently \"on\" (checked or aria-pressed=\"true\"). */\n  #activeTokens(): string[] {\n    const tokens: string[] = [];\n    for (const control of this.controlTargets) {\n      if (this.#isOn(control)) tokens.push(this.#tokenOf(control));\n    }\n    return tokens.filter(Boolean);\n  }\n\n  /** Whether a control is in its \"on\" state. */\n  #isOn(control: FilterControl): boolean {\n    if (control instanceof HTMLInputElement) return control.checked;\n    return control.getAttribute(\"aria-pressed\") === \"true\";\n  }\n\n  /** A control's token: explicit `data-stimeo--filter-token`, else `data-value` / value. */\n  #tokenOf(control: FilterControl): string {\n    const explicit = control.getAttribute(\"data-stimeo--filter-token\") ?? control.dataset.value;\n    if (explicit) return explicit;\n    return control instanceof HTMLInputElement ? control.value : \"\";\n  }\n\n  /** Whether an item satisfies the active token set per `match` (empty active → shown). */\n  #matches(item: HTMLElement, active: string[]): boolean {\n    if (active.length === 0) return true;\n    const tokens = this.#tokensOf(item);\n    return this.matchValue === \"any\"\n      ? active.some((token) => tokens.includes(token))\n      : active.every((token) => tokens.includes(token));\n  }\n\n  /** An item's declared tokens (`data-stimeo--filter-tokens`, space-separated). */\n  #tokensOf(item: HTMLElement): string[] {\n    return (item.getAttribute(\"data-stimeo--filter-tokens\") ?? \"\").split(/\\s+/).filter(Boolean);\n  }\n\n  /** Whether a group still contains at least one non-hidden item. */\n  #hasVisibleItem(group: HTMLElement): boolean {\n    return this.itemTargets.some((item) => !item.hidden && group.contains(item));\n  }\n}\n"]}

package/dist/controllers/flash_controller.js

@@ -55,6 +55,40 @@ var SafeTimeout = class extends TimerRegistry {
   }
 };
 
+// src/utils/transition_completion.ts
+function timeMs(value) {
+  const trimmed = value.trim();
+  const amount = Number.parseFloat(trimmed);
+  if (!Number.isFinite(amount)) return 0;
+  if (trimmed.endsWith("ms")) return amount;
+  if (trimmed.endsWith("s")) return amount * 1e3;
+  return 0;
+}
+function cssList(value) {
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function transitionTimings(style) {
+  const properties = cssList(style.transitionProperty);
+  const durations = cssList(style.transitionDuration).map(timeMs);
+  const delays = cssList(style.transitionDelay).map(timeMs);
+  const effectiveProperties = properties.length > 0 ? properties : Array.from({ length: Math.max(durations.length, delays.length, 1) }, () => "all");
+  const effectiveDurations = durations.length > 0 ? durations : [0];
+  const effectiveDelays = delays.length > 0 ? delays : [0];
+  return effectiveProperties.filter((property) => property !== "none").map((property, index) => ({
+    property,
+    totalMs: Math.max(
+      0,
+      (effectiveDurations[index % effectiveDurations.length] ?? 0) + (effectiveDelays[index % effectiveDelays.length] ?? 0)
+    )
+  }));
+}
+function maxTotalMs(timings) {
+  return timings.reduce((max, { totalMs }) => Math.max(max, totalMs), 0);
+}
+function maxTransitionTotalMs(style) {
+  return maxTotalMs(transitionTimings(style));
+}
+
 // src/controllers/flash_controller.ts
 var ASSERTIVE_TYPES = /* @__PURE__ */ new Set(["alert", "error"]);
 var MESSAGE_SELECTOR = '[data-stimeo--flash-target="message"]';
@@ -206,13 +240,10 @@ var FlashController = class extends Controller {
       finalize();
     }
   }
-  /** First `transition-duration` of `el` in ms (0 when none / unsupported). */
+  /** Maximum transition total (duration + delay) of `el` in ms (0 when none / unsupported). */
   #transitionMs(el) {
     if (typeof window.getComputedStyle !== "function") return 0;
-    const first = window.getComputedStyle(el).transitionDuration.split(",")[0]?.trim() ?? "";
-    const amount = Number.parseFloat(first);
-    if (Number.isNaN(amount)) return 0;
-    return first.endsWith("ms") ? amount : amount * 1e3;
+    return maxTransitionTotalMs(window.getComputedStyle(el));
   }
 };
 

package/dist/controllers/flash_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/flash_controller.ts"],"names":[],"mappings":"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","file":"flash_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/** Flash types that map to an assertive `alert` (everything else is a polite `status`). */\nconst ASSERTIVE_TYPES = new Set([\"alert\", \"error\"]);\n\n/** Selector for message targets, used by the MutationObserver to spot dynamic inserts. */\nconst MESSAGE_SELECTOR = '[data-stimeo--flash-target=\"message\"]';\n\n/** Per-message auto-dismiss timer bookkeeping (id 0 means paused). */\ninterface FlashTimer {\n  id: number;\n  startedAt: number;\n  remaining: number;\n}\n\n/**\n * Headless **Rails flash bridge**: turns server-rendered (and Turbo Stream-inserted)\n * `flash` elements into live-region announcements with auto-dismiss and a stacking\n * cap (no dedicated APG pattern; follows the WAI-ARIA status/alert guidance and WCAG\n * 2.2 **4.1.3 Status Messages**). The general-purpose sibling is Toast; this one is\n * specialized to the Rails `flash` convention.\n *\n * Markup contract (identifier: `stimeo--flash`):\n *   <div data-controller=\"stimeo--flash\" data-stimeo--flash-target=\"region\">\n *     <!-- server-rendered or Turbo Stream-inserted -->\n *     <div data-stimeo--flash-target=\"message\" data-flash-type=\"notice\">Saved</div>\n *   </div>\n *\n * Each message is mapped by `data-flash-type` to `role=\"status\"` (notice) or\n * `role=\"alert\"` (alert/error), flagged `data-flash-state=\"visible\"`, auto-dismissed\n * after `duration` (paused while hovered/focused when `pauseOnHover`), and capped at\n * `max` simultaneous messages. A close button wired to the `dismiss` action removes\n * one manually.\n *\n * @remarks\n * Reading is **delegated to the shared Announcer** — but only for the *initial*,\n * page-loaded messages: an in-place live region present at load is not announced by\n * assistive tech, so the controller bridges those via an `stimeo--announcer:announce`\n * event. Messages inserted *later* (Turbo Stream) are announced by their own freshly\n * inserted `role`, exactly like Toast, so they are not bridged again (no double\n * announcement). Behavior only — no styling; `data-flash-state=\"leaving\"` lets CSS\n * animate removal. Focus is never moved (WCAG 2.2 4.1.3). The observer, timers, and\n * per-message listeners are torn down on `disconnect()` (Turbo navigation included).\n */\nexport class FlashController extends Controller<HTMLElement> {\n  static override targets = [\"region\", \"message\"];\n  static override values = {\n    duration: { type: Number, default: 5000 },\n    pauseOnHover: { type: Boolean, default: true },\n    max: { type: Number, default: 0 },\n  };\n  static actions = [\"dismiss\"] as const;\n  static events = [\"show\", \"dismiss\"] as const;\n\n  declare readonly regionTarget: HTMLElement;\n  declare readonly messageTargets: HTMLElement[];\n  declare readonly hasRegionTarget: boolean;\n\n  declare durationValue: number;\n  declare pauseOnHoverValue: boolean;\n  declare maxValue: number;\n\n  readonly #timers = new SafeTimeout();\n  #observer: MutationObserver | null = null;\n  /** Auto-dismiss timer state keyed by message element. */\n  readonly #state = new Map<HTMLElement, FlashTimer>();\n  /** Messages already processed, in insertion order, to enforce `max` and avoid double work. */\n  readonly #order: HTMLElement[] = [];\n\n  readonly #onEnter = (event: Event): void => this.#pause(event.currentTarget as HTMLElement);\n  readonly #onLeave = (event: Event): void => this.#resume(event.currentTarget as HTMLElement);\n\n  override connect(): void {\n    if (!this.hasRegionTarget) return;\n    // Initial, server-rendered flashes: bridge them to the Announcer because an\n    // in-place live region present at page load is not announced on its own.\n    for (const message of this.messageTargets) {\n      this.#process(message, true);\n    }\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#observer = new MutationObserver((mutations) => this.#onMutations(mutations));\n      this.#observer.observe(this.regionTarget, { childList: true, subtree: true });\n    }\n  }\n\n  override disconnect(): void {\n    this.#observer?.disconnect();\n    this.#observer = null;\n    this.#timers.clearAll();\n    for (const message of this.#order) this.#unbindPause(message);\n    this.#state.clear();\n    this.#order.length = 0;\n  }\n\n  /**\n   * Pause-on-hover/focus listeners, bound and unbound as a pair so the two sides\n   * stay in sync. Binding is gated by `pauseOnHover`; unbinding is unconditional\n   * and idempotent (a no-op when nothing was bound), which keeps teardown correct\n   * even if `pauseOnHover` were ever toggled during a message's life.\n   */\n  #bindPause(message: HTMLElement): void {\n    if (!this.pauseOnHoverValue) return;\n    message.addEventListener(\"mouseenter\", this.#onEnter);\n    message.addEventListener(\"mouseleave\", this.#onLeave);\n    message.addEventListener(\"focusin\", this.#onEnter);\n    message.addEventListener(\"focusout\", this.#onLeave);\n  }\n\n  #unbindPause(message: HTMLElement): void {\n    message.removeEventListener(\"mouseenter\", this.#onEnter);\n    message.removeEventListener(\"mouseleave\", this.#onLeave);\n    message.removeEventListener(\"focusin\", this.#onEnter);\n    message.removeEventListener(\"focusout\", this.#onLeave);\n  }\n\n  /** Dismisses the flash whose close control fired the event. */\n  dismiss(event: Event): void {\n    const target = (event.currentTarget || event.target) as HTMLElement | null;\n    const message = target?.closest<HTMLElement>(MESSAGE_SELECTOR);\n    if (message) this.#beginDismiss(message, \"user\");\n  }\n\n  /** Processes messages added after connect (Turbo Stream); their own role announces them. */\n  #onMutations(mutations: MutationRecord[]): void {\n    for (const mutation of mutations) {\n      for (const node of mutation.addedNodes) {\n        if (!(node instanceof HTMLElement)) continue;\n        if (node.matches(MESSAGE_SELECTOR)) this.#process(node, false);\n        for (const message of node.querySelectorAll<HTMLElement>(MESSAGE_SELECTOR)) {\n          this.#process(message, false);\n        }\n      }\n    }\n  }\n\n  /**\n   * Applies role/state, wires pause listeners, schedules auto-dismiss, and either\n   * bridges to the Announcer (`bridge`, for initial flashes) or leaves the message's\n   * own role to do the announcing (dynamic inserts). Idempotent per message.\n   */\n  #process(message: HTMLElement, bridge: boolean): void {\n    if (this.#state.has(message) || this.#order.includes(message)) return;\n\n    const type = message.getAttribute(\"data-flash-type\") ?? \"\";\n    const assertive = ASSERTIVE_TYPES.has(type);\n    // Don't clobber an authored role; otherwise map the flash type to a live role.\n    if (!message.hasAttribute(\"role\")) {\n      message.setAttribute(\"role\", assertive ? \"alert\" : \"status\");\n    }\n    message.setAttribute(\"data-flash-state\", \"visible\");\n    this.#order.push(message);\n\n    this.#bindPause(message);\n\n    const text = message.textContent?.trim() ?? \"\";\n    this.dispatch(\"show\", { target: message, detail: { type, message: text } });\n    if (bridge && text) {\n      window.dispatchEvent(\n        new CustomEvent(\"stimeo--announcer:announce\", { detail: { message: text, assertive } }),\n      );\n    }\n\n    this.#startTimer(message);\n    this.#enforceMax();\n  }\n\n  /** Removes the oldest visible flashes once the count exceeds `max` (0 = unlimited). */\n  #enforceMax(): void {\n    if (this.maxValue <= 0) return;\n    while (this.#order.length > this.maxValue) {\n      const oldest = this.#order[0];\n      if (!oldest) break;\n      this.#beginDismiss(oldest, \"limit\");\n    }\n  }\n\n  #startTimer(message: HTMLElement, duration = this.durationValue): void {\n    if (duration <= 0) return;\n    const existing = this.#state.get(message);\n    if (existing?.id) this.#timers.clear(existing.id);\n    const id = this.#timers.set(() => this.#beginDismiss(message, \"timeout\"), duration);\n    this.#state.set(message, { id, startedAt: Date.now(), remaining: duration });\n  }\n\n  /** Pauses a message's auto-dismiss, banking the time left (hover/focus, WCAG 2.2.1). */\n  #pause(message: HTMLElement): void {\n    const timer = this.#state.get(message);\n    if (!timer || timer.id === 0) return;\n    this.#timers.clear(timer.id);\n    const remaining = Math.max(0, timer.remaining - (Date.now() - timer.startedAt));\n    this.#state.set(message, { id: 0, startedAt: 0, remaining });\n  }\n\n  /** Resumes a paused message's auto-dismiss with the banked time. */\n  #resume(message: HTMLElement): void {\n    const timer = this.#state.get(message);\n    if (!timer) return;\n    // Only resume a genuinely paused timer (id 0) that still has time banked.\n    if (timer.id !== 0 || timer.remaining <= 0) return;\n    this.#startTimer(message, timer.remaining);\n  }\n\n  /** Marks a message leaving, then removes it after its CSS transition and emits dismiss. */\n  #beginDismiss(message: HTMLElement, reason: \"timeout\" | \"user\" | \"limit\"): void {\n    const timer = this.#state.get(message);\n    if (timer?.id) this.#timers.clear(timer.id);\n    this.#state.delete(message);\n    const index = this.#order.indexOf(message);\n    if (index !== -1) this.#order.splice(index, 1);\n\n    message.setAttribute(\"data-flash-state\", \"leaving\");\n\n    const finalize = (): void => {\n      this.#unbindPause(message);\n      message.remove();\n      this.dispatch(\"dismiss\", { detail: { element: message, reason } });\n    };\n\n    const transition = this.#transitionMs(message);\n    if (transition > 0) {\n      this.#timers.set(finalize, transition);\n    } else {\n      finalize();\n    }\n  }\n\n  /** First `transition-duration` of `el` in ms (0 when none / unsupported). */\n  #transitionMs(el: HTMLElement): number {\n    if (typeof window.getComputedStyle !== \"function\") return 0;\n    const first = window.getComputedStyle(el).transitionDuration.split(\",\")[0]?.trim() ?? \"\";\n    const amount = Number.parseFloat(first);\n    if (Number.isNaN(amount)) return 0;\n    return first.endsWith(\"ms\") ? amount : amount * 1000;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/utils/transition_completion.ts","../../src/controllers/flash_controller.ts"],"names":[],"mappings":"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","file":"flash_controller.js","sourcesContent":["/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { SafeTimeout } from \"./safe_timeout\";\n\n/** Computed transition fields needed to determine when an element has settled. */\nexport type TransitionStyle = Pick<\n  CSSStyleDeclaration,\n  \"transitionProperty\" | \"transitionDuration\" | \"transitionDelay\"\n>;\n\n/** Parsed transition property paired with its effective duration and delay. */\ninterface TransitionTiming {\n  property: string;\n  totalMs: number;\n}\n\n/** Parses a CSS `<time>` into milliseconds, returning `0` for malformed values. */\nfunction timeMs(value: string): number {\n  const trimmed = value.trim();\n  const amount = Number.parseFloat(trimmed);\n  if (!Number.isFinite(amount)) return 0;\n  if (trimmed.endsWith(\"ms\")) return amount;\n  if (trimmed.endsWith(\"s\")) return amount * 1000;\n  return 0;\n}\n\n/** Splits a computed comma-separated CSS list into normalized, non-empty items. */\nfunction cssList(value: string): string[] {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * Pairs transition properties, durations, and delays using CSS list repetition.\n *\n * The `transition-property` list determines the number of transitions. Shorter\n * duration/delay lists repeat, while extra values are ignored. A negative delay\n * shortens the remaining wall-clock time, and a non-positive total is settled.\n */\nfunction transitionTimings(style: TransitionStyle): TransitionTiming[] {\n  const properties = cssList(style.transitionProperty);\n  const durations = cssList(style.transitionDuration).map(timeMs);\n  const delays = cssList(style.transitionDelay).map(timeMs);\n  const effectiveProperties =\n    properties.length > 0\n      ? properties\n      : Array.from({ length: Math.max(durations.length, delays.length, 1) }, () => \"all\");\n  const effectiveDurations = durations.length > 0 ? durations : [0];\n  const effectiveDelays = delays.length > 0 ? delays : [0];\n\n  return effectiveProperties\n    .filter((property) => property !== \"none\")\n    .map((property, index) => ({\n      property,\n      totalMs: Math.max(\n        0,\n        (effectiveDurations[index % effectiveDurations.length] ?? 0) +\n          (effectiveDelays[index % effectiveDelays.length] ?? 0),\n      ),\n    }));\n}\n\n/** Maximum total over already-parsed timings (0 when the list is empty). */\nfunction maxTotalMs(timings: TransitionTiming[]): number {\n  return timings.reduce((max, { totalMs }) => Math.max(max, totalMs), 0);\n}\n\n/** Maximum effective transition duration plus delay, in milliseconds. */\nexport function maxTransitionTotalMs(style: TransitionStyle): number {\n  return maxTotalMs(transitionTimings(style));\n}\n\n/** Optional tuning for a single {@link TransitionCompletion.wait} call. */\nexport interface TransitionWaitOptions {\n  /**\n   * Positive wall-clock override (ms) for the bounded fallback, replacing the\n   * auto-computed `max + 50ms` timer verbatim. It also keeps the wait armed for\n   * a computed 0ms transition (no synchronous completion): the consumer asserts\n   * a transition budget that computed styles cannot see. Non-positive and\n   * non-finite (`NaN` / `Infinity`) values are ignored.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Owns one cancellable wait for an element's CSS transitions to settle.\n *\n * When available, active CSS transitions provide their expanded property names.\n * Tracking those names lets shorthand declarations settle from their longhand\n * terminal events. A terminal event from an interrupted phase is ignored while a\n * replacement transition for the same property is still active. Because that set\n * is sampled when the wait is armed, a property whose transition only starts a\n * frame later would otherwise be settled over; the still-running set is therefore\n * re-read before completing and adopted when it is not yet empty. Without Web\n * Animations data, explicit transition properties retain the declared-property\n * behavior and the ambiguous `transition-property: all` form waits until the\n * computed maximum wall-clock time. A `max + 50ms` timeout is always armed\n * because browsers emit no terminal event when a property never transitions, an\n * ancestor disappears, or rendering is otherwise interrupted; a consumer with\n * better knowledge can replace that fallback via\n * {@link TransitionWaitOptions.timeoutMs}.\n */\nexport class TransitionCompletion {\n  readonly #timers = new SafeTimeout();\n  #element: HTMLElement | null = null;\n  #complete: (() => void) | null = null;\n  #pendingProperties: Set<string> | null = null;\n  #deadline = 0;\n\n  /**\n   * Replaces any prior wait and invokes `complete` synchronously for a 0ms\n   * transition (including when `getComputedStyle` is unavailable).\n   *\n   * With a positive `options.timeoutMs` the synchronous fast-path is skipped and\n   * the override replaces the auto-computed fallback (see {@link TransitionWaitOptions}).\n   */\n  wait(element: HTMLElement, complete: () => void, options: TransitionWaitOptions = {}): void {\n    this.cancel();\n\n    const requested = options.timeoutMs ?? 0;\n    const override = Number.isFinite(requested) && requested > 0 ? requested : 0;\n    // A non-browser / partial-DOM environment cannot report a computable\n    // transition, which is indistinguishable from a 0ms one.\n    const timings =\n      typeof window.getComputedStyle === \"function\"\n        ? transitionTimings(window.getComputedStyle(element))\n        : [];\n    const maximum = maxTotalMs(timings);\n    if (maximum <= 0 && override <= 0) {\n      complete();\n      return;\n    }\n\n    this.#element = element;\n    this.#complete = complete;\n    this.#deadline = Date.now() + maximum;\n    const activeProperties = this.#activeTransitionProperties(element);\n    this.#pendingProperties =\n      activeProperties.size > 0 ? activeProperties : this.#explicitPendingProperties(timings);\n    element.addEventListener(\"transitionend\", this.#onTerminal);\n    element.addEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#timers.set(() => this.#finish(), override > 0 ? override : maximum + 50);\n  }\n\n  /** Cancels the pending wait without invoking its completion callback. */\n  cancel(): void {\n    this.#complete = null;\n    this.#teardown();\n  }\n\n  /**\n   * Handles terminal events from the observed element only.\n   *\n   * For explicit property lists, every declared positive-time property must\n   * settle. For `all`, no reliable property set exists, so an event can finish\n   * only after the computed maximum time; the safety timeout owns the usual path.\n   */\n  readonly #onTerminal = (event: Event): void => {\n    if (event.target !== this.#element) return;\n    const transitionEvent = event as TransitionEvent;\n    // A pseudo-element's transition is reported with its originating element\n    // as `target`; it must not settle the element's own transition.\n    if (transitionEvent.pseudoElement) return;\n\n    if (this.#pendingProperties) {\n      const propertyName = transitionEvent.propertyName;\n      const active = this.#activeTransitionProperties(this.#element);\n      // An interrupted transition queues its cancel event before the replacement\n      // phase starts, but dispatch can happen after the new wait is armed. The\n      // replacement is then the active transition for this property, so the stale\n      // terminal event must not settle the new phase.\n      if (active.has(propertyName)) return;\n      if (!this.#pendingProperties.delete(propertyName)) return;\n      if (this.#pendingProperties.size > 0) return;\n      // The tracked set is an arm-time snapshot, so a transition the phase starts\n      // one frame later is absent from it. Re-reading the still-running set before\n      // settling adopts those stragglers instead of completing over them; the\n      // fallback timer stays armed, so this cannot extend the wait unboundedly.\n      if (active.size > 0) {\n        this.#pendingProperties = active;\n        return;\n      }\n      this.#finish();\n      return;\n    }\n\n    if (Date.now() >= this.#deadline) this.#finish();\n  };\n\n  /**\n   * Returns active CSS transition properties expanded to the names reported by\n   * terminal events. CSS animations and pseudo-element effects are excluded.\n   */\n  #activeTransitionProperties(element: HTMLElement | null): Set<string> {\n    if (!element || typeof element.getAnimations !== \"function\") return new Set();\n\n    try {\n      const properties = element.getAnimations().flatMap((animation) => {\n        if (animation.playState === \"idle\" || animation.playState === \"finished\") return [];\n        const effect = animation.effect as KeyframeEffect | null;\n        // A pseudo-element effect names the originating element as its target, so\n        // `target` alone cannot separate it. Its terminal events are ignored, so\n        // tracking its properties would only strand the wait on the fallback.\n        if (effect?.pseudoElement) return [];\n        const target = effect?.target;\n        if (target && target !== element) return [];\n        const property = (animation as Partial<CSSTransition>).transitionProperty;\n        return typeof property === \"string\" && property.length > 0 ? [property] : [];\n      });\n      return new Set(properties);\n    } catch {\n      // Partial DOM implementations can expose getAnimations without supporting\n      // it. The declared-property tracker and bounded timer remain safe fallbacks.\n      return new Set();\n    }\n  }\n\n  /** Returns explicit positive-time properties, or `null` for the ambiguous `all`. */\n  #explicitPendingProperties(timings: TransitionTiming[]): Set<string> | null {\n    if (timings.some(({ property }) => property === \"all\")) return null;\n    const pending = new Set(\n      timings.filter(({ totalMs }) => totalMs > 0).map(({ property }) => property),\n    );\n    // An empty set is only reachable through a timeout override (a 0ms transition\n    // otherwise completes synchronously). With nothing to track, fall back to the\n    // deadline rule so any terminal event can settle the wait, exactly like `all`.\n    return pending.size > 0 ? pending : null;\n  }\n\n  /** Completes exactly once, releasing listeners and the fallback before the callback. */\n  #finish(): void {\n    const complete = this.#complete;\n    if (!complete) return;\n    this.#complete = null;\n    this.#teardown();\n    complete();\n  }\n\n  /** Releases the exact element listeners and timer owned by the current wait. */\n  #teardown(): void {\n    this.#timers.clearAll();\n    this.#element?.removeEventListener(\"transitionend\", this.#onTerminal);\n    this.#element?.removeEventListener(\"transitioncancel\", this.#onTerminal);\n    this.#element = null;\n    this.#pendingProperties = null;\n    this.#deadline = 0;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\nimport { maxTransitionTotalMs } from \"../utils/transition_completion\";\n\n/** Flash types that map to an assertive `alert` (everything else is a polite `status`). */\nconst ASSERTIVE_TYPES = new Set([\"alert\", \"error\"]);\n\n/** Selector for message targets, used by the MutationObserver to spot dynamic inserts. */\nconst MESSAGE_SELECTOR = '[data-stimeo--flash-target=\"message\"]';\n\n/** Per-message auto-dismiss timer bookkeeping (id 0 means paused). */\ninterface FlashTimer {\n  id: number;\n  startedAt: number;\n  remaining: number;\n}\n\n/**\n * Headless **Rails flash bridge**: turns server-rendered (and Turbo Stream-inserted)\n * `flash` elements into live-region announcements with auto-dismiss and a stacking\n * cap (no dedicated APG pattern; follows the WAI-ARIA status/alert guidance and WCAG\n * 2.2 **4.1.3 Status Messages**). The general-purpose sibling is Toast; this one is\n * specialized to the Rails `flash` convention.\n *\n * Markup contract (identifier: `stimeo--flash`):\n *   <div data-controller=\"stimeo--flash\" data-stimeo--flash-target=\"region\">\n *     <!-- server-rendered or Turbo Stream-inserted -->\n *     <div data-stimeo--flash-target=\"message\" data-flash-type=\"notice\">Saved</div>\n *   </div>\n *\n * Each message is mapped by `data-flash-type` to `role=\"status\"` (notice) or\n * `role=\"alert\"` (alert/error), flagged `data-flash-state=\"visible\"`, auto-dismissed\n * after `duration` (paused while hovered/focused when `pauseOnHover`), and capped at\n * `max` simultaneous messages. A close button wired to the `dismiss` action removes\n * one manually.\n *\n * @remarks\n * Reading is **delegated to the shared Announcer** — but only for the *initial*,\n * page-loaded messages: an in-place live region present at load is not announced by\n * assistive tech, so the controller bridges those via an `stimeo--announcer:announce`\n * event. Messages inserted *later* (Turbo Stream) are announced by their own freshly\n * inserted `role`, exactly like Toast, so they are not bridged again (no double\n * announcement). Behavior only — no styling; `data-flash-state=\"leaving\"` lets CSS\n * animate removal. Focus is never moved (WCAG 2.2 4.1.3). The observer, timers, and\n * per-message listeners are torn down on `disconnect()` (Turbo navigation included).\n */\nexport class FlashController extends Controller<HTMLElement> {\n  static override targets = [\"region\", \"message\"];\n  static override values = {\n    duration: { type: Number, default: 5000 },\n    pauseOnHover: { type: Boolean, default: true },\n    max: { type: Number, default: 0 },\n  };\n  static actions = [\"dismiss\"] as const;\n  static events = [\"show\", \"dismiss\"] as const;\n\n  declare readonly regionTarget: HTMLElement;\n  declare readonly messageTargets: HTMLElement[];\n  declare readonly hasRegionTarget: boolean;\n\n  declare durationValue: number;\n  declare pauseOnHoverValue: boolean;\n  declare maxValue: number;\n\n  readonly #timers = new SafeTimeout();\n  #observer: MutationObserver | null = null;\n  /** Auto-dismiss timer state keyed by message element. */\n  readonly #state = new Map<HTMLElement, FlashTimer>();\n  /** Messages already processed, in insertion order, to enforce `max` and avoid double work. */\n  readonly #order: HTMLElement[] = [];\n\n  readonly #onEnter = (event: Event): void => this.#pause(event.currentTarget as HTMLElement);\n  readonly #onLeave = (event: Event): void => this.#resume(event.currentTarget as HTMLElement);\n\n  override connect(): void {\n    if (!this.hasRegionTarget) return;\n    // Initial, server-rendered flashes: bridge them to the Announcer because an\n    // in-place live region present at page load is not announced on its own.\n    for (const message of this.messageTargets) {\n      this.#process(message, true);\n    }\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#observer = new MutationObserver((mutations) => this.#onMutations(mutations));\n      this.#observer.observe(this.regionTarget, { childList: true, subtree: true });\n    }\n  }\n\n  override disconnect(): void {\n    this.#observer?.disconnect();\n    this.#observer = null;\n    this.#timers.clearAll();\n    for (const message of this.#order) this.#unbindPause(message);\n    this.#state.clear();\n    this.#order.length = 0;\n  }\n\n  /**\n   * Pause-on-hover/focus listeners, bound and unbound as a pair so the two sides\n   * stay in sync. Binding is gated by `pauseOnHover`; unbinding is unconditional\n   * and idempotent (a no-op when nothing was bound), which keeps teardown correct\n   * even if `pauseOnHover` were ever toggled during a message's life.\n   */\n  #bindPause(message: HTMLElement): void {\n    if (!this.pauseOnHoverValue) return;\n    message.addEventListener(\"mouseenter\", this.#onEnter);\n    message.addEventListener(\"mouseleave\", this.#onLeave);\n    message.addEventListener(\"focusin\", this.#onEnter);\n    message.addEventListener(\"focusout\", this.#onLeave);\n  }\n\n  #unbindPause(message: HTMLElement): void {\n    message.removeEventListener(\"mouseenter\", this.#onEnter);\n    message.removeEventListener(\"mouseleave\", this.#onLeave);\n    message.removeEventListener(\"focusin\", this.#onEnter);\n    message.removeEventListener(\"focusout\", this.#onLeave);\n  }\n\n  /** Dismisses the flash whose close control fired the event. */\n  dismiss(event: Event): void {\n    const target = (event.currentTarget || event.target) as HTMLElement | null;\n    const message = target?.closest<HTMLElement>(MESSAGE_SELECTOR);\n    if (message) this.#beginDismiss(message, \"user\");\n  }\n\n  /** Processes messages added after connect (Turbo Stream); their own role announces them. */\n  #onMutations(mutations: MutationRecord[]): void {\n    for (const mutation of mutations) {\n      for (const node of mutation.addedNodes) {\n        if (!(node instanceof HTMLElement)) continue;\n        if (node.matches(MESSAGE_SELECTOR)) this.#process(node, false);\n        for (const message of node.querySelectorAll<HTMLElement>(MESSAGE_SELECTOR)) {\n          this.#process(message, false);\n        }\n      }\n    }\n  }\n\n  /**\n   * Applies role/state, wires pause listeners, schedules auto-dismiss, and either\n   * bridges to the Announcer (`bridge`, for initial flashes) or leaves the message's\n   * own role to do the announcing (dynamic inserts). Idempotent per message.\n   */\n  #process(message: HTMLElement, bridge: boolean): void {\n    if (this.#state.has(message) || this.#order.includes(message)) return;\n\n    const type = message.getAttribute(\"data-flash-type\") ?? \"\";\n    const assertive = ASSERTIVE_TYPES.has(type);\n    // Don't clobber an authored role; otherwise map the flash type to a live role.\n    if (!message.hasAttribute(\"role\")) {\n      message.setAttribute(\"role\", assertive ? \"alert\" : \"status\");\n    }\n    message.setAttribute(\"data-flash-state\", \"visible\");\n    this.#order.push(message);\n\n    this.#bindPause(message);\n\n    const text = message.textContent?.trim() ?? \"\";\n    this.dispatch(\"show\", { target: message, detail: { type, message: text } });\n    if (bridge && text) {\n      window.dispatchEvent(\n        new CustomEvent(\"stimeo--announcer:announce\", { detail: { message: text, assertive } }),\n      );\n    }\n\n    this.#startTimer(message);\n    this.#enforceMax();\n  }\n\n  /** Removes the oldest visible flashes once the count exceeds `max` (0 = unlimited). */\n  #enforceMax(): void {\n    if (this.maxValue <= 0) return;\n    while (this.#order.length > this.maxValue) {\n      const oldest = this.#order[0];\n      if (!oldest) break;\n      this.#beginDismiss(oldest, \"limit\");\n    }\n  }\n\n  #startTimer(message: HTMLElement, duration = this.durationValue): void {\n    if (duration <= 0) return;\n    const existing = this.#state.get(message);\n    if (existing?.id) this.#timers.clear(existing.id);\n    const id = this.#timers.set(() => this.#beginDismiss(message, \"timeout\"), duration);\n    this.#state.set(message, { id, startedAt: Date.now(), remaining: duration });\n  }\n\n  /** Pauses a message's auto-dismiss, banking the time left (hover/focus, WCAG 2.2.1). */\n  #pause(message: HTMLElement): void {\n    const timer = this.#state.get(message);\n    if (!timer || timer.id === 0) return;\n    this.#timers.clear(timer.id);\n    const remaining = Math.max(0, timer.remaining - (Date.now() - timer.startedAt));\n    this.#state.set(message, { id: 0, startedAt: 0, remaining });\n  }\n\n  /** Resumes a paused message's auto-dismiss with the banked time. */\n  #resume(message: HTMLElement): void {\n    const timer = this.#state.get(message);\n    if (!timer) return;\n    // Only resume a genuinely paused timer (id 0) that still has time banked.\n    if (timer.id !== 0 || timer.remaining <= 0) return;\n    this.#startTimer(message, timer.remaining);\n  }\n\n  /** Marks a message leaving, then removes it after its CSS transition and emits dismiss. */\n  #beginDismiss(message: HTMLElement, reason: \"timeout\" | \"user\" | \"limit\"): void {\n    const timer = this.#state.get(message);\n    if (timer?.id) this.#timers.clear(timer.id);\n    this.#state.delete(message);\n    const index = this.#order.indexOf(message);\n    if (index !== -1) this.#order.splice(index, 1);\n\n    message.setAttribute(\"data-flash-state\", \"leaving\");\n\n    const finalize = (): void => {\n      this.#unbindPause(message);\n      message.remove();\n      this.dispatch(\"dismiss\", { detail: { element: message, reason } });\n    };\n\n    const transition = this.#transitionMs(message);\n    if (transition > 0) {\n      this.#timers.set(finalize, transition);\n    } else {\n      finalize();\n    }\n  }\n\n  /** Maximum transition total (duration + delay) of `el` in ms (0 when none / unsupported). */\n  #transitionMs(el: HTMLElement): number {\n    if (typeof window.getComputedStyle !== \"function\") return 0;\n    return maxTransitionTotalMs(window.getComputedStyle(el));\n  }\n}\n"]}

package/dist/controllers/focus_controller.d.ts

@@ -22,7 +22,7 @@ import { Controller } from '@hotwired/stimulus';
  *
  * @remarks
  * Behavior only — it does not open/close or render an overlay (pair with Dialog) and
- * does not move DOM (pair with Portal). It reuses `src/utils/focus_trap.ts`, so it never
+ * does not move DOM (pair with Portal). It reuses the shared {@link FocusTrap}, so it never
  * scroll-locks the page (unlike the modal overlays) and tracks live focusable children
  * (dynamic additions are picked up on the next `Tab`). The opener is recorded on
  * activate and refocused on release if still present. Everything is torn down on