chore: retarget video and overlay to screencast api (microsoft#39915)

Author: pavelfeldman

docs/src/api/class-overlay.md

@@ -2759,10 +2759,6 @@ The page's main frame. Page is guaranteed to have a main frame which persists du
 * since: v1.8
 - type: <[Mouse]>
 
-## property: Page.overlay
-* since: v1.59
-- type: <[Overlay]>
-
 ## method: Page.onceDialog
 * since: v1.10
 * langs: java
@@ -4461,8 +4457,7 @@ Optional handler function to route the request.
 * since: v1.8
 - returns: <[Video]>
 
-Video object associated with this page. Can be used to control video recording with [`method: Video.start`]
-and [`method: Video.stop`], or to access the video file when using the `recordVideo` context option.
+Video object associated with this page. Can be used to access the video file when using the `recordVideo` context option.
 
 ## method: Page.viewportSize
 * since: v1.8

docs/src/api/class-page.md

@@ -47,3 +47,88 @@ Defaults to 800×800.
 * langs: js
 
 Stops the screencast started with [`method: Screencast.start`].
+
+## async method: Screencast.startRecording
+* since: v1.59
+- returns: <[Disposable]>
+
+Starts video recording. This method is mutually exclusive with the `recordVideo` context option.
+
+### param: Screencast.startRecording.path
+* since: v1.59
+- `path` <[path]>
+
+Path where the video should be saved when the recording is stopped.
+
+### option: Screencast.startRecording.size
+* since: v1.59
+- `size` ?<[Object]>
+  - `width` <[int]> Video frame width.
+  - `height` <[int]> Video frame height.
+
+Optional dimensions of the recorded video. If not specified the size will be equal to page viewport scaled down to fit into 800x800. Actual picture of the page will be scaled down if necessary to fit the specified size.
+
+### option: Screencast.startRecording.annotate
+* since: v1.59
+- `annotate` ?<[Object]>
+  - `duration` ?<[float]> How long each annotation is displayed in milliseconds. Defaults to `500`.
+  - `position` ?<[AnnotatePosition]<"top-left"|"top"|"top-right"|"bottom-left"|"bottom"|"bottom-right">> Position of the action title overlay. Defaults to `"top-right"`.
+  - `fontSize` ?<[int]> Font size of the action title in pixels. Defaults to `24`.
+
+If specified, enables visual annotations on interacted elements during video recording. Interacted elements are highlighted with a semi-transparent blue box and click points are shown as red circles.
+
+## async method: Screencast.stopRecording
+* since: v1.59
+
+Stops video recording started with [`method: Screencast.startRecording`].
+
+## async method: Screencast.showOverlay
+* since: v1.59
+- returns: <[Disposable]>
+
+Adds an overlay with the given HTML content. The overlay is displayed on top of the page until removed. Returns a disposable that removes the overlay when disposed.
+
+### param: Screencast.showOverlay.html
+* since: v1.59
+- `html` <[string]>
+
+HTML content for the overlay.
+
+### option: Screencast.showOverlay.duration
+* since: v1.59
+- `duration` <[float]>
+
+Duration in milliseconds after which the overlay is automatically removed. Overlay stays until dismissed if not provided.
+
+## async method: Screencast.showChapter
+* since: v1.59
+
+Shows a chapter overlay with a title and optional description, centered on the page with a blurred backdrop. Useful for narrating video recordings. The overlay is removed after the specified duration, or 2000ms.
+
+### param: Screencast.showChapter.title
+* since: v1.59
+- `title` <[string]>
+
+Title text displayed prominently in the overlay.
+
+### option: Screencast.showChapter.description
+* since: v1.59
+- `description` <[string]>
+
+Optional description text displayed below the title.
+
+### option: Screencast.showChapter.duration
+* since: v1.59
+- `duration` <[float]>
+
+Duration in milliseconds after which the overlay is automatically removed. Defaults to `2000`.
+
+## async method: Screencast.showOverlays
+* since: v1.59
+
+Shows overlays.
+
+## async method: Screencast.hideOverlays
+* since: v1.59
+
+Hides overlays without removing them.

docs/src/api/class-screencast.md

@@ -23,38 +23,6 @@ print(page.video.path())
 Console.WriteLine(await page.Video.GetPathAsync());
 ```
 
-Alternatively, you can use [`method: Video.start`] and [`method: Video.stop`] to record video manually. This approach is mutually exclusive with the `recordVideo` option.
-
-```js
-await page.video().start({ path: 'video.webm' });
-// ... perform actions ...
-await page.video().stop();
-```
-
-```java
-page.video().start(new Video.StartOptions().setPath(Paths.get("video.webm")));
-// ... perform actions ...
-page.video().stop();
-```
-
-```python async
-await page.video.start(path="video.webm")
-# ... perform actions ...
-await page.video.stop()
-```
-
-```python sync
-page.video.start(path="video.webm")
-# ... perform actions ...
-page.video.stop()
-```
-
-```csharp
-await page.Video.StartAsync(new() { Path = "video.webm" });
-// ... perform actions ...
-await page.Video.StopAsync();
-```
-
 ## async method: Video.delete
 * since: v1.11
 
@@ -90,70 +58,3 @@ Saves the video to a user-specified path. If using the sync API, this must be ca
 - `path` <[path]>
 
 Path where the video should be saved.
-
-
-## async method: Video.start
-* since: v1.59
-- returns: <[Disposable]>
-
-Starts video recording. This method is mutually exclusive with the `recordVideo` context option.
-
-**Usage**
-
-```js
-await page.video().start({ path: 'video.webm' });
-// ... perform actions ...
-await page.video().stop();
-```
-
-```java
-page.video().start(new Video.StartOptions().setPath(Paths.get("video.webm")));
-// ... perform actions ...
-page.video().stop();
-```
-
-```python async
-await page.video.start(path="video.webm")
-# ... perform actions ...
-await page.video.stop()
-```
-
-```python sync
-page.video.start(path="video.webm")
-# ... perform actions ...
-page.video.stop()
-```
-
-```csharp
-await page.Video.StartAsync(new() { Path = "video.webm" });
-// ... perform actions ...
-await page.Video.StopAsync();
-```
-
-### option: Video.start.path
-* since: v1.59
-- `path` <[path]>
-
-Path where the video should be saved when the recording is stopped.
-
-### option: Video.start.size
-* since: v1.59
-- `size` ?<[Object]>
-  - `width` <[int]> Video frame width.
-  - `height` <[int]> Video frame height.
-
-Optional dimensions of the recorded video. If not specified the size will be equal to page viewport scaled down to fit into 800x800. Actual picture of the page will be scaled down if necessary to fit the specified size.
-
-### option: Video.start.annotate
-* since: v1.59
-- `annotate` ?<[Object]>
-  - `duration` ?<[float]> How long each annotation is displayed in milliseconds. Defaults to `500`.
-  - `position` ?<[AnnotatePosition]<"top-left"|"top"|"top-right"|"bottom-left"|"bottom"|"bottom-right">> Position of the action title overlay. Defaults to `"top-right"`.
-  - `fontSize` ?<[int]> Font size of the action title in pixels. Defaults to `24`.
-
-If specified, enables visual annotations on interacted elements during video recording. Interacted elements are highlighted with a semi-transparent blue box and click points are shown as red circles.
-
-## async method: Video.stop
-* since: v1.59
-
-Stops video recording started with [`method: Video.start`].