stimeo-ui 0.5.0 → 0.7.0

package/dist/controllers/currency_input_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/currency_input_controller.ts"],"names":[],"mappings":"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","file":"currency_input_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless currency / amount input behavior: groups digits for display while\n * keeping a machine-readable number in a hidden field, and mirrors the\n * normalized value to a visually-hidden span so assistive tech reads the real\n * amount rather than the grouped display string.\n *\n * Markup contract (identifier: `stimeo--currency-input`):\n *   <div data-controller=\"stimeo--currency-input\"\n *        data-stimeo--currency-input-locale-value=\"en-US\"\n *        data-stimeo--currency-input-currency-value=\"USD\"\n *        data-stimeo--currency-input-precision-value=\"2\">\n *     <input type=\"text\" inputmode=\"decimal\"\n *            aria-describedby=\"amt-sr\"\n *            data-stimeo--currency-input-target=\"display\"\n *            data-action=\"input->stimeo--currency-input#onInput\n *                         blur->stimeo--currency-input#format\" />\n *     <span id=\"amt-sr\" class=\"visually-hidden\"\n *           data-stimeo--currency-input-target=\"srValue\"></span>\n *     <input type=\"hidden\" data-stimeo--currency-input-target=\"field\" />\n *   </div>\n *\n * @remarks\n * Behavior only — no styling, no validation (range/required belong to the\n * consumer or Form Field). The display field is the sole Tab stop and keeps its\n * native text-editing behavior; this controller never steals focus. Grouping is\n * applied on every input while preserving the caret (counted by digits to its\n * left), and the fixed-precision rounding is applied on `blur`.\n *\n * Honest a11y note: a hidden `<input>` is not exposed to assistive tech, so the\n * normalized value is *also* published as text in the `srValue` span referenced\n * by the display's `aria-describedby` — that, not the hidden field, is what a\n * screen reader announces.\n */\nexport class CurrencyInputController extends Controller<HTMLElement> {\n  static override targets = [\"display\", \"field\", \"srValue\"];\n  static override values = {\n    locale: { type: String, default: \"en-US\" },\n    currency: { type: String, default: \"\" },\n    precision: { type: Number, default: 2 },\n  };\n  static actions = [\"format\", \"onInput\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly displayTarget: HTMLInputElement;\n  declare readonly fieldTarget: HTMLInputElement;\n  declare readonly srValueTarget: HTMLElement;\n  declare readonly hasDisplayTarget: boolean;\n  declare readonly hasFieldTarget: boolean;\n  declare readonly hasSrValueTarget: boolean;\n  declare localeValue: string;\n  declare currencyValue: string;\n  declare precisionValue: number;\n\n  /** Last committed numeric value, to suppress duplicate `change` dispatches. */\n  #lastValue: number | null = null;\n\n  /** Normalizes any pre-filled display value to its fixed-precision form. */\n  override connect(): void {\n    if (!this.hasDisplayTarget) return;\n    // Seed lastValue with the *rounded* initial value so the idempotent\n    // connect-time reformat does not dispatch a spurious `change`.\n    const parsed = this.#parse(this.displayTarget.value);\n    this.#lastValue = parsed === null ? null : round(parsed, this.precisionValue);\n    if (this.displayTarget.value.trim() !== \"\") {\n      this.#reformat(true);\n    } else {\n      this.#reflect(null, \"\");\n    }\n  }\n\n  /** Re-groups digits as the user types, preserving the caret position. */\n  onInput(): void {\n    this.#reformat(false);\n  }\n\n  /** Applies the fixed-precision rounding on blur. */\n  format(): void {\n    this.#reformat(true);\n  }\n\n  /**\n   * Parses the display value, rewrites it grouped (optionally at fixed\n   * precision), keeps the caret stable by digit count, and syncs the field,\n   * the screen-reader span, and the `change` event.\n   */\n  #reformat(fixedPrecision: boolean): void {\n    if (!this.hasDisplayTarget) return;\n    const raw = this.displayTarget.value;\n    const number = this.#parse(raw);\n\n    if (number === null) {\n      this.displayTarget.value = \"\";\n      this.#reflect(null, \"\");\n      return;\n    }\n\n    const value = fixedPrecision ? round(number, this.precisionValue) : number;\n    const caret = this.displayTarget.selectionStart;\n    const digitsBeforeCaret = typeof caret === \"number\" ? countDigits(raw.slice(0, caret)) : null;\n\n    const formatted = this.#formatNumber(value, fixedPrecision);\n    this.displayTarget.value = formatted;\n    if (digitsBeforeCaret !== null) this.#restoreCaret(formatted, digitsBeforeCaret);\n\n    this.#reflect(value, formatted);\n  }\n\n  /** Restores the caret to sit just after the n-th digit of the new string. */\n  #restoreCaret(formatted: string, digitsBefore: number): void {\n    let seen = 0;\n    let position = formatted.length;\n    for (let i = 0; i < formatted.length; i++) {\n      if (seen >= digitsBefore) {\n        position = i;\n        break;\n      }\n      if (/\\d/.test(formatted[i] as string)) seen += 1;\n    }\n    try {\n      this.displayTarget.setSelectionRange(position, position);\n    } catch {\n      // Some hosts disallow selection on certain input states; the value is\n      // already correct, so a failed caret restore is non-fatal.\n    }\n  }\n\n  /** Writes the normalized value to the field, the SR span, and `change`. */\n  #reflect(value: number | null, formatted: string): void {\n    const isEmpty = value === null;\n    if (this.hasFieldTarget) this.fieldTarget.value = isEmpty ? \"\" : String(value);\n    if (this.hasSrValueTarget) {\n      this.srValueTarget.textContent = isEmpty ? \"\" : this.#accessibleText(value);\n    }\n    this.element.toggleAttribute(\"data-stimeo--currency-input-empty\", isEmpty);\n\n    if (value !== this.#lastValue) {\n      this.#lastValue = value;\n      if (!isEmpty) this.dispatch(\"change\", { detail: { value, formatted } });\n    }\n  }\n\n  /** Parses arbitrary input text into a finite number, or `null` when blank. */\n  #parse(text: string): number | null {\n    if (text.trim() === \"\") return null;\n    const { decimal } = this.#separators();\n    // Keep digits, a leading sign, and decimal marks; normalize the locale's\n    // decimal separator to \".\" and drop everything else (grouping, symbols).\n    let cleaned = \"\";\n    let sawDot = false;\n    for (let i = 0; i < text.length; i++) {\n      const ch = text[i] as string;\n      if (ch >= \"0\" && ch <= \"9\") cleaned += ch;\n      else if ((ch === \"-\" || ch === \"+\") && cleaned === \"\") cleaned += ch;\n      else if ((ch === decimal || ch === \".\") && !sawDot) {\n        cleaned += \".\";\n        sawDot = true;\n      }\n    }\n    if (cleaned === \"\" || cleaned === \"-\" || cleaned === \"+\" || cleaned === \".\") return null;\n    const value = Number(cleaned);\n    return Number.isFinite(value) ? value : null;\n  }\n\n  /** Formats a number with grouping for the display field. */\n  #formatNumber(value: number, fixedPrecision: boolean): string {\n    const formatter = new Intl.NumberFormat(this.localeValue, {\n      useGrouping: true,\n      minimumFractionDigits: fixedPrecision ? this.precisionValue : 0,\n      maximumFractionDigits: this.precisionValue,\n    });\n    return formatter.format(value);\n  }\n\n  /** The text announced to assistive tech (currency-aware when configured). */\n  #accessibleText(value: number): string {\n    if (this.currencyValue) {\n      return new Intl.NumberFormat(this.localeValue, {\n        style: \"currency\",\n        currency: this.currencyValue,\n      }).format(value);\n    }\n    return new Intl.NumberFormat(this.localeValue, {\n      minimumFractionDigits: this.precisionValue,\n      maximumFractionDigits: this.precisionValue,\n    }).format(value);\n  }\n\n  /** Resolves the locale's grouping and decimal separator characters. */\n  #separators(): { group: string; decimal: string } {\n    const parts = new Intl.NumberFormat(this.localeValue).formatToParts(11111.1);\n    const group = parts.find((p) => p.type === \"group\")?.value ?? \",\";\n    const decimal = parts.find((p) => p.type === \"decimal\")?.value ?? \".\";\n    return { group, decimal };\n  }\n}\n\n/** Counts the digit characters in a string. */\nfunction countDigits(text: string): number {\n  let count = 0;\n  for (const ch of text) if (ch >= \"0\" && ch <= \"9\") count += 1;\n  return count;\n}\n\n/** Rounds `value` to `precision` decimal places, avoiding `-0`. */\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** Math.max(0, precision);\n  const rounded = Math.round(value * factor) / factor;\n  return rounded === 0 ? 0 : rounded;\n}\n"]}
+{"version":3,"sources":["../../src/controllers/currency_input_controller.ts"],"names":[],"mappings":"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","file":"currency_input_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless currency / amount input behavior: groups digits for display while\n * keeping a machine-readable number in a hidden field, and mirrors the\n * normalized value to a visually-hidden span so assistive tech reads the real\n * amount rather than the grouped display string.\n *\n * Markup contract (identifier: `stimeo--currency-input`):\n *   <div data-controller=\"stimeo--currency-input\"\n *        data-stimeo--currency-input-locale-value=\"en-US\"\n *        data-stimeo--currency-input-currency-value=\"USD\"\n *        data-stimeo--currency-input-precision-value=\"2\">\n *     <input type=\"text\" inputmode=\"decimal\"\n *            aria-describedby=\"amt-sr\"\n *            data-stimeo--currency-input-target=\"display\"\n *            data-action=\"input->stimeo--currency-input#onInput\n *                         blur->stimeo--currency-input#format\" />\n *     <span id=\"amt-sr\" class=\"visually-hidden\"\n *           data-stimeo--currency-input-target=\"srValue\"></span>\n *     <input type=\"hidden\" data-stimeo--currency-input-target=\"field\" />\n *   </div>\n *\n * `change` dispatches `{ value: number, formatted: string }`.\n *\n * @remarks\n * Behavior only — no styling, no validation (range/required belong to the\n * consumer or Form Field). The display field is the sole Tab stop and keeps its\n * native text-editing behavior; this controller never steals focus. Grouping is\n * applied on every input while preserving the caret (counted by digits to its\n * left), and the fixed-precision rounding is applied on `blur`.\n *\n * Honest a11y note: a hidden `<input>` is not exposed to assistive tech, so the\n * normalized value is *also* published as text in the `srValue` span referenced\n * by the display's `aria-describedby` — that, not the hidden field, is what a\n * screen reader announces.\n */\nexport class CurrencyInputController extends Controller<HTMLElement> {\n  static override targets = [\"display\", \"field\", \"srValue\"];\n  static override values = {\n    locale: { type: String, default: \"en-US\" },\n    currency: { type: String, default: \"\" },\n    precision: { type: Number, default: 2 },\n  };\n  static actions = [\"format\", \"onInput\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly displayTarget: HTMLInputElement;\n  declare readonly fieldTarget: HTMLInputElement;\n  declare readonly srValueTarget: HTMLElement;\n  declare readonly hasDisplayTarget: boolean;\n  declare readonly hasFieldTarget: boolean;\n  declare readonly hasSrValueTarget: boolean;\n  declare localeValue: string;\n  declare currencyValue: string;\n  declare precisionValue: number;\n\n  /** Last committed numeric value, to suppress duplicate `change` dispatches. */\n  #lastValue: number | null = null;\n\n  /** Normalizes any pre-filled display value to its fixed-precision form. */\n  override connect(): void {\n    if (!this.hasDisplayTarget) return;\n    // Seed lastValue with the *rounded* initial value so the idempotent\n    // connect-time reformat does not dispatch a spurious `change`.\n    const parsed = this.#parse(this.displayTarget.value);\n    this.#lastValue = parsed === null ? null : round(parsed, this.precisionValue);\n    if (this.displayTarget.value.trim() !== \"\") {\n      this.#reformat(true);\n    } else {\n      this.#reflect(null, \"\");\n    }\n  }\n\n  /** Re-groups digits as the user types, preserving the caret position. */\n  onInput(): void {\n    this.#reformat(false);\n  }\n\n  /** Applies the fixed-precision rounding on blur. */\n  format(): void {\n    this.#reformat(true);\n  }\n\n  /**\n   * Parses the display value, rewrites it grouped (optionally at fixed\n   * precision), keeps the caret stable by digit count, and syncs the field,\n   * the screen-reader span, and the `change` event.\n   */\n  #reformat(fixedPrecision: boolean): void {\n    if (!this.hasDisplayTarget) return;\n    const raw = this.displayTarget.value;\n    const number = this.#parse(raw);\n\n    if (number === null) {\n      this.displayTarget.value = \"\";\n      this.#reflect(null, \"\");\n      return;\n    }\n\n    const value = fixedPrecision ? round(number, this.precisionValue) : number;\n    const caret = this.displayTarget.selectionStart;\n    const digitsBeforeCaret = typeof caret === \"number\" ? countDigits(raw.slice(0, caret)) : null;\n\n    const formatted = this.#formatNumber(value, fixedPrecision);\n    this.displayTarget.value = formatted;\n    if (digitsBeforeCaret !== null) this.#restoreCaret(formatted, digitsBeforeCaret);\n\n    this.#reflect(value, formatted);\n  }\n\n  /** Restores the caret to sit just after the n-th digit of the new string. */\n  #restoreCaret(formatted: string, digitsBefore: number): void {\n    let seen = 0;\n    let position = formatted.length;\n    for (let i = 0; i < formatted.length; i++) {\n      if (seen >= digitsBefore) {\n        position = i;\n        break;\n      }\n      if (/\\d/.test(formatted[i] as string)) seen += 1;\n    }\n    try {\n      this.displayTarget.setSelectionRange(position, position);\n    } catch {\n      // Some hosts disallow selection on certain input states; the value is\n      // already correct, so a failed caret restore is non-fatal.\n    }\n  }\n\n  /** Writes the normalized value to the field, the SR span, and `change`. */\n  #reflect(value: number | null, formatted: string): void {\n    const isEmpty = value === null;\n    if (this.hasFieldTarget) this.fieldTarget.value = isEmpty ? \"\" : String(value);\n    if (this.hasSrValueTarget) {\n      this.srValueTarget.textContent = isEmpty ? \"\" : this.#accessibleText(value);\n    }\n    this.element.toggleAttribute(\"data-stimeo--currency-input-empty\", isEmpty);\n\n    if (value !== this.#lastValue) {\n      this.#lastValue = value;\n      if (!isEmpty) this.dispatch(\"change\", { detail: { value, formatted } });\n    }\n  }\n\n  /** Parses arbitrary input text into a finite number, or `null` when blank. */\n  #parse(text: string): number | null {\n    if (text.trim() === \"\") return null;\n    const { decimal } = this.#separators();\n    // Keep digits, a leading sign, and decimal marks; normalize the locale's\n    // decimal separator to \".\" and drop everything else (grouping, symbols).\n    let cleaned = \"\";\n    let sawDot = false;\n    for (let i = 0; i < text.length; i++) {\n      const ch = text[i] as string;\n      if (ch >= \"0\" && ch <= \"9\") cleaned += ch;\n      else if ((ch === \"-\" || ch === \"+\") && cleaned === \"\") cleaned += ch;\n      else if ((ch === decimal || ch === \".\") && !sawDot) {\n        cleaned += \".\";\n        sawDot = true;\n      }\n    }\n    if (cleaned === \"\" || cleaned === \"-\" || cleaned === \"+\" || cleaned === \".\") return null;\n    const value = Number(cleaned);\n    return Number.isFinite(value) ? value : null;\n  }\n\n  /** Formats a number with grouping for the display field. */\n  #formatNumber(value: number, fixedPrecision: boolean): string {\n    const formatter = new Intl.NumberFormat(this.localeValue, {\n      useGrouping: true,\n      minimumFractionDigits: fixedPrecision ? this.precisionValue : 0,\n      maximumFractionDigits: this.precisionValue,\n    });\n    return formatter.format(value);\n  }\n\n  /** The text announced to assistive tech (currency-aware when configured). */\n  #accessibleText(value: number): string {\n    if (this.currencyValue) {\n      return new Intl.NumberFormat(this.localeValue, {\n        style: \"currency\",\n        currency: this.currencyValue,\n      }).format(value);\n    }\n    return new Intl.NumberFormat(this.localeValue, {\n      minimumFractionDigits: this.precisionValue,\n      maximumFractionDigits: this.precisionValue,\n    }).format(value);\n  }\n\n  /** Resolves the locale's grouping and decimal separator characters. */\n  #separators(): { group: string; decimal: string } {\n    const parts = new Intl.NumberFormat(this.localeValue).formatToParts(11111.1);\n    const group = parts.find((p) => p.type === \"group\")?.value ?? \",\";\n    const decimal = parts.find((p) => p.type === \"decimal\")?.value ?? \".\";\n    return { group, decimal };\n  }\n}\n\n/** Counts the digit characters in a string. */\nfunction countDigits(text: string): number {\n  let count = 0;\n  for (const ch of text) if (ch >= \"0\" && ch <= \"9\") count += 1;\n  return count;\n}\n\n/** Rounds `value` to `precision` decimal places, avoiding `-0`. */\nfunction round(value: number, precision: number): number {\n  const factor = 10 ** Math.max(0, precision);\n  const rounded = Math.round(value * factor) / factor;\n  return rounded === 0 ? 0 : rounded;\n}\n"]}

