stimeo-ui 0.16.0 → 0.17.0

package/dist/controllers/filter_controller.js

@@ -1,6 +1,69 @@
 import { Controller } from '@hotwired/stimulus';
 
-// src/controllers/filter_controller.ts
+var ListenerSet = class {
+  #abort = new AbortController();
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
+
+var MicrotaskCoalescer = class {
+  #run;
+  #queued = false;
+  #active = false;
+  #generation = 0;
+  constructor(run) {
+    this.#run = run;
+  }
+  activate() {
+    this.#active = true;
+  }
+  cancel() {
+    this.#active = false;
+    this.#queued = false;
+    this.#generation += 1;
+  }
+  schedule() {
+    if (!this.#active || this.#queued) return;
+    this.#queued = true;
+    const generation = this.#generation;
+    queueMicrotask(() => {
+      if (generation !== this.#generation || !this.#queued || !this.#active) return;
+      this.#queued = false;
+      this.#run();
+    });
+  }
+};
+
+var MorphRenderWatcher = class {
+  #listeners = new ListenerSet();
+  #pass;
+  #element = null;
+  #onMorph = () => this.#pass.schedule();
+  constructor(run) {
+    this.#pass = new MicrotaskCoalescer(run);
+  }
+  observe(element) {
+    if (this.#element === element) return;
+    this.disconnect();
+    this.#element = element;
+    this.#pass.activate();
+    this.#listeners.add(element, "turbo:morph-element", this.#onMorph);
+  }
+  schedule() {
+    this.#pass.schedule();
+  }
+  disconnect() {
+    this.#listeners.dispose();
+    this.#pass.cancel();
+    this.#element = null;
+  }
+};
+
 var FilterController = class extends Controller {
   static targets = ["item", "control", "group", "empty"];
   static values = { match: { type: String, default: "all" } };
@@ -9,55 +72,28 @@ var FilterController = class extends Controller {
   #onChange = () => {
     this.apply();
   };
-  /**
-   * The outcome the last `change` reported, which the next evaluation is compared
-   * with; `null` until the first evaluation after `connect()`, which reports
-   * whatever it finds.
-   */
   #reported = null;
-  /**
-   * Gates the declaration callback to the connected window.
-   *
-   * Stimulus delivers a Value callback ahead of `connect()` and again for every
-   * runtime change; without the gate, merely connecting would emit an evaluation
-   * — and its `change` — before `connect()` runs its own.
-   */
   #connected = false;
+  #morphRender = new MorphRenderWatcher(() => this.#evaluate());
   connect() {
+    this.#morphRender.observe(this.element);
     this.#reported = null;
     this.#evaluate();
     this.element.addEventListener("change", this.#onChange);
     this.#connected = true;
   }
   disconnect() {
+    this.#morphRender.disconnect();
     this.#connected = false;
     this.element.removeEventListener("change", this.#onChange);
   }
-  /**
-   * Re-evaluates when the match declaration changes at runtime.
-   *
-   * The declaration decides which items are shown, so an element kept across a
-   * morph — where `connect()` does not run again — still has to follow it instead
-   * of waiting for the next control interaction. The evaluation is the ordinary
-   * one, `change` included: a declaration swap is an evaluation like any other.
-   */
   matchValueChanged() {
     if (!this.#connected) return;
     this.#evaluate();
   }
-  /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */
   apply() {
     this.#evaluate();
   }
-  /**
-   * The evaluation itself: every item's visibility from the active tokens, then
-   * the groups and the empty element, then `change` when the outcome moved from
-   * the one last reported. Several triggers can land on the same outcome — a
-   * `clear` evaluates, and a toggle group wired to `apply` reports the presses it
-   * turned off — so an evaluation that changes nothing reports nothing.
-   *
-   * @stimeoRenderRoot
-   */
   #evaluate() {
     const active = this.#activeTokens();
     let visibleCount = 0;
@@ -80,7 +116,6 @@ var FilterController = class extends Controller {
     this.#reported = { active, visibleCount, total };
     this.dispatch("change", { detail: { active: [...active], visibleCount, total } });
   }
-  /** Turns every control off (uncheck / aria-pressed="false") and re-applies. */
   clear() {
     for (const control of this.controlTargets) {
       if (control instanceof HTMLInputElement) {
@@ -91,7 +126,6 @@ var FilterController = class extends Controller {
     }
     this.apply();
   }
-  /** The tokens of every control currently "on" (checked or aria-pressed="true"). */
   #activeTokens() {
     const tokens = [];
     for (const control of this.controlTargets) {
@@ -99,33 +133,27 @@ var FilterController = class extends Controller {
     }
     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-${this.identifier}-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-${this.identifier}-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

@@ -1 +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/** What an evaluation settles on and `change` reports. */\ninterface FilterOutcome {\n  readonly active: readonly string[];\n  readonly visibleCount: number;\n  readonly total: number;\n}\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` reports the outcome\n * when it moves.\n *\n * `change` dispatches `{ active, visibleCount, total }` — the active tokens, how\n * many items they leave visible, and how many items there are — whenever an\n * evaluation lands on an outcome other than the one it last reported. The first\n * evaluation after `connect()` always reports.\n *\n * @remarks\n * Behavior only — the consumer owns all styling and the controls' own accessible\n * state (e.g. `aria-pressed`); the one exception is `clear`, which writes those\n * controls one way, to off. Visibility is re-derived from the live DOM on\n * `connect()`, on every native `change` that bubbles to the root, on the `apply`\n * and `clear` actions, and when `match` changes at runtime — the declaration\n * decides what is shown, so an element kept across a morph still follows it.\n * Button toggles that emit no native `change` wire their events to the `apply`\n * action: `stimeo--toggle-group:change->stimeo--filter#apply` for a press, and\n * `stimeo--toggle-group:reconcile->stimeo--filter#apply` for a pressed set the\n * page moves.\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  /**\n   * The outcome the last `change` reported, which the next evaluation is compared\n   * with; `null` until the first evaluation after `connect()`, which reports\n   * whatever it finds.\n   */\n  #reported: FilterOutcome | null = null;\n\n  /**\n   * Gates the declaration callback to the connected window.\n   *\n   * Stimulus delivers a Value callback ahead of `connect()` and again for every\n   * runtime change; without the gate, merely connecting would emit an evaluation\n   * — and its `change` — before `connect()` runs its own.\n   */\n  #connected = false;\n\n  override connect(): void {\n    this.#reported = null;\n    this.#evaluate();\n    this.element.addEventListener(\"change\", this.#onChange);\n    this.#connected = true;\n  }\n\n  override disconnect(): void {\n    this.#connected = false;\n    this.element.removeEventListener(\"change\", this.#onChange);\n  }\n\n  /**\n   * Re-evaluates when the match declaration changes at runtime.\n   *\n   * The declaration decides which items are shown, so an element kept across a\n   * morph — where `connect()` does not run again — still has to follow it instead\n   * of waiting for the next control interaction. The evaluation is the ordinary\n   * one, `change` included: a declaration swap is an evaluation like any other.\n   */\n  matchValueChanged(): void {\n    if (!this.#connected) return;\n    this.#evaluate();\n  }\n\n  /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */\n  apply(): void {\n    this.#evaluate();\n  }\n\n  /**\n   * The evaluation itself: every item's visibility from the active tokens, then\n   * the groups and the empty element, then `change` when the outcome moved from\n   * the one last reported. Several triggers can land on the same outcome — a\n   * `clear` evaluates, and a toggle group wired to `apply` reports the presses it\n   * turned off — so an evaluation that changes nothing reports nothing.\n   *\n   * @stimeoRenderRoot\n   */\n  #evaluate(): 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    const total = this.itemTargets.length;\n    const reported = this.#reported;\n    if (\n      reported !== null &&\n      reported.visibleCount === visibleCount &&\n      reported.total === total &&\n      reported.active.length === active.length &&\n      reported.active.every((token, index) => token === active[index])\n    ) {\n      return;\n    }\n    this.#reported = { active, visibleCount, total };\n    this.dispatch(\"change\", { detail: { active: [...active], visibleCount, total } });\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-${this.identifier}-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-${this.identifier}-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"]}
+{"version":3,"sources":["../../src/utils/listener_set.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/morph_render_watcher.ts","../../src/controllers/filter_controller.ts"],"names":[],"mappings":"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","file":"filter_controller.js","sourcesContent":["/**\n * Owns every listener a controller attaches for one connected lifetime and\n * releases them together, so an event name is spelled once and the release\n * cannot drift from the registration.\n *\n * Detaching by hand repeats three things at the release site — the type, the\n * handler reference and the capture flag — and any one of them drifting leaves\n * a listener alive on an element the controller no longer drives. Aborting the\n * signal a registration was created with releases it whatever it was made of,\n * so the release site names nothing.\n *\n * One set per lifetime, held as a field and never rebuilt. {@link\n * ListenerSet.dispose} is the only thing that closes a generation, and it opens\n * the next one in the same step, so the lifecycle hooks can call `add` and\n * `dispose` in any order any number of times, and no `add` ever meets an\n * already aborted signal — a DOM that registers a listener on such a signal\n * would keep it forever. Rebuilding the set instead would leak:\n * `addEventListener` matches an existing registration on target, type, callback\n * and capture alone, so re-adding the same handler while the first registration\n * is live is discarded, and that live registration keeps the signal it was\n * attached with — a set built by a second `connect()` can never release what it\n * appears to own.\n *\n * Scope is the registration only. Timers, observers, leases and the order they\n * are unwound in stay with the controller, which places `dispose()` in its\n * cleanup sequence. A receiver that changes at runtime (a\n * swapped target) is rebound by calling `dispose()` and then `add()` again from\n * the rebind, not by a second set.\n *\n * The set must own every registration of a tuple it holds: a listener the same\n * target already carries for the same type, callback and capture flag keeps the\n * right to remove it, and this set's `add` for that tuple is discarded. A\n * subscription shared between instances behind a participant count, or one that\n * lives for less than the connection, keeps its own pair of calls.\n *\n * @example\n * ```ts\n * readonly #listeners = new ListenerSet();\n *\n * connect(): void {\n *   this.#listeners.add(this.element, \"submit\", this.#onNativeSubmit, { capture: true });\n *   this.#listeners.add(this.element, \"turbo:submit-start\", this.#onSubmitStart);\n *   this.#listeners.add(this.element, \"turbo:submit-end\", this.#onSubmitEnd);\n * }\n *\n * disconnect(): void {\n *   this.#listeners.dispose();\n * }\n * ```\n */\nexport class ListenerSet {\n  /** The generation every `add` joins until the next `dispose()`. */\n  #abort = new AbortController();\n\n  /**\n   * Attaches `handler` to the open generation, exactly as the caller spelled it.\n   *\n   * The set supplies the signal, so `options` carries everything else the DOM\n   * accepts — `capture` included, which has to match at release time and no\n   * longer has a second place to drift from.\n   */\n  add(\n    target: EventTarget,\n    type: string,\n    handler: EventListener,\n    options?: Omit<AddEventListenerOptions, \"signal\">,\n  ): void {\n    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });\n  }\n\n  /**\n   * Releases every listener of the open generation, synchronously, and opens the\n   * next one. Idempotent, and safe before anything has been added.\n   */\n  dispose(): void {\n    this.#abort.abort();\n    this.#abort = new AbortController();\n  }\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { ListenerSet } from \"./listener_set\";\nimport { MicrotaskCoalescer } from \"./microtask_coalescer\";\n\n/**\n * Coalesces retained-element morphs and explicit lifecycle requests into one pass.\n *\n * Observe the controller's element after its initial state is settled. Morphs on\n * that element and bubbling morphs on its descendants share the same microtask\n * as {@link schedule}. The callback repairs derived output; the controller owns\n * any logical transition reporting. {@link disconnect} releases the listener and\n * cancels pending work, including work from an earlier connected lifetime.\n */\nexport class MorphRenderWatcher {\n  readonly #listeners = new ListenerSet();\n  readonly #pass: MicrotaskCoalescer;\n  #element: Element | null = null;\n  readonly #onMorph = (): void => this.#pass.schedule();\n\n  /** @param run - the single pass that repairs the settled controller's output. */\n  constructor(run: () => void) {\n    this.#pass = new MicrotaskCoalescer(run);\n  }\n\n  /** Opens observation; observing the same element again preserves queued work. */\n  observe(element: Element): void {\n    if (this.#element === element) return;\n    this.disconnect();\n    this.#element = element;\n    this.#pass.activate();\n    this.#listeners.add(element, \"turbo:morph-element\", this.#onMorph);\n  }\n\n  /** Requests one pass; requests outside an observed lifetime are ignored. */\n  schedule(): void {\n    this.#pass.schedule();\n  }\n\n  /** Releases observation and pending work synchronously; safe to repeat. */\n  disconnect(): void {\n    this.#listeners.dispose();\n    this.#pass.cancel();\n    this.#element = null;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { MorphRenderWatcher } from \"../utils/morph_render_watcher\";\n\n/** A control whose \"on\" state contributes its token to the active filter set. */\ntype FilterControl = HTMLElement;\n\n/** What an evaluation settles on and `change` reports. */\ninterface FilterOutcome {\n  readonly active: readonly string[];\n  readonly visibleCount: number;\n  readonly total: number;\n}\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` reports the outcome\n * when it moves.\n *\n * `change` dispatches `{ active, visibleCount, total }` — the active tokens, how\n * many items they leave visible, and how many items there are — whenever an\n * evaluation lands on an outcome other than the one it last reported. The first\n * evaluation after `connect()` always reports.\n *\n * @remarks\n * Behavior only — the consumer owns all styling and the controls' own accessible\n * state (e.g. `aria-pressed`); the one exception is `clear`, which writes those\n * controls one way, to off. Visibility is re-derived from the live DOM on\n * `connect()`, on every native `change` that bubbles to the root, on the `apply`\n * and `clear` actions, and when `match` changes at runtime — the declaration\n * decides what is shown, so an element kept across a morph still follows it.\n * Button toggles that emit no native `change` wire their events to the `apply`\n * action: `stimeo--toggle-group:change->stimeo--filter#apply` for a press, and\n * `stimeo--toggle-group:reconcile->stimeo--filter#apply` for a pressed set the\n * page moves.\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  /**\n   * The outcome the last `change` reported, which the next evaluation is compared\n   * with; `null` until the first evaluation after `connect()`, which reports\n   * whatever it finds.\n   */\n  #reported: FilterOutcome | null = null;\n\n  /**\n   * Gates the declaration callback to the connected window.\n   *\n   * Stimulus delivers a Value callback ahead of `connect()` and again for every\n   * runtime change; without the gate, merely connecting would emit an evaluation\n   * — and its `change` — before `connect()` runs its own.\n   */\n  #connected = false;\n\n  readonly #morphRender = new MorphRenderWatcher(() => this.#evaluate());\n\n  override connect(): void {\n    this.#morphRender.observe(this.element);\n    this.#reported = null;\n    this.#evaluate();\n    this.element.addEventListener(\"change\", this.#onChange);\n    this.#connected = true;\n  }\n\n  override disconnect(): void {\n    this.#morphRender.disconnect();\n    this.#connected = false;\n    this.element.removeEventListener(\"change\", this.#onChange);\n  }\n\n  /**\n   * Re-evaluates when the match declaration changes at runtime.\n   *\n   * The declaration decides which items are shown, so an element kept across a\n   * morph — where `connect()` does not run again — still has to follow it instead\n   * of waiting for the next control interaction. The evaluation is the ordinary\n   * one, `change` included: a declaration swap is an evaluation like any other.\n   */\n  matchValueChanged(): void {\n    if (!this.#connected) return;\n    this.#evaluate();\n  }\n\n  /** Re-derives every item's visibility from the active tokens and syncs groups/empty. */\n  apply(): void {\n    this.#evaluate();\n  }\n\n  /**\n   * The evaluation itself: every item's visibility from the active tokens, then\n   * the groups and the empty element, then `change` when the outcome moved from\n   * the one last reported. Several triggers can land on the same outcome — a\n   * `clear` evaluates, and a toggle group wired to `apply` reports the presses it\n   * turned off — so an evaluation that changes nothing reports nothing.\n   *\n   * @stimeoRenderRoot\n   */\n  #evaluate(): 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    const total = this.itemTargets.length;\n    const reported = this.#reported;\n    if (\n      reported !== null &&\n      reported.visibleCount === visibleCount &&\n      reported.total === total &&\n      reported.active.length === active.length &&\n      reported.active.every((token, index) => token === active[index])\n    ) {\n      return;\n    }\n    this.#reported = { active, visibleCount, total };\n    this.dispatch(\"change\", { detail: { active: [...active], visibleCount, total } });\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-${this.identifier}-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-${this.identifier}-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.d.ts

@@ -7,6 +7,9 @@ import { Controller } from '@hotwired/stimulus';
  * 2.2 **4.1.3 Status Messages**). The general-purpose sibling is Toast; this one is
  * specialized to the Rails `flash` convention.
  *
+ * Capacity evicts by arrival order, independent of DOM order. The same controller
+ * instance preserves that order across reconnects; a new instance uses DOM order.
+ *
  * Markup contract (identifier: `stimeo--flash`):
  *   <div data-controller="stimeo--flash" data-stimeo--flash-target="region">
  *     <!-- server-rendered or Turbo Stream-inserted -->
@@ -27,11 +30,13 @@ import { Controller } from '@hotwired/stimulus';
  * those holds is released.
  * A close button wired to the `dismiss` action removes one manually.
  *
- * `dismiss` dispatches `{ element, reason }`.
+ * `dismiss` dispatches `{ element, reason: StateReason }`.
  *
- * `show` dispatches `{ type, message }`.
- * `reconcile` dispatches `{ removed: number }` — the messages the Turbo cache
- * rewind took out, which no `dismiss` will report because nobody dismissed them.
+ * `show` dispatches `{ type, message }`, once per message: a reconnection of the same
+ * instance — an in-page move, a `data-turbo-permanent` region carried to the next page —
+ * takes its messages on again without showing or announcing them a second time.
+ * `reconcile` dispatches `{ removed: number }` — the messages a page restored from the
+ * Turbo cache still carried, which no `dismiss` will report because nobody dismissed them.
  *
  * @remarks
  * Reading is **delegated to the shared Announcer** — but only for the *initial*,
@@ -48,8 +53,16 @@ import { Controller } from '@hotwired/stimulus';
  * subtree, and a message that leaves it gives up its stacking slot, its pending
  * auto-dismiss, and any removal already scheduled. The observer, timers,
  * and per-message listeners are torn down on `disconnect()` (Turbo navigation
- * included), and the managed flashes leave the page before Turbo caches it so a
- * restored snapshot does not replay a notification the visitor already received.
+ * included).
+ *
+ * **A restored page does not replay a notification.** Every message taken on carries
+ * `data-<identifier>-shown`. A page Turbo restores from its cache is a copy taken while
+ * its messages were on screen, so a connection that finds marked messages it never took
+ * on itself removes them, silently, before it takes anything else on, and reports how
+ * many as `reconcile`. Server-rendered messages carry no mark and are announced as
+ * usual. Nothing is removed on `turbo:before-cache`, which Turbo also dispatches on
+ * pages that stay — a promoted frame navigation, a state-less `popstate`, a refresh of
+ * a cached URL, a permanent region — where the message is still being read.
  */
 declare class FlashController extends Controller<HTMLElement> {
     #private;
@@ -68,6 +81,16 @@ declare class FlashController extends Controller<HTMLElement> {
             default: number;
         };
     };
+    static valueConstraints: {
+        duration: {
+            readonly finite: true;
+            readonly min: 0;
+            readonly max: 2147483647;
+        };
+        max: {
+            readonly finite: true;
+        };
+    };
     static actions: readonly ["dismiss"];
     static events: readonly ["show", "dismiss", "reconcile"];
     readonly regionTarget: HTMLElement;
@@ -102,8 +125,8 @@ declare class FlashController extends Controller<HTMLElement> {
      * ended a hold, so those are read again.
      */
     messageTargetDisconnected(message: HTMLElement): void;
-    /** Dismisses the flash whose close control fired the event. */
-    dismiss(event: Event): void;
+    /** Dismisses an owned message or descendant, or the message a DOM action operated. */
+    dismiss(input: Event | HTMLElement): void;
 }
 
 export { FlashController };