stimeo-ui 0.2.0 → 0.3.0

package/dist/controllers/tags_input_controller.d.ts

@@ -0,0 +1,91 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible free-input tags / chips field.
+ *
+ * Markup contract (identifier: `stimeo--tags-input`):
+ *   <div data-controller="stimeo--tags-input"
+ *        data-stimeo--tags-input-delimiter-value=",">
+ *     <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>
+ *         <!-- Removal is delegated on the tags container; no per-chip action needed. -->
+ *         <button type="button" tabindex="-1">×</button>
+ *       </li>
+ *     </template>
+ *   </div>
+ *
+ * There is no single established APG pattern; this composes a labeled text input
+ * with a roving-tabindex list of removable chips, mapping to WCAG 2.1.1, 2.4.7,
+ * 4.1.2, 4.1.3, and 1.3.1. Unlike {@link MultiSelectController} (pick from a
+ * candidate list) the user types arbitrary strings.
+ *
+ * Behavior provided:
+ * - `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
+ *   `fields` container mirrors the tag set as `name`d hidden inputs for form
+ *   submission, and every change dispatches `stimeo--tags-input:change`.
+ * - 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.
+ */
+declare class TagsInputController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        delimiter: {
+            type: StringConstructor;
+            default: string;
+        };
+        max: {
+            type: NumberConstructor;
+            default: number;
+        };
+        allowDuplicates: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        name: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["onKeydown"];
+    static events: readonly ["change", "reject"];
+    readonly inputTarget: HTMLInputElement;
+    readonly tagsTarget: HTMLElement;
+    readonly tagTargets: HTMLElement[];
+    readonly tagTemplateTarget: HTMLTemplateElement;
+    readonly statusTarget: HTMLElement;
+    readonly fieldsTarget: HTMLElement;
+    readonly hasStatusTarget: boolean;
+    readonly hasFieldsTarget: boolean;
+    readonly hasTagTemplateTarget: boolean;
+    readonly hasInputTarget: boolean;
+    delimiterValue: string;
+    maxValue: number;
+    allowDuplicatesValue: boolean;
+    nameValue: 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. */
+    disconnect(): void;
+    /** Tracks an input added initially or after connect. */
+    inputTargetConnected(input: HTMLInputElement): void;
+    /** Removes composition listeners when the active input is replaced or removed. */
+    inputTargetDisconnected(input: HTMLInputElement): void;
+    /** Commits on `Enter`/delimiter and deletes the last tag on empty `Backspace`. */
+    onKeydown(event: KeyboardEvent): void;
+}
+
+export { TagsInputController };

package/dist/controllers/tags_input_controller.js

@@ -0,0 +1,295 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/tags_input_controller.ts
+
+// src/utils/logical_scroll.ts
+function isRtl(element) {
+  return window.getComputedStyle(element).direction === "rtl";
+}
+
+// src/utils/arrow_step.ts
+function logicalArrowKey(key, element) {
+  if (key !== "ArrowRight" && key !== "ArrowLeft") return key;
+  if (!isRtl(element)) return key;
+  return key === "ArrowRight" ? "ArrowLeft" : "ArrowRight";
+}
+function isReservedArrowChord(event, allow = []) {
+  if (!event.key.startsWith("Arrow")) return false;
+  return event.altKey && !allow.includes("alt") || event.ctrlKey && !allow.includes("ctrl") || event.metaKey && !allow.includes("meta") || event.shiftKey && !allow.includes("shift");
+}
+
+// src/utils/composition_tracker.ts
+var CompositionTracker = class {
+  #observedTargets = /* @__PURE__ */ new Set();
+  #activeTargets = /* @__PURE__ */ new Set();
+  #onStart;
+  #onEnd;
+  constructor(options = {}) {
+    this.#onStart = options.onStart;
+    this.#onEnd = options.onEnd;
+  }
+  /** Starts lifecycle tracking for `target`; repeated calls are idempotent. */
+  observe(target) {
+    if (this.#observedTargets.has(target)) return;
+    target.addEventListener("compositionstart", this.#handleStart);
+    target.addEventListener("compositionend", this.#handleEnd);
+    this.#observedTargets.add(target);
+  }
+  /** Stops tracking one target and clears any active composition it owned. */
+  unobserve(target) {
+    if (!this.#observedTargets.delete(target)) return;
+    target.removeEventListener("compositionstart", this.#handleStart);
+    target.removeEventListener("compositionend", this.#handleEnd);
+    this.#activeTargets.delete(target);
+  }
+  /** Releases every listener and clears state so reconnect starts cleanly. */
+  disconnect() {
+    for (const target of this.#observedTargets) {
+      target.removeEventListener("compositionstart", this.#handleStart);
+      target.removeEventListener("compositionend", this.#handleEnd);
+    }
+    this.#observedTargets.clear();
+    this.#activeTargets.clear();
+  }
+  /** True when lifecycle tracking or the current event reports composition. */
+  isComposing(event) {
+    return this.#activeTargets.size > 0 || event?.isComposing === true;
+  }
+  #handleStart = (event) => {
+    if (event.currentTarget) this.#activeTargets.add(event.currentTarget);
+    this.#onStart?.(event);
+  };
+  #handleEnd = (event) => {
+    if (event.currentTarget) this.#activeTargets.delete(event.currentTarget);
+    this.#onEnd?.(event);
+  };
+};
+
+// src/utils/roving_tabindex.ts
+var RovingTabindex = class {
+  /** Returns the current ordered item elements; called on every operation. */
+  #getItems;
+  /**
+   * @param getItems - Returns the current ordered item elements. Called on every
+   *   operation so the live target list is always used.
+   */
+  constructor(getItems) {
+    this.#getItems = getItems;
+  }
+  /** Index of the currently tabbable item (`tabindex="0"`), or `-1` if none. */
+  get activeIndex() {
+    return this.#getItems().findIndex((item) => item.tabIndex === 0);
+  }
+  /**
+   * Makes exactly the item at `index` tabbable (`tabindex="0"`) and removes every
+   * other item from the Tab sequence (`tabindex="-1"`). An out-of-range `index`
+   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express
+   * "nothing is currently tabbable".
+   *
+   * @param index - Position of the item to make tabbable.
+   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.
+   */
+  setActive(index, { focus = false } = {}) {
+    const items = this.#getItems();
+    items.forEach((item, i) => {
+      item.tabIndex = i === index ? 0 : -1;
+    });
+    if (focus) items[index]?.focus();
+  }
+};
+
+// src/controllers/tags_input_controller.ts
+var TagsInputController = class extends Controller {
+  static targets = ["input", "tags", "tag", "tagTemplate", "status", "fields"];
+  static values = {
+    delimiter: { type: String, default: "," },
+    max: { type: Number, default: 0 },
+    allowDuplicates: { type: Boolean, default: false },
+    name: { type: String, default: "tags[]" }
+  };
+  static actions = ["onKeydown"];
+  static events = ["change", "reject"];
+  #roving = new RovingTabindex(() => this.#removeButtons);
+  /** Owns IME lifecycle state for commit-key guarding. */
+  #composition = new CompositionTracker();
+  /** Wires tag-list keyboard navigation and removal, and seeds the single Tab stop. */
+  connect() {
+    if (this.hasInputTarget) this.#composition.observe(this.inputTarget);
+    this.tagsTarget.addEventListener("keydown", this.#onTagKeydown);
+    this.tagsTarget.addEventListener("click", this.#onTagClick);
+    this.#syncState();
+  }
+  /** Releases the delegated listeners so no handler outlives the element. */
+  disconnect() {
+    this.#composition.disconnect();
+    this.tagsTarget.removeEventListener("keydown", this.#onTagKeydown);
+    this.tagsTarget.removeEventListener("click", this.#onTagClick);
+  }
+  /** Tracks an input added initially or after connect. */
+  inputTargetConnected(input) {
+    this.#composition.observe(input);
+  }
+  /** Removes composition listeners when the active input is replaced or removed. */
+  inputTargetDisconnected(input) {
+    this.#composition.unobserve(input);
+  }
+  /** Commits on `Enter`/delimiter and deletes the last tag on empty `Backspace`. */
+  onKeydown(event) {
+    if (event.defaultPrevented) return;
+    if (isReservedArrowChord(event)) return;
+    if (this.#composition.isComposing(event)) return;
+    if (event.key === "Enter" || event.key === this.delimiterValue) {
+      event.preventDefault();
+      this.#commitInput();
+      return;
+    }
+    if (event.key === "Backspace" && this.inputTarget.value === "") {
+      const buttons = this.#removeButtons;
+      if (buttons.length > 0) {
+        event.preventDefault();
+        this.#removeAt(buttons.length - 1);
+      }
+      return;
+    }
+    if (logicalArrowKey(event.key, this.element) === "ArrowLeft" && this.inputTarget.value === "") {
+      const buttons = this.#removeButtons;
+      if (buttons.length > 0) {
+        event.preventDefault();
+        this.#roving.setActive(buttons.length - 1, { focus: true });
+      }
+    }
+  }
+  /**
+   * Deletes the tag whose remove button was clicked. Delegated on the tags
+   * container (like `#onTagKeydown`) rather than bound per chip via
+   * `data-action`, so it works the instant a chip is appended without waiting on
+   * Stimulus to wire a freshly created element.
+   */
+  #onTagClick = (event) => {
+    const button = event.target.closest("button");
+    if (!button || !this.tagsTarget.contains(button)) return;
+    const index = this.#removeButtons.indexOf(button);
+    if (index !== -1) this.#removeAt(index);
+  };
+  /** Validates and adds the current input value as a tag, then clears the input. */
+  #commitInput() {
+    const value = this.inputTarget.value.trim();
+    if (value === "") {
+      this.#reject(value, "empty");
+      return;
+    }
+    if (this.maxValue > 0 && this.tagTargets.length >= this.maxValue) {
+      this.#reject(value, "max");
+      return;
+    }
+    if (!this.allowDuplicatesValue && this.#values.includes(value)) {
+      this.#reject(value, "duplicate");
+      return;
+    }
+    this.#appendTag(value);
+    this.inputTarget.value = "";
+    this.#announce(value);
+    this.#syncState();
+    this.dispatch("change", { detail: { tags: this.#values } });
+  }
+  /** Builds one chip from the template and appends it to the tag list. */
+  #appendTag(value) {
+    if (!this.hasTagTemplateTarget) return;
+    const fragment = this.tagTemplateTarget.content.cloneNode(true);
+    const tag = fragment.querySelector('[data-stimeo--tags-input-target="tag"]');
+    const label = fragment.querySelector('[data-tags-input-slot="label"]');
+    const button = fragment.querySelector("button");
+    if (!tag || !button) return;
+    tag.dataset.value = value;
+    if (label) label.textContent = value;
+    button.setAttribute("aria-label", `Remove ${value}`);
+    button.tabIndex = -1;
+    this.tagsTarget.appendChild(fragment);
+  }
+  /** Removes the tag at `index`, then moves focus to a neighbor or the input. */
+  #removeAt(index) {
+    const tag = this.tagTargets[index];
+    if (!tag) return;
+    const value = tag.dataset.value ?? "";
+    tag.remove();
+    this.#announce(value);
+    this.#syncState();
+    this.dispatch("change", { detail: { tags: this.#values } });
+    const remaining = this.#removeButtons;
+    if (remaining.length === 0) {
+      this.inputTarget.focus();
+    } else {
+      this.#roving.setActive(Math.min(index, remaining.length - 1), { focus: true });
+    }
+  }
+  /** Handles arrow navigation and deletion within the chip list (delegated). */
+  #onTagKeydown = (event) => {
+    if (event.defaultPrevented) return;
+    if (isReservedArrowChord(event)) return;
+    const button = event.target.closest("button");
+    if (!button) return;
+    const buttons = this.#removeButtons;
+    const index = buttons.indexOf(button);
+    if (index === -1) return;
+    switch (logicalArrowKey(event.key, this.element)) {
+      case "ArrowLeft":
+        if (index > 0) {
+          event.preventDefault();
+          this.#roving.setActive(index - 1, { focus: true });
+        }
+        break;
+      case "ArrowRight":
+        event.preventDefault();
+        if (index < buttons.length - 1) {
+          this.#roving.setActive(index + 1, { focus: true });
+        } else {
+          this.inputTarget.focus();
+        }
+        break;
+      case "Delete":
+      case "Backspace":
+        event.preventDefault();
+        this.#removeAt(index);
+        break;
+    }
+  };
+  /** Rebuilds the hidden form fields, the `full` flag, and the roving Tab stop. */
+  #syncState() {
+    if (this.hasFieldsTarget) {
+      this.fieldsTarget.replaceChildren(
+        ...this.#values.map((value) => {
+          const input = document.createElement("input");
+          input.type = "hidden";
+          input.name = this.nameValue;
+          input.value = value;
+          return input;
+        })
+      );
+    }
+    const full = this.maxValue > 0 && this.tagTargets.length >= this.maxValue;
+    this.element.toggleAttribute("data-stimeo--tags-input-full", full);
+    if (this.#removeButtons.length > 0 && this.#roving.activeIndex === -1) {
+      this.#roving.setActive(0);
+    }
+  }
+  /** Mirrors the changed tag into the live region for assistive tech. */
+  #announce(value) {
+    if (this.hasStatusTarget) this.statusTarget.textContent = value;
+  }
+  /** Reports a rejected addition via `stimeo--tags-input:reject`. */
+  #reject(value, reason) {
+    this.dispatch("reject", { detail: { value, reason } });
+  }
+  /** The remove buttons in document order (the roving navigation set). */
+  get #removeButtons() {
+    return Array.from(this.tagsTarget.querySelectorAll("button"));
+  }
+  /** Current tag values in order. */
+  get #values() {
+    return this.tagTargets.map((tag) => tag.dataset.value ?? "");
+  }
+};
+
+export { TagsInputController };
+//# sourceMappingURL=tags_input_controller.js.map
+//# sourceMappingURL=tags_input_controller.js.map

