stimeo-ui 0.4.0 → 0.6.0

package/dist/controllers/stepper_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/stepper_controller.ts"],"names":[],"mappings":"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","file":"stepper_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, accessible stepper / wizard navigation behavior.\n *\n * Markup contract (identifier: `stimeo--stepper`):\n *   <ol data-controller=\"stimeo--stepper\" data-stimeo--stepper-index-value=\"0\">\n *     <li data-stimeo--stepper-target=\"step\">\n *       <button aria-current=\"step\" data-stimeo--stepper-index-param=\"0\"\n *               data-action=\"click->stimeo--stepper#goto\">Account</button>\n *     </li>\n *     <!-- more steps -->\n *   </ol>\n *\n * There is no dedicated APG widget; the current step is expressed with\n * `aria-current=\"step\"` on the operable `<button>`. Each step `<li>` also gets a\n * `data-state` (`complete`/`current`/`upcoming`) derived from the current index.\n * For a read-only progress display use\n * {@link StepIndicatorController | Step Indicator}; for panel switching use Tabs.\n *\n * @remarks\n * Behavior only. The controller never traps or restores focus — each step button\n * is in the natural Tab order. `data-state` is purely derived from `index`\n * (completion is not persisted).\n *\n * Behavior provided:\n * - `next`/`prev` move one step, ignoring moves past either end.\n * - `goto` jumps to the step in its `index` action param.\n * - With `linear=true`, `goto` may not skip more than one step ahead of the\n *   current one (moving backward is always allowed).\n * - Runtime changes to the `index` Value re-derive every step's state.\n * - Each move re-derives `data-state`/`aria-current` and dispatches\n *   `stimeo--stepper:change`.\n */\nexport class StepperController extends Controller<HTMLElement> {\n  static override targets = [\"step\"];\n  static override values = {\n    index: { type: Number, default: 0 },\n    linear: { type: Boolean, default: false },\n  };\n  static actions = [\"goto\", \"next\", \"prev\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly stepTargets: HTMLElement[];\n  declare indexValue: number;\n  declare linearValue: boolean;\n\n  #isConnected = false;\n\n  /** Normalizes an out-of-range initial `index` and renders the initial state. */\n  override connect(): void {\n    this.#isConnected = true;\n    this.#normalizeAndRender();\n  }\n\n  override disconnect(): void {\n    this.#isConnected = false;\n  }\n\n  /** Re-renders when Turbo Morph or application code changes `index` at runtime. */\n  indexValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#normalizeAndRender();\n  }\n\n  /** Advances to the next step (ignored at the last step). */\n  next(): void {\n    this.#moveTo(this.#clampIndex(this.indexValue) + 1);\n  }\n\n  /** Returns to the previous step (ignored at the first step). */\n  prev(): void {\n    this.#moveTo(this.#clampIndex(this.indexValue) - 1);\n  }\n\n  /** Jumps to the step carried in the action's `index` param. */\n  goto(event: { params: { index?: number } }): void {\n    const target = Number(event.params.index);\n    if (!Number.isFinite(target) || !Number.isInteger(target)) return;\n    this.#moveTo(target);\n  }\n\n  /**\n   * Moves the current step to `target` when allowed: in range, not a no-op, and\n   * — under `linear` — not skipping more than one step ahead. Re-renders and\n   * dispatches `change`.\n   */\n  #moveTo(target: number): void {\n    const total = this.stepTargets.length;\n    if (!Number.isFinite(target) || !Number.isInteger(target)) return;\n    if (target < 0 || target >= total) return;\n    const current = this.#clampIndex(this.indexValue);\n    if (target === current) return;\n    if (this.linearValue && target > current + 1) return;\n\n    const previous = current;\n    this.indexValue = target;\n    this.#render(target);\n    this.dispatch(\"change\", {\n      detail: { index: target, previous, step: this.stepTargets[target] },\n    });\n  }\n\n  /** Normalizes the public Value and reflects it without dispatching an action event. */\n  #normalizeAndRender(): void {\n    const normalized = this.#clampIndex(this.indexValue);\n    if (!Object.is(normalized, this.indexValue)) this.indexValue = normalized;\n    this.#render(normalized);\n  }\n\n  /**\n   * Derives each step's `data-state` and the current button's `aria-current`.\n   *\n   * `aria-current=\"step\"` is placed on the step's **first** `<button>`; the markup\n   * contract assumes one operable button per step. If a step needs multiple\n   * buttons, mark the navigational one first (or this would target the wrong one).\n   */\n  #render(current: number): void {\n    this.stepTargets.forEach((step, index) => {\n      step.dataset.state =\n        index < current ? \"complete\" : index === current ? \"current\" : \"upcoming\";\n      const button = step.querySelector<HTMLElement>(\"button\");\n      if (!button) return;\n      if (index === current) {\n        button.setAttribute(\"aria-current\", \"step\");\n      } else {\n        button.removeAttribute(\"aria-current\");\n      }\n    });\n  }\n\n  /** Constrains an index to `[0, total-1]` (or `0` when there are no steps). */\n  #clampIndex(index: number): number {\n    const last = this.stepTargets.length - 1;\n    if (last < 0 || !Number.isFinite(index)) return 0;\n    return Math.min(last, Math.max(0, Math.trunc(index)));\n  }\n}\n"]}
+{"version":3,"sources":["../../src/controllers/stepper_controller.ts"],"names":[],"mappings":"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","file":"stepper_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, accessible stepper / wizard navigation behavior.\n *\n * Markup contract (identifier: `stimeo--stepper`):\n *   <ol data-controller=\"stimeo--stepper\" data-stimeo--stepper-index-value=\"0\">\n *     <li data-stimeo--stepper-target=\"step\">\n *       <button aria-current=\"step\" data-stimeo--stepper-index-param=\"0\"\n *               data-action=\"click->stimeo--stepper#goto\">Account</button>\n *     </li>\n *     <!-- more steps -->\n *   </ol>\n *\n * There is no dedicated APG widget; the current step is expressed with\n * `aria-current=\"step\"` on the operable `<button>`. Each step `<li>` also gets a\n * `data-state` (`complete`/`current`/`upcoming`) derived from the current index.\n * For a read-only progress display use\n * {@link StepIndicatorController | Step Indicator}; for panel switching use Tabs.\n *\n * @remarks\n * Behavior only. The controller never traps or restores focus — each step button\n * is in the natural Tab order. `data-state` is purely derived from `index`\n * (completion is not persisted).\n *\n * Behavior provided:\n * - `next`/`prev` move one step, ignoring moves past either end.\n * - `goto` jumps to the step in its `index` action param.\n * - With `linear=true`, `goto` may not skip more than one step ahead of the\n *   current one (moving backward is always allowed).\n * - Runtime changes to the `index` Value re-derive every step's state.\n * - Each move re-derives `data-state`/`aria-current` and dispatches\n *   `stimeo--stepper:change`.\n */\nexport class StepperController extends Controller<HTMLElement> {\n  static override targets = [\"step\"];\n  static override values = {\n    index: { type: Number, default: 0 },\n    linear: { type: Boolean, default: false },\n  };\n  static actions = [\"goto\", \"next\", \"prev\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly stepTargets: HTMLElement[];\n  declare indexValue: number;\n  declare linearValue: boolean;\n\n  #isConnected = false;\n\n  /** Normalizes an out-of-range initial `index` and renders the initial state. */\n  override connect(): void {\n    this.#isConnected = true;\n    this.#normalizeAndRender();\n  }\n\n  override disconnect(): void {\n    this.#isConnected = false;\n  }\n\n  /** Re-renders when Turbo Morph or application code changes `index` at runtime. */\n  indexValueChanged(): void {\n    if (!this.#isConnected) return;\n    this.#normalizeAndRender();\n  }\n\n  /** Advances to the next step (ignored at the last step). */\n  next(): void {\n    this.#moveTo(this.#clampIndex(this.indexValue) + 1);\n  }\n\n  /** Returns to the previous step (ignored at the first step). */\n  prev(): void {\n    this.#moveTo(this.#clampIndex(this.indexValue) - 1);\n  }\n\n  /** Jumps to the step carried in the action's `index` param. */\n  goto(event: { params: { index?: number } }): void {\n    const target = Number(event.params.index);\n    if (!Number.isFinite(target) || !Number.isInteger(target)) return;\n    this.#moveTo(target);\n  }\n\n  /**\n   * Moves the current step to `target` when allowed: in range, not a no-op, and\n   * — under `linear` — not skipping more than one step ahead. Re-renders and\n   * dispatches `change`.\n   */\n  #moveTo(target: number): void {\n    const total = this.stepTargets.length;\n    if (!Number.isFinite(target) || !Number.isInteger(target)) return;\n    if (target < 0 || target >= total) return;\n    const current = this.#clampIndex(this.indexValue);\n    if (target === current) return;\n    if (this.linearValue && target > current + 1) return;\n\n    const previous = current;\n    this.indexValue = target;\n    this.#render(target);\n    this.dispatch(\"change\", {\n      detail: { index: target, previous, step: this.stepTargets[target] },\n    });\n  }\n\n  /** Normalizes the public Value and reflects it without dispatching an action event. */\n  #normalizeAndRender(): void {\n    const normalized = this.#clampIndex(this.indexValue);\n    if (!Object.is(normalized, this.indexValue)) this.indexValue = normalized;\n    this.#render(normalized);\n  }\n\n  /**\n   * Derives each step's `data-state` and the current button's `aria-current`.\n   *\n   * `aria-current=\"step\"` is placed on the step's **first** `<button>`; the markup\n   * contract assumes one operable button per step. If a step needs multiple\n   * buttons, mark the navigational one first (or this would target the wrong one).\n   *\n   * @stimeoRenderRoot\n   */\n  #render(current: number): void {\n    this.stepTargets.forEach((step, index) => {\n      step.dataset.state =\n        index < current ? \"complete\" : index === current ? \"current\" : \"upcoming\";\n      const button = step.querySelector<HTMLElement>(\"button\");\n      if (!button) return;\n      if (index === current) {\n        button.setAttribute(\"aria-current\", \"step\");\n      } else {\n        button.removeAttribute(\"aria-current\");\n      }\n    });\n  }\n\n  /** Constrains an index to `[0, total-1]` (or `0` when there are no steps). */\n  #clampIndex(index: number): number {\n    const last = this.stepTargets.length - 1;\n    if (last < 0 || !Number.isFinite(index)) return 0;\n    return Math.min(last, Math.max(0, Math.trunc(index)));\n  }\n}\n"]}

