stimeo-ui 0.16.0 → 0.17.0

package/dist/controllers/calendar_controller.d.ts

@@ -15,7 +15,7 @@ import { Controller } from '@hotwired/stimulus';
  *     <table role="grid">
  *       <tbody data-stimeo--calendar-target="grid"
  *              data-action="keydown->stimeo--calendar#onKeydown
- *                           click->stimeo--calendar#selectByClick">
+ *                           click->stimeo--calendar#select">
  *         <!-- Markup must contain exactly 42 day targets (7 days x 6 rows) -->
  *         <tr role="row">
  *           <td role="gridcell" data-stimeo--calendar-target="day" tabindex="-1"></td>
@@ -64,6 +64,10 @@ import { Controller } from '@hotwired/stimulus';
  * or connecting again, reports neither `monthchange` nor `reconcile`, whichever
  * month the grid opens on.
  *
+ * A pick is measured from the selection last published. Selecting it again
+ * reports nothing; a page request still awaiting its paint is included in the
+ * user's pick. Listen to cell clicks separately to observe repeated activation.
+ *
  * Two optional fields carry the grid's state into a form, so a server can serve
  * the days it is showing: `field` mirrors the published selection (`YYYY-MM-DD`,
  * empty when nothing is selected) and `monthField` the month being painted
@@ -116,7 +120,15 @@ declare class CalendarController extends Controller<HTMLElement> {
             default: string;
         };
     };
-    static actions: readonly ["next", "onKeydown", "prev", "selectByClick"];
+    static valueConstraints: {
+        weekStart: {
+            finite: true;
+            integer: true;
+            min: number;
+            max: number;
+        };
+    };
+    static actions: readonly ["next", "onKeydown", "prev", "select"];
     static events: readonly ["monthchange", "reconcile", "select"];
     readonly labelTarget: HTMLElement;
     readonly gridTarget: HTMLElement;
@@ -177,15 +189,22 @@ declare class CalendarController extends Controller<HTMLElement> {
     prev(event?: Event): void;
     /** Navigates to the next month. */
     next(event?: Event): void;
-    /** Handles day selection when a gridcell is clicked. */
-    selectByClick(event: MouseEvent): void;
+    /** Selects an owned day or a descendant, preserving focus outside the grid. */
+    select(source: Event | HTMLElement): void;
     /** Handles grid cell keyboard navigation and triggers selection. */
     onKeydown(event: KeyboardEvent): void;
+    /** Repaints so a month label inserted or replaced at runtime names the month on screen. */
+    labelTargetConnected(): void;
+    /** Repaints so the label that stays when an earlier one leaves names the month on screen. */
+    labelTargetDisconnected(): void;
     /** Fills a selected-day field inserted or replaced at runtime with the published selection. */
     fieldTargetConnected(field: HTMLInputElement): void;
+    /** Repaints so the day field that stays when an earlier one leaves holds the selection. */
+    fieldTargetDisconnected(): void;
     /** Fills a painted-month field inserted or replaced at runtime. */
     monthFieldTargetConnected(field: HTMLInputElement): void;
-    selectDayElement(dayElement: HTMLElement): void;
+    /** Repaints so the painted-month field that stays when an earlier one leaves holds the month. */
+    monthFieldTargetDisconnected(): void;
 }
 
 export { CalendarController };