package/dist/controllers/data_grid_controller.d.ts

@@ -25,6 +25,9 @@ import { Controller } from '@hotwired/stimulus';
  * `-1`); arrow keys move both DOM focus and that tabbable position. Sort state is
  * exposed via `aria-sort` on headers, selection via `aria-selected` on rows.
  *
+ * `selectionchange` dispatches `{ rows: HTMLElement[] }`; `sort` dispatches
+ * `{ column: HTMLElement, direction: "ascending" | "descending" | "none" }`.
+ *
  * @remarks
  * Behavior only — the consumer performs the actual data sort/render in response to
  * the `sort` event and owns all styling. No timers or observers are held, so there

package/dist/controllers/data_grid_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/logical_scroll.ts","../../src/utils/arrow_step.ts","../../src/controllers/data_grid_controller.ts"],"names":[],"mappings":"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","file":"data_grid_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","import { Controller } from \"@hotwired/stimulus\";\nimport { isReservedArrowChord, logicalArrowKey } from \"../utils/arrow_step\";\n\n/** Cycle order for a sortable column header's `aria-sort`. */\nconst SORT_CYCLE = [\"none\", \"ascending\", \"descending\"] as const;\ntype SortDirection = (typeof SORT_CYCLE)[number];\n\n/**\n * Returns the next `aria-sort` direction in the cycle after `current`. Unknown or\n * ARIA-only values (e.g. `\"other\"`, or an empty/missing attribute) are treated as\n * `\"none\"`, so the first activation always advances to `\"ascending\"` instead of\n * stalling.\n */\nfunction nextSortDirection(current: string): SortDirection {\n  const index = SORT_CYCLE.indexOf(current as SortDirection);\n  const from = index < 0 ? 0 : index;\n  return SORT_CYCLE[(from + 1) % SORT_CYCLE.length] ?? \"ascending\";\n}\n\n/**\n * Headless, accessible **Data Grid** behavior: column sorting, row selection, and\n * roving keyboard navigation over an interactive table.\n *\n * Markup contract (identifier: `stimeo--data-grid`):\n *   <table data-controller=\"stimeo--data-grid\" role=\"grid\" aria-label=\"Users\"\n *          data-stimeo--data-grid-selection-value=\"single\">\n *     <thead><tr role=\"row\">\n *       <th role=\"columnheader\" aria-sort=\"none\" tabindex=\"-1\"\n *           data-stimeo--data-grid-target=\"columnHeader\"\n *           data-action=\"click->stimeo--data-grid#sort\n *                        keydown->stimeo--data-grid#onKeydown\">Name</th>\n *     </tr></thead>\n *     <tbody><tr role=\"row\" aria-selected=\"false\"\n *                data-stimeo--data-grid-target=\"row\">\n *       <td role=\"gridcell\" tabindex=\"0\" data-stimeo--data-grid-target=\"cell\"\n *           data-action=\"keydown->stimeo--data-grid#onKeydown\">Jane</td>\n *     </tr></tbody>\n *   </table>\n *\n * Implements the WAI-ARIA APG **Grid** pattern plus `aria-sort`. The whole grid is\n * a single Tab stop (roving `tabindex`: exactly one cell/header is `0`, the rest\n * `-1`); arrow keys move both DOM focus and that tabbable position. Sort state is\n * exposed via `aria-sort` on headers, selection via `aria-selected` on rows.\n *\n * @remarks\n * Behavior only — the consumer performs the actual data sort/render in response to\n * the `sort` event and owns all styling. No timers or observers are held, so there\n * is nothing to leak across Turbo navigations; `connect()` rebuilds the single tab\n * stop idempotently from the DOM.\n *\n * Behavior provided:\n * - `Arrow*` move between cells (clamped at edges); `Home`/`End` to the row's\n *   first/last cell; `Ctrl+Home`/`Ctrl+End` to the grid's first/last cell.\n * - `Enter`/`Space` cycles a header's sort (`none→ascending→descending`) or toggles\n *   the focused row's selection when selection is enabled.\n */\nexport class DataGridController extends Controller<HTMLElement> {\n  static override targets = [\"columnHeader\", \"row\", \"cell\"];\n  static override values = {\n    selection: { type: String, default: \"none\" },\n  };\n  static actions = [\"onKeydown\", \"sort\", \"toggleSelect\"] as const;\n  static events = [\"selectionchange\", \"sort\"] as const;\n\n  declare readonly columnHeaderTargets: HTMLElement[];\n  declare readonly rowTargets: HTMLElement[];\n  declare readonly cellTargets: HTMLElement[];\n  declare selectionValue: string;\n\n  /** Gates the row callback so it does not re-walk every row once per authored row on mount. */\n  #connected = false;\n\n  /**\n   * Establishes a single tab stop across all navigable cells/headers and brings\n   * the rows to their baseline.\n   *\n   * Normalizing here rather than leaving it to {@link selectionValueChanged}\n   * guarantees exactly one pass per mount: a re-attached element reuses its\n   * cached Stimulus context, whose value observer already knows the `selection`\n   * attribute, so the Value callback does not fire a second time.\n   */\n  override connect(): void {\n    const cells = this.#navigableCells();\n    const active = cells.find((cell) => cell.tabIndex === 0) ?? cells[0];\n    this.#setActiveCell(active, { focus: false });\n    this.#normalizeSelection();\n    this.#connected = true;\n  }\n\n  /** Reopens the row callback for the next mount. */\n  override disconnect(): void {\n    this.#connected = false;\n  }\n\n  /**\n   * Keeps `aria-multiselectable` in step with the `selection` Value. Fires on connect\n   * (so it self-heals after a Turbo morph) and on any runtime change, so the ARIA\n   * never drifts from the selection logic, which reads `selectionValue` live.\n   */\n  selectionValueChanged(): void {\n    this.#syncSelectable();\n    this.#normalizeSelection();\n  }\n\n  /**\n   * Re-establishes the row baseline for a row added after connect.\n   *\n   * Each pass walks every row, and Stimulus reports the authored rows one by one\n   * before `connect()`, so the mount is gated to keep it linear in the row count\n   * rather than quadratic; `connect()` runs the single baseline pass instead.\n   */\n  rowTargetConnected(): void {\n    if (!this.#connected) return;\n    this.#normalizeSelection();\n  }\n\n  /**\n   * Brings the authored rows to the shape the APG requires, without changing\n   * which rows the author chose.\n   *\n   * Every selectable row gets an explicit value — an absent `aria-selected` means\n   * \"not selectable\" in ARIA, so a forgotten attribute hides a selectable row —\n   * and a single-select grid keeps at most one `true`, first in DOM order.\n   * A grid that declares `selection=\"none\"` has no selectable rows, so the\n   * attribute is removed rather than written: in ARIA its absence is what \"not\n   * selectable\" looks like.\n   */\n  #normalizeSelection(): void {\n    const rows = this.rowTargets;\n    if (this.selectionValue === \"none\") {\n      // Reclaim, do not merely skip: a grid that *became* unselectable would\n      // otherwise keep announcing rows as selected while the logic refuses to\n      // change them. In ARIA the absence of the attribute is what \"not\n      // selectable\" looks like, so the rows have to lose it outright.\n      for (const row of rows) row.removeAttribute(\"aria-selected\");\n      return;\n    }\n    const single = this.selectionValue === \"single\";\n    const first = rows.find((row) => row.getAttribute(\"aria-selected\") === \"true\");\n    for (const row of rows) {\n      if (single) {\n        row.setAttribute(\"aria-selected\", row === first ? \"true\" : \"false\");\n      } else if (row.getAttribute(\"aria-selected\") !== \"true\") {\n        row.setAttribute(\"aria-selected\", \"false\");\n      }\n    }\n  }\n\n  /**\n   * Mirrors `selection=\"multiple\"` onto `aria-multiselectable` (APG Grid) so SRs\n   * announce that more than one row can be selected; cleared for single/none so a\n   * grid never carries a misleading attribute.\n   */\n  #syncSelectable(): void {\n    if (this.selectionValue === \"multiple\") {\n      this.element.setAttribute(\"aria-multiselectable\", \"true\");\n    } else {\n      this.element.removeAttribute(\"aria-multiselectable\");\n    }\n  }\n\n  /** Cycles the activated column header's sort and emits `sort`. */\n  sort(event: Event): void {\n    const header = event.currentTarget as HTMLElement;\n    if (!this.columnHeaderTargets.includes(header)) return;\n\n    const direction = nextSortDirection(header.getAttribute(\"aria-sort\") ?? \"none\");\n\n    // Only one column is sorted at a time: reset the others to `none`.\n    for (const other of this.columnHeaderTargets) {\n      other.setAttribute(\"aria-sort\", other === header ? direction : \"none\");\n    }\n\n    this.#setActiveCell(header, { focus: false });\n    this.dispatch(\"sort\", { detail: { column: header, direction } });\n  }\n\n  /** Toggles selection of the row owning the event target. Bound optionally. */\n  toggleSelect(event: Event): void {\n    // The pointer path guards on `selection=\"none\"` exactly as the keyboard path\n    // does, so a grid that declares itself unselectable never grows selected rows.\n    if (this.selectionValue === \"none\") return;\n    const row = (event.currentTarget as HTMLElement).closest<HTMLElement>(\"[role='row']\");\n    if (row && this.rowTargets.includes(row)) this.#toggleRow(row);\n  }\n\n  /** Grid navigation + sort/select activation. Bound to cells and headers. */\n  onKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key (a grabbed drag handle, a\n    // nested menu) must not ALSO act on it — composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (isReservedArrowChord(event)) return;\n    const cell = event.currentTarget as HTMLElement;\n    const matrix = this.#matrix();\n    const position = this.#locate(matrix, cell);\n    if (!position) return;\n    const [row, col] = position;\n    const rowCells = matrix[row] ?? [];\n\n    let target: HTMLElement | undefined;\n    // Logical, not physical. The key is normalised rather than the\n    // delta negated: these two branches are not mirror images — their guards\n    // differ — so swapping the key keeps each guard with its own direction.\n    switch (logicalArrowKey(event.key, this.element)) {\n      case \"ArrowRight\":\n        target = this.#cellInRow(matrix, row, col + 1);\n        break;\n      case \"ArrowLeft\":\n        target = this.#cellInRow(matrix, row, Math.max(col - 1, 0));\n        break;\n      case \"ArrowDown\":\n        target = this.#cellInRow(matrix, Math.min(row + 1, matrix.length - 1), col);\n        break;\n      case \"ArrowUp\":\n        target = this.#cellInRow(matrix, Math.max(row - 1, 0), col);\n        break;\n      case \"Home\":\n        target = event.ctrlKey ? this.#cellInRow(matrix, 0, 0) : rowCells[0];\n        break;\n      case \"End\":\n        target = event.ctrlKey\n          ? this.#cellInRow(matrix, matrix.length - 1, Number.POSITIVE_INFINITY)\n          : rowCells[rowCells.length - 1];\n        break;\n      case \"Enter\":\n      case \" \":\n        this.#activate(cell);\n        event.preventDefault();\n        return;\n      default:\n        return;\n    }\n\n    if (target) {\n      event.preventDefault();\n      this.#setActiveCell(target, { focus: true });\n    }\n  }\n\n  /** Performs a header's sort or a cell row's selection toggle on activation. */\n  #activate(cell: HTMLElement): void {\n    if (this.columnHeaderTargets.includes(cell)) {\n      this.#cycleSort(cell);\n      return;\n    }\n    if (this.selectionValue === \"none\") return;\n    const row = cell.closest<HTMLElement>(\"[role='row']\");\n    if (row && this.rowTargets.includes(row)) this.#toggleRow(row);\n  }\n\n  /** Shared sort logic for both click and keyboard activation. */\n  #cycleSort(header: HTMLElement): void {\n    const direction = nextSortDirection(header.getAttribute(\"aria-sort\") ?? \"none\");\n    for (const other of this.columnHeaderTargets) {\n      other.setAttribute(\"aria-sort\", other === header ? direction : \"none\");\n    }\n    this.dispatch(\"sort\", { detail: { column: header, direction } });\n  }\n\n  /** Toggles a row's `aria-selected`, honoring single vs. multiple selection. */\n  #toggleRow(row: HTMLElement): void {\n    const selected = row.getAttribute(\"aria-selected\") === \"true\";\n    // Enforce single-ness on every toggle, not only when turning a row on:\n    // switching one *off* would otherwise leave a second `true` behind, and\n    // nothing else clears it for the rest of the session.\n    if (this.selectionValue === \"single\") {\n      for (const other of this.rowTargets) {\n        if (other !== row) other.setAttribute(\"aria-selected\", \"false\");\n      }\n    }\n    row.setAttribute(\"aria-selected\", selected ? \"false\" : \"true\");\n\n    const rows = this.rowTargets.filter((r) => r.getAttribute(\"aria-selected\") === \"true\");\n    this.dispatch(\"selectionchange\", { detail: { rows } });\n  }\n\n  /** Makes `cell` the single tabbable cell (roving) and optionally focuses it. */\n  #setActiveCell(cell: HTMLElement | undefined, { focus }: { focus: boolean }): void {\n    if (!cell) return;\n    for (const candidate of this.#navigableCells()) {\n      candidate.tabIndex = candidate === cell ? 0 : -1;\n    }\n    if (focus) cell.focus();\n  }\n\n  /** All navigable elements (headers + cells) in DOM order. */\n  #navigableCells(): HTMLElement[] {\n    return this.#matrix().flat();\n  }\n\n  /** The grid as rows of navigable cells, derived from each `role=\"row\"`. */\n  #matrix(): HTMLElement[][] {\n    const navigable = new Set<HTMLElement>([...this.columnHeaderTargets, ...this.cellTargets]);\n    const rows = Array.from(this.element.querySelectorAll<HTMLElement>(\"[role='row']\"));\n    return rows\n      .map((row) =>\n        Array.from(row.children).filter((child): child is HTMLElement =>\n          navigable.has(child as HTMLElement),\n        ),\n      )\n      .filter((cells) => cells.length > 0);\n  }\n\n  /** Finds `[rowIndex, colIndex]` of `cell` within `matrix`, or null. */\n  #locate(matrix: HTMLElement[][], cell: HTMLElement): [number, number] | null {\n    for (let row = 0; row < matrix.length; row++) {\n      const col = (matrix[row] ?? []).indexOf(cell);\n      if (col !== -1) return [row, col];\n    }\n    return null;\n  }\n\n  /** The cell at `[row, col]`, clamping `col` to that row's last cell. */\n  #cellInRow(matrix: HTMLElement[][], row: number, col: number): HTMLElement | undefined {\n    const cells = matrix[row];\n    if (!cells || cells.length === 0) return undefined;\n    return cells[Math.min(col, cells.length - 1)];\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/logical_scroll.ts","../../src/utils/arrow_step.ts","../../src/controllers/data_grid_controller.ts"],"names":[],"mappings":";;;;;AAiBO,SAAS,MAAM,OAAA,EAA2B;AAC/C,EAAA,OAAO,MAAA,CAAO,gBAAA,CAAiB,OAAO,CAAA,CAAE,SAAA,KAAc,KAAA;AACxD;;;AC6CO,SAAS,eAAA,CAAgB,KAAa,OAAA,EAA0B;AACrE,EAAA,IAAI,GAAA,KAAQ,YAAA,IAAgB,GAAA,KAAQ,WAAA,EAAa,OAAO,GAAA;AACxD,EAAA,IAAI,CAAC,KAAA,CAAM,OAAO,CAAA,EAAG,OAAO,GAAA;AAC5B,EAAA,OAAO,GAAA,KAAQ,eAAe,WAAA,GAAc,YAAA;AAC9C;AA2BO,SAAS,oBAAA,CACd,KAAA,EACA,KAAA,GAAkC,EAAC,EAC1B;AACT,EAAA,IAAI,CAAC,KAAA,CAAM,GAAA,CAAI,UAAA,CAAW,OAAO,GAAG,OAAO,KAAA;AAC3C,EAAA,OACG,KAAA,CAAM,MAAA,IAAU,CAAC,KAAA,CAAM,QAAA,CAAS,KAAK,CAAA,IACrC,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,QAAA,CAAS,MAAM,KACvC,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,QAAA,CAAS,MAAM,CAAA,IACvC,KAAA,CAAM,QAAA,IAAY,CAAC,KAAA,CAAM,QAAA,CAAS,OAAO,CAAA;AAE9C;;;ACtGA,IAAM,UAAA,GAAa,CAAC,MAAA,EAAQ,WAAA,EAAa,YAAY,CAAA;AASrD,SAAS,kBAAkB,OAAA,EAAgC;AACzD,EAAA,MAAM,KAAA,GAAQ,UAAA,CAAW,OAAA,CAAQ,OAAwB,CAAA;AACzD,EAAA,MAAM,IAAA,GAAO,KAAA,GAAQ,CAAA,GAAI,CAAA,GAAI,KAAA;AAC7B,EAAA,OAAO,UAAA,CAAA,CAAY,IAAA,GAAO,CAAA,IAAK,UAAA,CAAW,MAAM,CAAA,IAAK,WAAA;AACvD;AA0CO,IAAM,kBAAA,GAAN,cAAiC,UAAA,CAAwB;AAAA,EAC9D,OAAgB,OAAA,GAAU,CAAC,cAAA,EAAgB,OAAO,MAAM,CAAA;AAAA,EACxD,OAAgB,MAAA,GAAS;AAAA,IACvB,SAAA,EAAW,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,MAAA;AAAO,GAC7C;AAAA,EACA,OAAO,OAAA,GAAU,CAAC,WAAA,EAAa,QAAQ,cAAc,CAAA;AAAA,EACrD,OAAO,MAAA,GAAS,CAAC,iBAAA,EAAmB,MAAM,CAAA;AAAA;AAAA,EAQ1C,UAAA,GAAa,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWJ,OAAA,GAAgB;AACvB,IAAA,MAAM,KAAA,GAAQ,KAAK,eAAA,EAAgB;AACnC,IAAA,MAAM,MAAA,GAAS,KAAA,CAAM,IAAA,CAAK,CAAC,IAAA,KAAS,KAAK,QAAA,KAAa,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA;AACnE,IAAA,IAAA,CAAK,cAAA,CAAe,MAAA,EAAQ,EAAE,KAAA,EAAO,OAAO,CAAA;AAC5C,IAAA,IAAA,CAAK,mBAAA,EAAoB;AACzB,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAAA,EACpB;AAAA;AAAA,EAGS,UAAA,GAAmB;AAC1B,IAAA,IAAA,CAAK,UAAA,GAAa,KAAA;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAAA,GAA8B;AAC5B,IAAA,IAAA,CAAK,eAAA,EAAgB;AACrB,IAAA,IAAA,CAAK,mBAAA,EAAoB;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,kBAAA,GAA2B;AACzB,IAAA,IAAI,CAAC,KAAK,UAAA,EAAY;AACtB,IAAA,IAAA,CAAK,mBAAA,EAAoB;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,mBAAA,GAA4B;AAC1B,IAAA,MAAM,OAAO,IAAA,CAAK,UAAA;AAClB,IAAA,IAAI,IAAA,CAAK,mBAAmB,MAAA,EAAQ;AAKlC,MAAA,KAAA,MAAW,GAAA,IAAO,IAAA,EAAM,GAAA,CAAI,eAAA,CAAgB,eAAe,CAAA;AAC3D,MAAA;AAAA,IACF;AACA,IAAA,MAAM,MAAA,GAAS,KAAK,cAAA,KAAmB,QAAA;AACvC,IAAA,MAAM,KAAA,GAAQ,KAAK,IAAA,CAAK,CAAC,QAAQ,GAAA,CAAI,YAAA,CAAa,eAAe,CAAA,KAAM,MAAM,CAAA;AAC7E,IAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,MAAA,IAAI,MAAA,EAAQ;AACV,QAAA,GAAA,CAAI,YAAA,CAAa,eAAA,EAAiB,GAAA,KAAQ,KAAA,GAAQ,SAAS,OAAO,CAAA;AAAA,MACpE,CAAA,MAAA,IAAW,GAAA,CAAI,YAAA,CAAa,eAAe,MAAM,MAAA,EAAQ;AACvD,QAAA,GAAA,CAAI,YAAA,CAAa,iBAAiB,OAAO,CAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,eAAA,GAAwB;AACtB,IAAA,IAAI,IAAA,CAAK,mBAAmB,UAAA,EAAY;AACtC,MAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,sBAAA,EAAwB,MAAM,CAAA;AAAA,IAC1D,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,OAAA,CAAQ,gBAAgB,sBAAsB,CAAA;AAAA,IACrD;AAAA,EACF;AAAA;AAAA,EAGA,KAAK,KAAA,EAAoB;AACvB,IAAA,MAAM,SAAS,KAAA,CAAM,aAAA;AACrB,IAAA,IAAI,CAAC,IAAA,CAAK,mBAAA,CAAoB,QAAA,CAAS,MAAM,CAAA,EAAG;AAEhD,IAAA,MAAM,YAAY,iBAAA,CAAkB,MAAA,CAAO,YAAA,CAAa,WAAW,KAAK,MAAM,CAAA;AAG9E,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,mBAAA,EAAqB;AAC5C,MAAA,KAAA,CAAM,YAAA,CAAa,WAAA,EAAa,KAAA,KAAU,MAAA,GAAS,YAAY,MAAM,CAAA;AAAA,IACvE;AAEA,IAAA,IAAA,CAAK,cAAA,CAAe,MAAA,EAAQ,EAAE,KAAA,EAAO,OAAO,CAAA;AAC5C,IAAA,IAAA,CAAK,QAAA,CAAS,QAAQ,EAAE,MAAA,EAAQ,EAAE,MAAA,EAAQ,MAAA,EAAQ,SAAA,EAAU,EAAG,CAAA;AAAA,EACjE;AAAA;AAAA,EAGA,aAAa,KAAA,EAAoB;AAG/B,IAAA,IAAI,IAAA,CAAK,mBAAmB,MAAA,EAAQ;AACpC,IAAA,MAAM,GAAA,GAAO,KAAA,CAAM,aAAA,CAA8B,OAAA,CAAqB,cAAc,CAAA;AACpF,IAAA,IAAI,GAAA,IAAO,KAAK,UAAA,CAAW,QAAA,CAAS,GAAG,CAAA,EAAG,IAAA,CAAK,WAAW,GAAG,CAAA;AAAA,EAC/D;AAAA;AAAA,EAGA,UAAU,KAAA,EAA4B;AAGpC,IAAA,IAAI,MAAM,gBAAA,EAAkB;AAC5B,IAAA,IAAI,oBAAA,CAAqB,KAAK,CAAA,EAAG;AACjC,IAAA,MAAM,OAAO,KAAA,CAAM,aAAA;AACnB,IAAA,MAAM,MAAA,GAAS,KAAK,OAAA,EAAQ;AAC5B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAQ,IAAI,CAAA;AAC1C,IAAA,IAAI,CAAC,QAAA,EAAU;AACf,IAAA,MAAM,CAAC,GAAA,EAAK,GAAG,CAAA,GAAI,QAAA;AACnB,IAAA,MAAM,QAAA,GAAW,MAAA,CAAO,GAAG,CAAA,IAAK,EAAC;AAEjC,IAAA,IAAI,MAAA;AAIJ,IAAA,QAAQ,eAAA,CAAgB,KAAA,CAAM,GAAA,EAAK,IAAA,CAAK,OAAO,CAAA;AAAG,MAChD,KAAK,YAAA;AACH,QAAA,MAAA,GAAS,IAAA,CAAK,UAAA,CAAW,MAAA,EAAQ,GAAA,EAAK,MAAM,CAAC,CAAA;AAC7C,QAAA;AAAA,MACF,KAAK,WAAA;AACH,QAAA,MAAA,GAAS,IAAA,CAAK,WAAW,MAAA,EAAQ,GAAA,EAAK,KAAK,GAAA,CAAI,GAAA,GAAM,CAAA,EAAG,CAAC,CAAC,CAAA;AAC1D,QAAA;AAAA,MACF,KAAK,WAAA;AACH,QAAA,MAAA,GAAS,IAAA,CAAK,UAAA,CAAW,MAAA,EAAQ,IAAA,CAAK,GAAA,CAAI,GAAA,GAAM,CAAA,EAAG,MAAA,CAAO,MAAA,GAAS,CAAC,CAAA,EAAG,GAAG,CAAA;AAC1E,QAAA;AAAA,MACF,KAAK,SAAA;AACH,QAAA,MAAA,GAAS,IAAA,CAAK,WAAW,MAAA,EAAQ,IAAA,CAAK,IAAI,GAAA,GAAM,CAAA,EAAG,CAAC,CAAA,EAAG,GAAG,CAAA;AAC1D,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA,MAAA,GAAS,KAAA,CAAM,UAAU,IAAA,CAAK,UAAA,CAAW,QAAQ,CAAA,EAAG,CAAC,CAAA,GAAI,QAAA,CAAS,CAAC,CAAA;AACnE,QAAA;AAAA,MACF,KAAK,KAAA;AACH,QAAA,MAAA,GAAS,KAAA,CAAM,OAAA,GACX,IAAA,CAAK,UAAA,CAAW,QAAQ,MAAA,CAAO,MAAA,GAAS,CAAA,EAAG,MAAA,CAAO,iBAAiB,CAAA,GACnE,QAAA,CAAS,QAAA,CAAS,SAAS,CAAC,CAAA;AAChC,QAAA;AAAA,MACF,KAAK,OAAA;AAAA,MACL,KAAK,GAAA;AACH,QAAA,IAAA,CAAK,UAAU,IAAI,CAAA;AACnB,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA;AAAA,MACF;AACE,QAAA;AAAA;AAGJ,IAAA,IAAI,MAAA,EAAQ;AACV,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,IAAA,CAAK,cAAA,CAAe,MAAA,EAAQ,EAAE,KAAA,EAAO,MAAM,CAAA;AAAA,IAC7C;AAAA,EACF;AAAA;AAAA,EAGA,UAAU,IAAA,EAAyB;AACjC,IAAA,IAAI,IAAA,CAAK,mBAAA,CAAoB,QAAA,CAAS,IAAI,CAAA,EAAG;AAC3C,MAAA,IAAA,CAAK,WAAW,IAAI,CAAA;AACpB,MAAA;AAAA,IACF;AACA,IAAA,IAAI,IAAA,CAAK,mBAAmB,MAAA,EAAQ;AACpC,IAAA,MAAM,GAAA,GAAM,IAAA,CAAK,OAAA,CAAqB,cAAc,CAAA;AACpD,IAAA,IAAI,GAAA,IAAO,KAAK,UAAA,CAAW,QAAA,CAAS,GAAG,CAAA,EAAG,IAAA,CAAK,WAAW,GAAG,CAAA;AAAA,EAC/D;AAAA;AAAA,EAGA,WAAW,MAAA,EAA2B;AACpC,IAAA,MAAM,YAAY,iBAAA,CAAkB,MAAA,CAAO,YAAA,CAAa,WAAW,KAAK,MAAM,CAAA;AAC9E,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,mBAAA,EAAqB;AAC5C,MAAA,KAAA,CAAM,YAAA,CAAa,WAAA,EAAa,KAAA,KAAU,MAAA,GAAS,YAAY,MAAM,CAAA;AAAA,IACvE;AACA,IAAA,IAAA,CAAK,QAAA,CAAS,QAAQ,EAAE,MAAA,EAAQ,EAAE,MAAA,EAAQ,MAAA,EAAQ,SAAA,EAAU,EAAG,CAAA;AAAA,EACjE;AAAA;AAAA,EAGA,WAAW,GAAA,EAAwB;AACjC,IAAA,MAAM,QAAA,GAAW,GAAA,CAAI,YAAA,CAAa,eAAe,CAAA,KAAM,MAAA;AAIvD,IAAA,IAAI,IAAA,CAAK,mBAAmB,QAAA,EAAU;AACpC,MAAA,KAAA,MAAW,KAAA,IAAS,KAAK,UAAA,EAAY;AACnC,QAAA,IAAI,KAAA,KAAU,GAAA,EAAK,KAAA,CAAM,YAAA,CAAa,iBAAiB,OAAO,CAAA;AAAA,MAChE;AAAA,IACF;AACA,IAAA,GAAA,CAAI,YAAA,CAAa,eAAA,EAAiB,QAAA,GAAW,OAAA,GAAU,MAAM,CAAA;AAE7D,IAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,CAAW,MAAA,CAAO,CAAC,MAAM,CAAA,CAAE,YAAA,CAAa,eAAe,CAAA,KAAM,MAAM,CAAA;AACrF,IAAA,IAAA,CAAK,SAAS,iBAAA,EAAmB,EAAE,QAAQ,EAAE,IAAA,IAAQ,CAAA;AAAA,EACvD;AAAA;AAAA,EAGA,cAAA,CAAe,IAAA,EAA+B,EAAE,KAAA,EAAM,EAA6B;AACjF,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,KAAA,MAAW,SAAA,IAAa,IAAA,CAAK,eAAA,EAAgB,EAAG;AAC9C,MAAA,SAAA,CAAU,QAAA,GAAW,SAAA,KAAc,IAAA,GAAO,CAAA,GAAI,EAAA;AAAA,IAChD;AACA,IAAA,IAAI,KAAA,OAAY,KAAA,EAAM;AAAA,EACxB;AAAA;AAAA,EAGA,eAAA,GAAiC;AAC/B,IAAA,OAAO,IAAA,CAAK,OAAA,EAAQ,CAAE,IAAA,EAAK;AAAA,EAC7B;AAAA;AAAA,EAGA,OAAA,GAA2B;AACzB,IAAA,MAAM,SAAA,mBAAY,IAAI,GAAA,CAAiB,CAAC,GAAG,KAAK,mBAAA,EAAqB,GAAG,IAAA,CAAK,WAAW,CAAC,CAAA;AACzF,IAAA,MAAM,OAAO,KAAA,CAAM,IAAA,CAAK,KAAK,OAAA,CAAQ,gBAAA,CAA8B,cAAc,CAAC,CAAA;AAClF,IAAA,OAAO,IAAA,CACJ,GAAA;AAAA,MAAI,CAAC,GAAA,KACJ,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,QAAQ,CAAA,CAAE,MAAA;AAAA,QAAO,CAAC,KAAA,KAC/B,SAAA,CAAU,GAAA,CAAI,KAAoB;AAAA;AACpC,MAED,MAAA,CAAO,CAAC,KAAA,KAAU,KAAA,CAAM,SAAS,CAAC,CAAA;AAAA,EACvC;AAAA;AAAA,EAGA,OAAA,CAAQ,QAAyB,IAAA,EAA4C;AAC3E,IAAA,KAAA,IAAS,GAAA,GAAM,CAAA,EAAG,GAAA,GAAM,MAAA,CAAO,QAAQ,GAAA,EAAA,EAAO;AAC5C,MAAA,MAAM,OAAO,MAAA,CAAO,GAAG,KAAK,EAAC,EAAG,QAAQ,IAAI,CAAA;AAC5C,MAAA,IAAI,GAAA,KAAQ,EAAA,EAAI,OAAO,CAAC,KAAK,GAAG,CAAA;AAAA,IAClC;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAGA,UAAA,CAAW,MAAA,EAAyB,GAAA,EAAa,GAAA,EAAsC;AACrF,IAAA,MAAM,KAAA,GAAQ,OAAO,GAAG,CAAA;AACxB,IAAA,IAAI,CAAC,KAAA,IAAS,KAAA,CAAM,MAAA,KAAW,GAAG,OAAO,MAAA;AACzC,IAAA,OAAO,MAAM,IAAA,CAAK,GAAA,CAAI,KAAK,KAAA,CAAM,MAAA,GAAS,CAAC,CAAC,CAAA;AAAA,EAC9C;AACF","file":"data_grid_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","import { Controller } from \"@hotwired/stimulus\";\nimport { isReservedArrowChord, logicalArrowKey } from \"../utils/arrow_step\";\n\n/** Cycle order for a sortable column header's `aria-sort`. */\nconst SORT_CYCLE = [\"none\", \"ascending\", \"descending\"] as const;\ntype SortDirection = (typeof SORT_CYCLE)[number];\n\n/**\n * Returns the next `aria-sort` direction in the cycle after `current`. Unknown or\n * ARIA-only values (e.g. `\"other\"`, or an empty/missing attribute) are treated as\n * `\"none\"`, so the first activation always advances to `\"ascending\"` instead of\n * stalling.\n */\nfunction nextSortDirection(current: string): SortDirection {\n  const index = SORT_CYCLE.indexOf(current as SortDirection);\n  const from = index < 0 ? 0 : index;\n  return SORT_CYCLE[(from + 1) % SORT_CYCLE.length] ?? \"ascending\";\n}\n\n/**\n * Headless, accessible **Data Grid** behavior: column sorting, row selection, and\n * roving keyboard navigation over an interactive table.\n *\n * Markup contract (identifier: `stimeo--data-grid`):\n *   <table data-controller=\"stimeo--data-grid\" role=\"grid\" aria-label=\"Users\"\n *          data-stimeo--data-grid-selection-value=\"single\">\n *     <thead><tr role=\"row\">\n *       <th role=\"columnheader\" aria-sort=\"none\" tabindex=\"-1\"\n *           data-stimeo--data-grid-target=\"columnHeader\"\n *           data-action=\"click->stimeo--data-grid#sort\n *                        keydown->stimeo--data-grid#onKeydown\">Name</th>\n *     </tr></thead>\n *     <tbody><tr role=\"row\" aria-selected=\"false\"\n *                data-stimeo--data-grid-target=\"row\">\n *       <td role=\"gridcell\" tabindex=\"0\" data-stimeo--data-grid-target=\"cell\"\n *           data-action=\"keydown->stimeo--data-grid#onKeydown\">Jane</td>\n *     </tr></tbody>\n *   </table>\n *\n * Implements the WAI-ARIA APG **Grid** pattern plus `aria-sort`. The whole grid is\n * a single Tab stop (roving `tabindex`: exactly one cell/header is `0`, the rest\n * `-1`); arrow keys move both DOM focus and that tabbable position. Sort state is\n * exposed via `aria-sort` on headers, selection via `aria-selected` on rows.\n *\n * `selectionchange` dispatches `{ rows: HTMLElement[] }`; `sort` dispatches\n * `{ column: HTMLElement, direction: \"ascending\" | \"descending\" | \"none\" }`.\n *\n * @remarks\n * Behavior only — the consumer performs the actual data sort/render in response to\n * the `sort` event and owns all styling. No timers or observers are held, so there\n * is nothing to leak across Turbo navigations; `connect()` rebuilds the single tab\n * stop idempotently from the DOM.\n *\n * Behavior provided:\n * - `Arrow*` move between cells (clamped at edges); `Home`/`End` to the row's\n *   first/last cell; `Ctrl+Home`/`Ctrl+End` to the grid's first/last cell.\n * - `Enter`/`Space` cycles a header's sort (`none→ascending→descending`) or toggles\n *   the focused row's selection when selection is enabled.\n */\nexport class DataGridController extends Controller<HTMLElement> {\n  static override targets = [\"columnHeader\", \"row\", \"cell\"];\n  static override values = {\n    selection: { type: String, default: \"none\" },\n  };\n  static actions = [\"onKeydown\", \"sort\", \"toggleSelect\"] as const;\n  static events = [\"selectionchange\", \"sort\"] as const;\n\n  declare readonly columnHeaderTargets: HTMLElement[];\n  declare readonly rowTargets: HTMLElement[];\n  declare readonly cellTargets: HTMLElement[];\n  declare selectionValue: string;\n\n  /** Gates the row callback so it does not re-walk every row once per authored row on mount. */\n  #connected = false;\n\n  /**\n   * Establishes a single tab stop across all navigable cells/headers and brings\n   * the rows to their baseline.\n   *\n   * Normalizing here rather than leaving it to {@link selectionValueChanged}\n   * guarantees exactly one pass per mount: a re-attached element reuses its\n   * cached Stimulus context, whose value observer already knows the `selection`\n   * attribute, so the Value callback does not fire a second time.\n   */\n  override connect(): void {\n    const cells = this.#navigableCells();\n    const active = cells.find((cell) => cell.tabIndex === 0) ?? cells[0];\n    this.#setActiveCell(active, { focus: false });\n    this.#normalizeSelection();\n    this.#connected = true;\n  }\n\n  /** Reopens the row callback for the next mount. */\n  override disconnect(): void {\n    this.#connected = false;\n  }\n\n  /**\n   * Keeps `aria-multiselectable` in step with the `selection` Value. Fires on connect\n   * (so it self-heals after a Turbo morph) and on any runtime change, so the ARIA\n   * never drifts from the selection logic, which reads `selectionValue` live.\n   */\n  selectionValueChanged(): void {\n    this.#syncSelectable();\n    this.#normalizeSelection();\n  }\n\n  /**\n   * Re-establishes the row baseline for a row added after connect.\n   *\n   * Each pass walks every row, and Stimulus reports the authored rows one by one\n   * before `connect()`, so the mount is gated to keep it linear in the row count\n   * rather than quadratic; `connect()` runs the single baseline pass instead.\n   */\n  rowTargetConnected(): void {\n    if (!this.#connected) return;\n    this.#normalizeSelection();\n  }\n\n  /**\n   * Brings the authored rows to the shape the APG requires, without changing\n   * which rows the author chose.\n   *\n   * Every selectable row gets an explicit value — an absent `aria-selected` means\n   * \"not selectable\" in ARIA, so a forgotten attribute hides a selectable row —\n   * and a single-select grid keeps at most one `true`, first in DOM order.\n   * A grid that declares `selection=\"none\"` has no selectable rows, so the\n   * attribute is removed rather than written: in ARIA its absence is what \"not\n   * selectable\" looks like.\n   */\n  #normalizeSelection(): void {\n    const rows = this.rowTargets;\n    if (this.selectionValue === \"none\") {\n      // Reclaim, do not merely skip: a grid that *became* unselectable would\n      // otherwise keep announcing rows as selected while the logic refuses to\n      // change them. In ARIA the absence of the attribute is what \"not\n      // selectable\" looks like, so the rows have to lose it outright.\n      for (const row of rows) row.removeAttribute(\"aria-selected\");\n      return;\n    }\n    const single = this.selectionValue === \"single\";\n    const first = rows.find((row) => row.getAttribute(\"aria-selected\") === \"true\");\n    for (const row of rows) {\n      if (single) {\n        row.setAttribute(\"aria-selected\", row === first ? \"true\" : \"false\");\n      } else if (row.getAttribute(\"aria-selected\") !== \"true\") {\n        row.setAttribute(\"aria-selected\", \"false\");\n      }\n    }\n  }\n\n  /**\n   * Mirrors `selection=\"multiple\"` onto `aria-multiselectable` (APG Grid) so SRs\n   * announce that more than one row can be selected; cleared for single/none so a\n   * grid never carries a misleading attribute.\n   */\n  #syncSelectable(): void {\n    if (this.selectionValue === \"multiple\") {\n      this.element.setAttribute(\"aria-multiselectable\", \"true\");\n    } else {\n      this.element.removeAttribute(\"aria-multiselectable\");\n    }\n  }\n\n  /** Cycles the activated column header's sort and emits `sort`. */\n  sort(event: Event): void {\n    const header = event.currentTarget as HTMLElement;\n    if (!this.columnHeaderTargets.includes(header)) return;\n\n    const direction = nextSortDirection(header.getAttribute(\"aria-sort\") ?? \"none\");\n\n    // Only one column is sorted at a time: reset the others to `none`.\n    for (const other of this.columnHeaderTargets) {\n      other.setAttribute(\"aria-sort\", other === header ? direction : \"none\");\n    }\n\n    this.#setActiveCell(header, { focus: false });\n    this.dispatch(\"sort\", { detail: { column: header, direction } });\n  }\n\n  /** Toggles selection of the row owning the event target. Bound optionally. */\n  toggleSelect(event: Event): void {\n    // The pointer path guards on `selection=\"none\"` exactly as the keyboard path\n    // does, so a grid that declares itself unselectable never grows selected rows.\n    if (this.selectionValue === \"none\") return;\n    const row = (event.currentTarget as HTMLElement).closest<HTMLElement>(\"[role='row']\");\n    if (row && this.rowTargets.includes(row)) this.#toggleRow(row);\n  }\n\n  /** Grid navigation + sort/select activation. Bound to cells and headers. */\n  onKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key (a grabbed drag handle, a\n    // nested menu) must not ALSO act on it — composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (isReservedArrowChord(event)) return;\n    const cell = event.currentTarget as HTMLElement;\n    const matrix = this.#matrix();\n    const position = this.#locate(matrix, cell);\n    if (!position) return;\n    const [row, col] = position;\n    const rowCells = matrix[row] ?? [];\n\n    let target: HTMLElement | undefined;\n    // Logical, not physical. The key is normalised rather than the\n    // delta negated: these two branches are not mirror images — their guards\n    // differ — so swapping the key keeps each guard with its own direction.\n    switch (logicalArrowKey(event.key, this.element)) {\n      case \"ArrowRight\":\n        target = this.#cellInRow(matrix, row, col + 1);\n        break;\n      case \"ArrowLeft\":\n        target = this.#cellInRow(matrix, row, Math.max(col - 1, 0));\n        break;\n      case \"ArrowDown\":\n        target = this.#cellInRow(matrix, Math.min(row + 1, matrix.length - 1), col);\n        break;\n      case \"ArrowUp\":\n        target = this.#cellInRow(matrix, Math.max(row - 1, 0), col);\n        break;\n      case \"Home\":\n        target = event.ctrlKey ? this.#cellInRow(matrix, 0, 0) : rowCells[0];\n        break;\n      case \"End\":\n        target = event.ctrlKey\n          ? this.#cellInRow(matrix, matrix.length - 1, Number.POSITIVE_INFINITY)\n          : rowCells[rowCells.length - 1];\n        break;\n      case \"Enter\":\n      case \" \":\n        this.#activate(cell);\n        event.preventDefault();\n        return;\n      default:\n        return;\n    }\n\n    if (target) {\n      event.preventDefault();\n      this.#setActiveCell(target, { focus: true });\n    }\n  }\n\n  /** Performs a header's sort or a cell row's selection toggle on activation. */\n  #activate(cell: HTMLElement): void {\n    if (this.columnHeaderTargets.includes(cell)) {\n      this.#cycleSort(cell);\n      return;\n    }\n    if (this.selectionValue === \"none\") return;\n    const row = cell.closest<HTMLElement>(\"[role='row']\");\n    if (row && this.rowTargets.includes(row)) this.#toggleRow(row);\n  }\n\n  /** Shared sort logic for both click and keyboard activation. */\n  #cycleSort(header: HTMLElement): void {\n    const direction = nextSortDirection(header.getAttribute(\"aria-sort\") ?? \"none\");\n    for (const other of this.columnHeaderTargets) {\n      other.setAttribute(\"aria-sort\", other === header ? direction : \"none\");\n    }\n    this.dispatch(\"sort\", { detail: { column: header, direction } });\n  }\n\n  /** Toggles a row's `aria-selected`, honoring single vs. multiple selection. */\n  #toggleRow(row: HTMLElement): void {\n    const selected = row.getAttribute(\"aria-selected\") === \"true\";\n    // Enforce single-ness on every toggle, not only when turning a row on:\n    // switching one *off* would otherwise leave a second `true` behind, and\n    // nothing else clears it for the rest of the session.\n    if (this.selectionValue === \"single\") {\n      for (const other of this.rowTargets) {\n        if (other !== row) other.setAttribute(\"aria-selected\", \"false\");\n      }\n    }\n    row.setAttribute(\"aria-selected\", selected ? \"false\" : \"true\");\n\n    const rows = this.rowTargets.filter((r) => r.getAttribute(\"aria-selected\") === \"true\");\n    this.dispatch(\"selectionchange\", { detail: { rows } });\n  }\n\n  /** Makes `cell` the single tabbable cell (roving) and optionally focuses it. */\n  #setActiveCell(cell: HTMLElement | undefined, { focus }: { focus: boolean }): void {\n    if (!cell) return;\n    for (const candidate of this.#navigableCells()) {\n      candidate.tabIndex = candidate === cell ? 0 : -1;\n    }\n    if (focus) cell.focus();\n  }\n\n  /** All navigable elements (headers + cells) in DOM order. */\n  #navigableCells(): HTMLElement[] {\n    return this.#matrix().flat();\n  }\n\n  /** The grid as rows of navigable cells, derived from each `role=\"row\"`. */\n  #matrix(): HTMLElement[][] {\n    const navigable = new Set<HTMLElement>([...this.columnHeaderTargets, ...this.cellTargets]);\n    const rows = Array.from(this.element.querySelectorAll<HTMLElement>(\"[role='row']\"));\n    return rows\n      .map((row) =>\n        Array.from(row.children).filter((child): child is HTMLElement =>\n          navigable.has(child as HTMLElement),\n        ),\n      )\n      .filter((cells) => cells.length > 0);\n  }\n\n  /** Finds `[rowIndex, colIndex]` of `cell` within `matrix`, or null. */\n  #locate(matrix: HTMLElement[][], cell: HTMLElement): [number, number] | null {\n    for (let row = 0; row < matrix.length; row++) {\n      const col = (matrix[row] ?? []).indexOf(cell);\n      if (col !== -1) return [row, col];\n    }\n    return null;\n  }\n\n  /** The cell at `[row, col]`, clamping `col` to that row's last cell. */\n  #cellInRow(matrix: HTMLElement[][], row: number, col: number): HTMLElement | undefined {\n    const cells = matrix[row];\n    if (!cells || cells.length === 0) return undefined;\n    return cells[Math.min(col, cells.length - 1)];\n  }\n}\n"]}