package/dist/controllers/switch_controller.d.ts

@@ -4,7 +4,7 @@ import { Controller } from '@hotwired/stimulus';
  * Headless, accessible switch (toggle) behavior.
  *
  * Markup contract (identifier: `stimeo--switch`):
- *   <button data-controller="stimeo--switch"
+ *   <button type="button" data-controller="stimeo--switch"
  *           data-action="stimeo--switch#toggle keydown->stimeo--switch#onKeydown"
  *           role="switch" aria-checked="false">…</button>
  *
@@ -14,9 +14,11 @@ import { Controller } from '@hotwired/stimulus';
  * @remarks
  * Behavior only — the consumer owns all styling (typically keyed off the
  * `[aria-checked="true"]` attribute). On a native `<button>` host, the browser
- * already synthesizes a click for Space/Enter, so {@link onKeydown} deliberately
- * does nothing there (to avoid a double toggle) and only drives non-button hosts
- * such as `<div role="switch" tabindex="0">`.
+ * already synthesizes a click for Space/Enter, so {@link onKeydown} leaves the
+ * initial key to the browser and suppresses repeated keydowns. Non-button hosts
+ * such as `<div role="switch" tabindex="0">` are driven directly. Other native
+ * interactive hosts stand down because their checked/navigation semantics would
+ * conflict with `aria-checked` as this controller's sole source of truth.
  *
  * Behavior provided:
  * - Click (or Space/Enter) toggles `aria-checked` between `"true"` and `"false"`.
@@ -29,13 +31,15 @@ declare class SwitchController extends Controller<HTMLElement> {
     static events: readonly ["changed"];
     /** Ensures the switch exposes a role and is keyboard-reachable. */
     connect(): void;
+    /** Releases the explicit click guard and retained-element attribute observer. */
+    disconnect(): void;
     /** Toggles the checked state. Bound via `data-action` (click). */
     toggle(): void;
     /**
-     * Activates the switch on Space/Enter for non-native hosts and prevents the
-     * default Space scroll. Bound via `data-action` (keydown). Native `<button>`
-     * hosts are skipped because the browser already turns Space/Enter into a click,
-     * which would otherwise toggle the switch twice.
+     * Activates the switch on Space/Enter for non-native hosts and suppresses key
+     * repeat. Bound via `data-action` (keydown). A native `<button type="button">`
+     * owns the initial key-to-click synthesis; repeated keydowns are canceled before
+     * the browser can synthesize additional clicks.
      */
     onKeydown(event: KeyboardEvent): void;
 }

package/dist/controllers/switch_controller.js

@@ -1,39 +1,181 @@
 import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/switch_controller.ts
+
+// src/utils/default_attribute.ts
+function setDefaultAttribute(element, name, value) {
+  if (element.hasAttribute(name)) return false;
+  element.setAttribute(name, value);
+  return true;
+}
+
+// src/utils/focus_candidate.ts
+function inheritsFieldsetDisabled(control) {
+  let fieldset = control.closest("fieldset[disabled]");
+  while (fieldset) {
+    const legend = Array.from(fieldset.children).find((child) => child.tagName === "LEGEND");
+    if (!legend?.contains(control)) return true;
+    fieldset = fieldset.parentElement?.closest("fieldset[disabled]") ?? null;
+  }
+  return false;
+}
+
+// src/utils/interactive_host.ts
+var INTERACTIVE_HOST_SELECTOR = "button, input, select, textarea, label, a[href], area[href], summary, details, audio[controls], video[controls], iframe, object, embed";
+function isInteractiveHost(element) {
+  if (element.matches(INTERACTIVE_HOST_SELECTOR)) return true;
+  let current = element;
+  while (current) {
+    const raw = current.getAttribute("contenteditable");
+    if (raw !== null) {
+      const value = raw.trim().toLowerCase();
+      if (value === "false") return false;
+      if (value === "" || value === "true" || value === "plaintext-only") return true;
+    }
+    current = current.parentElement;
+  }
+  return false;
+}
+
+// src/controllers/switch_controller.ts
+var OBSERVED_ATTRIBUTES = [
+  "role",
+  "aria-checked",
+  "tabindex",
+  "type",
+  "href",
+  "contenteditable",
+  "controls"
+];
+var OBSERVED_ANCESTOR_ATTRIBUTES = ["contenteditable"];
 var SwitchController = class extends Controller {
   static actions = ["onKeydown", "toggle"];
   static events = ["changed"];
+  /** Defaults this instance introduced and may therefore remove safely. */
+  #ownedDefaults = /* @__PURE__ */ new Set();
+  /** Controller writes that must not be mistaken for authored morph changes. */
+  #internalAttributeValues = /* @__PURE__ */ new Map();
+  #attributeObserver = new MutationObserver((records) => {
+    this.#releaseAuthoredDefaults(records);
+    this.#attributeObserver.disconnect();
+    this.#reconcileDefaults();
+    this.#observeAttributes();
+  });
+  /** Blocks disabled pointer/native-key activation before consumer click handlers. */
+  #onClickCapture = (event) => {
+    if (!this.#isSupportedHost || !this.#isActivationDisabled) return;
+    event.preventDefault();
+    event.stopImmediatePropagation();
+  };
   /** Ensures the switch exposes a role and is keyboard-reachable. */
   connect() {
-    if (!this.element.hasAttribute("role")) {
-      this.element.setAttribute("role", "switch");
-    }
-    if (!this.element.hasAttribute("aria-checked")) {
-      this.element.setAttribute("aria-checked", "false");
-    }
-    if (!(this.element instanceof HTMLButtonElement) && !this.element.hasAttribute("tabindex")) {
-      this.element.setAttribute("tabindex", "0");
-    }
+    this.#reconcileDefaults();
+    this.element.addEventListener("click", this.#onClickCapture, true);
+    this.#observeAttributes();
+  }
+  /** Releases the explicit click guard and retained-element attribute observer. */
+  disconnect() {
+    this.element.removeEventListener("click", this.#onClickCapture, true);
+    this.#attributeObserver.disconnect();
+    this.#internalAttributeValues.clear();
   }
   /** Toggles the checked state. Bound via `data-action` (click). */
   toggle() {
+    if (!this.#isSupportedHost || this.#isActivationDisabled) return;
     this.#checked = !this.#checked;
   }
   /**
-   * Activates the switch on Space/Enter for non-native hosts and prevents the
-   * default Space scroll. Bound via `data-action` (keydown). Native `<button>`
-   * hosts are skipped because the browser already turns Space/Enter into a click,
-   * which would otherwise toggle the switch twice.
+   * Activates the switch on Space/Enter for non-native hosts and suppresses key
+   * repeat. Bound via `data-action` (keydown). A native `<button type="button">`
+   * owns the initial key-to-click synthesis; repeated keydowns are canceled before
+   * the browser can synthesize additional clicks.
    */
   onKeydown(event) {
     if (event.defaultPrevented) return;
-    if (this.element instanceof HTMLButtonElement) return;
-    if (event.repeat) return;
-    if (event.key === " " || event.key === "Enter") {
+    if (!this.#isSupportedHost) return;
+    if (event.key !== " " && event.key !== "Enter") return;
+    if (this.#isActivationDisabled) {
       event.preventDefault();
-      this.toggle();
+      event.stopImmediatePropagation();
+      return;
+    }
+    if (this.element instanceof HTMLButtonElement) {
+      if (event.repeat) event.preventDefault();
+      return;
+    }
+    event.preventDefault();
+    if (event.repeat) return;
+    this.toggle();
+  }
+  /** Re-adds only missing defaults, preserving every authored attribute value. */
+  #reconcileDefaults() {
+    if (!this.#isSupportedHost) {
+      this.#removeOwnedDefaults();
+      return;
+    }
+    this.#setOwnedDefault("role", "switch");
+    this.#setOwnedDefault("aria-checked", "false");
+    if (!(this.element instanceof HTMLButtonElement)) {
+      this.#setOwnedDefault("tabindex", "0");
+    }
+  }
+  /** Records a newly introduced default without claiming authored markup. */
+  #setOwnedDefault(name, value) {
+    if (setDefaultAttribute(this.element, name, value)) this.#ownedDefaults.add(name);
+  }
+  /**
+   * Gives ownership back when a retained-element morph authors a value. Missing
+   * owned attributes stay owned so reconciliation can restore them.
+   */
+  #releaseAuthoredDefaults(records) {
+    for (const record of records) {
+      if (record.target === this.element) {
+        const name = record.attributeName;
+        if (name && this.#ownedDefaults.has(name)) {
+          const value = this.element.getAttribute(name);
+          if (value !== null && this.#internalAttributeValues.get(name) !== value) {
+            this.#ownedDefaults.delete(name);
+          }
+        }
+      }
+    }
+    this.#internalAttributeValues.clear();
+  }
+  /** Removes only defaults introduced by this instance when a host becomes invalid. */
+  #removeOwnedDefaults() {
+    for (const name of this.#ownedDefaults) this.element.removeAttribute(name);
+    this.#ownedDefaults.clear();
+    this.#internalAttributeValues.clear();
+  }
+  /** Watches retained host attributes that Turbo can morph without reconnecting. */
+  #observeAttributes() {
+    this.#attributeObserver.observe(this.element, {
+      attributes: true,
+      attributeFilter: OBSERVED_ATTRIBUTES
+    });
+    let ancestor = this.element.parentElement;
+    while (ancestor) {
+      this.#attributeObserver.observe(ancestor, {
+        attributes: true,
+        attributeFilter: OBSERVED_ANCESTOR_ATTRIBUTES
+      });
+      ancestor = ancestor.parentElement;
+    }
+  }
+  /** Whether the host has one activation model that this controller can own. */
+  get #isSupportedHost() {
+    if (this.element instanceof HTMLButtonElement) return this.element.type === "button";
+    return !isInteractiveHost(this.element);
+  }
+  /** Whether ARIA or native HTML semantics make the supported switch inoperable. */
+  get #isActivationDisabled() {
+    let current = this.element;
+    while (current) {
+      if (current.getAttribute("aria-disabled") === "true") return true;
+      current = current.parentElement;
     }
