@vestra-player/sdk 1.6.10 → 1.6.12

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 1.6.12
+
+**Who must change: nobody.** A behaviour fix of `toggle` in fullscreen, an example fix and a development warning; no new API, `apiVersion` stays `vestra/1`.
+
+- **`Panel.toggle` and `PanelSlot.toggle` slide a collapsed column out.** In fullscreen a sidebar or adjust column the user wants shown is collapsed at the right edge (`reason: "fullscreen"`). Toggling it then turned it off; it now shows it, which player 0.7.6 answers by sliding the column out, as its own Adjust button and Alt+1…4 do. Toggling a column that is on screen still turns it off. With players before 0.7.6 a show of a collapsed column changes nothing on screen, as before.
+- **[adjust-panel](docs/examples/adjust-panel.md)** declares `events`: without it `plugin.player.state` changes only after the plugin's own calls, so a panel activated before a file was opened stayed disabled at 1×. A new test opens the file after activation. Its presets are four (0.5×, 1×, 1.5×, 2×), which fit the adjust column at its least width. No other example reads `player.state` without `events`.
+- **A development warning for state followed without `events`.** A plugin that registers an `onChange` or a `bind` whose function reads changing state (`player.state`, a panel position, and the like) without the `events` capability gets one line in its log, once per plugin: changes made elsewhere never reach it. Only a warning; behaviour is unchanged. `TestHost` already behaved like the player here (it delivers `source.state` and the other state events only to a plugin that subscribed, which needs `events`): a new test pins that down. The example's old tests passed because they opened the file before starting the plugin or did not check `enabled`. No SDK example or test relied on the opposite, so nobody must change.
+## 1.6.11
+
+**Who must change: nobody.** Additions only: a mount slot, a panel position, a button icon and `TestHost` support; `apiVersion` stays `vestra/1`, no new capability. A plugin that mounts `"adjust"` sets `minPlayerVersion` to `0.7.6`: older players refuse the slot (`invalid`), which fails the activation like any refused mount.
+
+- **The adjust slot** (player 0.7.6, menu redesign step 3b): `plugin.panels.mount("adjust", file, { title })` puts a panel in the adjust column, for controls that change what is playing (picture, sound, subtitles, speed). Any number of plugins mount there, one tab each. The slot is a contract about purpose; the player decides how it looks and may change that. The rule, in [Slots](docs/explanation/ui.md#slots-what-each-one-is-for) and on `Panels.mount`: if the user still looks at the panel after closing it, it is `"sidebar"`; otherwise it is `"adjust"`. Today the player draws a second column between the video and the sidebar, with text tabs and the opening key under each title (the key of the command the panel's commands name as their `home`), no close or detach button, floating over the video in a narrow window and sliding out from the right edge in fullscreen; it starts closed and is compiled the first time it opens.
+- **`plugin.panels.adjust`**: the position, the same shape as `panels.sidebar` without `setDetached` (`PanelSlot`: `state`, `panels`, `onChange`, `setVisible`, `toggle`, `activate`). `Panel.show` and `Panel.toggle` work on an adjust panel as on a sidebar tab. Players before 0.7.6 build the `plugin` object with their own SDK, which has no `adjust`: there `plugin.panels.adjust` is `undefined` and reading its `state` throws a `TypeError` (as for `commands.keys`), so declare `minPlayerVersion` 0.7.6 or test it first.
+- **Wire**: `ui.mount` and `layout.set` take `slot: "adjust"`; `layout.state` reports `adjust` (a `LayoutSlot`, never `detached`); `LayoutSlot` names the adjust column.
+- **`BAR_BUTTON_ICONS`** gains `"sliders"` (the player's Adjust button), and `BUILTIN_COMMANDS` the player's `host/adjust`. `@vestra/bar-buttons.slint` (synced): `BarButtonsHost.adjust`, counted in `fixed`; `@vestra/icons.slint`: `sliders`.
+- **`TestHost`**: `layout.adjust` (starts hidden), `mountOther("adjust", …)`, `selectTab` for adjust tabs, `layout.set` refuses detaching the adjust column, `keepsRunning` names an open adjust column's current tab; an unknown mount slot is refused with `invalid`, as by the player.
+- **Example** [adjust-panel](docs/examples/adjust-panel.md): a speed slider in the adjust column, opened and closed by its own key.
+
 ## 1.6.10
 
 **Who must change: nobody.** Additions only: a clip format, optional export fields, two optional `JobState` fields, an error code and a `TestHost` field. `apiVersion` stays `vestra/1`, no new capability (`media.control` covers them). A plugin that does not use them sends exactly what it sent before; one that uses them needs player 0.7.6: declare `"minPlayerVersion": "0.7.6"`, or compare `plugin.app.version` with 0.7.6 to offer them only where they exist (do not probe by trying: on an older player `plugin` comes from that player's own, older SDK, which rejects `format: "copy"` with `invalid` but builds a re-encode request without the `encoding` it does not know, so the clip is encoded with the fixed settings and no error), and leave `progress`, `start` and `end` out.

package/dist/commands.d.ts

@@ -136,7 +136,9 @@ export declare const MENU_IDS: readonly ["open", "playback", "subtitles", "video
  * 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
  * in your own Slint with `Icon { name: "store"; }`). The player's tests check
- * that this list is its icon set.
+ * that this list is its icon set. `"sliders"` (three sliders, the player's
+ * Adjust button) is new in player 0.7.6 (SDK 1.6.11); older players refuse
+ * it as a button icon with `invalid`.
  *
  * @example Check in a test that the button's icon exists
  * The test fails before release if the plugin's bar button names an icon
@@ -154,7 +156,7 @@ export declare const MENU_IDS: readonly ["open", "playback", "subtitles", "video
  *
  * @category Testing
  */
-export declare const BAR_BUTTON_ICONS: readonly ["play", "pause", "stop", "back", "forward", "open", "volume", "mute", "playlist", "detach", "attach", "close", "failed", "move-top", "move-up", "move-down", "move-bottom", "search", "chapter", "bookmark", "check-task", "check-box", "menu-check", "submenu", "scroll-up", "scroll-down", "caret-down", "sort-asc", "sort-desc", "tag-remove", "preview-play", "add", "remove", "sort", "fullscreen", "exit-fullscreen", "store", "ai"];
+export declare const BAR_BUTTON_ICONS: readonly ["play", "pause", "stop", "back", "forward", "open", "volume", "mute", "playlist", "detach", "attach", "close", "failed", "move-top", "move-up", "move-down", "move-bottom", "search", "chapter", "bookmark", "check-task", "check-box", "menu-check", "submenu", "scroll-up", "scroll-down", "caret-down", "sort-asc", "sort-desc", "tag-remove", "preview-play", "add", "remove", "sort", "fullscreen", "exit-fullscreen", "store", "ai", "sliders"];
 /**
  * The player's limits on bottom-bar buttons (`CommandOptions.button`), the
  * same values as the player's (its tests check that they agree). A button

package/dist/commands.js

@@ -141,7 +141,9 @@ export const MENU_IDS = [
  * 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
  * in your own Slint with `Icon { name: "store"; }`). The player's tests check
- * that this list is its icon set.
+ * that this list is its icon set. `"sliders"` (three sliders, the player's
+ * Adjust button) is new in player 0.7.6 (SDK 1.6.11); older players refuse
+ * it as a button icon with `invalid`.
  *
  * @example Check in a test that the button's icon exists
  * The test fails before release if the plugin's bar button names an icon
@@ -198,6 +200,7 @@ export const BAR_BUTTON_ICONS = [
     "exit-fullscreen",
     "store",
     "ai",
+    "sliders",
 ];
 /**
  * The player's limits on bottom-bar buttons (`CommandOptions.button`), the
@@ -601,6 +604,7 @@ host | enter-fullscreen | (Enter Fullscreen)
 host | exit-fullscreen | (Leave Fullscreen)
 host | sidebar | (Toggle Sidebar)
 host | palette | (Command Palette) | Ctrl+Shift+P
+host | adjust | (Adjust)
 vestra.info | info.brief | (Brief Info) | Shift+Tab
 vestra.playlist | playlist.play | (Play) | Enter, P | panel
 vestra.playlist | playlist.list-add | (Add Files…) | Ctrl+I | panel

package/dist/i18n.js

@@ -942,6 +942,7 @@ export const HOST_ZH_HANS = {
     "bottom bar": "底栏",
     sidebar: "侧栏",
     "video backdrop": "视频背景",
+    "adjust column": "调节栏",
     "The {} is used by {}": "{}已被 {} 使用",
     "{} is resolved by {}": "{} 已由 {} 解析",
     "File type .{}": "文件类型 .{}",

package/dist/plugin/runtime.js

@@ -208,6 +208,8 @@ export class Runtime {
     /** The plugin was disposed: no safety pass is armed any more. */
     #stopped = false;
     #events = new Map();
+    /** The missing `events` warning was given (once per plugin). */
+    #warnedEvents = false;
     views = new Map();
     commands = new Map();
     services = new Map();
@@ -617,6 +619,10 @@ export class Runtime {
             group.active++;
             group.whys.set(token, listenerWhy(this.callSite()));
         }
+        if (created && needs === "events" && !this.can(needs))
+            group.unheard = true;
+        if (!mirror && group.unheard)
+            this.#warnUnheard(event);
         if (created && (needs === null || this.can(needs))) {
             group.told = group.active > 0;
             const whys = group.told ? allWhys(group) : undefined;
@@ -658,6 +664,8 @@ export class Runtime {
         const group = this.#events.get(event);
         if (!group)
             return { dispose: async () => { } };
+        if (group.unheard)
+            this.#warnUnheard(event);
         group.active++;
         const token = {};
         group.whys.set(token, why ?? listenerWhy(this.callSite()));
@@ -675,6 +683,19 @@ export class Runtime {
             },
         };
     }
+    /**
+     * A development warning, once per plugin, no behaviour change (SDK
+     * 1.6.12): the plugin follows `event` (an `onChange`, a `bind` that reads
+     * the state) without the `events` capability, so changes made elsewhere
+     * (the user, the player, another plugin) never reach it; the state moves
+     * only after its own calls.
+     */
+    #warnUnheard(event) {
+        if (this.#warnedEvents)
+            return;
+        this.#warnedEvents = true;
+        console.warn(`[${this.manifest.id}] follows ${event} (onChange, or a bind() that reads the state) without the "events" capability: changes made elsewhere will not reach it, only its own calls refresh the state. Declare "events" in manifest.json.`);
+    }
     /**
      * Tell the player when `group` changes between mirror and listener, and
      * why it listens when that changed.

package/dist/plugin/testing.d.ts

@@ -601,7 +601,7 @@ export declare class TestHost implements Transport {
      * See {@link TestHost.mounted}.
      */
     panel: (Omit<FakeWindow, "callbacks" | "userClose"> & {
-        /** `"bottom"`, `"sidebar"` or `"backdrop"`. */
+        /** `"bottom"`, `"sidebar"`, `"adjust"` or `"backdrop"`. */
         slot: string;
         /** The exported component the SDK found in the file. */
         component: string;
@@ -643,6 +643,12 @@ export declare class TestHost implements Transport {
          * the current tab's (the plugin under test is owner 1).
          */
         sidebar: LayoutSlot | null;
+        /**
+         * The adjust column (SDK 1.6.11, player 0.7.6), like the sidebar but
+         * never `detached`. It starts hidden (`preferred: false`, `reason:
+         * "userHidden"`), as the player's does until the user opens it.
+         */
+        adjust: LayoutSlot | null;
     };
     /**
      * Every `osd.show` text as the player shows it (translated with the
@@ -1331,7 +1337,7 @@ export declare class TestHost implements Transport {
      *
      * @capability None.
      */
-    mountOther(slot: "bottom" | "sidebar" | "backdrop", plugin: string, options?: {
+    mountOther(slot: "bottom" | "sidebar" | "adjust" | "backdrop", plugin: string, options?: {
         title?: string;
     }): void;
     /**
@@ -2829,7 +2835,7 @@ export declare class TestHost implements Transport {
      * @since 1.0.0
      */
     mounted(): Omit<FakeWindow, "callbacks" | "userClose"> & {
-        /** `"bottom"`, `"sidebar"` or `"backdrop"`. */
+        /** `"bottom"`, `"sidebar"`, `"adjust"` or `"backdrop"`. */
         slot: string;
         /** The exported component the SDK found in the file. */
         component: string;

package/dist/plugin/testing.js

@@ -328,6 +328,7 @@ const SLOT_LABELS = {
     bottom: "bottom bar",
     sidebar: "sidebar",
     backdrop: "video backdrop",
+    adjust: "adjust column",
 };
 /** Texts only the test host uses, with their Chinese of SDK 1.5.8. */
 const TEST_ZH_HANS = {
@@ -550,6 +551,7 @@ export class TestHost {
     layout = {
         bottom: null,
         sidebar: null,
+        adjust: null,
     };
     /**
      * Every `osd.show` text as the player shows it (translated with the
@@ -1528,10 +1530,10 @@ export class TestHost {
      * ```
      */
     selectTab(plugin) {
-        const slot = this.layout.sidebar;
+        const slot = [this.layout.sidebar, this.layout.adjust].find((each) => each?.panels?.some((entry) => entry.plugin === plugin));
         const panel = slot?.panels?.find((entry) => entry.plugin === plugin);
         if (!slot || !panel)
-            throw new Error(`${plugin} has no sidebar tab`);
+            throw new Error(`${plugin} has no tab`);
         slot.owner = panel.owner;
         this.emit("window.state", this.#windowFacts());
     }
@@ -1539,15 +1541,18 @@ export class TestHost {
         const state = this.layout[slot];
         if (state)
             state.panels = [...(state.panels ?? []), panel];
-        else
+        else {
+            // The adjust column starts hidden, as the player's.
+            const shown = slot !== "adjust";
             this.layout[slot] = {
                 owner: panel.owner,
-                preferred: true,
-                effective: true,
-                reason: null,
+                preferred: shown,
+                effective: shown,
+                reason: shown ? null : "userHidden",
                 detached: false,
                 panels: [panel],
             };
+        }
     }
     #removePanel(slot, owner) {
         const state = this.layout[slot];
@@ -4247,11 +4252,16 @@ export class TestHost {
                 for (const why of this.listeningWhy.get(event) ?? ["a listener"])
                     reasons.push(`listens to ${event}: ${why}`);
         // 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 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");
+        }
         else if (this.panel)
             reasons.push("a mounted panel");
         for (const [id, window] of this.windows)
@@ -4487,8 +4497,11 @@ export class TestHost {
         "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");
             // 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).
+            // 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).
             const holder = p.slot === "backdrop"
                 ? this.backdrop?.owner
                 : p.slot === "bottom"
@@ -4542,7 +4555,10 @@ export class TestHost {
         "ui.menu": (p) => {
             if (!this.panel)
                 throw new HostError("unavailable", "panel not shown");
-            if (this.panel.slot === "sidebar" && this.layout.sidebar?.owner !== 1)
+            const tabs = this.panel.slot === "sidebar" || this.panel.slot === "adjust"
+                ? this.layout[this.panel.slot]
+                : null;
+            if (tabs && tabs.owner !== 1)
                 throw new HostError("unavailable", "the panel's tab is not the current one");
             const items = p.items;
             for (const id of items)
@@ -4559,11 +4575,15 @@ export class TestHost {
         }),
         "layout.set": (p) => {
             const slot = String(p.slot);
+            if (!["bottom", "sidebar", "adjust"].includes(slot))
+                throw new HostError("invalid", "unknown slot");
             const state = this.layout[slot];
             if (!state)
                 throw new HostError("missing", "no panel at this position");
             if (p.detached !== undefined && slot === "bottom")
                 throw new HostError("invalid", "the bottom bar cannot be detached");
+            if (p.detached === true && slot === "adjust")
+                throw new HostError("invalid", "the adjust column cannot be detached");
             if (p.active !== undefined && p.active !== null) {
                 const panel = state.panels?.find((entry) => entry.plugin === p.active);
                 if (!panel)

package/dist/plugin/types.d.ts

@@ -2578,12 +2578,13 @@ export interface PanelState {
      * else the position's reason ({@link SlotState.reason}).
      */
     reason: SlotState["reason"] | "otherTab";
-    /** The sidebar floats in its own window (with all its tabs). */
+    /** The sidebar floats in its own window (with all its tabs); always `false` in the adjust column. */
     detached: boolean;
 }
 /**
- * The bottom bar or the sidebar position (`plugin.panels.bottom`,
- * `plugin.panels.sidebar`), independent of who mounted the panel there.
+ * The bottom bar, the sidebar or the adjust column position
+ * (`plugin.panels.bottom`, `plugin.panels.sidebar`, `plugin.panels.adjust`),
+ * independent of who mounted the panel there.
  *
  * @remarks
  * The position does not belong to the plugin that mounted the panel: any
@@ -2704,7 +2705,9 @@ export interface PanelSlot {
      *
      * @remarks
      * Reads the state from the player first, so it is right even without
-     * `events`.
+     * `events`. A sidebar or adjust column wanted shown but collapsed at the
+     * right edge of fullscreen (`reason: "fullscreen"`) slides out instead of
+     * being turned off (SDK 1.6.12; player 0.7.6 pops it out).
      *
      * @capability ui.mount
      *
@@ -3009,7 +3012,10 @@ export interface Panel extends View, Disposable {
      * Reads the state from the player first. When the position is shown
      * (`preferred`) and this panel's tab is the current one, it hides the
      * position; otherwise it does {@link Panel.show}: a panel in a background
-     * tab comes to the front instead of the sidebar closing. A "Show list"
+     * tab comes to the front instead of the sidebar closing, and a column
+     * collapsed at the right edge of fullscreen (`reason: "fullscreen"`) slides
+     * out instead of being turned off (SDK 1.6.12; player 0.7.6 pops it out),
+     * like the player's own Alt+1…4 and Adjust button. A "Show list"
      * command checked by `state.preferred && state.active` matches it. Waits
      * for {@link Panel.ready} first.
      *
@@ -4140,6 +4146,38 @@ export interface Panels {
      *   takes no pointer or keyboard input. While it is mounted, the player does
      *   not show the cover art of audio files itself (from the next file
      *   opened on), so the plugin can draw it.
+     * - `"adjust"` (player 0.7.6, SDK 1.6.11): **controls that change what is
+     *   playing**: the picture, the sound, the subtitles, the speed (the
+     *   player's own Picture, Audio, Subtitles and Playback panels, a colour
+     *   grading tool). Several plugins may mount here, one tab each, labelled
+     *   `title` (else the plugin's name). Declare `minPlayerVersion: "0.7.6"`:
+     *   older players refuse the slot (`invalid`, "unknown mount slot"), and a
+     *   mount refused during `activate` fails the activation.
+     *
+     * **Choosing between `"sidebar"` and `"adjust"`.** The slot says what the
+     * panel is for; the player decides how it looks and may change that at any
+     * time. Ask: after the user closes the panel, do they still look at what it
+     * showed? If yes (a list, chapters, search results, another video), it is
+     * content: `"sidebar"`. If it only changes what is playing, it is
+     * `"adjust"`.
+     *
+     * **What the player shows today (may change; do not depend on it).** The
+     * adjust column is a second column between the video and the sidebar
+     * (`[video][adjust][sidebar]`; both can be open, the sidebar always
+     * rightmost), 317 wide by default, 280 to half the window, with text tabs
+     * and the key that opens each tab under its title (the key of the command
+     * your other commands name as their {@link CommandOptions.home | home}). It
+     * has no close or detach button: the bottom bar's Adjust button, your
+     * panel's own command ({@link Panel.toggle}) and the menus open and close
+     * it. It starts closed. In a window too narrow to dock it beside a video at
+     * least 480 wide, it floats over the right of the video, 300 wide; in
+     * fullscreen it slides out from the right edge, left of the sidebar. Its
+     * width, open state, current tab and tab order are remembered across
+     * launches. Its strip is always drawn, so panel coordinates (drops) start
+     * below it, and the bridge global's `tabbed` property, if declared, is
+     * `true`. As in the sidebar, only the current tab's plugin is kept
+     * running while the column is open, and the player compiles a panel the
+     * first time it is shown, not at start-up.
      *
      * @capability ui.mount
      *
@@ -4176,12 +4214,12 @@ export interface Panels {
      *
      * @since 1.0.0
      */
-    mount(slot: "bottom" | "sidebar" | "backdrop", file: string, options?: {
+    mount(slot: "bottom" | "sidebar" | "adjust" | "backdrop", file: string, options?: {
         /** The exported component to mount, if the file exports several. */
         component?: string;
         /** The exported global to use as the bridge, if the file exports several. */
         global?: string;
-        /** The floating sidebar window's title (at most 128 bytes). */
+        /** The tab label and the floating sidebar window's title (at most 128 bytes). */
         title?: string;
     }): Panel;
     /**
@@ -4193,6 +4231,51 @@ export interface Panels {
     readonly bottom: PanelSlot;
     /** The sidebar position, including its floating state; any plugin may read and toggle it. */
     readonly sidebar: SidebarSlot;
+    /**
+     * The adjust column (player 0.7.6, SDK 1.6.11), whoever mounted there;
+     * any plugin may read and toggle it. The same shape as
+     * {@link Panels.sidebar} without floating: the adjust column never
+     * detaches.
+     *
+     * @remarks
+     * `state` is `null` while no plugin has a panel there. Players before
+     * 0.7.6 build the `plugin` object with their own SDK, which has no
+     * `adjust`: there `plugin.panels.adjust` is `undefined` and reading its
+     * `state` throws a `TypeError`, so declare `"minPlayerVersion": "0.7.6"`
+     * (or test `plugin.panels.adjust` first). The column starts hidden (`preferred: false`, `reason:
+     * "userHidden"`) until the user opens it. To open the column at your own
+     * panel, call {@link Panel.show} (or {@link Panel.toggle}, which closes it
+     * again when your tab is already the current one, the behaviour of the
+     * player's own `Alt+1…4`).
+     *
+     * @example Open the adjust column at this plugin's tab with a key
+     * One command opens the column at the plugin's tab, and pressing it again
+     * while that tab is shown closes the column. The panel's other commands
+     * name it as their `home`, so the player shows its key under the tab and
+     * the command palette knows where they live.
+     * ```ts
+     * const panel = plugin.panels.mount("adjust", "ui/wheels.slint", { title: "Wheels" });
+     * plugin.commands.add({
+     *   id: "wheels",
+     *   title: "Colour Wheels",
+     *   bindings: ["Alt+5"],
+     *   // Opens the column at this tab; closes it when this tab is shown.
+     *   run: () => panel.toggle(),
+     * });
+     * plugin.commands.add({
+     *   id: "wheels-reset",
+     *   title: "Reset Colour Wheels",
+     *   // Lives in the panel `wheels` opens: its key shows under the tab.
+     *   home: "wheels",
+     *   run: () => panel.set({ lift: 0 }),
+     * });
+     * ```
+     *
+     * @player 0.7.6 (declare `"minPlayerVersion": "0.7.6"`; older players
+     *   have no `adjust`: reading its `state` throws a `TypeError`).
+     * @since 1.6.11
+     */
+    readonly adjust: PanelSlot;
 }
 /**
  * What a timeline mark stands for; readers choose colours by it.
@@ -9417,7 +9500,7 @@ export interface PluginWarning {
      * 0.4.1); a newer player may add codes.
      */
     code: string;
-    /** The panel position (`"bottom"`, `"sidebar"`, `"backdrop"`) for `slot-occupied`. */
+    /** The panel position (`"bottom"`, `"backdrop"`; the sidebar and the adjust column hold any number of tabs) for `slot-occupied`. */
     slot?: string;
     /**
      * What was taken, for `resolver-taken`: 「文件类型 .nes」 or the

package/dist/plugin/ui.js

@@ -917,7 +917,9 @@ class PanelHandle extends ViewBase {
             throw failure("invalid", "the player shows the backdrop by itself");
         await layoutOf(this.scope.runtime).read();
         const state = this.state;
-        if (state?.preferred && state.active)
+        // Collapsed at the edge of fullscreen (wanted shown, not on screen):
+        // slide it out rather than turn it off (player 0.7.6 pops it out).
+        if (state?.preferred && state.active && state.reason !== "fullscreen")
             await layoutOf(this.scope.runtime).set(this.#slot, { visible: false });
         else
             await this.show();
@@ -991,7 +993,8 @@ class LayoutService {
     state = {
         bottom: null,
         sidebar: null,
-        tabs: { bottom: null, sidebar: null },
+        adjust: null,
+        tabs: { bottom: null, sidebar: null, adjust: null },
         backdrop: null,
     };
     #listeners = new Set();
@@ -1051,10 +1054,16 @@ class LayoutService {
                         active: panel.owner === slot.owner,
                     })))
                     : null;
+                const adjust = raw.adjust ?? null;
                 const next = {
                     bottom: view(raw.bottom),
                     sidebar: view(raw.sidebar),
-                    tabs: { bottom: tabs(raw.bottom), sidebar: tabs(raw.sidebar) },
+                    adjust: view(adjust),
+                    tabs: {
+                        bottom: tabs(raw.bottom),
+                        sidebar: tabs(raw.sidebar),
+                        adjust: tabs(adjust),
+                    },
                     backdrop: raw.backdrop
                         ? Object.freeze({ effective: raw.backdrop.effective === true })
                         : null,
@@ -1110,7 +1119,11 @@ function slot(scope, name) {
         async toggle() {
             await service().read();
             const current = service().state[name];
-            await service().set(name, { visible: !(current?.preferred ?? true) });
+            // Collapsed at the edge of fullscreen: slide it out (see Panel.toggle).
+            const collapsed = current?.reason === "fullscreen";
+            await service().set(name, {
+                visible: collapsed || !(current?.preferred ?? true),
+            });
         },
         setDetached: (detached) => service().set(name, { detached }),
         activate: (plugin) => service().set(name, { active: plugin }),
@@ -1145,6 +1158,7 @@ export const panels = (scope) => ({
     mount: (position, file, options = {}) => new PanelHandle(scope, position, file, options),
     bottom: slot(scope, "bottom"),
     sidebar: slot(scope, "sidebar"),
+    adjust: slot(scope, "adjust"),
     backdrop: backdrop(scope),
 });
 export const dialogs = (scope) => {

package/dist/wire.d.ts

@@ -288,7 +288,10 @@ export interface LayoutPanel {
     /** The tab label: the mount's `title`, else the plugin's name. */
     title: string;
 }
-/** One position (bottom bar or sidebar) as `layout.state` reports it. */
+/**
+ * One position (the bottom bar, the sidebar or, from player 0.7.6, the
+ * adjust column) as `layout.state` reports it.
+ */
 export interface LayoutSlot {
     /** The current tab's panel (the only panel of the bottom bar). */
     owner: number;
@@ -696,10 +699,13 @@ export declare function createWire(transport: Transport): {
         state: () => Promise<{
             bottom: LayoutSlot | null;
             sidebar: LayoutSlot | null;
+            /** Player 0.7.6 (absent from older players). */
+            adjust?: LayoutSlot | null;
             backdrop?: LayoutBackdrop | null;
         }>;
         set: (options: {
-            slot: "bottom" | "sidebar";
+            /** `"adjust"`: player 0.7.6 (older players refuse it with `invalid`). */
+            slot: "bottom" | "sidebar" | "adjust";
             visible?: boolean;
             detached?: boolean;
             /** The plugin id of the panel whose tab becomes the current one. */
@@ -727,7 +733,8 @@ export declare function createWire(transport: Transport): {
             images: string[];
         }>;
         mount: (options: {
-            slot: "bottom" | "sidebar" | "backdrop";
+            /** `"adjust"`: player 0.7.6 (older players refuse it with `invalid`). */
+            slot: "bottom" | "sidebar" | "backdrop" | "adjust";
             file: string;
             component: string;
             global: string;

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.6.10: 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.12: 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.6.10",
+  "version": "1.6.12",
   "description": "Plugin API types, test host and plugin CLI for Vestra Player (apiVersion vestra/1)",
   "license": "Apache-2.0",
   "repository": {

package/slint/vestra/bar-buttons.slint

@@ -3,8 +3,8 @@
 // player's own. Since SDK 1.6.8 (menu redesign step 3a) the player draws
 // the strip itself, at the right end of the bottom slot, its 40px cells on
 // the slot's bottom edge (a bar's 40px button row), and also when no plugin
-// mounts a bottom bar: `[plugin buttons…][»][Command Palette][Toggle
-// Sidebar]`. A bottom bar places nothing: it lays its controls out left of
+// mounts a bottom bar: `[plugin buttons…][»][Command Palette][Adjust]
+// [Toggle Sidebar]`. A bottom bar places nothing: it lays its controls out left of
 // the strip and says how wide they must stay:
 //   import { BarButtonsHost } from "@vestra/bar-buttons.slint";
 //   export component MyBar inherits Rectangle {
@@ -65,12 +65,16 @@ export global BarButtonsHost {
     in property <BarButtonItem> toggle;
     // The command palette (`host/palette`; `token` "" while there is none).
     in property <BarButtonItem> palette;
+    // The adjust column's toggle (`host/adjust`, player 0.7.6; `token` ""
+    // while there is none).
+    in property <BarButtonItem> adjust;
     // Set when a (deprecated) `BarButtons` exists in this window.
     in-out property <bool> placed;
     // The width the player gives its strip (the player sets it).
     in-out property <length> room;
-    // The player's own cells, always shown (step 3b adds Adjust).
-    private property <int> own: (root.palette.token != "" ? 1 : 0) + (root.toggle.token != "" ? 1 : 0);
+    // The player's own cells, always shown: Command Palette, Adjust,
+    // Toggle Sidebar.
+    private property <int> own: (root.palette.token != "" ? 1 : 0) + (root.adjust.token != "" ? 1 : 0) + (root.toggle.token != "" ? 1 : 0);
     // The cells a bar must always leave free, 41px each: the player's own,
     // and the `»` cell whenever any plugin button exists (drawn only on
     // overflow, but always reserved, so `»` never covers the bar). Never

package/slint/vestra/icons.slint

@@ -52,6 +52,9 @@ export global Icons {
         // small cross (AI), the default 14 × 12 box; bar buttons use them.
         if name == "store" { return "M 2.5 4 H 11.5 L 10.9 9.6 Q 10.8 10.5 9.9 10.5 H 4.1 Q 3.2 10.5 3.1 9.6 Z M 5.2 4 V 3.3 A 1.8 1.8 0 0 1 8.8 3.3 V 4"; }
         if name == "ai" { return "M 6 1.5 Q 6.6 5.4 10.5 6 Q 6.6 6.6 6 10.5 Q 5.4 6.6 1.5 6 Q 5.4 5.4 6 1.5 Z M 11.5 1.2 V 3.8 M 10.2 2.5 H 12.8"; }
+        // Three sliders with their knobs (the adjust column, `host/adjust`),
+        // the default 14 × 12 box.
+        if name == "sliders" { return "M 1.5 2.5 H 7.6 M 10.4 2.5 H 12.5 M 10.4 2.5 A 1.4 1.4 0 1 1 7.6 2.5 A 1.4 1.4 0 1 1 10.4 2.5 Z M 1.5 6 H 3.1 M 5.9 6 H 12.5 M 5.9 6 A 1.4 1.4 0 1 1 3.1 6 A 1.4 1.4 0 1 1 5.9 6 Z M 1.5 9.5 H 6.6 M 9.4 9.5 H 12.5 M 9.4 9.5 A 1.4 1.4 0 1 1 6.6 9.5 A 1.4 1.4 0 1 1 9.4 9.5 Z"; }
         return "";
     }
     // Line width.