package/dist/controllers/date_range_picker_controller.d.ts

@@ -8,7 +8,8 @@ import { Controller } from '@hotwired/stimulus';
  * Markup contract (identifier: `stimeo--date-range-picker`):
  *   <div data-controller="stimeo--date-range-picker"
  *        data-stimeo--date-range-picker-min-value="2026-01-01"
- *        data-stimeo--date-range-picker-max-value="2026-12-31">
+ *        data-stimeo--date-range-picker-max-value="2026-12-31"
+ *        data-stimeo--date-range-picker-disabled-dates-value='["2026-06-15"]'>
  *     <button data-action="stimeo--date-range-picker#prev">Prev</button>
  *     <span data-stimeo--date-range-picker-target="monthLabel" aria-live="polite"></span>
  *     <button data-action="stimeo--date-range-picker#next">Next</button>
@@ -36,8 +37,18 @@ import { Controller } from '@hotwired/stimulus';
  *
  * Selection model: the first click/Enter sets a *pending* start and enters
  * "selecting" mode (preview follows the pointer/focus); the second confirms the
- * end (auto-swapped if earlier than the start) and dispatches `change`. Escape
- * abandons an in-progress selection, restoring the last confirmed range.
+ * end (auto-swapped if earlier than the start) and dispatches `change` with
+ * `{ start, end }` ISO dates. Escape abandons an in-progress selection,
+ * restoring the last confirmed range.
+ *
+ * Availability is declarative on both axes: `min` / `max` bound the selectable
+ * interval and `disabledDates` excludes individual dates inside it. Both are
+ * render inputs, so a cell's `aria-disabled` is derived during the paint that
+ * needs it rather than written back afterwards — selection, preview, and the
+ * grid paint all read one predicate and cannot disagree. A painted-month
+ * navigation dispatches `monthchange` with `{ month }` as a notification (for
+ * fetching a month's availability, say); the fetched result comes back in
+ * through `disabledDates`, which repaints on its own.
  */
 declare class DateRangePickerController extends Controller<HTMLElement> {
     #private;
@@ -51,9 +62,13 @@ declare class DateRangePickerController extends Controller<HTMLElement> {
             type: StringConstructor;
             default: string;
         };
+        disabledDates: {
+            type: StringConstructor;
+            default: string;
+        };
     };
     static actions: readonly ["applyPreset", "next", "onKeydown", "prev", "previewTo", "selectDate"];
-    static events: readonly ["change"];
+    static events: readonly ["change", "monthchange"];
     readonly gridTarget: HTMLElement;
     readonly hasGridTarget: boolean;
     readonly monthLabelTarget: HTMLElement;
@@ -67,6 +82,8 @@ declare class DateRangePickerController extends Controller<HTMLElement> {
     readonly hasEndFieldTarget: boolean;
     minValue: string;
     maxValue: string;
+    disabledDatesValue: string;
+    /** Seeds and normalizes the range from optional hidden fields, then paints the grid. */
     connect(): void;
     /** Cancels any pending deferred focus so it never fires on a detached element. */
     disconnect(): void;
@@ -74,6 +91,8 @@ declare class DateRangePickerController extends Controller<HTMLElement> {
     minValueChanged(): void;
     /** Repaints when application code (or a Turbo morph) changes `max` at runtime. */
     maxValueChanged(): void;
+    /** Re-indexes the unavailable dates and repaints when the declared set changes. */
+    disabledDatesValueChanged(): void;
     /** Navigates to the previous month. */
     prev(event?: Event): void;
     /** Navigates to the next month. */