+    if (!(this.element instanceof HTMLButtonElement)) return false;
+    return this.element.disabled || inheritsFieldsetDisabled(this.element);
   }
   /** Whether the switch is currently on. */
   get #checked() {
@@ -41,7 +183,9 @@ var SwitchController = class extends Controller {
   }
   /** Reflects the new state on `aria-checked` and notifies listeners. */
   set #checked(value) {
-    this.element.setAttribute("aria-checked", value ? "true" : "false");
+    const reflected = value ? "true" : "false";
+    this.#internalAttributeValues.set("aria-checked", reflected);
+    this.element.setAttribute("aria-checked", reflected);
     this.dispatch("changed", { detail: { checked: value } });
   }
 };

package/dist/controllers/switch_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/switch_controller.ts"],"names":[],"mappings":";;;AAyBO,IAAM,gBAAA,GAAN,cAA+B,UAAA,CAAwB;AAAA,EAC5D,OAAO,OAAA,GAAU,CAAC,WAAA,EAAa,QAAQ,CAAA;AAAA,EACvC,OAAO,MAAA,GAAS,CAAC,SAAS,CAAA;AAAA;AAAA,EAGjB,OAAA,GAAgB;AACvB,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,MAAM,CAAA,EAAG;AACtC,MAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,MAAA,EAAQ,QAAQ,CAAA;AAAA,IAC5C;AACA,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,cAAc,CAAA,EAAG;AAC9C,MAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,cAAA,EAAgB,OAAO,CAAA;AAAA,IACnD;AAIA,IAAA,IAAI,EAAE,KAAK,OAAA,YAAmB,iBAAA,CAAA,IAAsB,CAAC,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,UAAU,CAAA,EAAG;AAC1F,MAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,UAAA,EAAY,GAAG,CAAA;AAAA,IAC3C;AAAA,EACF;AAAA;AAAA,EAGA,MAAA,GAAe;AACb,IAAA,IAAA,CAAK,QAAA,GAAW,CAAC,IAAA,CAAK,QAAA;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,KAAA,EAA4B;AAGpC,IAAA,IAAI,MAAM,gBAAA,EAAkB;AAC5B,IAAA,IAAI,IAAA,CAAK,mBAAmB,iBAAA,EAAmB;AAC/C,IAAA,IAAI,MAAM,MAAA,EAAQ;AAClB,IAAA,IAAI,KAAA,CAAM,GAAA,KAAQ,GAAA,IAAO,KAAA,CAAM,QAAQ,OAAA,EAAS;AAC9C,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,IAAA,CAAK,MAAA,EAAO;AAAA,IACd;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,QAAA,GAAoB;AACtB,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,cAAc,CAAA,KAAM,MAAA;AAAA,EACvD;AAAA;AAAA,EAGA,IAAI,SAAS,KAAA,EAAgB;AAC3B,IAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,cAAA,EAAgB,KAAA,GAAQ,SAAS,OAAO,CAAA;AAClE,IAAA,IAAA,CAAK,QAAA,CAAS,WAAW,EAAE,MAAA,EAAQ,EAAE,OAAA,EAAS,KAAA,IAAS,CAAA;AAAA,EACzD;AACF","file":"switch_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, accessible switch (toggle) behavior.\n *\n * Markup contract (identifier: `stimeo--switch`):\n *   <button data-controller=\"stimeo--switch\"\n *           data-action=\"stimeo--switch#toggle keydown->stimeo--switch#onKeydown\"\n *           role=\"switch\" aria-checked=\"false\">…</button>\n *\n * Implements the WAI-ARIA APG **Switch** pattern. The controller element is the\n * switch itself; its on/off state is reflected solely through `aria-checked`.\n *\n * @remarks\n * Behavior only — the consumer owns all styling (typically keyed off the\n * `[aria-checked=\"true\"]` attribute). On a native `<button>` host, the browser\n * already synthesizes a click for Space/Enter, so {@link onKeydown} deliberately\n * does nothing there (to avoid a double toggle) and only drives non-button hosts\n * such as `<div role=\"switch\" tabindex=\"0\">`.\n *\n * Behavior provided:\n * - Click (or Space/Enter) toggles `aria-checked` between `\"true\"` and `\"false\"`.\n * - A `stimeo--switch:changed` event is dispatched on every toggle so the\n *   consumer can react (its `detail.checked` carries the new boolean state).\n */\nexport class SwitchController extends Controller<HTMLElement> {\n  static actions = [\"onKeydown\", \"toggle\"] as const;\n  static events = [\"changed\"] as const;\n\n  /** Ensures the switch exposes a role and is keyboard-reachable. */\n  override connect(): void {\n    if (!this.element.hasAttribute(\"role\")) {\n      this.element.setAttribute(\"role\", \"switch\");\n    }\n    if (!this.element.hasAttribute(\"aria-checked\")) {\n      this.element.setAttribute(\"aria-checked\", \"false\");\n    }\n    // Native <button> hosts are focusable already; a non-button host (e.g.\n    // <div role=\"switch\">) needs an explicit tabindex to be keyboard-reachable,\n    // otherwise the keyboard support below would be unreachable.\n    if (!(this.element instanceof HTMLButtonElement) && !this.element.hasAttribute(\"tabindex\")) {\n      this.element.setAttribute(\"tabindex\", \"0\");\n    }\n  }\n\n  /** Toggles the checked state. Bound via `data-action` (click). */\n  toggle(): void {\n    this.#checked = !this.#checked;\n  }\n\n  /**\n   * Activates the switch on Space/Enter for non-native hosts and prevents the\n   * default Space scroll. Bound via `data-action` (keydown). Native `<button>`\n   * hosts are skipped because the browser already turns Space/Enter into a click,\n   * which would otherwise toggle the switch twice.\n   */\n  onKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key must not ALSO toggle the switch —\n    // composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (this.element instanceof HTMLButtonElement) return;\n    if (event.repeat) return;\n    if (event.key === \" \" || event.key === \"Enter\") {\n      event.preventDefault();\n      this.toggle();\n    }\n  }\n\n  /** Whether the switch is currently on. */\n  get #checked(): boolean {\n    return this.element.getAttribute(\"aria-checked\") === \"true\";\n  }\n\n  /** Reflects the new state on `aria-checked` and notifies listeners. */\n  set #checked(value: boolean) {\n    this.element.setAttribute(\"aria-checked\", value ? \"true\" : \"false\");\n    this.dispatch(\"changed\", { detail: { checked: value } });\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/default_attribute.ts","../../src/utils/focus_candidate.ts","../../src/utils/interactive_host.ts","../../src/controllers/switch_controller.ts"],"names":[],"mappings":"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","file":"switch_controller.js","sourcesContent":["/**\n * Adds an attribute default without displacing an authored value.\n *\n * Attribute presence — including an authored empty string — is the ownership\n * boundary. The return value lets a caller remember that it supplied the\n * default when that caller must later restore the authored state.\n *\n * @param element - Element that owns the attribute\n * @param name - Attribute name\n * @param value - Value to write only when the attribute is absent\n * @returns Whether this call added the attribute\n */\nexport function setDefaultAttribute(element: Element, name: string, value: string): boolean {\n  if (element.hasAttribute(name)) return false;\n  element.setAttribute(name, value);\n  return true;\n}\n","/**\n * Whether a disabled `<fieldset>` ancestor actually reaches `control`.\n *\n * HTML exempts the contents of a fieldset's **first direct-child `<legend>`**, and\n * the exemption is per fieldset — a control legal in one legend can still be\n * disabled by a second, outer fieldset, so the walk continues upward.\n *\n * Exported for the consumer that needs this rule *without* the rest of\n * {@link canTakeFocus}: `toolbar` bounds its own `hidden` walk at the toolbar\n * root, which is a different rule, so it composes the two itself.\n */\nexport function inheritsFieldsetDisabled(control: HTMLElement): boolean {\n  let fieldset: Element | null = control.closest(\"fieldset[disabled]\");\n  while (fieldset) {\n    const legend = Array.from(fieldset.children).find((child) => child.tagName === \"LEGEND\");\n    if (!legend?.contains(control)) return true;\n    fieldset = fieldset.parentElement?.closest(\"fieldset[disabled]\") ?? null;\n  }\n  return false;\n}\n\n/**\n * Whether an element can actually take focus, checked **before** `focus()` runs.\n *\n * A controller that must move focus off a control it is about to disable or hide\n * picks a destination and calls `focus()` on it. If that destination cannot take\n * focus, the call **fails silently**: `hidden` and natively `disabled` elements\n * swallow it, so the caret stays in the subtree that is disappearing and lands on\n * `<body>` a frame later — the exact outcome the rescue exists to prevent, minus\n * any signal that it happened.\n *\n * Testing after the fact is the obvious alternative and is deliberately not the\n * rule. Reading `document.activeElement` back only works in a real browser, and\n * looping over candidates that way performs a real focus move per failure —\n * observable to assistive technology. Checking first costs nothing and catches\n * the cases that actually occur.\n *\n * **`aria-disabled` is not disqualifying.** It is the attribute an author uses\n * for a control that must stay *discoverable*, and the roving contract keeps\n * such items reachable. Only the three conditions that make the platform refuse\n * focus are checked: `hidden` (an ancestor's counts), the native `disabled`\n * property, and `disabled` inherited from an ancestor `fieldset`. CSS-only\n * invisibility is not detectable here and stays the consumer's problem.\n *\n * Reading `:disabled` instead of walking the fieldset chain would be shorter, but\n * that pseudo-class is not evaluated consistently outside real browsers and this\n * has to be right headlessly too. happy-dom in particular focuses a `<button>`\n * inside a disabled fieldset where a real engine refuses, so the inheritance is\n * spelled out rather than delegated.\n *\n * What a consumer does when nothing survives is its own call: some fall back to\n * their landmark, while a widget whose caret already sits somewhere legitimate\n * refuses the move outright rather than relocating it.\n *\n * @example\n * ```ts\n * const target = candidates.find(canTakeFocus);\n * if (target) target.focus();\n * else {\n *   this.#tabindex.lend(this.element); // nothing left: fall back to the landmark\n *   this.element.focus();\n * }\n * ```\n *\n * @param element - the candidate destination\n */\nexport function canTakeFocus(element: HTMLElement): boolean {\n  if (element.closest(\"[hidden]\")) return false;\n  if (!(\"disabled\" in element)) return true;\n  if ((element as HTMLElement & { disabled: boolean }).disabled) return false;\n  return !inheritsFieldsetDisabled(element);\n}\n","/**\n * Native interactive elements whose built-in activation must not be replaced\n * wholesale by a controller. Deliberately excludes `[tabindex]`: a generic\n * element made focusable is the supported host for several headless patterns.\n * Contenteditable is handled by {@link isInteractiveHost} because its state is\n * inherited and its keywords are ASCII-case-insensitive.\n */\nexport const INTERACTIVE_HOST_SELECTOR =\n  \"button, input, select, textarea, label, a[href], area[href], summary, details, audio[controls], video[controls], iframe, object, embed\";\n\n/**\n * Whether an element owns native activation or an inherited editing surface.\n *\n * The `contenteditable` missing and invalid states inherit. Walking explicitly\n * also keeps `contenteditable=\"false\"` as a real boundary inside an editable\n * ancestor instead of treating any ancestor attribute as decisive.\n */\nexport function isInteractiveHost(element: HTMLElement): boolean {\n  if (element.matches(INTERACTIVE_HOST_SELECTOR)) return true;\n\n  let current: HTMLElement | null = element;\n  while (current) {\n    const raw = current.getAttribute(\"contenteditable\");\n    if (raw !== null) {\n      const value = raw.trim().toLowerCase();\n      if (value === \"false\") return false;\n      if (value === \"\" || value === \"true\" || value === \"plaintext-only\") return true;\n    }\n    current = current.parentElement;\n  }\n  return false;\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { setDefaultAttribute } from \"../utils/default_attribute\";\nimport { inheritsFieldsetDisabled } from \"../utils/focus_candidate\";\nimport { isInteractiveHost } from \"../utils/interactive_host\";\n\n/** Attributes whose in-place changes can alter the host or its required defaults. */\nconst OBSERVED_ATTRIBUTES = [\n  \"role\",\n  \"aria-checked\",\n  \"tabindex\",\n  \"type\",\n  \"href\",\n  \"contenteditable\",\n  \"controls\",\n];\n\n/** Ancestor attributes whose inherited state can change the supported host. */\nconst OBSERVED_ANCESTOR_ATTRIBUTES = [\"contenteditable\"];\n\n/**\n * Headless, accessible switch (toggle) behavior.\n *\n * Markup contract (identifier: `stimeo--switch`):\n *   <button type=\"button\" data-controller=\"stimeo--switch\"\n *           data-action=\"stimeo--switch#toggle keydown->stimeo--switch#onKeydown\"\n *           role=\"switch\" aria-checked=\"false\">…</button>\n *\n * Implements the WAI-ARIA APG **Switch** pattern. The controller element is the\n * switch itself; its on/off state is reflected solely through `aria-checked`.\n *\n * @remarks\n * Behavior only — the consumer owns all styling (typically keyed off the\n * `[aria-checked=\"true\"]` attribute). On a native `<button>` host, the browser\n * already synthesizes a click for Space/Enter, so {@link onKeydown} leaves the\n * initial key to the browser and suppresses repeated keydowns. Non-button hosts\n * such as `<div role=\"switch\" tabindex=\"0\">` are driven directly. Other native\n * interactive hosts stand down because their checked/navigation semantics would\n * conflict with `aria-checked` as this controller's sole source of truth.\n *\n * Behavior provided:\n * - Click (or Space/Enter) toggles `aria-checked` between `\"true\"` and `\"false\"`.\n * - A `stimeo--switch:changed` event is dispatched on every toggle so the\n *   consumer can react (its `detail.checked` carries the new boolean state).\n */\nexport class SwitchController extends Controller<HTMLElement> {\n  static actions = [\"onKeydown\", \"toggle\"] as const;\n  static events = [\"changed\"] as const;\n\n  /** Defaults this instance introduced and may therefore remove safely. */\n  readonly #ownedDefaults = new Set<string>();\n  /** Controller writes that must not be mistaken for authored morph changes. */\n  readonly #internalAttributeValues = new Map<string, string>();\n\n  readonly #attributeObserver = new MutationObserver((records) => {\n    this.#releaseAuthoredDefaults(records);\n    // Stop observation while restoring defaults so the writes do not schedule a\n    // second, empty callback batch. Re-observe synchronously before returning.\n    this.#attributeObserver.disconnect();\n    this.#reconcileDefaults();\n    this.#observeAttributes();\n  });\n\n  /** Blocks disabled pointer/native-key activation before consumer click handlers. */\n  readonly #onClickCapture = (event: MouseEvent): void => {\n    if (!this.#isSupportedHost || !this.#isActivationDisabled) return;\n    event.preventDefault();\n    event.stopImmediatePropagation();\n  };\n\n  /** Ensures the switch exposes a role and is keyboard-reachable. */\n  override connect(): void {\n    this.#reconcileDefaults();\n    this.element.addEventListener(\"click\", this.#onClickCapture, true);\n    this.#observeAttributes();\n  }\n\n  /** Releases the explicit click guard and retained-element attribute observer. */\n  override disconnect(): void {\n    this.element.removeEventListener(\"click\", this.#onClickCapture, true);\n    this.#attributeObserver.disconnect();\n    this.#internalAttributeValues.clear();\n  }\n\n  /** Toggles the checked state. Bound via `data-action` (click). */\n  toggle(): void {\n    if (!this.#isSupportedHost || this.#isActivationDisabled) return;\n    this.#checked = !this.#checked;\n  }\n\n  /**\n   * Activates the switch on Space/Enter for non-native hosts and suppresses key\n   * repeat. Bound via `data-action` (keydown). A native `<button type=\"button\">`\n   * owns the initial key-to-click synthesis; repeated keydowns are canceled before\n   * the browser can synthesize additional clicks.\n   */\n  onKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key must not ALSO toggle the switch —\n    // composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (!this.#isSupportedHost) return;\n    if (event.key !== \" \" && event.key !== \"Enter\") return;\n    if (this.#isActivationDisabled) {\n      event.preventDefault();\n      event.stopImmediatePropagation();\n      return;\n    }\n    if (this.element instanceof HTMLButtonElement) {\n      if (event.repeat) event.preventDefault();\n      return;\n    }\n    event.preventDefault();\n    if (event.repeat) return;\n    this.toggle();\n  }\n\n  /** Re-adds only missing defaults, preserving every authored attribute value. */\n  #reconcileDefaults(): void {\n    if (!this.#isSupportedHost) {\n      this.#removeOwnedDefaults();\n      return;\n    }\n    this.#setOwnedDefault(\"role\", \"switch\");\n    this.#setOwnedDefault(\"aria-checked\", \"false\");\n    // Native buttons are focusable already; generic hosts need a Tab stop for\n    // the keyboard action above to be reachable.\n    if (!(this.element instanceof HTMLButtonElement)) {\n      this.#setOwnedDefault(\"tabindex\", \"0\");\n    }\n  }\n\n  /** Records a newly introduced default without claiming authored markup. */\n  #setOwnedDefault(name: string, value: string): void {\n    if (setDefaultAttribute(this.element, name, value)) this.#ownedDefaults.add(name);\n  }\n\n  /**\n   * Gives ownership back when a retained-element morph authors a value. Missing\n   * owned attributes stay owned so reconciliation can restore them.\n   */\n  #releaseAuthoredDefaults(records: MutationRecord[]): void {\n    for (const record of records) {\n      if (record.target === this.element) {\n        const name = record.attributeName;\n        if (name && this.#ownedDefaults.has(name)) {\n          const value = this.element.getAttribute(name);\n          if (value !== null && this.#internalAttributeValues.get(name) !== value) {\n            this.#ownedDefaults.delete(name);\n          }\n        }\n      }\n    }\n    this.#internalAttributeValues.clear();\n  }\n\n  /** Removes only defaults introduced by this instance when a host becomes invalid. */\n  #removeOwnedDefaults(): void {\n    for (const name of this.#ownedDefaults) this.element.removeAttribute(name);\n    this.#ownedDefaults.clear();\n    this.#internalAttributeValues.clear();\n  }\n\n  /** Watches retained host attributes that Turbo can morph without reconnecting. */\n  #observeAttributes(): void {\n    this.#attributeObserver.observe(this.element, {\n      attributes: true,\n      attributeFilter: OBSERVED_ATTRIBUTES,\n    });\n    let ancestor = this.element.parentElement;\n    while (ancestor) {\n      this.#attributeObserver.observe(ancestor, {\n        attributes: true,\n        attributeFilter: OBSERVED_ANCESTOR_ATTRIBUTES,\n      });\n      ancestor = ancestor.parentElement;\n    }\n  }\n\n  /** Whether the host has one activation model that this controller can own. */\n  get #isSupportedHost(): boolean {\n    if (this.element instanceof HTMLButtonElement) return this.element.type === \"button\";\n    return !isInteractiveHost(this.element);\n  }\n\n  /** Whether ARIA or native HTML semantics make the supported switch inoperable. */\n  get #isActivationDisabled(): boolean {\n    let current: HTMLElement | null = this.element;\n    while (current) {\n      if (current.getAttribute(\"aria-disabled\") === \"true\") return true;\n      current = current.parentElement;\n    }\n    if (!(this.element instanceof HTMLButtonElement)) return false;\n    return this.element.disabled || inheritsFieldsetDisabled(this.element);\n  }\n\n  /** Whether the switch is currently on. */\n  get #checked(): boolean {\n    return this.element.getAttribute(\"aria-checked\") === \"true\";\n  }\n\n  /** Reflects the new state on `aria-checked` and notifies listeners. */\n  set #checked(value: boolean) {\n    const reflected = value ? \"true\" : \"false\";\n    this.#internalAttributeValues.set(\"aria-checked\", reflected);\n    this.element.setAttribute(\"aria-checked\", reflected);\n    this.dispatch(\"changed\", { detail: { checked: value } });\n  }\n}\n"]}

