@vestra-player/sdk 1.5.50 → 1.5.52

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.5.52
+
+**Who must change: nobody.** Additive: `WindowState` gains `maximized`, `apiVersion` stays `vestra/1`, no new capability. Players before 0.6.3 do not report it and it reads `false` there; a plugin that depends on it sets `"minPlayerVersion": "0.6.3"`. A test that deep-compares the whole `plugin.window.state` now also sees `maximized: false`.
+
+- **`plugin.window.state.maximized`** (player 0.6.3): `true` while the main window is maximized, `false` in fullscreen (also when the window was maximized before and is again after leaving it). Changes arrive through `plugin.window.onChange` like the other window facts (with `events` for changes made by the user). A plugin that resizes the window, such as the Window plugin's "Window size when playback starts", leaves a maximized window alone, as MPC-HC and mpv do. The player sends it as `maximized` in the `window.state` reply and event; the SDK reads a missing or non-boolean field as `false`.
+- **`TestHost`**: `host.mainWindow.maximized` (default `false`) and `host.setMainWindow({ maximized: true })`, which broadcasts `window.state` as the player does; like the player, `window.state` reports `false` while fullscreen.
+- _Docs_: `WindowState.maximized`, `MainWindow`, `TestHost.setMainWindow` and [Reference: testing](docs/reference/testing.md#simulating-the-player) describe it.
+
+## 1.5.51
+
+**Who must change: nobody.** Additive: `MENU_IDS` and `MenuId` gain `reset`, `apiVersion` stays `vestra/1`, no new capability. A plugin that puts a command under `@reset` sets `"minPlayerVersion": "0.6.3"`: older players refuse `@reset` with `invalid` (since SDK 1.5.49 that command is skipped and the rest of the plugin activates).
+
+- **A Reset menu for every reset-to-default command** (user ruling, 2026-11-01). `["@reset", "Picture"]` (or the key `["Reset", …]`) puts a command into the player's new built-in top-level menu **Reset**, directly below Settings and in Settings' separator group (order 840, whatever the groups of the items inside). It lists the resets of every plugin in one place, so users do not hunt for them through Video, Audio and Subtitles; like every built-in menu it is shown only once a command is in it, and its title is the player's (复位 in Simplified Chinese).
+- **`BUILTIN_COMMANDS` lists the built-in plugins' resets under Reset**, as player 0.6.3 declares them (command ids and default keys unchanged): `Reset ▸ Subtitle Position` (`move-reset`, Alt+Home), `Reset ▸ Subtitle Sync` (`sync-reset`, /), `Reset ▸ Picture` (`video.reset`, Q), `Reset ▸ Framing` (`video.frame.reset`, Numpad5, Alt+Backspace), `Reset ▸ Crop Position` (`video.reframe.reset`), `Reset ▸ Audio Sync` (`audio.sync.reset`, ?), `Reset ▸ Audio Processing` (`audio.reset`, now the processing only) and `Reset ▸ Idle Logo` (`reset-logo`, was `Settings ▸ Appearance ▸ Restore Default Logo`). `BUILTIN_SUBMENUS` is unchanged: every submenu these left keeps other items. The built-in command table in [Reference: commands](docs/reference/commands.md) follows.
+- **`TestHost`** accepts `@reset`, shows Reset in the player's words (`HOST_ZH_HANS`) and lists it in its refusal of an unknown menu id (`… @settings, @reset`).
+- _Docs_: [Guidelines: menus](docs/guidelines/menus.md#reset) gains **Reset**: put reset-to-default commands under `@reset`, titled by what they reset, without the word Reset ("Picture", "Subtitle Sync"); order and group them by domain; keep the command id when moving one (bindings and the user's keys follow the id); a "Normal"/"Default" radio or clearing user data is not a reset. [Reference: commands](docs/reference/commands.md#built-in-menus) lists `@reset` and the top-level sketch shows it; `CommandOptions.order` gives its fixed order.
+
 ## 1.5.50
 
 **Who must change: tools that read `llms-full.txt`.** It is removed (approved by the maintainer, 2026-11-01): from the package (`@vestra-player/sdk/llms-full.txt`), from the documentation site and from the generators. Read the documentation tree instead: `npx -p @vestra-player/sdk vestra-plugin docs [path]` and `… docs --search <words>`, or `docs(path)` and `searchDocs(query)` from `@vestra-player/sdk/docs` in a program. The player's Workshop vendors the package's `dist/` (the tree is `dist/docs-tree.json.gz`, built with the package; reading it needs nothing else) and must drop its `llms-full.txt` expectation. Plugins need no change: no changes to the plugin API, `apiVersion` stays `vestra/1`, no new capability, no player version needed.

package/dist/commands.d.ts

@@ -98,8 +98,11 @@ export declare const COMMAND_LIMITS: {
  * command into that menu whatever language the player's menus are in. The
  * player stores the menu's title (视频 today); later segments are titles.
  * Needs player 0.3.0 (`"minPlayerVersion": "0.3.0"`); older players show
- * `@video` as a menu of its own. The player's tests check that this list
- * agrees with the player's.
+ * `@video` as a menu of its own. `reset` (SDK 1.5.51) needs player 0.6.3:
+ * the Reset menu, directly below Settings, gathers every command that puts
+ * something back to its default; older players refuse `@reset` with
+ * `invalid`. The player's tests check that this list agrees with the
+ * player's.
  *
  * @example Put a command into the built-in Video menu
  * "Blur" appears in the player's Video menu in every interface language.
@@ -121,7 +124,7 @@ export declare const COMMAND_LIMITS: {
  * @since 1.3.0
  * @category Testing
  */
-export declare const MENU_IDS: readonly ["open", "playback", "subtitles", "video", "audio", "screen", "settings"];
+export declare const MENU_IDS: readonly ["open", "playback", "subtitles", "video", "audio", "screen", "settings", "reset"];
 /**
  * The icons a bottom-bar button may name (`CommandOptions.button.icon`):
  * every icon of the player's V-Line set, `@vestra/icons.slint` (draw one

package/dist/commands.js

@@ -94,8 +94,11 @@ export const COMMAND_LIMITS = {
  * command into that menu whatever language the player's menus are in. The
  * player stores the menu's title (视频 today); later segments are titles.
  * Needs player 0.3.0 (`"minPlayerVersion": "0.3.0"`); older players show
- * `@video` as a menu of its own. The player's tests check that this list
- * agrees with the player's.
+ * `@video` as a menu of its own. `reset` (SDK 1.5.51) needs player 0.6.3:
+ * the Reset menu, directly below Settings, gathers every command that puts
+ * something back to its default; older players refuse `@reset` with
+ * `invalid`. The player's tests check that this list agrees with the
+ * player's.
  *
  * @example Put a command into the built-in Video menu
  * "Blur" appears in the player's Video menu in every interface language.
@@ -125,6 +128,7 @@ export const MENU_IDS = [
     "audio",
     "screen",
     "settings",
+    "reset",
 ];
 /**
  * The icons a bottom-bar button may name (`CommandOptions.button.icon`):
@@ -402,13 +406,11 @@ vestra.subtitles | size-up | Subtitles ▸ Subtitle Style ▸ Size + | Alt+PageU
 vestra.subtitles | size-down | Subtitles ▸ Subtitle Style ▸ Size − | Alt+PageDown
 vestra.subtitles | move-up | Subtitles ▸ Subtitle Style ▸ Move Up
 vestra.subtitles | move-down | Subtitles ▸ Subtitle Style ▸ Move Down
-vestra.subtitles | move-reset | Subtitles ▸ Subtitle Style ▸ Reset Position | Alt+Home
 vestra.subtitles | shadow | Subtitles ▸ Subtitle Style ▸ Shadow
 vestra.subtitles | box | Subtitles ▸ Subtitle Style ▸ Opaque Box
 vestra.subtitles | ass-original | Subtitles ▸ Original ASS/SSA Styles
 vestra.subtitles | sync-earlier | Subtitles ▸ Sync ▸ Earlier 0.5 s | .
 vestra.subtitles | sync-later | Subtitles ▸ Sync ▸ Later 0.5 s | ,
-vestra.subtitles | sync-reset | Subtitles ▸ Sync ▸ Reset | /
 vestra.subtitles | sync-input | Subtitles ▸ Sync ▸ Adjust Sync…
 vestra.subtitle-online | search | Subtitles ▸ Online Subtitles ▸ Search and Download Subtitles…
 vestra.subtitle-online | settings | Subtitles ▸ Online Subtitles ▸ Online Subtitle Settings…
@@ -458,12 +460,10 @@ vestra.video | video.reframe.crop.1 | Video ▸ Crop/Stretch ▸ Crop to 16:9
 vestra.video | video.reframe.crop.2 | Video ▸ Crop/Stretch ▸ Crop to 16:10
 vestra.video | video.reframe.crop.3 | Video ▸ Crop/Stretch ▸ Crop to 1.85:1
 vestra.video | video.reframe.crop.4 | Video ▸ Crop/Stretch ▸ Crop to 2.35:1
-vestra.video | video.reframe.reset | Video ▸ Crop/Stretch ▸ Reset Position
 vestra.video | video.reframe.left | Video ▸ Crop/Stretch ▸ Move Left
 vestra.video | video.reframe.right | Video ▸ Crop/Stretch ▸ Move Right
 vestra.video | video.reframe.up | Video ▸ Crop/Stretch ▸ Move Up
 vestra.video | video.reframe.down | Video ▸ Crop/Stretch ▸ Move Down
-vestra.video | video.frame.reset | Video ▸ Framing ▸ Reset Framing | Numpad5, Alt+Backspace
 vestra.video | video.frame.zoom-in | Video ▸ Framing ▸ Zoom In | Numpad9, Alt+Plus
 vestra.video | video.frame.zoom-out | Video ▸ Framing ▸ Zoom Out | Numpad1, Alt+-
 vestra.video | video.frame.right | Video ▸ Framing ▸ Pan → | Ctrl+Numpad6, Alt+ArrowRight
@@ -505,7 +505,6 @@ vestra.capture | capture.settings | Video ▸ Snapshot ▸ Snapshot Settings…
 vestra.capture | capture.folder | Video ▸ Snapshot ▸ Snapshot Folder…
 vestra.capture | capture.openFolder | Video ▸ Snapshot ▸ Open Snapshot Folder
 vestra.video | video.picture | Video ▸ Picture Adjustments…
-vestra.video | video.reset | Video ▸ Reset | Q
 vestra.video | video.brightness.down | Video ▸ Brightness -1% | W
 vestra.video | video.brightness.up | Video ▸ Brightness +1% | E
 vestra.video | video.contrast.down | Video ▸ Contrast -1% | R
@@ -534,13 +533,11 @@ vestra.audio | audio.preset.2 | Audio ▸ Preset ▸ Music
 vestra.audio | audio.preset.3 | Audio ▸ Preset ▸ Cinema
 vestra.audio | audio.sync.earlier | Audio ▸ Audio Sync ▸ 50 ms Earlier | >
 vestra.audio | audio.sync.later | Audio ▸ Audio Sync ▸ 50 ms Later | <
-vestra.audio | audio.sync.reset | Audio ▸ Audio Sync ▸ Reset | ?
 vestra.audio | audio.sync.keep.none | Audio ▸ Audio Sync ▸ Don't Keep
 vestra.audio | audio.sync.keep.session | Audio ▸ Audio Sync ▸ Keep for This Run
 vestra.audio | audio.sync.keep.always | Audio ▸ Audio Sync ▸ Always Keep
 vestra.audio | audio.normalize | Audio ▸ Processing ▸ Normalize | Shift+N
 vestra.audio | audio.clarity | Audio ▸ Processing ▸ Crystalizer | Shift+C
-vestra.audio | audio.reset | Audio ▸ Reset
 vestra.visualizer | audio-cover | Audio ▸ Show Album Cover for Audio Only
 host | fullscreen | Toggle Fullscreen | Escape
 vestra.window | pip | Screen ▸ Picture-in-Picture
@@ -575,7 +572,6 @@ vestra.preferences | theme.vestra | Settings ▸ Appearance ▸ Vestra Dark
 vestra.preferences | theme.vestra-light | Settings ▸ Appearance ▸ Vestra Light
 vestra.visualizer | idle-logo | Settings ▸ Appearance ▸ Show Logo When Idle
 vestra.visualizer | choose-logo | Settings ▸ Appearance ▸ Choose Logo Image…
-vestra.visualizer | reset-logo | Settings ▸ Appearance ▸ Restore Default Logo
 vestra.preferences | language.system | Settings ▸ Language ▸ Follow System
 vestra.preferences | language.en | Settings ▸ Language ▸ English
 vestra.preferences | language.zh-Hans | Settings ▸ Language ▸ 简体中文
@@ -584,6 +580,14 @@ vestra.preferences | language.ko | Settings ▸ Language ▸ 한국어
 vestra.preferences | language.de | Settings ▸ Language ▸ Deutsch
 vestra.preferences | language.fr | Settings ▸ Language ▸ Français
 vestra.preferences | language.es | Settings ▸ Language ▸ Español
+vestra.subtitles | move-reset | Reset ▸ Subtitle Position | Alt+Home
+vestra.subtitles | sync-reset | Reset ▸ Subtitle Sync | /
+vestra.video | video.reset | Reset ▸ Picture | Q
+vestra.video | video.frame.reset | Reset ▸ Framing | Numpad5, Alt+Backspace
+vestra.video | video.reframe.reset | Reset ▸ Crop Position
+vestra.audio | audio.sync.reset | Reset ▸ Audio Sync | ?
+vestra.audio | audio.reset | Reset ▸ Audio Processing
+vestra.visualizer | reset-logo | Reset ▸ Idle Logo
 vestra.info | info.about | About Vestra Player… | F1
 host | quit | Quit | Cmd+Q
 host | enter-fullscreen | (Enter Fullscreen)

package/dist/i18n.js

@@ -846,6 +846,7 @@ export const MENU_KEYS = {
     audio: "Audio",
     screen: "Screen",
     settings: "Settings",
+    reset: "Reset",
 };
 /** The player's old Chinese titles of its own menus: parent, title, key. */
 const LEGACY_MENUS = [
@@ -870,6 +871,7 @@ export const HOST_GROUPS = [
     "Audio",
     "Screen",
     "Settings",
+    "Reset",
     "Playback/Speed",
     "Playback/Seek",
 ];
@@ -906,6 +908,7 @@ export const HOST_ZH_HANS = {
     Audio: "声音",
     Screen: "屏幕",
     Settings: "设置",
+    Reset: "复位",
     Speed: "速度",
     Seek: "跳转",
     Close: "关闭",

package/dist/plugin/testing.d.ts

@@ -1664,14 +1664,22 @@ export declare class TestHost implements Transport {
     readonly confirms: Record<string, Json>[];
     /**
      * The main window as the player would show it. Change it with
-     * `setMainWindow` (the user resized it, entered fullscreen, closed the
-     * picture-in-picture window); `onTop`, `cursorAutoHide` and
+     * `setMainWindow` (the user resized or maximized it, entered fullscreen,
+     * closed the picture-in-picture window); `onTop`, `cursorAutoHide` and
      * `pictureInPicture.active` record the plugin's `window.set…` calls.
      * `pictureInPicture.supported: false` stands for Windows and Linux.
      */
     readonly mainWindow: {
         /** Whether the main window is fullscreen. */
         fullscreen: boolean;
+        /**
+         * Whether the main window is maximized (default `false`). Like the
+         * player, `window.state` reports `false` while fullscreen and this
+         * value again after leaving it.
+         *
+         * @since 1.5.52
+         */
+        maximized: boolean;
         /** The video area in logical points (default 780×609). */
         videoArea: {
             /** Width in logical points. */
@@ -2168,15 +2176,17 @@ export declare class TestHost implements Transport {
      */
     setSource(patch: Partial<SourceState>): void;
     /**
-     * Simulate the user changing the main window (resizing it, entering or
-     * leaving fullscreen, closing the picture-in-picture window) and broadcast
-     * it. Like the player, entering fullscreen collapses an attached, visible
+     * Simulate the user changing the main window (resizing, maximizing or
+     * restoring it, entering or leaving fullscreen, closing the
+     * picture-in-picture window) and broadcast it. `maximized` (SDK 1.5.52)
+     * reads `false` while fullscreen, as player 0.6.3 reports it. Like the player, entering fullscreen collapses an attached, visible
      * sidebar (`effective: false`, `reason: "fullscreen"`) and leaving
      * fullscreen docks it again.
      *
-     * @example Go fullscreen, then report picture-in-picture support
+     * @example Go fullscreen, report picture-in-picture support, maximize
      * The plugin sees the main window fullscreen at 1920×1080, then learns
-     * that picture-in-picture is available. `setMainWindow` changes the
+     * that picture-in-picture is available, then sees the window leave
+     * fullscreen maximized. `setMainWindow` changes the
      * host's window facts and broadcasts them as the player does when the
      * user resizes or toggles fullscreen; entering fullscreen also collapses
      * an attached sidebar.
@@ -2188,6 +2198,10 @@ export declare class TestHost implements Transport {
      * await host.settle();
      * assert.equal(plugin.window.state.fullscreen, true);
      * host.setMainWindow({ pictureInPicture: { supported: true, active: false } });
+     * // Leaving fullscreen into a maximized window: `maximized` reads true again.
+     * host.setMainWindow({ fullscreen: false, maximized: true });
+     * await host.settle();
+     * assert.equal(plugin.window.state.maximized, true);
      * ```
      *
      * @capability None.
@@ -2195,6 +2209,7 @@ export declare class TestHost implements Transport {
      */
     setMainWindow(patch: Partial<{
         fullscreen: boolean;
+        maximized: boolean;
         videoArea: {
             width: number;
             height: number;

package/dist/plugin/testing.js

@@ -1794,14 +1794,22 @@ export class TestHost {
     confirms = [];
     /**
      * The main window as the player would show it. Change it with
-     * `setMainWindow` (the user resized it, entered fullscreen, closed the
-     * picture-in-picture window); `onTop`, `cursorAutoHide` and
+     * `setMainWindow` (the user resized or maximized it, entered fullscreen,
+     * closed the picture-in-picture window); `onTop`, `cursorAutoHide` and
      * `pictureInPicture.active` record the plugin's `window.set…` calls.
      * `pictureInPicture.supported: false` stands for Windows and Linux.
      */
     mainWindow = {
         /** Whether the main window is fullscreen. */
         fullscreen: false,
+        /**
+         * Whether the main window is maximized (default `false`). Like the
+         * player, `window.state` reports `false` while fullscreen and this
+         * value again after leaving it.
+         *
+         * @since 1.5.52
+         */
+        maximized: false,
         /** The video area in logical points (default 780×609). */
         videoArea: {
             /** Width in logical points. */
@@ -2745,15 +2753,17 @@ export class TestHost {
             this.setBackdropEffective(true);
     }
     /**
-     * Simulate the user changing the main window (resizing it, entering or
-     * leaving fullscreen, closing the picture-in-picture window) and broadcast
-     * it. Like the player, entering fullscreen collapses an attached, visible
+     * Simulate the user changing the main window (resizing, maximizing or
+     * restoring it, entering or leaving fullscreen, closing the
+     * picture-in-picture window) and broadcast it. `maximized` (SDK 1.5.52)
+     * reads `false` while fullscreen, as player 0.6.3 reports it. Like the player, entering fullscreen collapses an attached, visible
      * sidebar (`effective: false`, `reason: "fullscreen"`) and leaving
      * fullscreen docks it again.
      *
-     * @example Go fullscreen, then report picture-in-picture support
+     * @example Go fullscreen, report picture-in-picture support, maximize
      * The plugin sees the main window fullscreen at 1920×1080, then learns
-     * that picture-in-picture is available. `setMainWindow` changes the
+     * that picture-in-picture is available, then sees the window leave
+     * fullscreen maximized. `setMainWindow` changes the
      * host's window facts and broadcasts them as the player does when the
      * user resizes or toggles fullscreen; entering fullscreen also collapses
      * an attached sidebar.
@@ -2765,6 +2775,10 @@ export class TestHost {
      * await host.settle();
      * assert.equal(plugin.window.state.fullscreen, true);
      * host.setMainWindow({ pictureInPicture: { supported: true, active: false } });
+     * // Leaving fullscreen into a maximized window: `maximized` reads true again.
+     * host.setMainWindow({ fullscreen: false, maximized: true });
+     * await host.settle();
+     * assert.equal(plugin.window.state.maximized, true);
      * ```
      *
      * @capability None.
@@ -2815,6 +2829,8 @@ export class TestHost {
     #windowFacts() {
         return {
             fullscreen: this.mainWindow.fullscreen,
+            // Like player 0.6.3: never maximized while fullscreen.
+            maximized: this.mainWindow.maximized && !this.mainWindow.fullscreen,
             videoArea: { ...this.mainWindow.videoArea },
             pictureInPicture: { ...this.mainWindow.pictureInPicture },
             appearance: this.appearance,

package/dist/plugin/types.d.ts

@@ -807,13 +807,15 @@ export interface When {
 /**
  * A built-in top-level menu of the player, named in a command path as
  * `@<id>` or by its English key (see {@link CommandOptions.path}): Open,
- * Playback, Subtitles, Video, Audio, Screen, Settings. The list is
- * `MENU_IDS` in `@vestra-player/sdk/testing`.
+ * Playback, Subtitles, Video, Audio, Screen, Settings, Reset. The list is
+ * `MENU_IDS` in `@vestra-player/sdk/testing`. Reset (`@reset`, SDK 1.5.51,
+ * player 0.6.3) gathers every command that puts something back to its
+ * default; older players refuse `@reset` with `invalid`.
  *
  * @since 1.3.0
  * @category Commands
  */
-export type MenuId = "open" | "playback" | "subtitles" | "video" | "audio" | "screen" | "settings";
+export type MenuId = "open" | "playback" | "subtitles" | "video" | "audio" | "screen" | "settings" | "reset";
 /**
  * An icon of the player's V-Line set (`@vestra/icons.slint`), by name: what
  * a bottom-bar button may show. The list is `BAR_BUTTON_ICONS` in
@@ -904,10 +906,12 @@ export interface CommandButton {
  * ranges: `open` 100–199, `domain` 200–699 (playback, subtitles, video,
  * audio…), `screen` 700–799, `windows` 800–899, `exit` 900–999.
  *
- * Built-in menus keep their place. The seven built-in top-level menus
+ * Built-in menus keep their place. The built-in top-level menus
  * ({@link MenuId}) sit at fixed orders, whatever is inside them: Open 110,
  * Playback 200, Subtitles 300, Video 400, Audio 500, Screen 710, Settings
- * 830 (player 0.3.0). This holds whether the path names the menu by id
+ * 830 (player 0.3.0), Reset 840 (player 0.6.3; directly below Settings and
+ * in its separator group). Like every built-in menu, Reset shows only when
+ * a command is in it. This holds whether the path names the menu by id
  * (`["@video", "Blur"]`) or by its key (`["Video", "Blur"]`), so a plugin's
  * item never moves the player's menu. Directly inside a built-in menu,
  * `order` 0 (the default) sorts after every other order: an item without
@@ -943,11 +947,11 @@ export interface CommandOptions {
      * The player shows each segment and the title in the interface language
      * from the declaring plugin's catalog (`locales/<lang>.po`, see the
      * [i18n guide](../../docs/how-to/i18n.md)); the player's own menus
-     * (Open, Playback, Subtitles, Video, Audio, Screen, Settings, and
+     * (Open, Playback, Subtitles, Video, Audio, Screen, Settings, Reset, and
      * Playback ▸ Speed, Playback ▸ Seek) always show the player's words.
      * A built-in menu can also be named by its id, `@` plus a {@link MenuId}:
-     * `@open`, `@playback`, `@subtitles`, `@video`, `@audio`, `@screen` or
-     * `@settings`. Only the first segment is read as an id; an unknown id, or
+     * `@open`, `@playback`, `@subtitles`, `@video`, `@audio`, `@screen`,
+     * `@settings` or `@reset` (player 0.6.3). Only the first segment is read as an id; an unknown id, or
      * an id with nothing after it, fails with `invalid`. Players up to 0.4.2
      * titled their menus in Chinese (视频…): there `["Video", "Blur"]` is a
      * menu of its own, so plugins for those players write `@video`; player
@@ -4037,6 +4041,18 @@ export interface Timeline {
 export interface WindowState {
     /** The main window is fullscreen. */
     readonly fullscreen: boolean;
+    /**
+     * The main window is maximized (`false` in fullscreen, also when it was
+     * maximized before and will be again after). Changes reach
+     * {@link MainWindow.onChange}. A plugin that sizes the window, such as to
+     * the video when playback starts, leaves a maximized window alone, as
+     * MPC-HC and mpv do. Always `false` with players before 0.6.3, which do
+     * not report it.
+     *
+     * @player 0.6.3; older players: always `false`.
+     * @since 1.5.52
+     */
+    readonly maximized: boolean;
     /** The video column, without the bottom bar, sidebar and splitter. */
     readonly videoArea: {
         /** Logical points. */
@@ -4085,8 +4101,8 @@ export interface WindowState {
  * ```
  *
  * @remarks
- * `plugin.window` is the player's main window: its size, fullscreen,
- * picture-in-picture and the video area. Reading it needs no capability;
+ * `plugin.window` is the player's main window: its size, whether it is
+ * maximized or fullscreen, picture-in-picture and the video area. Reading it needs no capability;
  * changing it needs `window.control`. Changes that last only while the
  * plugin runs (always on top, pointer auto-hide) revert when it stops.
  *

package/dist/plugin/window.js

@@ -2,6 +2,8 @@
 import { failure } from "./runtime.js";
 const view = (facts) => Object.freeze({
     fullscreen: facts.fullscreen === true,
+    // Players before 0.6.3 do not send it; never maximized in fullscreen.
+    maximized: facts.maximized === true && facts.fullscreen !== true,
     videoArea: Object.freeze({
         width: Number(facts.videoArea?.width ?? 0),
         height: Number(facts.videoArea?.height ?? 0),

package/dist/wire.d.ts

@@ -233,6 +233,8 @@ export interface BindingTable {
 /** `window.state`: the main window, in logical points (zero without one). */
 export interface WindowFacts {
     fullscreen: boolean;
+    /** The main window is maximized, `false` in fullscreen (player 0.6.3; absent from older players: `false`). */
+    maximized?: boolean;
     videoArea: {
         width: number;
         height: number;

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.5.50: write plugins for Vestra Player in TypeScript (plugin API `vestra/1`). A plugin is a folder with `manifest.json` and an entry module whose default export `activate(plugin)` the player calls. The documentation is a tree of short pages read by path, like `go doc`: the same pages and API as https://vestrasys.github.io/vestra-player-sdk/.
+> @vestra-player/sdk 1.5.52: write plugins for Vestra Player in TypeScript (plugin API `vestra/1`). A plugin is a folder with `manifest.json` and an entry module whose default export `activate(plugin)` the player calls. The documentation is a tree of short pages read by path, like `go doc`: the same pages and API as https://vestrasys.github.io/vestra-player-sdk/.
 
 ## Read the documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vestra-player/sdk",
-  "version": "1.5.50",
+  "version": "1.5.52",
   "description": "Plugin API types, test host and plugin CLI for Vestra Player (apiVersion vestra/1)",
   "license": "Apache-2.0",
   "repository": {