@vestra-player/sdk 1.6.14 → 1.6.16

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.6.16
+
+**Who must change: nobody.** A data refresh for the player's four built-in panels (player 0.7.6) and one additive read; no API is removed, `apiVersion` stays `vestra/1`.
+
+- **`BUILTIN_COMMANDS`**: the Picture, Audio, Subtitles and Playback panels open from four top-level items, **Picture…** (`vestra.video`, `video.picture`, Alt+1), **Audio…** (`audio.workbench`, Alt+2), **Subtitles…** (`tune`, Alt+3) and **Playback…** (`vestra.playback`, `panel`, Alt+4), next to Playlist. The commands their panels hold left the menus for the command palette, with their keys and categories: Video's Pixel Shaders, Deinterlace, Aspect, Crop/Stretch, Framing, Image Processing and Rotation, the picture steps and GPU Rendering; Audio's track, channel, equalizer, preset, sync and processing items; Subtitles' show, style, secondary subtitle, sync and reload items; the playback plugin's seek steps, keyframes, Jump to Time… and speeds; the Reset items of the video, audio and subtitles plugins (the visualizer's Reset ▸ Idle Logo stays). **Subtitle Track ▸ Off** and **Audio Track ▸ No Audio Tracks** are now top-level submenus. New palette commands: Remove External Subtitle (`vestra.subtitles`, `remove`) and Picture Panel (`video.resetPanel`, a reset of the panel's values). Audio ▸ Output Device ▸ No Output Devices (`audio.device.none`) is gone.
+- **`BUILTIN_SUBMENUS`**: the Video, Audio and Subtitles submenus of these plugins are gone; **Subtitle Track** (`vestra.subtitles`) and **Audio Track** (`vestra.audio`) are new, at the top level. Online Subtitles and Snapshot stay.
+- **`plugin.commands.keys("host/<id>")`** reads the keys of the player's own commands (`host/volume-up`, `host/mute`, the ids of the `host` rows of `BUILTIN_COMMANDS`), read-only and current like a plugin's own, so a panel can show the player's key caps beside its controls; `onKeysChange` fires for their changes too. The `commands.keys` answer and event carry them as `host/<id>` entries (a local id has no `/`); player 0.7.6, like `keys` itself. A side effect: rebinding one of the player's own commands now sends `commands.keys` to every plugin listening for it, and a listener in standby is started for it (as for a change to its own keys); `onKeysChange` still fires only when a label the plugin can read changed.
+- **`TestHost`**: `commands.keys` answers the core commands as `host/<id>` too, and `rebind` takes a core command's `host/<id>`.
+
+## 1.6.15
+
+**Who must change: nobody.** A plugin may now mount one panel per slot (player 0.7.6) instead of one panel in all; plugins with one panel work as before, and `apiVersion` stays `vestra/1`.
+
+- **One panel per slot.** `plugin.panels.mount` takes a second call for another slot: a playback plugin can have its control bar in `"bottom"` and its controls in `"adjust"`. Each `Panel` has its own bridge global, properties, callbacks, `state`, `show()`, `toggle()`, `setInteraction()` and menu; disposing one leaves the others, and stopping the plugin unmounts them all. A failed mount affects only that panel. A second panel in the same slot still throws (an `Error`, before anything is sent); the bottom bar and the backdrop still hold one panel for all plugins. Players before 0.7.6 refuse a second panel with `conflict` (they keep one panel per plugin); a plugin that mounts two declares `minPlayerVersion` 0.7.6.
+- **Wire** (additive): `ui.setMount`, `ui.interaction`, `ui.menu` and `ui.unmount` take an optional `slot` naming the panel (without it: the plugin's only panel; `ui.unmount` without it removes every panel); `ui.callback` and `ui.preparing` carry the panel's `slot`, and `ui.callback` keeps `view: "$mount"`. Older players ignore `slot`.
+- **`BUILTIN_COMMANDS`**: the player's seek, frame and speed actions (`host/seek-backward`, `seek-forward`, `frame-back`, `frame-forward`, `rate-down`, `rate-up`, `rate-normal`) leave Playback ▸ Seek and Speed for the command palette (player 0.7.6, with the playback plugin's panel); their keys and categories stay.
+- **`TestHost`**: `panels` (by slot, in mount order) and `mounted(slot?)`; without a slot `mounted()` returns the only panel and throws when there are several. `panel` stays, as the last panel mounted. The handlers take `slot` as the player does; `ui.interaction` stores the locks without it.
 ## 1.6.14
 
 **Who must change: nobody.** A data refresh: `BUILTIN_COMMANDS` lists the built-in capture plugin's commands as the player registers them since its capture tab; no API change, `apiVersion` stays `vestra/1`.

package/dist/commands.d.ts

