Event Calendar — Editing

1"use client";
2 
3/**
4 * The editing feature's Provider — the implementation `event-calendar`'s
5 * `editing?: CalendarEditExtension` prop wires in. Mounted by
6 * `EventCalendarRoot` (base) only when BOTH `editable` and `editing` are set.
7 *
8 * Reads the base calendar context (`useCalendar()`) for the fields the edit
9 * state machine and gestures need (occurrences / view / focusDate /
10 * scrollToHour / selectedId / select / statusOptions) — it is rendered INSIDE
11 * `CalendarContext.Provider`, so this resolves. Runs the `useCalendarEdit`
12 * state machine, builds the `@dnd-kit` sensors + `onDragEnd` (day-granular
13 * drag-to-reschedule), the cross-surface clipboard effect, the focus-restore
14 * effect (F-11), and the `handleEventKey` / `handleDayEnterKey` /
15 * `handleMethods` glue the base Root's keyboard router + imperative handle
16 * delegate to — then supplies the whole `CalendarEditContextValue`
17 * (dispatchers + transient UI state + the `components`/`gestures` records the
18 * base parts render through) via `CalendarEditContext`, wrapped in the
19 * `DndContext`. Mounts nothing visual itself.
20 */
21 
22import { useCallback, useEffect, useMemo, useRef } from "react";
23import type { KeyboardEvent, ReactNode } from "react";
24import { DndContext, PointerSensor, useSensor, useSensors } from "@dnd-kit/core";
25import type { DragEndEvent } from "@dnd-kit/core";
26import { addDays, differenceInCalendarDays, startOfDay } from "date-fns";
27import { useCalendar } from "../../hooks/use-calendar-context";
28import { CalendarEditContext } from "../../hooks/use-calendar-edit-extension";
29import type {
30  CalendarEditContextValue,
31  CalendarEditProps,
32} from "../../hooks/use-calendar-edit-extension";
33import { coveredDays } from "../../lib/segments";
34import { snapStepMs } from "./lib/edit-mutations";
35import { useCalendarEdit } from "./hooks/use-calendar-edit";
36import { useCalendarClipboard } from "./lib/clipboard-effect";
37import { createTimeGridGestures, BandDropCell } from "./lib/time-grid-gestures";
38import { DraggableEventWrap } from "./parts/calendar-edit-affordances";
39import { DroppableDayCell } from "./parts/droppable-day-cell";
40import { CalendarEventContextMenu } from "./parts/calendar-context-menu";
41import {
42  CalendarEventEditorOverlay,
43  CalendarRenameField,
44  EventEditorPanel,
45} from "./parts/calendar-edit-overlays";
46import { CalendarQuickComposer } from "./parts/calendar-quick-composer";
47import type { CalendarOccurrence, TaskItem } from "../../types";
48 
49// … truncated