package/dist/controllers/tags_input_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logical_scroll.ts","../../src/utils/arrow_step.ts","../../src/utils/composition_tracker.ts","../../src/utils/roving_tabindex.ts","../../src/controllers/tags_input_controller.ts"],"names":[],"mappings":"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","file":"tags_input_controller.js","sourcesContent":["/** Normalized scroll position and maximum distance on one logical axis. */\nexport interface LogicalScrollMetrics {\n  position: number;\n  max: number;\n}\n\n/**\n * Whether horizontal scrolling on `element` follows right-to-left inline flow.\n *\n * Resolved from the **computed** `direction`, so the authoring contract is the\n * usual `dir=\"rtl\"` (or a stylesheet) on the element or any ancestor.\n *\n * Scope: horizontal writing modes. A vertical writing mode (`writing-mode:\n * vertical-rl`) also inverts the horizontal axis, which this check does not\n * model — vertical writing modes are out of scope for the scroll utilities\n * (their consumers describe axes as horizontal/vertical, not inline/block).\n */\nexport function isRtl(element: Element): boolean {\n  return window.getComputedStyle(element).direction === \"rtl\";\n}\n\n/**\n * Returns scroll distance from the logical start edge.\n *\n * CSSOM View exposes standards-mode RTL horizontal offsets as `0` at the inline\n * start (right) and increasingly negative values toward the inline end (left).\n * The normalized position is always clamped to `[0, max]`, which also absorbs\n * Safari's elastic overscroll values.\n */\nexport function logicalScrollMetrics(\n  element: HTMLElement,\n  horizontal: boolean,\n): LogicalScrollMetrics {\n  const max = Math.max(\n    0,\n    horizontal\n      ? element.scrollWidth - element.clientWidth\n      : element.scrollHeight - element.clientHeight,\n  );\n  const raw = horizontal ? element.scrollLeft : element.scrollTop;\n  const position = horizontal && isRtl(element) ? -raw : raw;\n  return { position: Math.min(max, Math.max(0, position)), max };\n}\n\n/**\n * Converts a logical start/end delta to the physical value accepted by\n * `Element.scrollBy`.\n */\nexport function physicalScrollDelta(\n  element: HTMLElement,\n  horizontal: boolean,\n  logicalDelta: number,\n): number {\n  return horizontal && isRtl(element) ? -logicalDelta : logicalDelta;\n}\n","import { isRtl } from \"./logical_scroll\";\n\n/**\n * Turns an arrow key into a **logical** step: `+1` for \"next\", `-1` for\n * \"previous\", `0` when the key names neither.\n *\n * APG defines the horizontal pair as *next / previous* and says a vertical\n * arrangement swaps in Down/Up for the same meaning — so the pair is one axis's\n * spelling of an order, and the order reverses with the writing direction. Only\n * the horizontal pair reverses. Down/Up name an axis the writing direction does\n * not mirror, and returning them unchanged is the point: many controllers fold\n * both pairs into one branch, where swapping the branches under RTL would flip\n * the vertical axis too — a bug that reads as \"the arrows work\" until someone\n * presses Down.\n *\n * **Direction is read from the element the caller passes, which should be the\n * container that lays the items out** — not the focused child. A child may carry\n * its own `dir` (an LTR input inside an RTL form is ordinary authoring), and\n * probing per handler makes two handlers disagree at the boundary between them.\n *\n * This decides direction only. Whether the axis is even active (an\n * `orientation=\"horizontal\"` widget ignoring Down/Up), how far the step lands,\n * and what wrapping does all stay with the caller.\n *\n * **It encodes the list-order convention: `ArrowDown` is *next*.** Widgets that\n * pair the arrows by *value* instead — `ArrowUp` meaning \"more\", as a rating or a\n * slider does — must not use this, or their vertical axis inverts. Reverse the\n * horizontal pair on its own there.\n *\n * @example\n * ```ts\n * const step = logicalArrowStep(event.key, this.element);\n * if (step === 0) return;\n * this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n * ```\n */\nexport function logicalArrowStep(key: string, element: Element): 1 | -1 | 0 {\n  if (key === \"ArrowDown\") return 1;\n  if (key === \"ArrowUp\") return -1;\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = isRtl(element) ? \"ArrowLeft\" : \"ArrowRight\";\n  return key === forward ? 1 : -1;\n}\n\n/**\n * Rewrites `key` so an existing LTR-shaped branch keeps working under RTL:\n * `ArrowRight` and `ArrowLeft` trade places, everything else passes through.\n *\n * The alternative — negating a delta — silently breaks handlers whose two\n * horizontal branches are **not mirror images**. A grid that clamps one edge but\n * not the other, or a segmented field guarding `index > 0` on one side and\n * `index < length - 1` on the other, ends up applying the wrong guard to the\n * wrong direction. Swapping the key leaves each branch, guards and all, exactly\n * where its author put it.\n *\n * Same rule as {@link logicalArrowStep} about which element to read: pass the\n * container that lays the items out, not the focused child.\n *\n * @example\n * ```ts\n * switch (logicalArrowKey(event.key, this.element)) {\n *   case \"ArrowLeft\": // \"previous\" — whatever direction that is on screen\n * ```\n */\nexport function logicalArrowKey(key: string, element: Element): string {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return key;\n  if (!isRtl(element)) return key;\n  return key === \"ArrowRight\" ? \"ArrowLeft\" : \"ArrowRight\";\n}\n\n/** Modifiers a widget may claim on an arrow key, named for the `allow` list. */\nexport type ArrowModifier = \"alt\" | \"ctrl\" | \"meta\" | \"shift\";\n\n/**\n * True when an arrow key arrived carrying a modifier the widget must leave to\n * the browser: return without calling `preventDefault()` and without moving any\n * state.\n *\n * A bare arrow belongs to the widget; a chorded one usually does not.\n * `Alt`/`Meta` plus a horizontal arrow is history back/forward on every desktop\n * browser, and a widget that swallows it makes the shortcut work or not\n * depending on where focus happens to sit — a coin-flip the user cannot see.\n *\n * `allow` is for the combinations APG assigns to a pattern **and the widget\n * actually implements** — today only Combobox's optional `Alt+Down`/`Alt+Up`.\n * Listing one the widget does not implement defeats the point: the chord then\n * runs the plain-arrow branch, which is exactly what this guard exists to stop.\n * Non-arrow keys return `false`, so chorded letters and\n * `Control+Home`/`Control+End` are untouched.\n *\n * @example\n * ```ts\n * if (isReservedArrowChord(event)) return;\n * ```\n */\nexport function isReservedArrowChord(\n  event: KeyboardEvent,\n  allow: readonly ArrowModifier[] = [],\n): boolean {\n  if (!event.key.startsWith(\"Arrow\")) return false;\n  return (\n    (event.altKey && !allow.includes(\"alt\")) ||\n    (event.ctrlKey && !allow.includes(\"ctrl\")) ||\n    (event.metaKey && !allow.includes(\"meta\")) ||\n    (event.shiftKey && !allow.includes(\"shift\"))\n  );\n}\n","/** Minimal event shape carrying the platform's per-event composition signal. */\nexport interface CompositionSignal {\n  readonly isComposing?: boolean;\n}\n\n/** Hooks that keep component-specific work outside {@link CompositionTracker}. */\nexport interface CompositionTrackerOptions {\n  /** Runs after lifecycle state is set for a `compositionstart` event. */\n  readonly onStart?: (event: Event) => void;\n  /** Runs after lifecycle state is cleared for a `compositionend` event. */\n  readonly onEnd?: (event: Event) => void;\n}\n\n/**\n * Owns IME composition listeners and transient state for one or more event targets.\n *\n * Some browsers omit `KeyboardEvent.isComposing` on the keydown that confirms a\n * conversion. Tracking `compositionstart` through `compositionend` supplies the\n * missing lifecycle signal without relying on deprecated numeric key codes.\n * Component policy stays with the consumer: filtering, validation, and submission\n * belong in the optional {@link CompositionTrackerOptions.onEnd} callback.\n *\n * @example\n * ```ts\n * #composition = new CompositionTracker({ onEnd: () => this.filter() });\n *\n * connect(): void {\n *   this.#composition.observe(this.inputTarget);\n * }\n *\n * disconnect(): void {\n *   this.#composition.disconnect();\n * }\n *\n * onKeydown(event: KeyboardEvent): void {\n *   if (this.#composition.isComposing(event)) return;\n * }\n * ```\n */\nexport class CompositionTracker {\n  readonly #observedTargets = new Set<EventTarget>();\n  readonly #activeTargets = new Set<EventTarget>();\n  readonly #onStart: ((event: Event) => void) | undefined;\n  readonly #onEnd: ((event: Event) => void) | undefined;\n\n  constructor(options: CompositionTrackerOptions = {}) {\n    this.#onStart = options.onStart;\n    this.#onEnd = options.onEnd;\n  }\n\n  /** Starts lifecycle tracking for `target`; repeated calls are idempotent. */\n  observe(target: EventTarget): void {\n    if (this.#observedTargets.has(target)) return;\n    target.addEventListener(\"compositionstart\", this.#handleStart);\n    target.addEventListener(\"compositionend\", this.#handleEnd);\n    this.#observedTargets.add(target);\n  }\n\n  /** Stops tracking one target and clears any active composition it owned. */\n  unobserve(target: EventTarget): void {\n    if (!this.#observedTargets.delete(target)) return;\n    target.removeEventListener(\"compositionstart\", this.#handleStart);\n    target.removeEventListener(\"compositionend\", this.#handleEnd);\n    this.#activeTargets.delete(target);\n  }\n\n  /** Releases every listener and clears state so reconnect starts cleanly. */\n  disconnect(): void {\n    for (const target of this.#observedTargets) {\n      target.removeEventListener(\"compositionstart\", this.#handleStart);\n      target.removeEventListener(\"compositionend\", this.#handleEnd);\n    }\n    this.#observedTargets.clear();\n    this.#activeTargets.clear();\n  }\n\n  /** True when lifecycle tracking or the current event reports composition. */\n  isComposing(event?: CompositionSignal): boolean {\n    return this.#activeTargets.size > 0 || event?.isComposing === true;\n  }\n\n  readonly #handleStart = (event: Event): void => {\n    if (event.currentTarget) this.#activeTargets.add(event.currentTarget);\n    this.#onStart?.(event);\n  };\n\n  readonly #handleEnd = (event: Event): void => {\n    if (event.currentTarget) this.#activeTargets.delete(event.currentTarget);\n    this.#onEnd?.(event);\n  };\n}\n","/**\n * Low-level roving-tabindex primitive shared by composite-widget controllers.\n *\n * The APG roving-tabindex pattern keeps a composite widget a single Tab stop:\n * exactly one item is in the Tab sequence (`tabindex=\"0\"`) while the rest are\n * removed from it (`tabindex=\"-1\"`), and the arrow keys move both DOM focus and\n * that single tabbable position together. {@link RovingTabindex} owns *only* that\n * mechanical bookkeeping — \"which one item is tabbable, and move focus there\".\n *\n * It is intentionally **policy-free**. Orientation, wrapping vs. clamping,\n * selection-follows-focus, typeahead, and `Home`/`End` semantics differ per APG\n * pattern (Radio Group, Toolbar, Rating, …); folding them into one helper would\n * flatten those widgets to a lowest common denominator and lose each pattern's\n * correctness. Those decisions therefore stay in each controller, which calls\n * {@link RovingTabindex.setActive} with an index it computed itself (optionally\n * via the pure {@link rovingMove} helper).\n *\n * @remarks\n * Items are read lazily through a getter so a controller can add or remove\n * targets (Stimulus re-scans the DOM) without re-wiring this helper.\n */\nexport class RovingTabindex {\n  /** Returns the current ordered item elements; called on every operation. */\n  readonly #getItems: () => HTMLElement[];\n\n  /**\n   * @param getItems - Returns the current ordered item elements. Called on every\n   *   operation so the live target list is always used.\n   */\n  constructor(getItems: () => HTMLElement[]) {\n    this.#getItems = getItems;\n  }\n\n  /** Index of the currently tabbable item (`tabindex=\"0\"`), or `-1` if none. */\n  get activeIndex(): number {\n    return this.#getItems().findIndex((item) => item.tabIndex === 0);\n  }\n\n  /**\n   * Makes exactly the item at `index` tabbable (`tabindex=\"0\"`) and removes every\n   * other item from the Tab sequence (`tabindex=\"-1\"`). An out-of-range `index`\n   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express\n   * \"nothing is currently tabbable\".\n   *\n   * @param index - Position of the item to make tabbable.\n   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.\n   */\n  setActive(index: number, { focus = false }: { focus?: boolean } = {}): void {\n    const items = this.#getItems();\n    items.forEach((item, i) => {\n      item.tabIndex = i === index ? 0 : -1;\n    });\n    if (focus) items[index]?.focus();\n  }\n}\n\n/** Edge behavior for {@link rovingMove}: cycle past the ends, or stop at them. */\nexport type RovingWrap = \"wrap\" | \"clamp\";\n\n/**\n * Pure helper that resolves the target index for a one-step directional move.\n *\n * Keyboard/orientation mapping stays in the caller: it decides that a key means\n * `delta` `+1` (next) or `-1` (previous) and whether the widget should `\"wrap\"`\n * (Radio Group, Toolbar) or `\"clamp\"` at the ends.\n *\n * @param current - The index focus is moving from.\n * @param length - Number of items in the set.\n * @param delta - `+1` to move to the next item, `-1` for the previous.\n * @param wrap - `\"wrap\"` cycles around the ends; `\"clamp\"` stops at them.\n * @returns The resolved index, or `-1` when there are no items.\n */\nexport function rovingMove(\n  current: number,\n  length: number,\n  delta: number,\n  wrap: RovingWrap,\n): number {\n  if (length === 0) return -1;\n  const next = current + delta;\n  if (wrap === \"wrap\") return (next + length) % length;\n  return Math.min(length - 1, Math.max(0, next));\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { isReservedArrowChord, logicalArrowKey } from \"../utils/arrow_step\";\nimport { CompositionTracker } from \"../utils/composition_tracker\";\nimport { RovingTabindex } from \"../utils/roving_tabindex\";\n\n/**\n * Headless, accessible free-input tags / chips field.\n *\n * Markup contract (identifier: `stimeo--tags-input`):\n *   <div data-controller=\"stimeo--tags-input\"\n *        data-stimeo--tags-input-delimiter-value=\",\">\n *     <ul role=\"list\" aria-label=\"Tags\" data-stimeo--tags-input-target=\"tags\"></ul>\n *     <input type=\"text\" aria-label=\"Add tag\" aria-describedby=\"tags-help\"\n *            data-stimeo--tags-input-target=\"input\"\n *            data-action=\"keydown->stimeo--tags-input#onKeydown\" />\n *     <span role=\"status\" aria-live=\"polite\" class=\"visually-hidden\"\n *           data-stimeo--tags-input-target=\"status\"></span>\n *     <div data-stimeo--tags-input-target=\"fields\"></div>\n *     <template data-stimeo--tags-input-target=\"tagTemplate\">\n *       <li role=\"listitem\" data-stimeo--tags-input-target=\"tag\">\n *         <span data-tags-input-slot=\"label\"></span>\n *         <!-- Removal is delegated on the tags container; no per-chip action needed. -->\n *         <button type=\"button\" tabindex=\"-1\">×</button>\n *       </li>\n *     </template>\n *   </div>\n *\n * There is no single established APG pattern; this composes a labeled text input\n * with a roving-tabindex list of removable chips, mapping to WCAG 2.1.1, 2.4.7,\n * 4.1.2, 4.1.3, and 1.3.1. Unlike {@link MultiSelectController} (pick from a\n * candidate list) the user types arbitrary strings.\n *\n * Behavior provided:\n * - `Enter` or the configured delimiter commits the trimmed input as a tag.\n * - Empty / duplicate / over-limit additions are rejected with\n *   `stimeo--tags-input:reject`; duplicates are allowed when `allowDuplicates`.\n * - Tags render from the `tagTemplate`, each with a `Remove {label}` button; the\n *   `fields` container mirrors the tag set as `name`d hidden inputs for form\n *   submission, and every change dispatches `stimeo--tags-input:change`.\n * - The remove buttons form one roving Tab stop: `ArrowLeft`/`ArrowRight` move\n *   between them (right past the end returns to the input), `Delete`/`Backspace`\n *   delete the focused tag, and `Backspace` on an empty input deletes the last.\n * - Removing a tag moves focus to the neighboring tag, else back to the input.\n */\nexport class TagsInputController extends Controller<HTMLElement> {\n  static override targets = [\"input\", \"tags\", \"tag\", \"tagTemplate\", \"status\", \"fields\"];\n  static override values = {\n    delimiter: { type: String, default: \",\" },\n    max: { type: Number, default: 0 },\n    allowDuplicates: { type: Boolean, default: false },\n    name: { type: String, default: \"tags[]\" },\n  };\n  static actions = [\"onKeydown\"] as const;\n  static events = [\"change\", \"reject\"] as const;\n\n  declare readonly inputTarget: HTMLInputElement;\n  declare readonly tagsTarget: HTMLElement;\n  declare readonly tagTargets: HTMLElement[];\n  declare readonly tagTemplateTarget: HTMLTemplateElement;\n  declare readonly statusTarget: HTMLElement;\n  declare readonly fieldsTarget: HTMLElement;\n  declare readonly hasStatusTarget: boolean;\n  declare readonly hasFieldsTarget: boolean;\n  declare readonly hasTagTemplateTarget: boolean;\n  declare readonly hasInputTarget: boolean;\n\n  declare delimiterValue: string;\n  declare maxValue: number;\n  declare allowDuplicatesValue: boolean;\n  declare nameValue: string;\n\n  readonly #roving = new RovingTabindex(() => this.#removeButtons);\n  /** Owns IME lifecycle state for commit-key guarding. */\n  readonly #composition = new CompositionTracker();\n\n  /** Wires tag-list keyboard navigation and removal, and seeds the single Tab stop. */\n  override connect(): void {\n    if (this.hasInputTarget) this.#composition.observe(this.inputTarget);\n    this.tagsTarget.addEventListener(\"keydown\", this.#onTagKeydown);\n    this.tagsTarget.addEventListener(\"click\", this.#onTagClick);\n    this.#syncState();\n  }\n\n  /** Releases the delegated listeners so no handler outlives the element. */\n  override disconnect(): void {\n    this.#composition.disconnect();\n    this.tagsTarget.removeEventListener(\"keydown\", this.#onTagKeydown);\n    this.tagsTarget.removeEventListener(\"click\", this.#onTagClick);\n  }\n\n  /** Tracks an input added initially or after connect. */\n  inputTargetConnected(input: HTMLInputElement): void {\n    this.#composition.observe(input);\n  }\n\n  /** Removes composition listeners when the active input is replaced or removed. */\n  inputTargetDisconnected(input: HTMLInputElement): void {\n    this.#composition.unobserve(input);\n  }\n\n  /** Commits on `Enter`/delimiter and deletes the last tag on empty `Backspace`. */\n  onKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key must not ALSO commit a tag\n    // or reach into the chips — composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (isReservedArrowChord(event)) return;\n    // Ignore keys fired during IME composition: the `Enter` that confirms a\n    // candidate (and arrows that move within it) must not commit/navigate the\n    // chip list. Controller-owned lifecycle state covers confirming events that\n    // omit the standard per-event signal.\n    if (this.#composition.isComposing(event)) return;\n    if (event.key === \"Enter\" || event.key === this.delimiterValue) {\n      event.preventDefault();\n      this.#commitInput();\n      return;\n    }\n    if (event.key === \"Backspace\" && this.inputTarget.value === \"\") {\n      const buttons = this.#removeButtons;\n      if (buttons.length > 0) {\n        event.preventDefault();\n        this.#removeAt(buttons.length - 1);\n      }\n      return;\n    }\n    // Same normalisation as the chip handler below, read from the same element.\n    if (logicalArrowKey(event.key, this.element) === \"ArrowLeft\" && this.inputTarget.value === \"\") {\n      const buttons = this.#removeButtons;\n      if (buttons.length > 0) {\n        event.preventDefault();\n        this.#roving.setActive(buttons.length - 1, { focus: true });\n      }\n    }\n  }\n\n  /**\n   * Deletes the tag whose remove button was clicked. Delegated on the tags\n   * container (like `#onTagKeydown`) rather than bound per chip via\n   * `data-action`, so it works the instant a chip is appended without waiting on\n   * Stimulus to wire a freshly created element.\n   */\n  readonly #onTagClick = (event: MouseEvent): void => {\n    const button = (event.target as HTMLElement).closest(\"button\");\n    if (!button || !this.tagsTarget.contains(button)) return;\n    const index = this.#removeButtons.indexOf(button as HTMLButtonElement);\n    if (index !== -1) this.#removeAt(index);\n  };\n\n  /** Validates and adds the current input value as a tag, then clears the input. */\n  #commitInput(): void {\n    const value = this.inputTarget.value.trim();\n    if (value === \"\") {\n      this.#reject(value, \"empty\");\n      return;\n    }\n    if (this.maxValue > 0 && this.tagTargets.length >= this.maxValue) {\n      this.#reject(value, \"max\");\n      return;\n    }\n    if (!this.allowDuplicatesValue && this.#values.includes(value)) {\n      this.#reject(value, \"duplicate\");\n      return;\n    }\n    this.#appendTag(value);\n    this.inputTarget.value = \"\";\n    this.#announce(value);\n    this.#syncState();\n    this.dispatch(\"change\", { detail: { tags: this.#values } });\n  }\n\n  /** Builds one chip from the template and appends it to the tag list. */\n  #appendTag(value: string): void {\n    if (!this.hasTagTemplateTarget) return;\n    const fragment = this.tagTemplateTarget.content.cloneNode(true) as DocumentFragment;\n    const tag = fragment.querySelector<HTMLElement>('[data-stimeo--tags-input-target=\"tag\"]');\n    const label = fragment.querySelector<HTMLElement>('[data-tags-input-slot=\"label\"]');\n    const button = fragment.querySelector<HTMLButtonElement>(\"button\");\n    if (!tag || !button) return;\n    tag.dataset.value = value;\n    if (label) label.textContent = value;\n    button.setAttribute(\"aria-label\", `Remove ${value}`);\n    button.tabIndex = -1;\n    this.tagsTarget.appendChild(fragment);\n  }\n\n  /** Removes the tag at `index`, then moves focus to a neighbor or the input. */\n  #removeAt(index: number): void {\n    const tag = this.tagTargets[index];\n    if (!tag) return;\n    const value = tag.dataset.value ?? \"\";\n    tag.remove();\n    this.#announce(value);\n    this.#syncState();\n    this.dispatch(\"change\", { detail: { tags: this.#values } });\n    const remaining = this.#removeButtons;\n    if (remaining.length === 0) {\n      this.inputTarget.focus();\n    } else {\n      this.#roving.setActive(Math.min(index, remaining.length - 1), { focus: true });\n    }\n  }\n\n  /** Handles arrow navigation and deletion within the chip list (delegated). */\n  readonly #onTagKeydown = (event: KeyboardEvent): void => {\n    // A descendant widget that already claimed the key must not ALSO move the\n    // chip focus — composition depends on this yield. Chips render from the\n    // consumer's template, so an arbitrary widget can live inside one.\n    if (event.defaultPrevented) return;\n    if (isReservedArrowChord(event)) return;\n    const button = (event.target as HTMLElement).closest(\"button\");\n    if (!button) return;\n    const buttons = this.#removeButtons;\n    const index = buttons.indexOf(button);\n    if (index === -1) return;\n    // Logical, not physical. The key is normalised rather than a new case added:\n    // the two horizontal branches are not mirror images — only one guards its\n    // edge, and the other hands focus back to the input — so swapping the key\n    // keeps each branch, guards and all, with its own direction. Both handlers\n    // read the same element on purpose; probing the focused child would let the\n    // input and the chips disagree at the boundary between them.\n    switch (logicalArrowKey(event.key, this.element)) {\n      case \"ArrowLeft\":\n        if (index > 0) {\n          event.preventDefault();\n          this.#roving.setActive(index - 1, { focus: true });\n        }\n        break;\n      case \"ArrowRight\":\n        event.preventDefault();\n        if (index < buttons.length - 1) {\n          this.#roving.setActive(index + 1, { focus: true });\n        } else {\n          this.inputTarget.focus();\n        }\n        break;\n      case \"Delete\":\n      case \"Backspace\":\n        event.preventDefault();\n        this.#removeAt(index);\n        break;\n      default:\n        break;\n    }\n  };\n\n  /** Rebuilds the hidden form fields, the `full` flag, and the roving Tab stop. */\n  #syncState(): void {\n    if (this.hasFieldsTarget) {\n      this.fieldsTarget.replaceChildren(\n        ...this.#values.map((value) => {\n          const input = document.createElement(\"input\");\n          input.type = \"hidden\";\n          input.name = this.nameValue;\n          input.value = value;\n          return input;\n        }),\n      );\n    }\n    const full = this.maxValue > 0 && this.tagTargets.length >= this.maxValue;\n    this.element.toggleAttribute(\"data-stimeo--tags-input-full\", full);\n    // Keep exactly one remove button tabbable so the chip list is a single stop.\n    if (this.#removeButtons.length > 0 && this.#roving.activeIndex === -1) {\n      this.#roving.setActive(0);\n    }\n  }\n\n  /** Mirrors the changed tag into the live region for assistive tech. */\n  #announce(value: string): void {\n    if (this.hasStatusTarget) this.statusTarget.textContent = value;\n  }\n\n  /** Reports a rejected addition via `stimeo--tags-input:reject`. */\n  #reject(value: string, reason: \"duplicate\" | \"empty\" | \"max\"): void {\n    this.dispatch(\"reject\", { detail: { value, reason } });\n  }\n\n  /** The remove buttons in document order (the roving navigation set). */\n  get #removeButtons(): HTMLButtonElement[] {\n    return Array.from(this.tagsTarget.querySelectorAll<HTMLButtonElement>(\"button\"));\n  }\n\n  /** Current tag values in order. */\n  get #values(): string[] {\n    return this.tagTargets.map((tag) => tag.dataset.value ?? \"\");\n  }\n}\n"]}