package/dist/controllers/tags_input_controller.d.ts

@@ -5,19 +5,20 @@ import { Controller } from '@hotwired/stimulus';
  *
  * Markup contract (identifier: `stimeo--tags-input`):
  *   <div data-controller="stimeo--tags-input"
- *        data-stimeo--tags-input-delimiter-value=",">
+ *        data-stimeo--tags-input-delimiter-value=","
+ *        data-stimeo--tags-input-announce-text-value="{label} added; {count} total"
+ *        data-stimeo--tags-input-announce-removed-text-value="{label} removed; {count} total">
  *     <ul role="list" aria-label="Tags" data-stimeo--tags-input-target="tags"></ul>
  *     <input type="text" aria-label="Add tag" aria-describedby="tags-help"
  *            data-stimeo--tags-input-target="input"
  *            data-action="keydown->stimeo--tags-input#onKeydown" />
- *     <span role="status" aria-live="polite" class="visually-hidden"
- *           data-stimeo--tags-input-target="status"></span>
  *     <div data-stimeo--tags-input-target="fields"></div>
  *     <template data-stimeo--tags-input-target="tagTemplate">
  *       <li role="listitem" data-stimeo--tags-input-target="tag">
- *         <span data-tags-input-slot="label"></span>
+ *         <span data-stimeo--tags-input-target="label"></span>
  *         <!-- Removal is delegated on the tags container; no per-chip action needed. -->
