@forcecalendar/interface 1.2.0 → 1.4.0

package/types/core/DragController.d.ts

@@ -0,0 +1,56 @@
+/**
+ * DragController - pointer-driven interactions for calendar views.
+ *
+ * Implements drag-to-move (month and time grids), drag-to-resize, and
+ * drag-to-create using Pointer Events only: no HTML5 drag-and-drop (which
+ * misbehaves in shadow roots), no dependencies, Locker Service safe.
+ *
+ * Keyboard users have equivalent paths via the WAI-ARIA grid navigation
+ * (arrow keys + Enter) that every view already implements.
+ */
+/** Snap a minute offset to the grid. Exported for tests. */
+export declare function snapMinutes(minutes: any, snap?: number): number;
+/** Clamp a start minute so [start, start+duration] stays inside a day. */
+export declare function clampStartMinutes(startMinutes: any, durationMinutes: any): number;
+/**
+ * Combine a target day with an original start's time-of-day.
+ * Exported for tests.
+ */
+export declare function moveDatePreservingTime(targetDay: any, originalStart: any): Date;
+export declare class DragController {
+    renderer: any;
+    container: any;
+    stateManager: any;
+    _active: any;
+    _docListeners: any[];
+    _columnSelector: any;
+    _selectionEl: any;
+    constructor(renderer: any);
+    /** Month view: drag an event chip onto another day cell. */
+    enableMonthMove(): void;
+    /**
+     * Time grids (week/day): drag events vertically/across columns to move,
+     * drag the bottom handle to resize, drag empty grid to create.
+     */
+    enableTimeGrid(columnSelector: any): void;
+    /** Track from pointerdown; promote to a drag past the threshold. */
+    _arm(e: any, spec: any): void;
+    _onPointerMove(e: any): void;
+    _onPointerUp(e: any): void;
+    _cancel(): void;
+    _teardownDocListeners(): void;
+    _cleanupVisuals(a: any): void;
+    _cellAtPoint(x: any, y: any): any;
+    _monthDragMove(e: any): void;
+    _monthDrop(): void;
+    _columnAtPoint(x: any): any;
+    _timeMoveDragMove(e: any): void;
+    _timeMoveDrop(): void;
+    _resizeDragMove(e: any): void;
+    _resizeDrop(): void;
+    _createDragMove(e: any): void;
+    _createDrop(): void;
+    /** Append a resize handle to every timed event (idempotent per render). */
+    _injectResizeHandles(): void;
+}
+export default DragController;

package/types/renderers/BaseViewRenderer.d.ts

@@ -10,6 +10,13 @@ export declare class BaseViewRenderer {
     _listeners: any[];
     _scrolled: boolean;
     _nowIndicatorTimer: number | null;
+    _pendingSlotFocus: {
+        colIndex: number;
+        hour: number;
+    } | {
+        colIndex: number;
+        hour: number;
+    } | null | undefined;
     /**
      * @param {HTMLElement} container - The DOM element to render into
      * @param {StateManager} stateManager - The state manager instance
@@ -113,6 +120,28 @@ export declare class BaseViewRenderer {
      */
     attachCommonEventHandlers(): void;
     _selectEventFromElement(eventEl: any): void;
+    /**
+     * WAI-ARIA semantics and keyboard navigation for time grids (week/day
+     * views). The DOM is column-major (a column per day, an hour line per
+     * slot), so each day column is exposed as a row of 24 hour gridcells.
+     * Arrow keys navigate visually: Up/Down moves hours, Left/Right moves
+     * days, Home/End jumps to the day's bounds, PageUp/PageDown navigates
+     * periods, Enter/Space selects the slot's date and time.
+     * @param {string} columnSelector - Selector for the day columns
+     * @param {string} gridLabel - Accessible label for the grid
+     */
+    _enhanceTimeGridAccessibility(columnSelector: string, gridLabel: string): void;
+    /**
+     * Get the hour slot at a column/hour position
+     * @private
+     */
+    private _slotAt;
+    /**
+     * Keep exactly one hour slot tabbable. Defaults to 9:00 AM in the
+     * first column (today's column when present).
+     * @private
+     */
+    private _applySlotRovingTabindex;
     /**
      * Make rendered events keyboard-reachable and screen-reader labeled.
      * Runs after every render, across all views.