@@ -348,8 +348,9 @@ export type CommandDeclaration = {
 };
 /**
  * `commands.keys` (player 0.7.6): each of the plugin's own commands, by
- * local id, with the labels of its current keys; the answer to the request
- * and the data of the event of that name.
+ * local id, and (SDK 1.6.16) each of the player's own as `host/<id>`, with
+ * the labels of its current keys; the answer to the request and the data of
+ * the event of that name.
  */
 export type CommandKeys = {
     keys: Record<string, string[]>;

package/dist/commands.js

@@ -275,32 +275,7 @@ export const BUILTIN_SUBMENUS = Object.freeze([
         path: ["Subtitles", "Online Subtitles"],
         plugins: ["vestra.subtitle-online"],
     },
-    { path: ["Subtitles", "Secondary Subtitle"], plugins: ["vestra.subtitles"] },
-    {
-        path: ["Subtitles", "Secondary Subtitle", "Position"],
-        plugins: ["vestra.subtitles"],
-    },
-    { path: ["Subtitles", "Subtitle Style"], plugins: ["vestra.subtitles"] },
-    { path: ["Subtitles", "Subtitle Track"], plugins: ["vestra.subtitles"] },
-    { path: ["Subtitles", "Sync"], plugins: ["vestra.subtitles"] },
-    { path: ["Video", "Aspect"], plugins: ["vestra.video"] },
-    { path: ["Video", "Crop/Stretch"], plugins: ["vestra.video"] },
-    { path: ["Video", "Deinterlace"], plugins: ["vestra.video"] },
-    { path: ["Video", "Deinterlace", "Output"], plugins: ["vestra.video"] },
-    { path: ["Video", "Framing"], plugins: ["vestra.video"] },
-    { path: ["Video", "Image Processing"], plugins: ["vestra.video"] },
-    { path: ["Video", "Pixel Shaders"], plugins: ["vestra.video"] },
-    {
-        path: ["Video", "Pixel Shaders", "HDR Tone Mapping"],
-        plugins: ["vestra.video"],
-    },
-    { path: ["Video", "Rotation"], plugins: ["vestra.video"] },
     { path: ["Video", "Snapshot"], plugins: ["vestra.capture"] },
-    { path: ["Audio", "Audio Sync"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Audio Track"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Output Device"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Preset"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Processing"], plugins: ["vestra.audio"] },
     { path: ["Screen", "Always on Top"], plugins: ["vestra.window"] },
     { path: ["Screen", "When Playback Starts"], plugins: ["vestra.window"] },
     {
@@ -309,6 +284,8 @@ export const BUILTIN_SUBMENUS = Object.freeze([
     },
     { path: ["Settings", "Language"], plugins: ["vestra.preferences"] },
     { path: ["Copy to Clipboard"], plugins: ["vestra.playback"] },
+    { path: ["Subtitle Track"], plugins: ["vestra.subtitles"] },
+    { path: ["Audio Track"], plugins: ["vestra.audio"] },
 ]);
 /** owner | id | key path, or (title) outside the menu | bindings | panel */
 const BUILTIN_COMMAND_TABLE = `
@@ -330,31 +307,6 @@ vestra.playback | copy-path | Copy to Clipboard ▸ Full Path
 host | play-pause | Playback ▸ Play/Pause | Space, Mouse:LeftClick
 host | previous | Playback ▸ Previous | PageUp, Mouse:X2
 host | next | Playback ▸ Next | PageDown, Mouse:X1
-host | frame-back | Playback ▸ Seek ▸ Previous Frame | D
-host | frame-forward | Playback ▸ Seek ▸ Next Frame | F
-vestra.playback | keyframe-back | Playback ▸ Seek ▸ Previous Keyframe | Ctrl+Shift+ArrowLeft
-vestra.playback | keyframe-forward | Playback ▸ Seek ▸ Next Keyframe | Ctrl+Shift+ArrowRight
-host | seek-backward | Playback ▸ Seek ▸ Back 5 s | ArrowLeft
-host | seek-forward | Playback ▸ Seek ▸ Forward 5 s | ArrowRight
-vestra.playback | backward-2 | Playback ▸ Seek ▸ Back 30 s | Ctrl+ArrowLeft
-vestra.playback | forward-2 | Playback ▸ Seek ▸ Forward 30 s | Ctrl+ArrowRight
-vestra.playback | backward-3 | Playback ▸ Seek ▸ Back 60 s | Shift+ArrowLeft
-vestra.playback | forward-3 | Playback ▸ Seek ▸ Forward 60 s | Shift+ArrowRight
-vestra.playback | backward-4 | Playback ▸ Seek ▸ Back 300 s | Ctrl+Alt+ArrowLeft
-vestra.playback | forward-4 | Playback ▸ Seek ▸ Forward 300 s | Ctrl+Alt+ArrowRight
-vestra.subtitles | dialogue-previous | Playback ▸ Seek ▸ Previous Dialogue | Home
-vestra.subtitles | dialogue-next | Playback ▸ Seek ▸ Next Dialogue | End
-vestra.subtitles | dialogue-current | Playback ▸ Seek ▸ Current Subtitle Start | Ctrl+Home
-vestra.playback | jump-start | Playback ▸ Seek ▸ Jump to Start | Backspace
-vestra.playback | time-jump | Playback ▸ Seek ▸ Seek Steps…
-vestra.playback | jump | Playback ▸ Jump to Time… | G
-host | rate-normal | Playback ▸ Speed ▸ Normal | Z
-host | rate-down | Playback ▸ Speed ▸ Slower 0.1 | X
-host | rate-up | Playback ▸ Speed ▸ Faster 0.1 | C
-vestra.playback | rate-05 | Playback ▸ Speed ▸ 0.5×
-vestra.playback | rate-15 | Playback ▸ Speed ▸ 1.5×
-vestra.playback | rate-20 | Playback ▸ Speed ▸ 2×
-vestra.playback | rate-custom | Playback ▸ Speed ▸ Custom…
 vestra.playlist | playlist.add | Playback ▸ Playlist ▸ Add Files…
 vestra.playlist | playlist.link | Playback ▸ Playlist ▸ Add Link…
 vestra.playlist | playlist.add-folder | Playback ▸ Playlist ▸ Add Folder…
@@ -404,139 +356,19 @@ vestra.marks | ab.count.2 | Playback ▸ A-B Loop ▸ Loop Count ▸ 2 Times
 vestra.marks | ab.count.3 | Playback ▸ A-B Loop ▸ Loop Count ▸ 3 Times
 vestra.marks | ab.count.5 | Playback ▸ A-B Loop ▸ Loop Count ▸ 5 Times
 vestra.marks | ab.count.10 | Playback ▸ A-B Loop ▸ Loop Count ▸ 10 Times
-vestra.subtitles | show | Subtitles ▸ Show Subtitles | Alt+H
-vestra.subtitles | track-off | Subtitles ▸ Subtitle Track ▸ Off
-vestra.subtitles | track-cycle | Subtitles ▸ Subtitle Track ▸ Cycle | Alt+L
-vestra.subtitles | second-off | Subtitles ▸ Secondary Subtitle ▸ Off
-vestra.subtitles | second-position-top | Subtitles ▸ Secondary Subtitle ▸ Position ▸ Top
-vestra.subtitles | second-position-aboveMain | Subtitles ▸ Secondary Subtitle ▸ Position ▸ Above Main Subtitle
-vestra.subtitles | bold | Subtitles ▸ Subtitle Style ▸ Bold | Alt+B
-vestra.subtitles | size-up | Subtitles ▸ Subtitle Style ▸ Size + | Alt+PageUp
-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 | 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-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…
-vestra.subtitles | reload | Subtitles ▸ Reload Subtitles | Ctrl+Alt+Y
-vestra.subtitles | refresh | Subtitles ▸ Refresh Subtitle Tracks
-vestra.subtitles | tune | Subtitles ▸ Subtitle Tuning…
-vestra.subtitles | settings | Subtitles ▸ Subtitle Settings…
-vestra.video | video.shader.use | Video ▸ Pixel Shaders ▸ Use Shaders | Shift+P
-vestra.video | video.shader.list | Video ▸ Pixel Shaders ▸ Shader List…
-vestra.video | video.shader.folder | Video ▸ Pixel Shaders ▸ Open Shader Folder
-vestra.video | video.shader.reload | Video ▸ Pixel Shaders ▸ Reload Shaders
-vestra.video | video.hdr.auto | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Auto
-vestra.video | video.hdr.off | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Off
-vestra.video | video.hdr.bt.2390 | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ BT.2390
-vestra.video | video.hdr.hable | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Hable
-vestra.video | video.hdr.mobius | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Mobius
-vestra.video | video.hdr.reinhard | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Reinhard
-vestra.video | video.hdr.clip | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Clip
-vestra.video | video.hdr.peak | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Dynamic Peak Detection
-vestra.video | video.hdr.settings | Video ▸ Pixel Shaders ▸ HDR Settings…
-vestra.video | video.deinterlace.cycle | Video ▸ Deinterlace ▸ Cycle | Ctrl+I
-vestra.video | video.deinterlace.auto | Video ▸ Deinterlace ▸ Auto
-vestra.video | video.deinterlace.on | Video ▸ Deinterlace ▸ Always
-vestra.video | video.deinterlace.off | Video ▸ Deinterlace ▸ Never
-vestra.video | video.deinterlace.output.frame | Video ▸ Deinterlace ▸ Output ▸ By Frame
-vestra.video | video.deinterlace.output.field | Video ▸ Deinterlace ▸ Output ▸ By Field (Double Rate)
-vestra.video | video.fit.keep | Video ▸ Aspect ▸ Keep Aspect Ratio
-vestra.video | video.fit.stretch | Video ▸ Aspect ▸ Ignore Aspect Ratio
-vestra.video | video.fit.fill | Video ▸ Aspect ▸ Fill Window (Crop Excess)
-vestra.video | video.aspect.cycle | Video ▸ Aspect ▸ Cycle Aspect Ratio | Shift+F6
-vestra.video | video.aspect.default | Video ▸ Aspect ▸ Default (Source)
-vestra.video | video.aspect.0 | Video ▸ Aspect ▸ 4:3
-vestra.video | video.aspect.1 | Video ▸ Aspect ▸ 16:9
-vestra.video | video.aspect.2 | Video ▸ Aspect ▸ 16:10
-vestra.video | video.aspect.3 | Video ▸ Aspect ▸ 1.85:1
-vestra.video | video.aspect.4 | Video ▸ Aspect ▸ 2.35:1
-vestra.video | video.aspect.custom | Video ▸ Aspect ▸ Custom (x:y)
-vestra.video | video.aspect.edit | Video ▸ Aspect ▸ Custom Aspect Ratio…
-vestra.video | video.reframe.none | Video ▸ Crop/Stretch ▸ None
-vestra.video | video.reframe.pad.0 | Video ▸ Crop/Stretch ▸ Stretch to 4:3
-vestra.video | video.reframe.pad.1 | Video ▸ Crop/Stretch ▸ Stretch to 16:9
-vestra.video | video.reframe.pad.2 | Video ▸ Crop/Stretch ▸ Stretch to 16:10
-vestra.video | video.reframe.pad.3 | Video ▸ Crop/Stretch ▸ Stretch to 1.85:1
-vestra.video | video.reframe.pad.4 | Video ▸ Crop/Stretch ▸ Stretch to 2.35:1
-vestra.video | video.reframe.crop.0 | Video ▸ Crop/Stretch ▸ Crop to 4:3
-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.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.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
-vestra.video | video.frame.left | Video ▸ Framing ▸ Pan ← | Ctrl+Numpad4, Alt+ArrowLeft
-vestra.video | video.frame.up | Video ▸ Framing ▸ Pan ↑ | Ctrl+Numpad8, Alt+ArrowUp
-vestra.video | video.frame.down | Video ▸ Framing ▸ Pan ↓ | Ctrl+Numpad2, Alt+ArrowDown
-vestra.video | video.frame.centre | Video ▸ Framing ▸ Center Frame | Ctrl+Numpad5
-vestra.video | video.flip.vertical | Video ▸ Image Processing ▸ Flip Vertically | Ctrl+P
-vestra.video | video.flip.horizontal | Video ▸ Image Processing ▸ Flip Horizontally | Ctrl+Z
-vestra.video | video.gaussian | Video ▸ Image Processing ▸ Gaussian Blur | Ctrl+B
-vestra.video | video.sharpen | Video ▸ Image Processing ▸ Sharpen | Ctrl+R
-vestra.video | video.edge | Video ▸ Image Processing ▸ Edge Sharpen
-vestra.video | video.deblock | Video ▸ Image Processing ▸ Deblock | Ctrl+H
-vestra.video | video.deband | Video ▸ Image Processing ▸ Deband
-vestra.video | video.denoise.d3 | Video ▸ Image Processing ▸ 3D Denoise | Ctrl+N
-vestra.video | video.denoise.gradual | Video ▸ Image Processing ▸ Gradual Denoise
-vestra.video | video.denoise.temporal | Video ▸ Image Processing ▸ Temporal Denoise | Ctrl+M
-vestra.video | video.frame-blend | Video ▸ Image Processing ▸ Frame Doubling
-vestra.video | video.interpolation | Video ▸ Image Processing ▸ Motion Interpolation
-vestra.video | video.rotate.cycle | Video ▸ Rotation ▸ Cycle | Alt+K
-vestra.video | video.rotate.0 | Video ▸ Rotation ▸ No Rotation
-vestra.video | video.rotate.90 | Video ▸ Rotation ▸ 90°
-vestra.video | video.rotate.180 | Video ▸ Rotation ▸ 180°
-vestra.video | video.rotate.270 | Video ▸ Rotation ▸ 270°
+vestra.subtitles | track-off | Subtitle Track ▸ Off
 vestra.capture | capture.save | Video ▸ Snapshot ▸ Save Current Frame | Ctrl+E
 vestra.capture | capture.panel | Video ▸ Snapshot ▸ Capture… | Alt+S
 vestra.capture | capture.copy | Video ▸ Snapshot ▸ Copy Current Frame | Ctrl+C
 vestra.capture | capture.burst | Video ▸ Snapshot ▸ Burst… | Ctrl+G
 vestra.capture | capture.clip | Video ▸ Snapshot ▸ Export Clip…
-vestra.video | video.picture | Video ▸ Picture Adjustments…
-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
-vestra.video | video.contrast.up | Video ▸ Contrast +1% | T
-vestra.video | video.saturation.down | Video ▸ Saturation -1% | Y
-vestra.video | video.saturation.up | Video ▸ Saturation +1% | U
-vestra.video | video.hue.down | Video ▸ Hue -1% | I
-vestra.video | video.hue.up | Video ▸ Hue +1% | O
-vestra.video | video.gpu-rendering | Video ▸ GPU Rendering (Experimental)
 host | volume-up | Audio ▸ Volume + | ArrowUp, Mouse:WheelUp
 host | volume-down | Audio ▸ Volume − | ArrowDown, Mouse:WheelDown
 host | mute | Audio ▸ Mute | M
-vestra.audio | audio.workbench | Audio ▸ Audio Workbench…
-vestra.audio | audio.track.none | Audio ▸ Audio Track ▸ No Audio Tracks
-vestra.audio | audio.track.cycle | Audio ▸ Audio Track ▸ Cycle Tracks | Alt+A
-vestra.audio | audio.channels.stereo | Audio ▸ Audio Track ▸ Stereo
-vestra.audio | audio.channels.left | Audio ▸ Audio Track ▸ Left Channel
-vestra.audio | audio.channels.right | Audio ▸ Audio Track ▸ Right Channel
-vestra.audio | audio.channels.mono | Audio ▸ Audio Track ▸ Mono Mix
-vestra.audio | audio.channels.swap | Audio ▸ Audio Track ▸ Swap Left and Right
-vestra.audio | audio.device.none | Audio ▸ Output Device ▸ No Output Devices
-vestra.audio | audio.equalizer | Audio ▸ Equalizer | Shift+E
-vestra.audio | audio.preset.0 | Audio ▸ Preset ▸ Flat
-vestra.audio | audio.preset.1 | Audio ▸ Preset ▸ Voice
-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.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.visualizer | audio-cover | Audio ▸ Show Album Cover for Audio Only
+vestra.audio | audio.track.none | Audio Track ▸ No Audio Tracks
 host | fullscreen | Toggle Fullscreen | Escape
 vestra.window | pip | Screen ▸ Picture-in-Picture
 vestra.window | mini | Screen ▸ Mini Size | \`
@@ -557,6 +389,10 @@ vestra.window | top.never | Screen ▸ Always on Top ▸ Never
 vestra.window | top.always | Screen ▸ Always on Top ▸ Always
 vestra.window | top.playing | Screen ▸ Always on Top ▸ While Playing
 vestra.window | top.fullscreen | Screen ▸ Always on Top ▸ While Playing in Fullscreen
+vestra.video | video.picture | Picture… | Alt+1
+vestra.audio | audio.workbench | Audio… | Alt+2
+vestra.subtitles | tune | Subtitles… | Alt+3
+vestra.playback | panel | Playback… | Alt+4
 vestra.playlist | playlist.visibility | Playlist | F6
 vestra.info | info.toggle | Playback Info | Tab
 vestra.info | info.properties | Playback Properties… | Ctrl+F1
@@ -578,13 +414,6 @@ 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
 vestra.info | info.update | Check for Updates…
@@ -594,6 +423,33 @@ host | exit-fullscreen | (Leave Fullscreen)
 host | sidebar | (Toggle Sidebar)
 host | palette | (Command Palette) | Ctrl+Shift+P
 host | adjust | (Adjust)
+host | frame-back | (Previous Frame) | D
+host | frame-forward | (Next Frame) | F
+host | seek-backward | (Back 5 s) | ArrowLeft
+host | seek-forward | (Forward 5 s) | ArrowRight
+host | rate-normal | (Normal) | Z
+host | rate-down | (Slower 0.1) | X
+host | rate-up | (Faster 0.1) | C
+vestra.audio | audio.track.cycle | (Cycle Tracks) | Alt+A
+vestra.audio | audio.channels.stereo | (Stereo)
+vestra.audio | audio.channels.left | (Left Channel)
+vestra.audio | audio.channels.right | (Right Channel)
+vestra.audio | audio.channels.mono | (Mono Mix)
+vestra.audio | audio.channels.swap | (Swap Left and Right)
+vestra.audio | audio.equalizer | (Equalizer) | Shift+E
+vestra.audio | audio.preset.0 | (Flat)
+vestra.audio | audio.preset.1 | (Voice)
+vestra.audio | audio.preset.2 | (Music)
+vestra.audio | audio.preset.3 | (Cinema)
+vestra.audio | audio.sync.earlier | (50 ms Earlier) | >
+vestra.audio | audio.sync.later | (50 ms Later) | <
+vestra.audio | audio.sync.reset | (Reset) | ?
+vestra.audio | audio.sync.keep.none | (Don't Keep)
+vestra.audio | audio.sync.keep.session | (Keep for This Run)
+vestra.audio | audio.sync.keep.always | (Always Keep)
+vestra.audio | audio.normalize | (Normalize) | Shift+N
+vestra.audio | audio.clarity | (Crystalizer) | Shift+C
+vestra.audio | audio.reset | (Reset)
 vestra.capture | capture.clipExport | (Export Clip Range) | Ctrl+Shift+E
 vestra.capture | capture.saveAs | (Save Current Frame As…)
 vestra.capture | capture.saveScreen | (Save Rendered Frame) | Ctrl+Alt+E
@@ -615,6 +471,21 @@ vestra.capture | capture.clipStart | (Set Clip Start)
 vestra.capture | capture.clipEnd | (Set Clip End)
 vestra.capture | capture.last30 | (Export Last 30 Seconds) | Ctrl+Shift+R
 vestra.info | info.brief | (Brief Info) | Shift+Tab
+vestra.playback | keyframe-back | (Previous Keyframe) | Ctrl+Shift+ArrowLeft
+vestra.playback | keyframe-forward | (Next Keyframe) | Ctrl+Shift+ArrowRight
+vestra.playback | jump | (Jump to Time…) | G
+vestra.playback | jump-start | (Jump to Start) | Backspace
+vestra.playback | time-jump | (Seek Steps…)
+vestra.playback | rate-05 | (0.5×)
+vestra.playback | rate-15 | (1.5×)
+vestra.playback | rate-20 | (2×)
+vestra.playback | rate-custom | (Custom…)
+vestra.playback | backward-2 | (Back 30 s) | Ctrl+ArrowLeft
+vestra.playback | forward-2 | (Forward 30 s) | Ctrl+ArrowRight
+vestra.playback | backward-3 | (Back 60 s) | Shift+ArrowLeft
+vestra.playback | forward-3 | (Forward 60 s) | Shift+ArrowRight
+vestra.playback | backward-4 | (Back 300 s) | Ctrl+Alt+ArrowLeft
+vestra.playback | forward-4 | (Forward 300 s) | Ctrl+Alt+ArrowRight
 vestra.playlist | playlist.play | (Play) | Enter, P | panel
 vestra.playlist | playlist.list-add | (Add Files…) | Ctrl+I | panel
 vestra.playlist | playlist.list-add-folder | (Add Folder…) | Ctrl+O | panel
@@ -646,6 +517,114 @@ vestra.playlist | playlist.list-open-list | (Open List File…) | F3 | panel
 vestra.playlist | playlist.list-save-list | (Save List…) | F2 | panel
 vestra.playlist | playlist.close | (Close List) | F6 | panel
 vestra.playlist | playlist.settings | (Playlist Settings…) | F5 | panel
+vestra.subtitles | show | (Show Subtitles) | Alt+H
+vestra.subtitles | second-off | (Off)
+vestra.subtitles | second-position-top | (Top)
+vestra.subtitles | second-position-aboveMain | (Above Main Subtitle)
+vestra.subtitles | track-cycle | (Cycle) | Alt+L
+vestra.subtitles | size-up | (Size +) | Alt+PageUp
+vestra.subtitles | size-down | (Size −) | Alt+PageDown
+vestra.subtitles | move-up | (Move Up)
+vestra.subtitles | move-down | (Move Down)
+vestra.subtitles | move-reset | (Subtitle Position) | Alt+Home
+vestra.subtitles | bold | (Bold) | Alt+B
+vestra.subtitles | shadow | (Shadow)
+vestra.subtitles | box | (Opaque Box)
+vestra.subtitles | ass-original | (Original ASS/SSA Styles)
+vestra.subtitles | dialogue-previous | (Previous Dialogue) | Home
+vestra.subtitles | dialogue-next | (Next Dialogue) | End
+vestra.subtitles | dialogue-current | (Current Subtitle Start) | Ctrl+Home
+vestra.subtitles | sync-reset | (Subtitle Sync) | /
+vestra.subtitles | sync-input | (Adjust Sync…)
+vestra.subtitles | reload | (Reload Subtitles) | Ctrl+Alt+Y
+vestra.subtitles | refresh | (Refresh Subtitle Tracks)
+vestra.subtitles | remove | (Remove External Subtitle)
+vestra.subtitles | settings | (Subtitle Settings…)
+vestra.subtitles | sync-earlier | (Earlier 0.5 s) | .
+vestra.subtitles | sync-later | (Later 0.5 s) | ,
+vestra.video | video.shader.use | (Use Shaders) | Shift+P
+vestra.video | video.shader.list | (Shader List…)
+vestra.video | video.shader.folder | (Open Shader Folder)
+vestra.video | video.shader.reload | (Reload Shaders)
+vestra.video | video.hdr.auto | (Auto)
+vestra.video | video.hdr.off | (Off)
+vestra.video | video.hdr.bt.2390 | (BT.2390)
+vestra.video | video.hdr.hable | (Hable)
+vestra.video | video.hdr.mobius | (Mobius)
+vestra.video | video.hdr.reinhard | (Reinhard)
+vestra.video | video.hdr.clip | (Clip)
+vestra.video | video.hdr.peak | (Dynamic Peak Detection)
+vestra.video | video.hdr.settings | (HDR Settings…)
+vestra.video | video.deinterlace.cycle | (Cycle) | Ctrl+I
+vestra.video | video.deinterlace.auto | (Auto)
+vestra.video | video.deinterlace.on | (Always)
+vestra.video | video.deinterlace.off | (Never)
+vestra.video | video.deinterlace.output.frame | (By Frame)
+vestra.video | video.deinterlace.output.field | (By Field (Double Rate))
+vestra.video | video.fit.keep | (Keep Aspect Ratio)
+vestra.video | video.fit.stretch | (Ignore Aspect Ratio)
+vestra.video | video.fit.fill | (Fill Window (Crop Excess))
+vestra.video | video.aspect.cycle | (Cycle Aspect Ratio) | Shift+F6
+vestra.video | video.aspect.default | (Default (Source))
+vestra.video | video.aspect.0 | (4:3)
+vestra.video | video.aspect.1 | (16:9)
+vestra.video | video.aspect.2 | (16:10)
+vestra.video | video.aspect.3 | (1.85:1)
+vestra.video | video.aspect.4 | (2.35:1)
+vestra.video | video.aspect.custom | (Custom (x:y))
+vestra.video | video.aspect.edit | (Custom Aspect Ratio…)
+vestra.video | video.reframe.none | (None)
+vestra.video | video.reframe.pad.0 | (Stretch to 4:3)
+vestra.video | video.reframe.pad.1 | (Stretch to 16:9)
+vestra.video | video.reframe.pad.2 | (Stretch to 16:10)
+vestra.video | video.reframe.pad.3 | (Stretch to 1.85:1)
+vestra.video | video.reframe.pad.4 | (Stretch to 2.35:1)
+vestra.video | video.reframe.crop.0 | (Crop to 4:3)
+vestra.video | video.reframe.crop.1 | (Crop to 16:9)
+vestra.video | video.reframe.crop.2 | (Crop to 16:10)
+vestra.video | video.reframe.crop.3 | (Crop to 1.85:1)
+vestra.video | video.reframe.crop.4 | (Crop to 2.35:1)
+vestra.video | video.reframe.left | (Move Left)
+vestra.video | video.reframe.right | (Move Right)
+vestra.video | video.reframe.up | (Move Up)
+vestra.video | video.reframe.down | (Move Down)
+vestra.video | video.reframe.reset | (Crop Position)
+vestra.video | video.frame.zoom-in | (Zoom In) | Alt+Plus, Numpad9
+vestra.video | video.frame.zoom-out | (Zoom Out) | Alt+-, Numpad1
+vestra.video | video.frame.right | (Pan →) | Alt+ArrowRight, Ctrl+Numpad6
+vestra.video | video.frame.left | (Pan ←) | Alt+ArrowLeft, Ctrl+Numpad4
+vestra.video | video.frame.up | (Pan ↑) | Alt+ArrowUp, Ctrl+Numpad8
+vestra.video | video.frame.down | (Pan ↓) | Alt+ArrowDown, Ctrl+Numpad2
+vestra.video | video.frame.centre | (Center Frame) | Ctrl+Numpad5
+vestra.video | video.frame.reset | (Framing) | Alt+Backspace, Numpad5
+vestra.video | video.flip.vertical | (Flip Vertically) | Ctrl+P
+vestra.video | video.flip.horizontal | (Flip Horizontally) | Ctrl+Z
+vestra.video | video.gaussian | (Gaussian Blur) | Ctrl+B
+vestra.video | video.sharpen | (Sharpen) | Ctrl+R
+vestra.video | video.edge | (Edge Sharpen)
+vestra.video | video.deblock | (Deblock) | Ctrl+H
+vestra.video | video.deband | (Deband)
+vestra.video | video.denoise.d3 | (3D Denoise) | Ctrl+N
+vestra.video | video.denoise.gradual | (Gradual Denoise)
+vestra.video | video.denoise.temporal | (Temporal Denoise) | Ctrl+M
+vestra.video | video.frame-blend | (Frame Doubling)
+vestra.video | video.interpolation | (Motion Interpolation)
+vestra.video | video.rotate.cycle | (Cycle) | Alt+K
+vestra.video | video.rotate.0 | (No Rotation)
+vestra.video | video.rotate.90 | (90°)
+vestra.video | video.rotate.180 | (180°)
+vestra.video | video.rotate.270 | (270°)
+vestra.video | video.reset | (Picture) | Q
+vestra.video | video.resetPanel | (Picture Panel)
+vestra.video | video.brightness.down | (Brightness -1%) | W
+vestra.video | video.brightness.up | (Brightness +1%) | E
+vestra.video | video.contrast.down | (Contrast -1%) | R
+vestra.video | video.contrast.up | (Contrast +1%) | T
+vestra.video | video.saturation.down | (Saturation -1%) | Y
+vestra.video | video.saturation.up | (Saturation +1%) | U
+vestra.video | video.hue.down | (Hue -1%) | I
+vestra.video | video.hue.up | (Hue +1%) | O
+vestra.video | video.gpu-rendering | (GPU Rendering (Experimental))
 `;
 /**
  * The commands the player and its built-in plugins register when the

package/dist/plugin/runtime.js

@@ -13,7 +13,9 @@ const SDK_DIRECTORY = fileURLToPath(new URL("..", import.meta.url));
 export const WAKE_EVENTS = [
     "packages.changed",
     "bindings.changed",
-    // Player 0.7.6: sent only to the plugin whose own keys changed.
+    // Player 0.7.6: sent to a plugin whose own keys changed and, from SDK
+    // 1.6.16, to every listener when a player command (`host/<id>`) is
+    // rebound, which wakes each parked listener.
     "commands.keys",
     "appearance.changed",
     "resolvers.fileTypes",
@@ -248,7 +250,15 @@ export class Runtime {
         this.directory = directory;
         transport.on("ui.callback", (data) => {
             const event = data;
-            this.views.get(event.view)?.(event.callback, event.args);
+            // A panel's callback names its slot (player 0.7.6: one panel per
+            // slot); older players name only `"$mount"`, and the plugin has one.
+            const view = event.view === "$mount"
+                ? event.slot
+                    ? `panel:${event.slot}`
+                    : [...this.views.keys()].find((key) => key.startsWith("panel:"))
+                : event.view;
+            if (view)
+                this.views.get(view)?.(event.callback, event.args);
         });
         transport.on("commands.execute", (data) => {
             this.commands.get(data.id)?.();

package/dist/plugin/testing.d.ts

@@ -480,6 +480,37 @@ export interface MarkdownWire {
     /** Remote image address → the file the SDK downloaded for it. */
     images: Record<string, string>;
 }
+/**
+ * One mounted panel of the plugin under test ({@link TestHost.mounted},
+ * {@link TestHost.panels}): a {@link FakeWindow} record with its slot,
+ * component and interaction locks.
+ *
+ * @remarks
+ * One per slot the plugin mounted (SDK 1.6.15), kept in
+ * {@link TestHost.panels}; disposing a panel removes only its own.
+ *
+ * @example Check the adjust panel's locks
+ * The plugin's adjust panel reports a drag; the test reads the locks it
+ * sent. `mounted(slot)` picks one of the plugin's panels by slot.
+ * ```ts
+ * import assert from "node:assert/strict";
+ * declare const host: TestHost;
+ * // ---cut---
+ * const panel: FakePanel = host.mounted("adjust");
+ * assert.deepEqual(panel.locks, { focused: false, dragging: true, popupOpen: false });
+ * ```n *
+ * @capability None.
+ * @since 1.6.15
+ * @category Testing
+ */
+export type FakePanel = Omit<FakeWindow, "callbacks" | "userClose"> & {
+    /** `"bottom"`, `"sidebar"`, `"adjust"` or `"backdrop"`. */
+    slot: string;
+    /** The exported component the SDK found in the file. */
+    component: string;
+    /** The last `panel.setInteraction(...)` locks, `null` before any. */
+    locks: Json;
+};
 /**
  * An in-memory fake Vestra Player for plugin tests.
  *
@@ -597,17 +628,16 @@ export declare class TestHost implements Transport {
     /** Tool windows by id (see {@link TestHost.window}). */
     readonly windows: Map<string, FakeWindow>;
     /**
-     * The plugin's mounted panel (bottom bar, sidebar or backdrop), or `null`.
-     * See {@link TestHost.mounted}.
+     * The plugin's mounted panels by slot, in mount order (SDK 1.6.15: one
+     * panel per slot). See {@link TestHost.mounted}.
      */
-    panel: (Omit<FakeWindow, "callbacks" | "userClose"> & {
-        /** `"bottom"`, `"sidebar"`, `"adjust"` or `"backdrop"`. */
-        slot: string;
-        /** The exported component the SDK found in the file. */
-        component: string;
-        /** The last `panel.setInteraction(...)` locks, `null` before any. */
-        locks: Json;
-    }) | null;
+    readonly panels: Map<string, FakePanel>;
+    /**
+     * The plugin's mounted panel (bottom bar, sidebar, adjust column or
+     * backdrop), the last mounted when it has several, or `null`. See
+     * {@link TestHost.mounted}.
+     */
+    get panel(): FakePanel | null;
     /** The plugin's commands by local id (see {@link TestHost.command}). */
     readonly commands: Map<string, FakeCommand>;
     /** The player's 14 core actions (`host/<id>`), kept apart from the plugin's `commands`. */
@@ -2527,8 +2557,9 @@ export declare class TestHost implements Transport {
      */
     get conflicts(): string[][];
     /**
-     * Change the keys of one of the plugin's commands as the user does in
-     * Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
+     * Change the keys of one of the plugin's commands, or of one of the
+     * player's core commands by its `host/<id>` (SDK 1.6.16), as the user
+     * does in Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
      * clears them, as Ignore Default Shortcuts does for every default),
      * `null` gives it its own defaults back. It writes
      * {@link TestHost.bindings | bindings.overlay}, and the plugin hears it
@@ -2550,7 +2581,8 @@ export declare class TestHost implements Transport {
      * ```
      *
      * @capability None.
-     * @throws `Error` `command` is not a command of the plugin.
+     * @throws `Error` `command` is neither a command of the plugin nor a
+     *   core command.
      * @since 1.6.6
      */
     rebind(command: string, inputs: readonly string[] | null): void;
@@ -2814,9 +2846,11 @@ export declare class TestHost implements Transport {
      */
     window(id: string): FakeWindow;
     /**
-     * The plugin's mounted panel (bottom bar, sidebar or backdrop). Throws when
-     * none is mounted. Its `props` use Slint (kebab-case) names; `emit` fires a
-     * callback on the panel's global.
+     * The plugin's mounted panel (bottom bar, sidebar, adjust column or
+     * backdrop): the one in `slot`, or without it the only one (SDK 1.6.15: a
+     * plugin mounts one panel per slot; with several, name the slot). Throws
+     * when there is none. Its `props` use Slint (kebab-case) names; `emit`
+     * fires a callback on the panel's global.
      *
      * @example Select a row in the plugin's sidebar panel
      * The test checks the panel sits in the sidebar and selects its third
@@ -2835,14 +2869,7 @@ export declare class TestHost implements Transport {
      * @capability None.
      * @since 1.0.0
      */
-    mounted(): Omit<FakeWindow, "callbacks" | "userClose"> & {
-        /** `"bottom"`, `"sidebar"`, `"adjust"` or `"backdrop"`. */
-        slot: string;
-        /** The exported component the SDK found in the file. */
-        component: string;
-        /** The last `panel.setInteraction(...)` locks, `null` before any. */
-        locks: Json;
-    };
+    mounted(slot?: "bottom" | "sidebar" | "adjust" | "backdrop"): FakePanel;
     /**
      * The parameters of every request of one wire method, oldest first.
      *

package/dist/plugin/testing.js

@@ -330,6 +330,8 @@ const SLOT_LABELS = {
     backdrop: "video backdrop",
     adjust: "adjust column",
 };
+/** The view a panel's writes are kept under (the player's, per slot). */
+const mountView = (slot) => slot === "bottom" ? "$mount" : `$mount:${slot}`;
 /** Texts only the test host uses, with their Chinese of SDK 1.5.8. */
 const TEST_ZH_HANS = {
     "this site": "这个网站",
@@ -521,10 +523,18 @@ export class TestHost {
     /** Tool windows by id (see {@link TestHost.window}). */
     windows = new Map();
     /**
-     * The plugin's mounted panel (bottom bar, sidebar or backdrop), or `null`.
-     * See {@link TestHost.mounted}.
+     * The plugin's mounted panels by slot, in mount order (SDK 1.6.15: one
+     * panel per slot). See {@link TestHost.mounted}.
      */
-    panel = null;
+    panels = new Map();
+    /**
+     * The plugin's mounted panel (bottom bar, sidebar, adjust column or
+     * backdrop), the last mounted when it has several, or `null`. See
+     * {@link TestHost.mounted}.
+     */
+    get panel() {
+        return [...this.panels.values()].at(-1) ?? null;
+    }
     /** The plugin's commands by local id (see {@link TestHost.command}). */
     commands = new Map();
     /** The player's 14 core actions (`host/<id>`), kept apart from the plugin's `commands`. */
@@ -3234,8 +3244,9 @@ export class TestHost {
         return this.coreCommands.has(id) ? id : `${this.manifestId}/${id}`;
     }
     /**
-     * Change the keys of one of the plugin's commands as the user does in
-     * Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
+     * Change the keys of one of the plugin's commands, or of one of the
+     * player's core commands by its `host/<id>` (SDK 1.6.16), as the user
+     * does in Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
      * clears them, as Ignore Default Shortcuts does for every default),
      * `null` gives it its own defaults back. It writes
      * {@link TestHost.bindings | bindings.overlay}, and the plugin hears it
@@ -3257,11 +3268,12 @@ export class TestHost {
      * ```
      *
      * @capability None.
-     * @throws `Error` `command` is not a command of the plugin.
+     * @throws `Error` `command` is neither a command of the plugin nor a
+     *   core command.
      * @since 1.6.6
      */
     rebind(command, inputs) {
-        if (!this.commands.has(command))
+        if (!this.commands.has(command) && !this.coreCommands.has(command))
             throw new Error(`test host: no command ${command}`);
         const key = this.#bindingKey(command);
         if (inputs === null)
@@ -3277,15 +3289,19 @@ export class TestHost {
     #keysRevision = 0;
     /**
      * `commands.keys` as the player answers it: each of the plugin's own
-     * commands with the labels of the keys it holds now (the overlay, else
-     * its defaults; not a key an earlier command holds), as menus write
-     * them on `systemInfo.os`.
+     * commands, and the player's core commands as `host/<id>` (SDK 1.6.16),
+     * with the labels of the keys it holds now (the overlay, else its
+     * defaults; not a key an earlier command holds), as menus write them on
+     * `systemInfo.os`.
      */
     #keys() {
         const claims = this.#claims();
         const mac = this.systemInfo.os === "macos";
         const keys = {};
-        for (const [id, { declaration }] of this.commands) {
+        for (const [id, { declaration }] of [
+            ...this.commands,
+            ...this.coreCommands,
+        ]) {
             const scope = declaration.focus ? "panel" : "global";
             const current = this.bindings.overlay.get(this.#bindingKey(id)) ??
                 declaration.bindings ??
@@ -3627,9 +3643,11 @@ export class TestHost {
         return window;
     }
     /**
-     * The plugin's mounted panel (bottom bar, sidebar or backdrop). Throws when
-     * none is mounted. Its `props` use Slint (kebab-case) names; `emit` fires a
-     * callback on the panel's global.
+     * The plugin's mounted panel (bottom bar, sidebar, adjust column or
+     * backdrop): the one in `slot`, or without it the only one (SDK 1.6.15: a
+     * plugin mounts one panel per slot; with several, name the slot). Throws
+     * when there is none. Its `props` use Slint (kebab-case) names; `emit`
+     * fires a callback on the panel's global.
      *
      * @example Select a row in the plugin's sidebar panel
      * The test checks the panel sits in the sidebar and selects its third
@@ -3648,11 +3666,27 @@ export class TestHost {
      * @capability None.
      * @since 1.0.0
      */
-    mounted() {
+    mounted(slot) {
+        if (slot !== undefined) {
+            const panel = this.panels.get(slot);
+            if (!panel)
+                throw new Error(`no panel mounted in the ${slot}`);
+            return panel;
+        }
+        if (this.panels.size > 1)
+            throw new Error(`panels are mounted in ${[...this.panels.keys()].join(", ")}: name the slot`);
         if (!this.panel)
             throw new Error("no panel mounted");
         return this.panel;
     }
+    /** The panel a request is about: its `slot`, else the only one. */
+    #panelFor(p) {
+        const slot = typeof p.slot === "string" ? p.slot : undefined;
+        const panel = slot ? this.panels.get(slot) : this.panel;
+        if (!panel)
+            throw new HostError("missing", "owner has no ready mount");
+        return panel;
+    }
     /**
      * The parameters of every request of one wire method, oldest first.
      *
@@ -4260,16 +4294,18 @@ export class TestHost {
         // A sidebar panel is never live (player 0.7.3): the current tab keeps
         // the plugin running as busy work, a background tab not at all. The
         // adjust column's current tab only while the column is open (0.7.6).
-        if (this.panel?.slot === "sidebar") {
-            if (this.layout.sidebar?.owner === 1)
-                reasons.push("its sidebar tab is the current tab");
-        }
-        else if (this.panel?.slot === "adjust") {
-            if (this.layout.adjust?.owner === 1 && this.layout.adjust.preferred)
-                reasons.push("its adjust tab is the current tab");
+        for (const panel of this.panels.values()) {
+            if (panel.slot === "sidebar") {
+                if (this.layout.sidebar?.owner === 1)
+                    reasons.push("its sidebar tab is the current tab");
+            }
+            else if (panel.slot === "adjust") {
+                if (this.layout.adjust?.owner === 1 && this.layout.adjust.preferred)
+                    reasons.push("its adjust tab is the current tab");
+            }
+            else
+                reasons.push("a mounted panel");
         }
-        else if (this.panel)
-            reasons.push("a mounted panel");
         for (const [id, window] of this.windows)
             if (window.visible)
                 reasons.push(`an open window (${id})`);
@@ -4501,10 +4537,11 @@ export class TestHost {
                 throw new HostError("missing", "view not found");
         },
         "ui.mount": (p) => {
-            if (this.panel)
-                throw new HostError("conflict", "owner already mounted");
             if (!(String(p.slot) in SLOT_LABELS))
                 throw new HostError("invalid", "unknown mount slot");
+            // One panel per slot and plugin (player 0.7.6).
+            if (this.panels.has(String(p.slot)))
+                throw new HostError("conflict", "this plugin already has a panel in this slot");
             // Like the player: one panel in the bottom bar and the backdrop, any
             // number of tabs in the sidebar (player 0.7.3; 0.4.x to 0.7.2 took 8)
             // and in the adjust column (player 0.7.6).
@@ -4520,10 +4557,11 @@ export class TestHost {
                 ]));
             const properties = this.#initialValues(this.#shownValues(p.properties));
             this.#seeImages(properties);
-            this.#resetWrites("$mount");
+            const panelSlot = String(p.slot);
+            this.#resetWrites(mountView(panelSlot));
             const host = this;
-            this.panel = {
-                slot: String(p.slot),
+            this.panels.set(panelSlot, {
+                slot: panelSlot,
                 file: String(p.file),
                 component: String(p.component),
                 visible: true,
@@ -4532,11 +4570,12 @@ export class TestHost {
                 emit(callback, ...args) {
                     host.emit("ui.callback", {
                         view: "$mount",
+                        slot: panelSlot,
                         callback: kebab(callback),
                         args,
                     });
                 },
-            };
+            });
             if (p.slot === "backdrop") {
                 this.backdrop = { owner: this.manifestId, effective: true };
                 return { status: "ready", prepareMs: 0, shellGeneration: 1 };
@@ -4551,18 +4590,24 @@ export class TestHost {
             });
             return { status: "ready", prepareMs: 0, shellGeneration: 1 };
         },
-        "ui.unmount": () => {
-            if (this.panel?.slot === "backdrop")
-                this.backdrop = null;
-            else if (this.panel)
-                this.#removePanel(this.panel.slot, 1);
-            this.panel = null;
+        "ui.unmount": (p) => {
+            // The slot's panel, or without one every panel (as the player).
+            const slots = typeof p.slot === "string" ? [p.slot] : [...this.panels.keys()];
+            for (const slot of slots) {
+                if (!this.panels.delete(slot))
+                    continue;
+                if (slot === "backdrop")
+                    this.backdrop = null;
+                else
+                    this.#removePanel(slot, 1);
+            }
         },
         "ui.menu": (p) => {
-            if (!this.panel)
+            if (!this.panels.size)
                 throw new HostError("unavailable", "panel not shown");
-            const tabs = this.panel.slot === "sidebar" || this.panel.slot === "adjust"
-                ? this.layout[this.panel.slot]
+            const panel = this.#panelFor(p);
+            const tabs = panel.slot === "sidebar" || panel.slot === "adjust"
+                ? this.layout[panel.slot]
                 : null;
             if (tabs && tabs.owner !== 1)
                 throw new HostError("unavailable", "the panel's tab is not the current one");
@@ -4613,8 +4658,9 @@ export class TestHost {
                     : collapsed
                         ? "fullscreen"
                         : null;
-                if (this.panel?.slot === slot)
-                    this.panel.visible = p.visible;
+                const panel = this.panels.get(slot);
+                if (panel)
+                    panel.visible = p.visible;
             }
             if (typeof p.detached === "boolean")
                 state.detached = p.detached;
@@ -4880,9 +4926,9 @@ export class TestHost {
             this.emit("sequence.step", { direction });
         },
         "ui.setMount": (p) => {
-            const panel = this.mounted();
+            const panel = this.#panelFor(p);
             const property = String(p.property);
-            const next = this.#write("$mount", property, p, panel.props[property]);
+            const next = this.#write(mountView(panel.slot), property, p, panel.props[property]);
             // A part of a value sent in parts is held until the last (player 0.6.0).
             if (next !== undefined)
                 panel.props[property] = next;
@@ -5122,7 +5168,10 @@ export class TestHost {
             })));
             return { applied: true };
         },
-        "ui.interaction": (p) => void (this.mounted().locks = p),
+        "ui.interaction": (p) => {
+            const { slot: _, ...locks } = p;
+            this.#panelFor(p).locks = locks;
+        },
         "dialogs.confirm": (p) => {
             this.confirms.push(p);
             const shown = (field, formatted = false) => p[field] === undefined

package/dist/plugin/types.d.ts

@@ -1470,8 +1470,11 @@ export interface Commands {
      * player, and until its answer arrives (a few milliseconds) every
      * command reads `[]`; a binding that read it runs again then.
      *
-     * Only the plugin's own commands: an id the plugin has not added (or
-     * another plugin's) reads `[]`. Needs nothing beyond `commands`, not
+     * The plugin's own commands, and the player's own as `host/<id>` (SDK
+     * 1.6.16; `host/volume-up`, `host/mute`: the ids of
+     * {@link "@vestra-player/sdk/testing"!BUILTIN_COMMANDS | BUILTIN_COMMANDS} rows owned by `host`), for a panel that
+     * shows the player's keys beside its own controls; an id the plugin has
+     * not added (or another plugin's) reads `[]`. Needs nothing beyond `commands`, not
      * `bindings.manage` (the whole binding table, every plugin's, is
      * {@link Bindings.list}). Without the `commands` capability every
      * command reads `[]`. Players before 0.7.6 have no `keys` (the player
@@ -4095,9 +4098,14 @@ export interface BackdropSlot {
  * or the sidebar moves to or from its floating window, while the global is
  * one stable address.
  *
- * Each plugin mounts at most one panel, and each position holds one panel
- * for all plugins. {@link Panels.bottom} and {@link Panels.sidebar} describe
- * the positions, whoever mounted there.
+ * A plugin mounts at most one panel per slot (SDK 1.6.15, player 0.7.6;
+ * before, one panel in all): a playback plugin can have its control bar in
+ * `"bottom"` and its controls in `"adjust"`. Each {@link Panel} has its own
+ * bridge, state, `toggle()` and `setInteraction()`; disposing one leaves
+ * the others, and stopping the plugin unmounts them all. The bottom bar and
+ * the backdrop hold one panel for all plugins; the sidebar and the adjust
+ * column one tab per plugin. {@link Panels.bottom}, {@link Panels.sidebar}
+ * and {@link Panels.adjust} describe the positions, whoever mounted there.
  *
  * @capability ui.mount
  *
@@ -4194,8 +4202,11 @@ export interface Panels {
      * @returns A {@link Panel} owned by this scope; await {@link Panel.ready}
      *   for the result.
      *
-     * @throws `Error` without a code (throws) This plugin already has a panel,
-     *   or the file exports no component or global, or several and `options`
+     * @throws `Error` without a code (throws) This plugin already has a panel
+     *   in this slot (a panel in another slot is fine from player 0.7.6;
+     *   players before 0.7.6 refuse a second panel with `conflict`, so a
+     *   plugin that mounts two declares `minPlayerVersion` 0.7.6), or the file
+     *   exports no component or global, or several and `options`
      *   does not name one. A file that cannot be read throws Node's file system
      *   error (`code` `ENOENT` and so on).
      * @throws The errors of {@link Panel.ready} (rejects `ready`) The player

package/dist/plugin/ui.js

@@ -839,13 +839,15 @@ class PanelHandle extends ViewBase {
     #locks = { focused: false, dragging: false, popupOpen: false };
     #interaction;
     constructor(scope, slot, file, options) {
-        if (scope.runtime.views.has("$mount"))
-            throw new Error("a plugin can mount only one panel");
+        // One panel per slot (SDK 1.6.15, player 0.7.6; a player before 0.7.6
+        // refuses a second panel with `conflict`).
+        if (scope.runtime.views.has(`panel:${slot}`))
+            throw new Error(`this plugin already has a panel in the ${slot}`);
         super(scope);
         this.#slot = slot;
         const runtime = scope.runtime;
-        runtime.views.set("$mount", (callback, args) => this.dispatch(callback, args));
-        this.#interaction = new Latest((locks) => runtime.host.ui.interaction(locks));
+        runtime.views.set(`panel:${slot}`, (callback, args) => this.dispatch(callback, args));
+        this.#interaction = new Latest((locks) => runtime.host.ui.interaction(locks, this.#named()));
         const component = options.component ?? exported(runtime.directory, file, "component");
         const global = options.global ?? exported(runtime.directory, file, "global");
         scope.add(this);
@@ -874,8 +876,17 @@ class PanelHandle extends ViewBase {
     live() {
         return this.#mounted && !this.closed;
     }
+    /**
+     * The slot to name in a request about this panel: only while the plugin
+     * has panels in more than one slot (the player then needs it); a plugin
+     * with one panel sends what it always sent.
+     */
+    #named() {
+        const panels = [...this.scope.runtime.views.keys()].filter((key) => key.startsWith("panel:"));
+        return panels.length > 1 ? this.#slot : undefined;
+    }
     write(property, write) {
-        return this.scope.runtime.host.ui.setMount(property, write);
+        return this.scope.runtime.host.ui.setMount(property, write, this.#named());
     }
     get state() {
         const service = layoutOf(this.scope.runtime);
@@ -932,7 +943,7 @@ class PanelHandle extends ViewBase {
     }
     async showMenu(items, at) {
         await this.ready;
-        await this.scope.runtime.host.ui.menu(items.map((item) => item?.id ?? null), at.x, at.y);
+        await this.scope.runtime.host.ui.menu(items.map((item) => item?.id ?? null), at.x, at.y, this.#named());
     }
     onDrop(listener) {
         const watch = dropsOf(this.scope.runtime).listen(this.scope, (event) => this.scope.run(listener, event));
@@ -950,10 +961,10 @@ class PanelHandle extends ViewBase {
         this.scope.forget(this);
         this.#interaction.stop();
         if (this.#mounted)
-            await this.scope.runtime.host.ui.unmount().catch(() => { });
+            await this.scope.runtime.host.ui.unmount(this.#named()).catch(() => { });
         this.#mounted = false;
         await this.release();
-        this.scope.runtime.views.delete("$mount");
+        this.scope.runtime.views.delete(`panel:${this.#slot}`);
         // Listeners of `onChange` hear `null`.
         this.scope.runtime.invalidate();
         await layoutOf(this.scope.runtime).refresh();

package/dist/wire.d.ts

@@ -275,6 +275,8 @@ export interface WireTimeline {
     marks: WireMark[];
     ranges?: WireRange[];
 }
+/** A panel position (`ui.mount`'s `slot`). */
+export type MountSlot = "bottom" | "sidebar" | "backdrop" | "adjust";
 /** The backdrop as `layout.state` reports it; `null` without one. */
 export interface LayoutBackdrop {
     owner: number;
@@ -752,14 +754,14 @@ export declare function createWire(transport: Transport): {
             prepareMs: number;
             shellGeneration: number;
         }>;
-        setMount: (property: string, write: PropertyWrite) => Promise<void>;
+        setMount: (property: string, write: PropertyWrite, slot?: MountSlot) => Promise<void>;
         interaction: (locks: {
             focused: boolean;
             dragging: boolean;
             popupOpen: boolean;
-        }) => Promise<void>;
-        unmount: () => Promise<void>;
-        menu: (items: (string | null)[], x: number, y: number) => Promise<void>;
+        }, slot?: MountSlot) => Promise<void>;
+        unmount: (slot?: MountSlot) => Promise<void>;
+        menu: (items: (string | null)[], x: number, y: number, slot?: MountSlot) => Promise<void>;
         open: (id: string, file: string, properties?: Record<string, Json>, callbacks?: string[]) => Promise<void>;
         set: (id: string, property: string, write: PropertyWrite) => Promise<void>;
         show: (id: string, visible: boolean) => Promise<void>;

package/dist/wire.js

@@ -328,10 +328,24 @@ export function createWire(transport) {
                 base,
             }),
             mount: (options) => transport.request("ui.mount", options),
-            setMount: (property, write) => transport.request("ui.setMount", { property, ...write }),
-            interaction: (locks) => transport.request("ui.interaction", locks),
-            unmount: () => transport.request("ui.unmount"),
-            menu: (items, x, y) => transport.request("ui.menu", { items, x, y }),
+            // `slot`: which of the plugin's panels (player 0.7.6: one per slot;
+            // older players have one and ignore it).
+            setMount: (property, write, slot) => transport.request("ui.setMount", {
+                property,
+                ...write,
+                ...(slot ? { slot } : {}),
+            }),
+            interaction: (locks, slot) => transport.request("ui.interaction", {
+                ...locks,
+                ...(slot ? { slot } : {}),
+            }),
+            unmount: (slot) => transport.request("ui.unmount", slot ? { slot } : undefined),
+            menu: (items, x, y, slot) => transport.request("ui.menu", {
+                items,
+                x,
+                y,
+                ...(slot ? { slot } : {}),
+            }),
             open: (id, file, properties = {}, callbacks = []) => transport.request("ui.open", { id, file, properties, callbacks }),
             set: (id, property, write) => transport.request("ui.set", { id, property, ...write }),
             show: (id, visible) => transport.request("ui.show", { id, visible }),

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.6.14: 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.6.16: 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
 
@@ -38,5 +38,5 @@
 - `/API/Sources`: 7 entries: ResolverOptions, WebResolverOptions, FileResolverOptions, ResolvedStream, Resolver, Resolvers, ResolvedMedia
 - `/API/Subtitles`: 5 entries: SubtitleTrack, SubtitlesState, SubtitleConditional, Subtitles, SubtitleStyle
 - `/API/UI`: 44 entries: ImageRef, ImageOptions, MarkdownRef, MarkdownOptions, PropValue, PropData, Props, Ui, View, Window, Windows, SlotState, SlotPanel, PanelState, PanelSlot, SidebarSlot, Panel,…
-- `/API/Testing`: 33 entries: CapabilityInfo, CAPABILITY_INFO, MESSAGE_LIMIT, COMMAND_LIMITS, MENU_IDS, BAR_BUTTON_ICONS, BAR_BUTTON_LIMITS, BuiltinSubmenu, BUILTIN_SUBMENUS, BuiltinCommand, BUILTIN_COMMANDS, LOCALES,…
+- `/API/Testing`: 34 entries: CapabilityInfo, CAPABILITY_INFO, MESSAGE_LIMIT, COMMAND_LIMITS, MENU_IDS, BAR_BUTTON_ICONS, BAR_BUTTON_LIMITS, BuiltinSubmenu, BUILTIN_SUBMENUS, BuiltinCommand, BUILTIN_COMMANDS, LOCALES,…
 - `/API/Docs`: 4 entries: DOCS_PAGE_BYTES, DocsOptions, docs, searchDocs

package/package.json

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