- *         <button type="button" tabindex="-1">×</button>
+ *         <button type="button" tabindex="-1" aria-label="Remove {label}"
+ *                 data-stimeo--tags-input-target="remove">×</button>
  *       </li>
  *     </template>
  *   </div>
@@ -31,13 +32,17 @@ import { Controller } from '@hotwired/stimulus';
  * - `Enter` or the configured delimiter commits the trimmed input as a tag.
  * - Empty / duplicate / over-limit additions are rejected with
  *   `stimeo--tags-input:reject`; duplicates are allowed when `allowDuplicates`.
- * - Tags render from the `tagTemplate`, each with a `Remove {label}` button; the
+ * - Tags render transactionally from the `tagTemplate`; its author-localized
+ *   remove-button `aria-label` expands `{label}` / `{value}`. The
  *   `fields` container mirrors the tag set as `name`d hidden inputs for form
- *   submission, and every change dispatches `stimeo--tags-input:change`.
+ *   submission. User changes dispatch `stimeo--tags-input:change`; DOM/Turbo tag
+ *   changes dispatch `stimeo--tags-input:reconcile`; authored templates route
+ *   localized addition/removal text to the shared announcer.
  * - The remove buttons form one roving Tab stop: `ArrowLeft`/`ArrowRight` move
  *   between them (right past the end returns to the input), `Delete`/`Backspace`
  *   delete the focused tag, and `Backspace` on an empty input deletes the last.
