@vestra-player/sdk 1.5.50 → 1.5.51

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 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/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

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.51: 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.51",
   "description": "Plugin API types, test host and plugin CLI for Vestra Player (apiVersion vestra/1)",
   "license": "Apache-2.0",
   "repository": {