[dev] add description for custom recurring modal

Author: AlexKlimenkov

docs/guides/recurring-events.md

@@ -471,6 +471,48 @@ For example:
 addEventListener(node, "click", function(){...})
 ~~~
 
+## Custom confirmation modal
+
+When a user edits or drags a recurring event, the scheduler displays a built-in modal that asks whether to modify just this occurrence, this and following events, or the entire series. You can replace it with your own UI by overriding `scheduler.ext.recurring.confirm`.
+
+~~~js
+scheduler.ext.recurring.confirm = function(context) {
+  // context contains:
+  // - origin: "lightbox" | "dnd"
+  // - occurrence: the occurrence event object
+  // - series: the parent series event object
+  // - labels: { title, ok, cancel, occurrence, following, series }
+  // - options: ["occurrence", "following", "series"]
+  //
+  // Return one of: "occurrence", "following", "series", or null to cancel.
+  // Can return a Promise for async UI.
+
+  return new Promise(function(resolve) {
+    myCustomDialog.show({
+      title: context.labels.title,
+      options: context.options,
+      onSelect: function(choice) { resolve(choice); },
+      onCancel: function() { resolve(null); }
+    });
+  });
+};
+~~~
+
+The context object has the following properties:
+
+| Property | Type | Description |
+|---|---|---|
+| `origin` | `"lightbox" \| "dnd"` | Whether the action was triggered from the lightbox or drag-and-drop |
+| `occurrence` | `object` | The specific occurrence being edited |
+| `series` | `object` | The parent recurring event |
+| `labels` | `object` | Localized strings: `title`, `ok`, `cancel`, `occurrence`, `following`, `series` |
+| `options` | `string[]` | Available choices, e.g. `["occurrence", "following", "series"]` |
+
+The function must return `"occurrence"`, `"following"`, `"series"`, or `null` to cancel. It can return the value directly or as a Promise.
+
+For a React implementation, see the [React Scheduler documentation](integrations/react/overview.md#customizing-the-recurrence-confirmation-modal).
+
+
 ## Legacy format of recurring events
 
 Until v7.1 Scheduler used a custom format for recurring events, you can find the format details [here](guides/recurring-events-legacy.md).

docs/integrations/react/overview.md

@@ -351,6 +351,75 @@ The delete confirmation dialog can be overridden via `modals`.
 />
 ```
 
+### Customizing the Recurrence Confirmation Modal
+
+When a user edits or drags a recurring event, a confirmation modal asks whether to modify just this occurrence, this and following events, or the entire series. You can replace this built-in dialog with your own using `modals.onRecurrenceConfirm`.
+
+The callback receives a context object and must return a decision (or a Promise that resolves to one):
+
+| Field | Type | Description |
+|---|---|---|
+| `origin` | `"lightbox" \| "dnd"` | Whether the action was triggered from the lightbox or drag-and-drop |
+| `occurrence` | `any` | The specific occurrence being edited |
+| `series` | `any` | The parent recurring event |
+| `labels` | `object` | Localized labels: `title`, `ok`, `cancel`, `occurrence`, `following`, `series` |
+| `options` | `string[]` | Available choices, e.g. `["occurrence", "following", "series"]` |
+
+Return value (`RecurrenceDecision`): `"occurrence"`, `"following"`, `"series"`, or `null` to cancel.
+
+Minimal example using `window.confirm`:
+
+```tsx
+<ReactScheduler
+  modals={{
+    onRecurrenceConfirm: (context) => {
+      const choice = window.prompt(
+        `${context.labels.title}\nOptions: ${context.options.join(", ")}`
+      );
+      return context.options.includes(choice) ? choice : null;
+    },
+  }}
+/>
+```
+
+Full example with a custom React dialog:
+
+```tsx
+import { useState, useCallback } from "react";
+
+function App() {
+  const [recurrencePrompt, setRecurrencePrompt] = useState(null);
+
+  const onRecurrenceConfirm = useCallback((context) => {
+    return new Promise((resolve) => {
+      setRecurrencePrompt({ context, resolve });
+    });
+  }, []);
+
+  return (
+    <>
+      <ReactScheduler
+        modals={{ onRecurrenceConfirm }}
+      />
+      {recurrencePrompt && (
+        <MyRecurrenceDialog
+          options={recurrencePrompt.context.options}
+          labels={recurrencePrompt.context.labels}
+          onSelect={(choice) => {
+            recurrencePrompt.resolve(choice);
+            setRecurrencePrompt(null);
+          }}
+          onCancel={() => {
+            recurrencePrompt.resolve(null);
+            setRecurrencePrompt(null);
+          }}
+        />
+      )}
+    </>
+  );
+}
+```
+
 ## Filtering
 
 Use the `filter` prop to control which events are displayed: