@vestra-player/sdk 1.5.7 → 1.5.9

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.5.7: 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.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.
 
 **How plugins run**
 
@@ -120,6 +120,8 @@ test("shows the position", async () => {
 - `vestra-plugin test [dir...]`: Runs `node --test` on `tests/*.test.{ts,mjs}`.
 - `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-player --plugin <dir>` runs a plugin from source, no build needed.
 
 **Error codes** (`error.code`; branch on it, never on `message`)
@@ -136,7 +138,7 @@ test("shows the position", async () => {
 - `aborted`: An `AbortSignal` fired
 - `timeout`: A time limit ran out
 - `limit`: A player-wide limit was reached
-- `reserved`: Packages.validate, PackageCandidate.trial, PackageCandidate.install: the id is `vestra` or starts with `vestra.`, which only the player's built-in plugins use
+- `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
 - `ui`: The player could not apply a property to a tool window or a settings page, or could not build the Options window
@@ -150,54 +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–4172
-- [API: @vestra-player/sdk/testing](https://vestrasys.github.io/vestra-player-sdk/modules/_vestra-player_sdk_testing.html) (TestHost, startPlugin): L4173–5113
+- [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
 
 Where each module of `plugin` is declared:
 
-- Plugin L1152, Scope L1023, PluginError L974, Disposable L947
-- plugin.commands: Commands L1349
-- plugin.windows: Windows L1554
-- plugin.panels: Panels L2005
-- plugin.dialogs: Dialogs L2287
-- plugin.player: Player L2726
-- plugin.video: VideoFilter L2975, VideoView L3038, RenderOptions L3080
-- plugin.audio: AudioFilter L2999
-- plugin.subtitles: Subtitles L3178
-- plugin.media: MediaCapture L3336
-- plugin.resolvers: Resolvers L3441
-- plugin.packages: Packages L3662
-- plugin.osd: Osd L2912
-- plugin.host: Host L2875
-- plugin.clipboard: Clipboard L3769
-- plugin.power: Power L3789
-- plugin.tools: Tools L3822
-- plugin.storage: Storage L3865
-- plugin.system: System L3888
-- plugin.secrets: Secrets L3906
-- plugin.window: MainWindow L2128
-- plugin.app: App L2209
-- plugin.bindings: Bindings L3739
-- plugin.ui: Ui L1441
-- plugin.timeline: Timeline L2085
-- plugin.drops: Drops L1851
-- plugin.appearance: Appearance L1880
-- plugin.settings: Settings L1938
+- 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
 
 ## 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. L5527–5616
-- blur: A tool window with one slider that blurs the playing video. L5617–5878
-- signal-generator: Generates its own video and audio: colour bars and a 1 kHz tone. L5879–6211
-- bookmark: A tool window bound to the playback state: remember the position and jump back to it. L6212–6396
-- panel-menu: A sidebar panel with its own right-click menu. L6397–6602
-- menus: Radio menu items, separator groups and a menu item whose title changes. L6603–6762
-- theme-widgets: A tool window drawn with the player's theme and widgets. L6763–6926
-- markdown: A window that shows a Markdown document. L6927–7120
+- 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
 
 ## Optional
 

package/package.json

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

package/slint/vestra/markdown.slint

@@ -7,7 +7,7 @@
 // `MarkdownView` scrolls one document. `MarkdownBlocks` does not scroll and
 // is as tall as its content: put it in your own layout or in a `ListView`
 // row (a chat message: a `[MarkdownBlock]` field of the row's struct).
-// `code-copy: true` adds a 复制 button to code blocks that reports
+// `code-copy: true` adds a Copy button to code blocks that reports
 // `copy-code(code)`; the plugin copies it (`plugin.clipboard`).
 import { ScrollView } from "std-widgets.slint";
 import { Theme } from "theme.slint";
@@ -139,7 +139,7 @@ component MarkdownBlockView {
                     border-radius: Theme.radius-control;
                     background: copy-touch.pressed ? Theme.button-press : copy-touch.has-hover ? Theme.button-hover : Theme.button-bg;
                     copy-label := Text {
-                        text: "复制";
+                        text: @tr("Copy");
                         color: copy-touch.has-hover ? Theme.text : Theme.text-dim;
                         font-size: Theme.font-body;
                         vertical-alignment: center;
@@ -160,7 +160,7 @@ component MarkdownBlockView {
                 }
             }
             if block.kind == "image" && !block.has-image: Text {
-                text: block.alt == "" ? "[图片]" : "[图片] " + block.alt;
+                text: block.alt == "" ? @tr("[Image]") : @tr("[Image] {}", block.alt);
                 color: Theme.text-dim;
                 font-size: Theme.font-body;
                 wrap: word-wrap;
@@ -214,7 +214,7 @@ component MarkdownBlockView {
 // Markdown blocks without scrolling, as tall as their content.
 export component MarkdownBlocks inherits Rectangle {
     in property <[MarkdownBlock]> blocks;
-    // A 复制 button on code blocks, reporting `copy-code(code)`.
+    // A Copy button on code blocks, reporting `copy-code(code)`.
     in property <bool> code-copy: false;
     callback link-clicked(string);
     callback copy-code(string);
@@ -239,7 +239,7 @@ export component MarkdownView inherits Rectangle {
     in property <[MarkdownBlock]> blocks;
     // Space around the document.
     in property <length> inset: 10px;
-    // A 复制 button on code blocks, reporting `copy-code(code)`.
+    // A Copy button on code blocks, reporting `copy-code(code)`.
     in property <bool> code-copy: false;
     callback link-clicked(string);
     callback copy-code(string);

package/slint/vestra/widgets.slint

@@ -183,14 +183,14 @@ export component Slider {
     }
 }
 
-// Link input (UI-DLG-02): a multi-line input and [打开] [取消]. Enter or the
-// confirm button accepts (Shift+Enter starts a new line), Esc or 取消 cancels.
+// Link input (UI-DLG-02): a multi-line input and [Open] [Cancel]. Enter or the
+// confirm button accepts (Shift+Enter starts a new line), Esc or Cancel cancels.
 // No validation here: the plugin checks the address.
 export component UrlInputRow {
     in-out property <string> text;
     in property <string> placeholder;
-    in property <string> confirm-text: "打开";
-    in property <string> cancel-text: "取消";
+    in property <string> confirm-text: @tr("Open");
+    in property <string> cancel-text: @tr("Cancel");
     in property <bool> enabled: true;
     callback accepted(string);
     callback cancelled();