package/dist/controllers/theme_controller.d.ts

@@ -33,7 +33,7 @@ import { Controller } from '@hotwired/stimulus';
  * `aria-checked` + roving tabindex (APG radio) or the single button's `aria-pressed`
  * in sync, and never moves focus. The `prefers-color-scheme` listener is attached on
  * `connect()` and removed on `disconnect()` (Turbo included). FOUC avoidance for the
- * very first paint is an inline `<head>` snippet (documented), not this controller.
+ * very first paint is an inline `<head>` snippet, not this controller.
  */
 declare class ThemeController extends Controller<HTMLElement> {
     #private;

package/dist/controllers/theme_controller.js

@@ -1,5 +1,40 @@
 import { Controller } from '@hotwired/stimulus';
 
+// src/controllers/theme_controller.ts
+
+// src/utils/logical_scroll.ts
+function isRtl(element) {
+  return window.getComputedStyle(element).direction === "rtl";
+}
+
+// src/utils/arrow_step.ts
+function logicalArrowStep(key, element) {
+  if (key === "ArrowDown") return 1;
+  if (key === "ArrowUp") return -1;
+  if (key !== "ArrowRight" && key !== "ArrowLeft") return 0;
+  const forward = isRtl(element) ? "ArrowLeft" : "ArrowRight";
+  return key === forward ? 1 : -1;
+}
+function isReservedArrowChord(event, allow = []) {
+  if (!event.key.startsWith("Arrow")) return false;
+  return event.altKey && !allow.includes("alt") || event.ctrlKey && !allow.includes("ctrl") || event.metaKey && !allow.includes("meta") || event.shiftKey && !allow.includes("shift");
+}
+
+// src/utils/safe_storage.ts
+function readLocalStorage(key) {
+  try {
+    return window.localStorage.getItem(key);
+  } catch {
+    return null;
+  }
+}
+function writeLocalStorage(key, value) {
+  try {
+    window.localStorage.setItem(key, value);
+  } catch {
+  }
+}
+
 // src/controllers/theme_controller.ts
 var MODES = ["light", "dark", "system"];
 var isMode = (value) => typeof value === "string" && MODES.includes(value);
@@ -24,6 +59,8 @@ var ThemeController = class extends Controller {
   };
   /** Arrow/Home/End navigation for the radiogroup (APG radio pattern). */
   #onKeydown = (event) => {
+    if (event.defaultPrevented) return;
+    if (isReservedArrowChord(event)) return;
     const options = this.optionTargets;
     if (options.length === 0) return;
     const target = event.target;
@@ -31,14 +68,13 @@ var ThemeController = class extends Controller {
     if (current === -1) return;
     const last = options.length - 1;
     let next = current;
+    const step = logicalArrowStep(event.key, this.element);
     switch (event.key) {
       case "ArrowDown":
       case "ArrowRight":
-        next = current === last ? 0 : current + 1;
-        break;
       case "ArrowUp":
       case "ArrowLeft":
-        next = current === 0 ? last : current - 1;
+        next = step === 1 ? current === last ? 0 : current + 1 : current === 0 ? last : current - 1;
         break;
       case "Home":
         next = 0;
@@ -133,19 +169,12 @@ var ThemeController = class extends Controller {
   }
   /** Reads a persisted, validated mode from `localStorage` (null when absent/blocked). */
   #readStored() {
-    try {
-      const value = window.localStorage.getItem(this.storageKeyValue);
-      return isMode(value) ? value : null;
-    } catch {
-      return null;
-    }
+    const value = readLocalStorage(this.storageKeyValue);
+    return isMode(value) ? value : null;
   }
   /** Persists the mode, swallowing storage errors (private mode / quota). */
   #writeStored(mode) {
-    try {
-      window.localStorage.setItem(this.storageKeyValue, mode);
-    } catch {
-    }
+    writeLocalStorage(this.storageKeyValue, mode);
   }
 };