@vestra-player/sdk 1.6.14 → 1.6.15

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 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.js

@@ -330,12 +330,8 @@ 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
@@ -348,9 +344,6 @@ vestra.subtitles | dialogue-current | Playback ▸ Seek ▸ Current Subtitle Sta
 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×
@@ -594,6 +587,13 @@ 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.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

package/dist/plugin/runtime.js

@@ -248,7 +248,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`. */
@@ -2814,9 +2844,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 +2867,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`. */
@@ -3627,9 +3637,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 +3660,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 +4288,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 +4531,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 +4551,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 +4564,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 +4584,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 +4652,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 +4920,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 +5162,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

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