- * - Removing a tag moves focus to the neighboring tag, else back to the input.
+ * - Removing from a chip moves focus to its neighbor (else the input); removing
+ *   via empty-input `Backspace` keeps focus in the input for continued editing.
  */
 declare class TagsInputController extends Controller<HTMLElement> {
     #private;
@@ -59,23 +64,34 @@ declare class TagsInputController extends Controller<HTMLElement> {
             type: StringConstructor;
             default: string;
         };
+        announceText: {
+            type: StringConstructor;
+            default: string;
+        };
+        announceRemovedText: {
+            type: StringConstructor;
+            default: string;
+        };
     };
     static actions: readonly ["onKeydown"];
-    static events: readonly ["change", "reject"];
+    static events: readonly ["change", "reconcile", "reject"];
     readonly inputTarget: HTMLInputElement;
     readonly tagsTarget: HTMLElement;
     readonly tagTargets: HTMLElement[];
     readonly tagTemplateTarget: HTMLTemplateElement;
-    readonly statusTarget: HTMLElement;
+    readonly labelTargets: HTMLElement[];
+    readonly removeTargets: HTMLButtonElement[];
     readonly fieldsTarget: HTMLElement;
-    readonly hasStatusTarget: boolean;
     readonly hasFieldsTarget: boolean;
     readonly hasTagTemplateTarget: boolean;
     readonly hasInputTarget: boolean;
