stimeo-ui 0.2.0 → 0.2.1

package/dist/controllers/data_grid_controller.d.ts

@@ -0,0 +1,71 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible **Data Grid** behavior: column sorting, row selection, and
+ * roving keyboard navigation over an interactive table.
+ *
+ * Markup contract (identifier: `stimeo--data-grid`):
+ *   <table data-controller="stimeo--data-grid" role="grid" aria-label="Users"
+ *          data-stimeo--data-grid-selection-value="single">
+ *     <thead><tr role="row">
+ *       <th role="columnheader" aria-sort="none" tabindex="-1"
+ *           data-stimeo--data-grid-target="columnHeader"
+ *           data-action="click->stimeo--data-grid#sort
+ *                        keydown->stimeo--data-grid#onKeydown">Name</th>
+ *     </tr></thead>
+ *     <tbody><tr role="row" aria-selected="false"
+ *                data-stimeo--data-grid-target="row">
+ *       <td role="gridcell" tabindex="0" data-stimeo--data-grid-target="cell"
+ *           data-action="keydown->stimeo--data-grid#onKeydown">Jane</td>
+ *     </tr></tbody>
+ *   </table>
+ *
+ * Implements the WAI-ARIA APG **Grid** pattern plus `aria-sort`. The whole grid is
+ * a single Tab stop (roving `tabindex`: exactly one cell/header is `0`, the rest
+ * `-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.
+ *
+ * @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
+ * is nothing to leak across Turbo navigations; `connect()` rebuilds the single tab
+ * stop idempotently from the DOM.
+ *
+ * Behavior provided:
+ * - `Arrow*` move between cells (clamped at edges); `Home`/`End` to the row's
+ *   first/last cell; `Ctrl+Home`/`Ctrl+End` to the grid's first/last cell.
+ * - `Enter`/`Space` cycles a header's sort (`none→ascending→descending`) or toggles
+ *   the focused row's selection when selection is enabled.
+ */
+declare class DataGridController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        selection: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["onKeydown", "sort", "toggleSelect"];
+    static events: readonly ["selectionchange", "sort"];
+    readonly columnHeaderTargets: HTMLElement[];
+    readonly rowTargets: HTMLElement[];
+    readonly cellTargets: HTMLElement[];
+    selectionValue: string;
+    /** Establishes a single tab stop across all navigable cells/headers. */
+    connect(): void;
+    /**
+     * Keeps `aria-multiselectable` in step with the `selection` Value. Fires on connect
+     * (so it self-heals after a Turbo morph) and on any runtime change, so the ARIA
+     * never drifts from the selection logic, which reads `selectionValue` live.
+     */
+    selectionValueChanged(): void;
+    /** Cycles the activated column header's sort and emits `sort`. */
+    sort(event: Event): void;
+    /** Toggles selection of the row owning the event target. Bound optionally. */
+    toggleSelect(event: Event): void;
+    /** Grid navigation + sort/select activation. Bound to cells and headers. */
+    onKeydown(event: KeyboardEvent): void;
+}
+
+export { DataGridController };

package/dist/controllers/data_grid_controller.js

@@ -0,0 +1,168 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/data_grid_controller.ts
+var SORT_CYCLE = ["none", "ascending", "descending"];
+function nextSortDirection(current) {
+  const index = SORT_CYCLE.indexOf(current);
+  const from = index < 0 ? 0 : index;
+  return SORT_CYCLE[(from + 1) % SORT_CYCLE.length] ?? "ascending";
+}
+var DataGridController = class extends Controller {
+  static targets = ["columnHeader", "row", "cell"];
+  static values = {
+    selection: { type: String, default: "none" }
+  };
+  static actions = ["onKeydown", "sort", "toggleSelect"];
+  static events = ["selectionchange", "sort"];
+  /** Establishes a single tab stop across all navigable cells/headers. */
+  connect() {
+    const cells = this.#navigableCells();
+    const active = cells.find((cell) => cell.tabIndex === 0) ?? cells[0];
+    this.#setActiveCell(active, { focus: false });
+  }
+  /**
+   * Keeps `aria-multiselectable` in step with the `selection` Value. Fires on connect
+   * (so it self-heals after a Turbo morph) and on any runtime change, so the ARIA
+   * never drifts from the selection logic, which reads `selectionValue` live.
+   */
+  selectionValueChanged() {
+    this.#syncSelectable();
+  }
+  /**
+   * Mirrors `selection="multiple"` onto `aria-multiselectable` (APG Grid) so SRs
+   * announce that more than one row can be selected; cleared for single/none so a
+   * grid never carries a misleading attribute.
+   */
+  #syncSelectable() {
+    if (this.selectionValue === "multiple") {
+      this.element.setAttribute("aria-multiselectable", "true");
+    } else {
+      this.element.removeAttribute("aria-multiselectable");
+    }
+  }
+  /** Cycles the activated column header's sort and emits `sort`. */
+  sort(event) {
+    const header = event.currentTarget;
+    if (!this.columnHeaderTargets.includes(header)) return;
+    const direction = nextSortDirection(header.getAttribute("aria-sort") ?? "none");
+    for (const other of this.columnHeaderTargets) {
+      other.setAttribute("aria-sort", other === header ? direction : "none");
+    }
+    this.#setActiveCell(header, { focus: false });
+    this.dispatch("sort", { detail: { column: header, direction } });
+  }
+  /** Toggles selection of the row owning the event target. Bound optionally. */
+  toggleSelect(event) {
+    const row = event.currentTarget.closest("[role='row']");
+    if (row && this.rowTargets.includes(row)) this.#toggleRow(row);
+  }
+  /** Grid navigation + sort/select activation. Bound to cells and headers. */
+  onKeydown(event) {
+    const cell = event.currentTarget;
+    const matrix = this.#matrix();
+    const position = this.#locate(matrix, cell);
+    if (!position) return;
+    const [row, col] = position;
+    const rowCells = matrix[row] ?? [];
+    let target;
+    switch (event.key) {
+      case "ArrowRight":
+        target = this.#cellInRow(matrix, row, col + 1);
+        break;
+      case "ArrowLeft":
+        target = this.#cellInRow(matrix, row, Math.max(col - 1, 0));
+        break;
+      case "ArrowDown":
+        target = this.#cellInRow(matrix, Math.min(row + 1, matrix.length - 1), col);
+        break;
+      case "ArrowUp":
+        target = this.#cellInRow(matrix, Math.max(row - 1, 0), col);
+        break;
+      case "Home":
+        target = event.ctrlKey ? this.#cellInRow(matrix, 0, 0) : rowCells[0];
+        break;
+      case "End":
+        target = event.ctrlKey ? this.#cellInRow(matrix, matrix.length - 1, Number.POSITIVE_INFINITY) : rowCells[rowCells.length - 1];
+        break;
+      case "Enter":
+      case " ":
+        this.#activate(cell);
+        event.preventDefault();
+        return;
+      default:
+        return;
+    }
+    if (target) {
+      event.preventDefault();
+      this.#setActiveCell(target, { focus: true });
+    }
+  }
+  /** Performs a header's sort or a cell row's selection toggle on activation. */
+  #activate(cell) {
+    if (this.columnHeaderTargets.includes(cell)) {
+      this.#cycleSort(cell);
+      return;
+    }
+    if (this.selectionValue === "none") return;
+    const row = cell.closest("[role='row']");
+    if (row && this.rowTargets.includes(row)) this.#toggleRow(row);
+  }
+  /** Shared sort logic for both click and keyboard activation. */
+  #cycleSort(header) {
+    const direction = nextSortDirection(header.getAttribute("aria-sort") ?? "none");
+    for (const other of this.columnHeaderTargets) {
+      other.setAttribute("aria-sort", other === header ? direction : "none");
+    }
+    this.dispatch("sort", { detail: { column: header, direction } });
+  }
+  /** Toggles a row's `aria-selected`, honoring single vs. multiple selection. */
+  #toggleRow(row) {
+    const selected = row.getAttribute("aria-selected") === "true";
+    if (this.selectionValue === "single" && !selected) {
+      for (const other of this.rowTargets) other.setAttribute("aria-selected", "false");
+    }
+    row.setAttribute("aria-selected", selected ? "false" : "true");
+    const rows = this.rowTargets.filter((r) => r.getAttribute("aria-selected") === "true");
+    this.dispatch("selectionchange", { detail: { rows } });
+  }
+  /** Makes `cell` the single tabbable cell (roving) and optionally focuses it. */
+  #setActiveCell(cell, { focus }) {
+    if (!cell) return;
+    for (const candidate of this.#navigableCells()) {
+      candidate.tabIndex = candidate === cell ? 0 : -1;
+    }
+    if (focus) cell.focus();
+  }
+  /** All navigable elements (headers + cells) in DOM order. */
+  #navigableCells() {
+    return this.#matrix().flat();
+  }
+  /** The grid as rows of navigable cells, derived from each `role="row"`. */
+  #matrix() {
+    const navigable = /* @__PURE__ */ new Set([...this.columnHeaderTargets, ...this.cellTargets]);
+    const rows = Array.from(this.element.querySelectorAll("[role='row']"));
+    return rows.map(
+      (row) => Array.from(row.children).filter(
+        (child) => navigable.has(child)
+      )
+    ).filter((cells) => cells.length > 0);
+  }
+  /** Finds `[rowIndex, colIndex]` of `cell` within `matrix`, or null. */
+  #locate(matrix, cell) {
+    for (let row = 0; row < matrix.length; row++) {
+      const col = (matrix[row] ?? []).indexOf(cell);
+      if (col !== -1) return [row, col];
+    }
+    return null;
+  }
+  /** The cell at `[row, col]`, clamping `col` to that row's last cell. */
+  #cellInRow(matrix, row, col) {
+    const cells = matrix[row];
+    if (!cells || cells.length === 0) return void 0;
+    return cells[Math.min(col, cells.length - 1)];
+  }
+};
+
+export { DataGridController };
+//# sourceMappingURL=data_grid_controller.js.map
+//# sourceMappingURL=data_grid_controller.js.map

package/dist/controllers/data_grid_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/data_grid_controller.ts"],"names":[],"mappings":"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","file":"data_grid_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\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  /** Establishes a single tab stop across all navigable cells/headers. */\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  }\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  }\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    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    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    switch (event.key) {\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    if (this.selectionValue === \"single\" && !selected) {\n      for (const other of this.rowTargets) other.setAttribute(\"aria-selected\", \"false\");\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

@@ -0,0 +1,87 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible **date range picker** behavior. A derivative of
+ * {@link CalendarController}: it reuses the month-grid navigation model and adds
+ * two-point range selection, in-progress range preview, and presets.
+ *
+ * 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">
+ *     <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>
+ *     <div role="grid" data-stimeo--date-range-picker-target="grid">
+ *       <!-- exactly 42 cell targets (7 days × 6 rows) -->
+ *       <button role="gridcell" tabindex="-1"
+ *               data-stimeo--date-range-picker-target="cell"
+ *               data-action="click->stimeo--date-range-picker#selectDate
+ *                            mouseenter->stimeo--date-range-picker#previewTo
+ *                            focus->stimeo--date-range-picker#previewTo
+ *                            keydown->stimeo--date-range-picker#onKeydown"></button>
+ *     </div>
+ *     <button data-range="last7" data-action="stimeo--date-range-picker#applyPreset">…</button>
+ *     <span role="status" aria-live="polite" data-stimeo--date-range-picker-target="status"></span>
+ *     <input type="hidden" data-stimeo--date-range-picker-target="startField" />
+ *     <input type="hidden" data-stimeo--date-range-picker-target="endField" />
+ *   </div>
+ *
+ * @remarks
+ * Behavior only — the consumer styles the grid and renders the range using the
+ * `data-range-start` / `data-in-range` / `data-range-end` hooks. Assistive tech
+ * is told the two confirmed endpoints via `aria-selected`; inner cells use
+ * `data-in-range` (visual only) so the announcement stays to the two ends. The
+ * confirmed range is also mirrored to the live `status` region.
+ *
+ * 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.
+ */
+declare class DateRangePickerController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        min: {
+            type: StringConstructor;
+            default: string;
+        };
+        max: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["applyPreset", "next", "onKeydown", "prev", "previewTo", "selectDate"];
+    static events: readonly ["change"];
+    readonly gridTarget: HTMLElement;
+    readonly monthLabelTarget: HTMLElement;
+    readonly cellTargets: HTMLElement[];
+    readonly statusTarget: HTMLElement;
+    readonly startFieldTarget: HTMLInputElement;
+    readonly endFieldTarget: HTMLInputElement;
+    readonly hasMonthLabelTarget: boolean;
+    readonly hasStatusTarget: boolean;
+    readonly hasStartFieldTarget: boolean;
+    readonly hasEndFieldTarget: boolean;
+    minValue: string;
+    maxValue: string;
+    /** Seeds the range from any pre-filled hidden fields and renders the grid. */
+    connect(): void;
+    /** Cancels any pending deferred focus so it never fires on a detached element. */
+    disconnect(): void;
+    /** Navigates to the previous month. */
+    prev(event?: Event): void;
+    /** Navigates to the next month. */
+    next(event?: Event): void;
+    /** Confirms a range endpoint from a clicked cell. */
+    selectDate(event: Event): void;
+    /** Previews the range up to a hovered/focused cell while selecting. */
+    previewTo(event: Event): void;
+    /** Applies a named preset (`today` / `last7` / `last30` / `thisMonth`). */
+    applyPreset(event: Event): void;
+    /** Grid keyboard navigation, selection (Enter/Space), and Escape-to-cancel. */
+    onKeydown(event: KeyboardEvent): void;
+}
+
+export { DateRangePickerController };