@vestra-player/sdk 1.6.10 → 1.6.11

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 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/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
@@ -4140,6 +4141,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 +4209,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 +4226,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 +9495,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

@@ -991,7 +991,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 +1052,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,
@@ -1145,6 +1152,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.11: 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.11",
   "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.