import type { TemporalSupportedObject, TemporalTimezone } from "../../base-ui-copy/types/index.js";
import type { RecurringEventPresetKey, RecurringEventScope, RecurringEventWeekDayCode, SchedulerEventOccurrence, SchedulerEventRecurrenceRule, SchedulerEventUpdatedProperties, SchedulerProcessedDate, SchedulerProcessedEvent, SchedulerProcessedEventRecurrenceRule } from "../../models/index.js";
import type { Adapter } from "../../use-adapter/useAdapter.types.js";
import type { UpdateEventsParameters } from "../utils/SchedulerStore/SchedulerStore.types.js";
/** Contract implemented by the premium recurring-events plugin. */
export interface SchedulerRecurringEventsPluginInterface {
  /**
   * Parses a recurrence rule into a canonical `SchedulerProcessedEventRecurrenceRule`
   * expressed in the given timezone. String inputs are validated against RFC5545; object
   * inputs are trusted and normalized.
   */
  parseRRule(adapter: Adapter, input: string | SchedulerEventRecurrenceRule, timezone: TemporalTimezone): SchedulerProcessedEventRecurrenceRule;
  /**
   * Projects a recurrence rule from its data timezone to a different timezone.
   * The returned rule is a derived representation intended for UI purposes only.
   */
  projectRRuleToTimezone(adapter: Adapter, rrule: SchedulerProcessedEventRecurrenceRule, targetTimezone: TemporalTimezone, seriesStartDataTimezone: TemporalSupportedObject): SchedulerProcessedEventRecurrenceRule;
  /**
   * Expands a recurring event into the occurrences that fall within the visible range,
   * honoring COUNT/UNTIL boundaries and EXDATE exclusions.
   */
  getOccurrencesForVisibleDays(event: SchedulerProcessedEvent, start: TemporalSupportedObject, end: TemporalSupportedObject, adapter: Adapter, displayTimezone: TemporalTimezone): SchedulerEventOccurrence[];
  /**
   * Generates the update payload to apply when editing a recurring event, scoped to
   * a single occurrence, the occurrence and the following ones, or the entire series.
   */
  updateRecurringEvent(adapter: Adapter, originalEvent: SchedulerProcessedEvent, occurrenceStart: TemporalSupportedObject, changes: SchedulerEventUpdatedProperties, scope: RecurringEventScope): UpdateEventsParameters;
  /**
   * Generates the update payload to apply when deleting a recurring event, scoped to
   * a single occurrence, the occurrence and the following ones, or the entire series.
   */
  deleteRecurringEvent(adapter: Adapter, originalEvent: SchedulerProcessedEvent, occurrenceStart: TemporalSupportedObject, scope: RecurringEventScope): UpdateEventsParameters;
  /**
   * Normalizes display-timezone changes (start/end/rrule) back to the event's data
   * timezone before they are persisted.
   */
  applyDataTimezoneToEventUpdate(params: {
    adapter: Adapter;
    originalEvent: SchedulerProcessedEvent;
    changes: SchedulerEventUpdatedProperties;
  }): SchedulerEventUpdatedProperties;
  /**
   * Builds the recurrence presets (Daily / Weekly / Monthly / Yearly)
   * the user can choose from when editing an event.
   */
  computePresets(adapter: Adapter, date: SchedulerProcessedDate): Record<RecurringEventPresetKey, SchedulerProcessedEventRecurrenceRule>;
  /**
   * Determines which preset (if any) the given rule corresponds to.
   * Returns 'custom' if the rule does not match any preset, or `null` if no rule is provided.
   */
  getDefaultPresetKey(adapter: Adapter, rule: SchedulerProcessedEventRecurrenceRule | undefined, occurrenceStart: SchedulerProcessedDate): RecurringEventPresetKey | 'custom' | null;
  /**
   * Returns `true` if both recurrence rules serialize to the same RRULE string.
   */
  isSameRRule(adapter: Adapter, rruleA: SchedulerProcessedEventRecurrenceRule | undefined, rruleB: SchedulerProcessedEventRecurrenceRule | undefined): boolean;
  /**
   * Returns the 7 week days with their code and date,
   * starting at the start of the week containing the given visible date.
   */
  getWeeklyDays(adapter: Adapter, visibleDate: TemporalSupportedObject): {
    code: RecurringEventWeekDayCode;
    date: TemporalSupportedObject;
  }[];
  /**
   * Returns month reference for the given occurrence: dayOfMonth, weekday code and ordinal.
   */
  getMonthlyReference(adapter: Adapter, date: SchedulerProcessedDate): {
    dayOfMonth: number;
    code: RecurringEventWeekDayCode;
    ord: number;
    date: TemporalSupportedObject;
  };
}