+    readonly hasTagsTarget: boolean;
     delimiterValue: string;
     maxValue: number;
     allowDuplicatesValue: boolean;
     nameValue: string;
+    announceTextValue: string;
+    announceRemovedTextValue: string;
     /** Wires tag-list keyboard navigation and removal, and seeds the single Tab stop. */
     connect(): void;
     /** Releases the delegated listeners so no handler outlives the element. */
@@ -84,6 +100,20 @@ declare class TagsInputController extends Controller<HTMLElement> {
     inputTargetConnected(input: HTMLInputElement): void;
     /** Removes composition listeners when the active input is replaced or removed. */
     inputTargetDisconnected(input: HTMLInputElement): void;
+    /** Rebinds delegation and derived state when the tags container is replaced. */
+    tagsTargetConnected(_tags: HTMLElement): void;
+    /** Releases only the row that disconnected, leaving a newer target intact. */
+    tagsTargetDisconnected(tags: HTMLElement): void;
+    /** Reconciles a tag inserted by Turbo, a server render, or another controller. */
+    tagTargetConnected(_tag: HTMLElement): void;
+    /** Reconciles a tag removed by Turbo, a server render, or another controller. */
+    tagTargetDisconnected(_tag: HTMLElement): void;
+    /** Seeds a fields target inserted after connect. */
+    fieldsTargetConnected(): void;
+    /** Rebuilds submitted fields when the public name changes at runtime. */
+    nameValueChanged(): void;
+    /** Recomputes the full hook when the cap changes at runtime. */
+    maxValueChanged(): void;
     /** Commits on `Enter`/delimiter and deletes the last tag on empty `Backspace`. */
     onKeydown(event: KeyboardEvent): void;
 }