@vestra-player/sdk 1.5.40 → 1.5.41

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.5.41
+
+**Who must change: nobody.** No API changes, `apiVersion` stays `vestra/1`, no player version needed. Only how the player draws the bottom bar's strip of command buttons changes (player 0.5.22); a plugin's declarations and a bar that places `BarButtons` stay as they are.
+
+- **`@vestra/bar-buttons.slint`** (the read-only copy of the player's widget library): every enabled button of the strip draws its icon in the accent colour (`Theme.accent`, `Theme.accent-press` while pressed; `Theme.icon-disabled` when disabled), plugin images (`plugin.ui.image`) included. Before, icons were in the text colour and only a checked toggle in the accent. A checked command (`checked: true`, the sidebar toggle while the sidebar is on) now shows a 4px dot in the icon's colour centred under the icon, as the macOS Dock marks a running app; the accessibility checked state is unchanged.
+- _Commands_ (reference), `CommandOptions.button` and `TestHost.barButtons[].checked` describe the new look.
+
 ## 1.5.40
 
 **Who must change: nobody.** Additions only, `apiVersion` stays `vestra/1`. `plugin.when` needs player 0.5.21 (`"minPlayerVersion": "0.5.21"`); older players have no `plugin.when`. A plugin that does not use it sees no difference. What changes with the player's lazy activation (off by default; `VESTRA_LAZY=1`): a listener of `packages.changed`, `bindings.changed`, `appearance.changed` or `resolvers.fileTypes` no longer keeps a plugin running; the player stops it while idle and starts it again to deliver the event. `bindings.changed` (`plugin.bindings.onChange`) now fires only when the binding list changes, no longer when a plugin starts again with the same commands; nobody must change (the event carries no data, and the list is what it stands for).

package/dist/plugin/testing.d.ts

@@ -370,7 +370,7 @@ export interface FakeBarButton {
     readonly order: number;
     /** Clickable: the command is enabled and not busy. */
     readonly enabled: boolean;
-    /** Drawn in the accent colour: the command is checked. */
+    /** Shown with the on dot under its icon: the command is checked. */
     readonly checked: boolean;
     /**
      * The tooltip without the key: the command's shown title (trailing "…"

package/dist/plugin/types.d.ts

@@ -838,9 +838,9 @@ export type BarButtonIcon = "play" | "pause" | "stop" | "back" | "forward" | "op
  * "…" removed) and its first key as the tooltip ("Plugin Store (F9)"),
  * `enabled`, `busy` and `reason` as the menu item has them: a disabled or
  * busy command's button is drawn disabled, its tooltip adds the reason, and
- * a click runs nothing. A command with `checked` shows its icon in the
- * accent colour while checked. A click runs the command exactly like a
- * click on its menu item.
+ * a click runs nothing. Every button's icon is drawn in the accent colour;
+ * a command with `checked` shows a small dot under its icon while checked.
+ * A click runs the command exactly like a click on its menu item.
  *
  * **Limits.** One button per plugin and eight in the player
  * (`BAR_BUTTON_LIMITS`): a button past them is left out (its command and

package/llms-full.txt

@@ -1,4 +1,4 @@
-# @vestra-player/sdk 1.5.40: full reference
+# @vestra-player/sdk 1.5.41: full reference
 
 > Everything needed to write a Vestra Player plugin (plugin API `vestra/1`): the guides, every public declaration of `@vestra-player/sdk` and `@vestra-player/sdk/testing` with its documentation, and the complete source of the example plugins. Generated from the SDK's sources by scripts/llms.mjs; the short index is llms.txt.
 
@@ -3330,7 +3330,7 @@ Every command the player (`host`) and its built-in plugins register when the pla
 | `order` | Integer 0–999, left to right ascending; equal orders by plugin id, then declaration order. The built-in plugins use 100 (Vestra Player AI) and 200 (Plugin Store). |
 | `path` | Required: a button without a menu path is `invalid`. |
 
-- **Shown**: the icon; the tooltip is the command's shown title without a trailing "…" and its first active key ("Plugin Store (F9)"), plus the reason on a second line while the command is disabled or busy. Disabled or busy: drawn disabled, a click runs nothing. `checked: true`: the icon in the accent colour. Accessibility: a button named by the title, with its enabled and checked state and a default action.
+- **Shown**: the icon; the tooltip is the command's shown title without a trailing "…" and its first active key ("Plugin Store (F9)"), plus the reason on a second line while the command is disabled or busy. The icon is drawn in the accent colour (player 0.5.22; the text colour before), darker while pressed. Disabled or busy: drawn disabled, a click runs nothing. `checked: true`: a small dot in the icon's colour under the icon (before player 0.5.22: the icon in the accent colour, the others in the text colour). Accessibility: a button named by the title, with its enabled and checked state and a default action.
 - **Click**: runs the command exactly as a click on its menu item does.
 - **Order and room**: left to right by `order`, the player's **Toggle Sidebar** rightmost; in a narrow window the strip loses cells from its outer (left) end inward: the lowest order goes first, the sidebar toggle last. `order` is position only: low is further left and goes first.
 - **Limits** (Limits): one button per plugin (its first declared), eight in the player (the highest orders; the lowest go first, ties: the smaller plugin id, then the earlier declaration). A button past them is left out and logged with `limit`; the command and its menu entry stay.
@@ -4469,9 +4469,9 @@ Writing a bottom bar.
 "…" removed) and its first key as the tooltip ("Plugin Store (F9)"),
 `enabled`, `busy` and `reason` as the menu item has them: a disabled or
 busy command's button is drawn disabled, its tooltip adds the reason, and
-a click runs nothing. A command with `checked` shows its icon in the
-accent colour while checked. A click runs the command exactly like a
-click on its menu item.
+a click runs nothing. Every button's icon is drawn in the accent colour;
+a command with `checked` shows a small dot under its icon while checked.
+A click runs the command exactly like a click on its menu item.
 
 **Limits.** One button per plugin and eight in the player
 (`BAR_BUTTON_LIMITS`): a button past them is left out (its command and
@@ -13068,7 +13068,7 @@ interface FakeBarButton {
   readonly order: number;
   /** Clickable: the command is enabled and not busy. */
   readonly enabled: boolean;
-  /** Drawn in the accent colour: the command is checked. */
+  /** Shown with the on dot under its icon: the command is checked. */
   readonly checked: boolean;
   /** The tooltip without the key: the command's shown title (trailing "…" removed), then, while it cannot run, its reason on a second line. */
   readonly tooltip: string;

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.5.40: 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; it runs in its own Node.js process. Everything a plugin creates (commands, windows, panels, filters, listeners…) is a handle that is released automatically when the plugin stops. L<n>: a line of llms-full.txt (next to this file), which has every page, declaration and example.
+> @vestra-player/sdk 1.5.41: 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; it runs in its own Node.js process. Everything a plugin creates (commands, windows, panels, filters, listeners…) is a handle that is released automatically when the plugin stops. L<n>: a line of llms-full.txt (next to this file), which has every page, declaration and example.
 
 **Rules**
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vestra-player/sdk",
-  "version": "1.5.40",
+  "version": "1.5.41",
   "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

@@ -12,9 +12,13 @@
 // entries stay; the player logs which buttons are hidden).
 //
 // The cells look like the bar's own icon buttons: a 32×32 plate on hover
-// and press, the V-Line icon in the text colour (accent while a toggle is
-// on), the bar's tooltip (ToolTipArea). They are persistent elements shown with
-// `visible:`; nothing is created on hover or resize.
+// and press, the bar's tooltip (ToolTipArea). Every enabled cell draws its
+// icon in the accent (accent-press while pressed; icon-disabled when
+// disabled), so the strip reads as one group. A toggle that is on shows a
+// small dot in the icon's colour centred under the icon, like a running app
+// in the macOS Dock (player 0.5.22, SDK 1.5.41; before, icons were in the
+// text colour and only an on toggle in the accent). They are persistent
+// elements shown with `visible:`; nothing is created on hover or resize.
 import { Theme } from "theme.slint";
 import { Icon } from "icons.slint";
 import { ToolTipArea } from "widgets.slint";
@@ -32,7 +36,7 @@ export struct BarButtonItem {
     // The tooltip: the title and its key, the reason it is unavailable.
     tip: string,
     enabled: bool,
-    // The command has a checked state; `checked` draws the icon in the accent.
+    // The command has a checked state; `checked` shows the dot under the icon.
     checkable: bool,
     checked: bool,
     // At half opacity: on, but not shown for want of room (the sidebar).
@@ -58,8 +62,11 @@ component Cell inherits Rectangle {
     in property <bool> shown;
     private property <bool> live: root.shown && root.item.enabled;
     private property <brush> tint: !root.item.enabled ? Theme.icon-disabled
-        : root.item.checked ? (touch.pressed ? Theme.accent-press : Theme.accent)
-        : Theme.text;
+        : touch.pressed ? Theme.accent-press : Theme.accent;
+    // The on dot: its diameter and top edge, between the icon box (y 14–26)
+    // and the hover plate's lower edge (y 36).
+    private property <length> dot-size: 4px;
+    private property <length> dot-y: 29px;
     width: 41px;
     height: 40px;
     visible: root.shown;
@@ -99,6 +106,16 @@ component Cell inherits Rectangle {
         image-fit: contain;
         colorize: root.tint;
     }
+    // On (`checked`): the dot under the icon, in the icon's colour.
+    Rectangle {
+        visible: root.item.checked;
+        x: (root.width - 1px - self.width) / 2;
+        y: root.dot-y;
+        width: root.dot-size;
+        height: root.dot-size;
+        border-radius: self.width / 2;
+        background: root.tint;
+    }
     ToolTipArea {
         width: 100%;
         height: 100%;