@vestra-player/sdk 1.5.9 → 1.5.12

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.5.9: 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. llms-full.txt, next to this file, has every declaration, the guides and the examples; L<n> below are its line numbers.
+> @vestra-player/sdk 1.5.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; it runs in its own Node.js process. llms-full.txt, next to this file, has every declaration, the guides and the examples; L<n> below are its line numbers.
 
 **How plugins run**
 
@@ -121,7 +121,7 @@ test("shows the position", async () => {
 - `vestra-plugin build [dir...] [--version x.y.z]`: Writes `dist/`: types stripped, files copied, manifest versioned.
 - `vestra-plugin pack [dir...] [--version x.y.z] [--out dir]`: Builds, then packs `dist/` as `<id>-<version>.vxp`.
 - `vestra-plugin i18n extract [dir...] [--locale lang]`: Collects the texts to translate into `locales/`, keeping translations.
-- `vestra-plugin i18n check [dir...]`: Translation coverage and untranslatable text (warnings only).
+- `vestra-plugin i18n check [dir...]`: Translation coverage and untranslatable text; fails on stale catalogs.
 - `vestra-player --plugin <dir>` runs a plugin from source, no build needed.
 
 **Error codes** (`error.code`; branch on it, never on `message`)
@@ -137,7 +137,7 @@ test("shows the position", async () => {
 - `failed`: The operation ran and failed
 - `aborted`: An `AbortSignal` fired
 - `timeout`: A time limit ran out
-- `limit`: A player-wide limit was reached
+- `limit`: A player-wide limit was reached, a property value is over the limits of PropValue, or a request is longer than the player's 1 MiB message
 - `reserved`: Packages.validate, PackageCandidate.install: the id is `vestra` or starts with `vestra.`, which only the player's built-in plugins use
 - `versionMismatch`: The package needs a newer player or another `apiVersion`
 - `ui-prepare`: The player could not prepare a mounted panel or a settings page
@@ -152,56 +152,56 @@ test("shows the position", async () => {
 - [Concept: Windows, panels, settings pages, dialogs and the OSD](https://vestrasys.github.io/vestra-player-sdk/documents/Windows__panels__settings_pages__dialogs_and_the_OSD.html): L281–626
 - [How-to: Keep a slider responsive while dragging](https://vestrasys.github.io/vestra-player-sdk/documents/Keep_a_slider_responsive_while_dragging.html): L627–801
 - [How-to: Remember a window's state between runs](https://vestrasys.github.io/vestra-player-sdk/documents/Remember_a_window_s_state_between_runs.html): L802–931
-- [API: @vestra-player/sdk](https://vestrasys.github.io/vestra-player-sdk/modules/_vestra-player_sdk.html): L932–4268
-- [API: @vestra-player/sdk/testing](https://vestrasys.github.io/vestra-player-sdk/modules/_vestra-player_sdk_testing.html) (TestHost, startPlugin): L4269–5290
+- [API: @vestra-player/sdk](https://vestrasys.github.io/vestra-player-sdk/modules/_vestra-player_sdk.html): L932–4427
+- [API: @vestra-player/sdk/testing](https://vestrasys.github.io/vestra-player-sdk/modules/_vestra-player_sdk_testing.html) (TestHost, startPlugin): L4428–5538
 
 ## API
 
 Where each module of `plugin` is declared:
 
 - Plugin L1153, Scope L1022, PluginError L974, Disposable L947
-- plugin.commands: Commands L1356
-- plugin.windows: Windows L1561
-- plugin.panels: Panels L2070
-- plugin.dialogs: Dialogs L2356
-- plugin.player: Player L2795
-- plugin.video: VideoFilter L3046, VideoView L3109, RenderOptions L3151
-- plugin.audio: AudioFilter L3070
-- plugin.subtitles: Subtitles L3249
-- plugin.media: MediaCapture L3407
-- plugin.resolvers: Resolvers L3512
-- plugin.packages: Packages L3752
-- plugin.osd: Osd L2982
-- plugin.host: Host L2944
-- plugin.clipboard: Clipboard L3865
-- plugin.power: Power L3885
-- plugin.tools: Tools L3918
-- plugin.storage: Storage L3961
-- plugin.system: System L3984
-- plugin.secrets: Secrets L4002
-- plugin.window: MainWindow L2193
-- plugin.app: App L2274
-- plugin.bindings: Bindings L3835
-- plugin.ui: Ui L1448
-- plugin.timeline: Timeline L2150
-- plugin.drops: Drops L1858
-- plugin.appearance: Appearance L1887
-- plugin.i18n: I18n L1959
-- plugin.settings: Settings L2003
+- plugin.commands: Commands L1361
+- plugin.windows: Windows L1566
+- plugin.panels: Panels L2207
+- plugin.dialogs: Dialogs L2493
+- plugin.player: Player L2934
+- plugin.video: VideoFilter L3199, VideoView L3262, RenderOptions L3304
+- plugin.audio: AudioFilter L3223
+- plugin.subtitles: Subtitles L3402
+- plugin.media: MediaCapture L3562
+- plugin.resolvers: Resolvers L3667
+- plugin.packages: Packages L3907
+- plugin.osd: Osd L3135
+- plugin.host: Host L3083
+- plugin.clipboard: Clipboard L4024
+- plugin.power: Power L4044
+- plugin.tools: Tools L4077
+- plugin.storage: Storage L4120
+- plugin.system: System L4143
+- plugin.secrets: Secrets L4161
+- plugin.window: MainWindow L2330
+- plugin.app: App L2411
+- plugin.bindings: Bindings L3994
+- plugin.ui: Ui L1453
+- plugin.timeline: Timeline L2287
+- plugin.drops: Drops L1863
+- plugin.appearance: Appearance L1892
+- plugin.i18n: I18n L2034
+- plugin.settings: Settings L2140
 
 ## Examples
 
 Complete plugins with tests, in [examples/](https://github.com/vestrasys/vestra-player-sdk/tree/main/examples) and in llms-full.txt:
 
-- hello: The README Quick start: one menu command and an on-screen message. L5706–5795
-- blur: A tool window with one slider that blurs the playing video. L5796–6057
-- signal-generator: Generates its own video and audio: colour bars and a 1 kHz tone. L6058–6390
-- bookmark: A tool window bound to the playback state: remember the position and jump back to it. L6391–6575
-- panel-menu: A sidebar panel with its own right-click menu. L6576–6781
-- menus: Radio menu items, separator groups and a menu item whose title changes. L6782–6941
-- theme-widgets: A tool window drawn with the player's theme and widgets. L6942–7105
-- markdown: A window that shows a Markdown document. L7106–7299
-- i18n: A plugin in the player's language: English source text, a Chinese translation. L7300–7467
+- hello: The README Quick start: one menu command and an on-screen message. L5955–6044
+- blur: A tool window with one slider that blurs the playing video. L6045–6306
+- signal-generator: Generates its own video and audio: colour bars and a 1 kHz tone. L6307–6639
+- bookmark: A tool window bound to the playback state: remember the position and jump back to it. L6640–6824
+- panel-menu: A sidebar panel with its own right-click menu. L6825–7030
+- menus: Radio menu items, separator groups and a menu item whose title changes. L7031–7190
+- theme-widgets: A tool window drawn with the player's theme and widgets. L7191–7354
+- markdown: A window that shows a Markdown document. L7355–7548
+- i18n: A plugin in the player's language: English source text, a Chinese translation. L7549–7716
 
 ## Optional
 

package/package.json

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

package/slint/vestra/widgets.slint

@@ -81,13 +81,17 @@ export component Button {
     min-height: root.icon-only ? root.icon-height : root.small ? Theme.button-small-height : Theme.button-height;
     min-width: root.icon-only ? root.icon-width : root.small ? Theme.button-small-min-width : Theme.button-min-width;
     preferred-height: self.min-height;
+    // A longer (translated) label widens the button instead of overflowing it.
+    preferred-width: root.icon-only ? self.min-width
+        : max(self.min-width, label.preferred-width + 2 * Theme.button-padding);
     accessible-role: button;
     accessible-label: root.text;
     accessible-enabled: root.enabled;
     accessible-checkable: root.icon-only;
     accessible-checked: root.checked;
     accessible-action-default => { if root.enabled { root.clicked(); } }
-    if !root.icon-only: Rectangle {
+    Rectangle {
+        visible: !root.icon-only;
         border-radius: Theme.radius-control;
         background: !root.enabled ? Theme.button-disabled
             : touch.pressed ? Theme.button-press
@@ -96,7 +100,7 @@ export component Button {
             padding-left: Theme.button-padding;
             padding-right: Theme.button-padding;
             alignment: center;
-            Text {
+            label := Text {
                 text: root.text;
                 color: root.enabled ? Theme.text-list : Theme.text-dim;
                 font-size: Theme.font-body;