@vestra-player/sdk 1.5.7 → 1.5.9

package/dist/plugin/types.d.ts

@@ -73,9 +73,8 @@ export interface Disposable {
  * | `timeout` | A time limit ran out (`openStream` start-up, `tools.run`, `system.*` after 10 s). |
  * | `stream`, `device` | `openStream`: the producer failed / the audio device is not ready. |
  * | `backend-uncertain` | The player's backend blocked a filter stage; call `retry()`. |
- * | `cleanup` | {@link PackageTrial.stop} could not confirm cleanup; call it again. |
  * | `limit` | A player-wide limit was reached (for example the number of commands). |
- * | `reserved` | {@link Packages.validate}, {@link PackageCandidate.trial}, {@link PackageCandidate.install}: the id is `vestra` or starts with `vestra.` (any case), which only the player's built-in plugins use (player 0.4.1). |
+ * | `reserved` | {@link Packages.validate}, {@link PackageCandidate.install}: the id is `vestra` or starts with `vestra.` (any case), which only the player's built-in plugins use (player 0.4.1). |
  * | `versionMismatch` | The package needs a newer player (`minPlayerVersion`) or another `apiVersion`. |
  * | `ui-prepare` | The player could not prepare a mounted panel or a settings page (its Slint file does not compile, a bound property is not declared, or another plugin's panel holds the slot); `message` has the diagnostics. |
  * | `ui` | The player could not apply a property to a tool window or a settings page, or could not build the Options window (a property the Slint file does not declare, a value of the wrong type); `message` has Slint's reason. |
@@ -195,7 +194,7 @@ export interface Scope extends Disposable {
     readonly media: MediaCapture;
     /** Page-URL to stream-URL resolvers (`source.resolve`). */
     readonly resolvers: Resolvers;
-    /** The installed plugins; validation, trials, installs (`plugins.manage` for changes). */
+    /** The installed plugins; validation, installs (`plugins.manage` for changes). */
     readonly packages: Packages;
     /** On-screen messages over the video (`ui.osd`). */
     readonly osd: Osd;
@@ -225,8 +224,10 @@ export interface Scope extends Disposable {
     readonly timeline: Timeline;
     /** Files dropped on the video area, by extension (`ui.drop`). */
     readonly drops: Drops;
-    /** The player's palette. */
+    /** The player's palette and the saved interface language. */
     readonly appearance: Appearance;
+    /** The interface language of this run (read-only). */
+    readonly i18n: I18n;
     /** Pages in the player's options window (`ui.settings`). */
     readonly settings: Settings;
     /**
@@ -320,8 +321,7 @@ export interface Plugin extends Scope {
     readonly id: string;
     /**
      * A writable directory for this plugin's own files (settings, remembered
-     * folders). Kept across restarts, disabling and upgrades; a trial gets a
-     * temporary one. Write files atomically: to a temporary name, then rename.
+     * folders). Kept across restarts, disabling and upgrades. Write files atomically: to a temporary name, then rename.
      * Throws `unavailable` when the player provided none.
      *
      * Location: `~/Library/Application Support/Vestra/plugin-data/<id>/` on
@@ -362,9 +362,9 @@ export interface CommandState {
 export type Bindable<T> = T | (() => T);
 /**
  * A built-in top-level menu of the player, named in a command path as
- * `@<id>` (see {@link CommandOptions.path}): Open (打开), Playback (播放),
- * Subtitles (字幕), Video (视频), Audio (声音), Screen (屏幕), Settings (设置).
- * The list is `MENU_IDS` in `@vestra-player/sdk/testing`.
+ * `@<id>` or by its English key (see {@link CommandOptions.path}): Open,
+ * Playback, Subtitles, Video, Audio, Screen, Settings. The list is
+ * `MENU_IDS` in `@vestra-player/sdk/testing`.
  */
 export type MenuId = "open" | "playback" | "subtitles" | "video" | "audio" | "screen" | "settings";
 /**
@@ -381,7 +381,7 @@ export type MenuId = "open" | "playback" | "subtitles" | "video" | "audio" | "sc
  * ({@link MenuId}) sit at fixed orders, whatever is inside them: Open 110,
  * Playback 200, Subtitles 300, Video 400, Audio 500, Screen 710, Settings
  * 830 (player 0.3.0). This holds whether the path names the menu by id
- * (`["@video", "Blur"]`) or by its title (`["视频", "Blur"]`), so a plugin's
+ * (`["@video", "Blur"]`) or by its key (`["Video", "Blur"]`), so a plugin's
  * item never moves the player's menu. Directly inside a built-in menu,
  * `order` 0 (the default) sorts after every other order: an item without
  * `order` goes at the end, after the player's own items (which all use 100
@@ -404,13 +404,20 @@ export interface CommandOptions {
      * one segment is a top-level item. Omit it for a command that is not in the
      * main menu (bindings and panel menus only); `title` is then required.
      *
-     * Segments are menu titles, matched exactly. The player's own menus have
-     * Chinese titles, so `["Video", "Blur"]` would add a second top-level menu
-     * "Video". To join a built-in menu, start the path with its id, `@` plus a
-     * {@link MenuId}: `@open`, `@playback`, `@subtitles`, `@video`, `@audio`,
-     * `@screen` or `@settings`. Only the first segment is read as an id; an
-     * unknown id, or an id with nothing after it, fails with `invalid`. Needs
-     * player 0.3.0 (set `"minPlayerVersion": "0.3.0"`).
+     * Segments are English source text, and menus merge by them: commands
+     * of different plugins with the same leading segments share a submenu.
+     * The player shows each segment and the title in the interface language
+     * from the declaring plugin's catalog (`locales/<lang>.po`, see the
+     * [i18n guide](../../docs/how-to/i18n.md)); the player's own menus
+     * (Open, Playback, Subtitles, Video, Audio, Screen, Settings, and
+     * Playback ▸ Speed, Playback ▸ Seek) always show the player's words.
+     * A built-in menu can also be named by its id, `@` plus a {@link MenuId}:
+     * `@open`, `@playback`, `@subtitles`, `@video`, `@audio`, `@screen` or
+     * `@settings`. Only the first segment is read as an id; an unknown id, or
+     * an id with nothing after it, fails with `invalid`. Players up to 0.4.2
+     * titled their menus in Chinese (视频…): there `["Video", "Blur"]` is a
+     * menu of its own, so plugins for those players write `@video`; player
+     * 0.4.3 still accepts the old Chinese titles of its own menus.
      *
      * @example
      * ```ts
@@ -418,7 +425,10 @@ export interface CommandOptions {
      * ```
      */
     path?: string[];
-    /** Menu label; defaults to the last path segment. */
+    /**
+     * Menu label (English source text, shown translated); defaults to the
+     * last path segment.
+     */
     title?: string;
     /**
      * Sibling order in the menu, ascending (integer, default 0). A submenu sits
@@ -1942,6 +1952,121 @@ export interface Appearance {
      * @since 1.0.0
      */
     set(theme: ThemeId): Promise<void>;
+    /**
+     * The saved interface language: `"system"` (follow the system's
+     * languages, the default) or a {@link Locale}.
+     *
+     * @remarks
+     * This is the choice for the next start. The language of this run is
+     * {@link I18n.locale} and never changes while the player runs. Read before
+     * activation; with `events` it follows other plugins' changes, without it
+     * only this plugin's own. Players before 0.4.3 report `"system"`.
+     *
+     * @since 1.5.9
+     */
+    readonly language: LanguagePreference;
+    /**
+     * Save the interface language for the next start.
+     *
+     * @remarks
+     * The player keeps the choice in its interface state; the language
+     * changes when the player starts again (tell the user, for example "Takes
+     * effect after restart"). Every plugin with `events` hears the change in
+     * {@link Appearance.language}.
+     *
+     * @capability ui.theme
+     * @player 0.4.3
+     *
+     * @param language - `"system"` or a {@link Locale}.
+     * @returns Resolves once the player saved it; {@link Appearance.language}
+     *   has the new value.
+     *
+     * @throws `invalid` (rejects) `language` is not `"system"` or a {@link Locale}.
+     * @throws `capability` (rejects) The manifest does not declare `ui.theme`.
+     * @throws `unsupported` (rejects) A player before 0.4.3.
+     *
+     * @example
+     * ```ts
+     * await plugin.appearance.setLanguage("de");
+     * await plugin.osd.show("Takes effect after restart");
+     * ```
+     *
+     * @since 1.5.9
+     */
+    setLanguage(language: LanguagePreference): Promise<void>;
+}
+/**
+ * An interface language of the player: English (`en`, the source language
+ * of every plugin text) or a translation. The list is `LOCALES` in
+ * `@vestra-player/sdk/testing`.
+ *
+ * @remarks
+ * Simplified Chinese is `zh-Hans`. There is no Traditional Chinese: a
+ * system set to Traditional Chinese (Taiwan, Hong Kong, Macao) gets English.
+ *
+ * @since 1.5.9
+ * @category UI
+ */
+export type Locale = "en" | "zh-Hans" | "ja" | "ko" | "de" | "fr" | "es";
+/**
+ * The saved interface language ({@link Appearance.language}): follow the
+ * system, or one {@link Locale}.
+ *
+ * @since 1.5.9
+ * @category UI
+ */
+export type LanguagePreference = "system" | Locale;
+/**
+ * Arguments of a template sentence ({@link Osd.show},
+ * {@link OsdPanel.set}, {@link ConfirmOptions.args}): an array for `{}` and
+ * `{0}`, `{1}` placeholders, or an object for `{name}` placeholders. At most
+ * 16 strings and finite numbers; whole numbers print without a fraction.
+ *
+ * @since 1.5.9
+ * @category UI
+ */
+export type TemplateArgs = readonly (string | number)[] | Readonly<Record<string, string | number>>;
+/**
+ * The interface language of this run. `plugin.i18n`.
+ *
+ * @remarks
+ * Plugins write no translation code. Every user-visible text is English
+ * source text in one of three places, and the player translates it with
+ * the plugin's own catalog (`locales/<lang>.po`, compiled into the package
+ * by `vestra-plugin build`):
+ *
+ * 1. declarations: command titles and paths, settings page and panel
+ *    titles, the manifest's `name`, `punchline`, `description` and `tags`;
+ * 2. Slint: `@tr("…")` in the plugin's `.slint` files;
+ * 3. sentences the plugin hands the player: {@link Osd.show},
+ *    {@link OsdPanel.set} and {@link Dialogs.confirm} take a template and
+ *    its arguments (`osd.show("Speed {}×", [rate])`), never a sentence
+ *    composed in TypeScript.
+ *
+ * The language is fixed when the player starts: {@link I18n.locale} never
+ * changes during a run. Read it for what is not text, such as the order of
+ * names or a date format. `vestra-plugin i18n extract` collects the texts
+ * into `locales/messages.pot`; see the
+ * [i18n guide](../../docs/how-to/i18n.md).
+ *
+ * @capability None.
+ *
+ * @example Format a date the way the interface language writes it
+ * ```ts
+ * const day = new Date().toLocaleDateString(plugin.i18n.locale);
+ * await plugin.osd.show("Today is {}", [day]);
+ * ```
+ *
+ * @since 1.5.9
+ * @category UI
+ */
+export interface I18n {
+    /**
+     * The interface language of this run, chosen at start-up from the saved
+     * {@link Appearance.language} or the system's languages; English when
+     * neither names a {@link Locale}. Players before 0.4.3 report `"en"`.
+     */
+    readonly locale: Locale;
 }
 /**
  * The categories of the Options window. The tree shows them in this order:
@@ -2582,6 +2707,16 @@ export interface ConfirmOptions {
     destructive?: boolean;
     /** A checkbox under the text, such as "Don't ask again"; 1–40 characters. */
     checkbox?: string;
+    /**
+     * Values for the placeholders of `message` and `detail` (player 0.4.3).
+     * Every text of the dialog is English source text that the player shows
+     * translated from the plugin's catalog; `message` and `detail` are
+     * templates like {@link Osd.show}'s. The length limits apply to the shown
+     * text.
+     *
+     * @since 1.5.9
+     */
+    args?: TemplateArgs;
 }
 /**
  * The system's own dialogs: a confirmation alert and the open and save file
@@ -3351,18 +3486,20 @@ export interface OsdPanel extends Disposable {
      * @capability ui.osd
      *
      * @param text - The text, with `\n` between lines: at most 32 lines and
-     *   4096 bytes. `null` hides the block.
+     *   4096 bytes once translated and formatted. `null` hides the block. A
+     *   template, like {@link Osd.show}'s.
+     * @param args - Values for its placeholders (player 0.4.3).
      *
      * @example
      * ```ts
      * const info = plugin.osd.panel();
-     * info.set("A: 12.0 s\nB: 18.5 s");
+     * info.set("A: {} s\nB: {} s", ["12.0", "18.5"]);
      * info.set(null); // hide it
      * ```
      *
      * @since 1.0.0
      */
-    set(text: string | null): void;
+    set(text: string | null, args?: TemplateArgs): void;
 }
 /**
  * Text the player draws over the video: short messages and an information
@@ -3400,24 +3537,35 @@ export interface Osd {
      * Replaces the message on screen, whichever plugin showed it. A message
      * that is on screen when the plugin stops still disappears on time.
      *
+     * The text is a template in English: the player shows its translation
+     * from the plugin's catalog, with the placeholders (`{}`, `{0}`, `{name}`;
+     * `{{` and `}}` for braces) filled from `args`. Without `args` the text
+     * shows as it is (braces included). Untranslated, the English template is
+     * formatted. Never compose the sentence in TypeScript
+     * (`` `Speed ${rate}×` ``): translators can only translate whole templates.
+     *
      * @capability ui.osd
      *
-     * @param text - 1–200 characters; line breaks become spaces.
+     * @param text - The template, 1–200 characters once translated and
+     *   formatted; line breaks become spaces.
+     * @param args - Values for its placeholders (player 0.4.3; older players
+     *   show the template as it is).
      * @returns Resolves once the message is on screen.
      *
-     * @throws `invalid` (rejects) `text` is empty, only white space, or longer
-     *   than 200 characters.
+     * @throws `invalid` (rejects) The shown text is empty, only white space,
+     *   or longer than 200 characters, or `args` is not a {@link TemplateArgs}.
      * @throws `unavailable` (rejects) The player runs without a user interface.
      * @throws `capability` (rejects) The manifest does not declare `ui.osd`.
      *
      * @example
      * ```ts
      * await plugin.osd.show("Bookmark added");
+     * await plugin.osd.show("Speed {}×", [plugin.player.state.rate]);
      * ```
      *
      * @since 1.0.0
      */
-    show(text: string): Promise<void>;
+    show(text: string, args?: TemplateArgs): Promise<void>;
     /**
      * Create this plugin's information block.
      *
@@ -4008,6 +4156,47 @@ export interface Resolvers {
      * error's message.
      */
     add(options: ResolverOptions): Resolver;
+    /**
+     * The extensions some plugin's file resolver handles (SDK 1.5.8, player
+     * 0.4.2): lower case, without the dot, sorted, each once; not who
+     * registered them. Reading needs no capability; `[]` from older players.
+     * Without `events` it is the list from when the plugin first read it.
+     * Use it to accept such files beside the player's own media types, for
+     * example in a playlist's drop or folder scan.
+     *
+     * @example
+     * ```ts
+     * const MEDIA = ["mp4", "mkv", "mp3"];
+     * const accepted = (path: string) => {
+     *   const extension = path.split(".").pop()?.toLowerCase() ?? "";
+     *   return MEDIA.includes(extension) || plugin.resolvers.fileTypes.includes(extension);
+     * };
+     * ```
+     *
+     * @capability None.
+     * @player 0.4.2
+     * @since 1.5.8
+     */
+    readonly fileTypes: readonly string[];
+    /**
+     * {@link Resolvers.fileTypes} changed: a file resolver was added, or its
+     * plugin stopped. Needs `events`; without it the listener never fires.
+     *
+     * @param listener - Receives the new list.
+     * @returns A handle that removes the listener.
+     *
+     * @example
+     * ```ts
+     * plugin.resolvers.onFileTypesChange((types) => {
+     *   void plugin.osd.show(`Also accepted: ${types.join(", ")}`);
+     * });
+     * ```
+     *
+     * @capability `events`
+     * @player 0.4.2
+     * @since 1.5.8
+     */
+    onFileTypesChange(listener: (types: string[]) => void): Disposable;
 }
 /**
  * The manifest of a package, as validated. The display fields and
@@ -4099,11 +4288,6 @@ export interface PackageCandidate {
     readonly manifest: PackageManifest;
     /** The checks the player ran. */
     readonly checks: string[];
-    /**
-     * Load it temporarily alongside the installed plugins. A reserved id
-     * (`vestra.*`) fails with `reserved`.
-     */
-    trial(): Promise<PackageTrial>;
     /**
      * Install it. The same source upgrades the installed plugin (its data
      * stays); another source fails with `conflict` unless `replace` is set;
@@ -4114,17 +4298,6 @@ export interface PackageCandidate {
      */
     install(options?: InstallOptions): Promise<PackageChange>;
 }
-/** A trial load of a package. Disposing it stops the trial and waits for cleanup. */
-export interface PackageTrial extends Disposable {
-    /** The trial's status as the player reports it. */
-    readonly status: string;
-    /**
-     * Stop and wait until the host confirmed cleanup. Rejects with code
-     * `cleanup` when the host stopped the trial without confirming cleanup;
-     * calling `stop()` again then asks the host again.
-     */
-    stop(): Promise<void>;
-}
 /** The progress of an install, rollback or uninstall. */
 export type PackageChangeStatus = "preparing" | "activating" | "restoring" | "committed" | "cancelled" | "failed" | "failedDegraded" | "tooLate";
 /**
@@ -4149,8 +4322,8 @@ export interface PluginInfo {
     id: string;
     /** Version, `null` when unknown. */
     version: string | null;
-    /** From the install library, a `--plugin` development load, or a trial. */
-    origin: "installed" | "development" | "trial";
+    /** From the install library, or a `--plugin` development load. */
+    origin: "installed" | "development";
     /** Run state. */
     state: "starting" | "running" | "disabled" | "failed" | "stopped";
     /** Why it failed (`state: "failed"`). */
@@ -4166,7 +4339,7 @@ export interface PluginInfo {
      * replaced. `false` from players before 0.2.0.
      */
     builtin: boolean;
-    /** Where an installed plugin came from; `null` for development loads and trials. */
+    /** Where an installed plugin came from; `null` for development loads. */
     source: PackageSource | null;
     /**
      * Its data directory (`plugin.dataDirectory` of that plugin); `null` when
@@ -4184,6 +4357,30 @@ export interface PluginInfo {
      * @since 1.5.2
      */
     warnings?: readonly PluginWarning[];
+    /**
+     * The manifest's display texts in the interface language, translated
+     * with that package's catalog; absent from players before 0.4.3 (read
+     * `manifest.json` there).
+     *
+     * @since 1.5.9
+     */
+    display?: PluginDisplay;
+}
+/**
+ * {@link PluginInfo.display}: a package's `name`, `punchline`,
+ * `description` and `tags` as the player shows them.
+ *
+ * @since 1.5.9
+ */
+export interface PluginDisplay {
+    /** `name`, translated; `null` when the manifest has none. */
+    readonly name: string | null;
+    /** `punchline`, translated; `null` when the manifest has none. */
+    readonly punchline: string | null;
+    /** `description`, translated; `null` when the manifest has none. */
+    readonly description: string | null;
+    /** `tags`, each translated. */
+    readonly tags: readonly string[];
 }
 /**
  * One refusal in {@link PluginInfo.warnings}.
@@ -4222,6 +4419,10 @@ export interface Packages {
      * Validate a package directory (`plugins.manage`). A package whose id is
      * reserved for the built-in plugins (`vestra` or `vestra.*`) fails with
      * `reserved` (player 0.4.1).
+     *
+     * The player keeps the 32 most recent candidates of all plugins; an
+     * older one's `install` fails with `stale` (validate again). Before
+     * player 0.4.2 the 33rd validation of a run failed with `busy` instead.
      */
     validate(directory: string): Promise<PackageCandidate>;
     /**
@@ -4240,7 +4441,7 @@ export interface Packages {
     /**
      * Stop or start a plugin (`plugins.manage`). An installed plugin stays
      * disabled across launches; a development load only for this run.
-     * `invalid` to disable oneself, `unsupported` for a trial, `missing` unknown.
+     * `invalid` to disable oneself, `missing` unknown.
      * `busy` while it is being installed.
      */
     setEnabled(id: string, enabled: boolean): Promise<void>;
@@ -4248,7 +4449,7 @@ export interface Packages {
      * Remove an installed plugin (`plugins.manage`); `removeData` also deletes
      * its data directory, otherwise reinstalling it from the same source
      * reconnects to its data. Its user bindings stay (as orphans).
-     * `unsupported` for built-ins, development loads and trials, `missing`
+     * `unsupported` for built-ins and development loads, `missing`
      * unknown, `invalid` for oneself.
      */
     uninstall(id: string, options?: {

package/dist/plugin/ui.js

@@ -1,4 +1,5 @@
 /** Tool windows, docked panels and system dialogs. */
+import { templateArgs } from "./osd.js";
 import { readFileSync } from "node:fs";
 import { basename, extname, resolve } from "node:path";
 import { failure, Latest, quiet } from "./runtime.js";
@@ -651,7 +652,8 @@ export const dialogs = (scope) => {
     };
     return {
         async confirm(options) {
-            const { message, detail, confirm, cancel, destructive, checkbox } = options ?? {};
+            const { message, detail, confirm, cancel, destructive, checkbox, args } = options ?? {};
+            const values = templateArgs(args);
             const length = (text, min, max) => typeof text === "string" &&
                 [...text].length >= min &&
                 [...text].length <= max;
@@ -669,6 +671,7 @@ export const dialogs = (scope) => {
                 ...(cancel === undefined ? {} : { cancel }),
                 ...(destructive === undefined ? {} : { destructive }),
                 ...(checkbox === undefined ? {} : { checkbox }),
+                ...(values === undefined ? {} : { args: values }),
             });
             return {
                 confirmed: answer.confirmed === true,

package/dist/plugin/window.d.ts

@@ -19,6 +19,10 @@ export declare class WindowService {
     start(): void;
     /** The palette, as the `window.state` reply carried it (`plugin.appearance`). */
     appearance: string | undefined;
+    /** The file resolvers' extensions, as the reply carried them (`plugin.resolvers.fileTypes`). */
+    fileTypes: string[] | undefined;
+    /** The saved interface language, as the reply carried it (`plugin.appearance.language`). */
+    language: string | undefined;
     accept(facts: WindowFacts): void;
     read(): Promise<void>;
     watch(listener: (state: WindowState) => void): {

package/dist/plugin/window.js

@@ -52,9 +52,17 @@ export class WindowService {
     }
     /** The palette, as the `window.state` reply carried it (`plugin.appearance`). */
     appearance;
+    /** The file resolvers' extensions, as the reply carried them (`plugin.resolvers.fileTypes`). */
+    fileTypes;
+    /** The saved interface language, as the reply carried it (`plugin.appearance.language`). */
+    language;
     accept(facts) {
         if (facts.appearance)
             this.appearance = facts.appearance;
+        if (facts.language)
+            this.language = facts.language;
+        if (Array.isArray(facts.fileTypes))
+            this.fileTypes = [...facts.fileTypes];
         const next = view(facts);
         if (JSON.stringify(next) === JSON.stringify(this.state))
             return;

package/dist/wire.d.ts

@@ -25,12 +25,6 @@ export interface PackageValidation {
     checks: string[];
     trustedExecution: true;
 }
-export interface PackageTrial {
-    trialId: number;
-    activationOwner?: number;
-    status: string;
-    cleanupConfirmed?: boolean;
-}
 export interface InstalledPackage {
     revision: number;
     current: null | {
@@ -102,7 +96,7 @@ export declare class HostError extends Error {
 export interface PackageInfo {
     id: string;
     version: string | null;
-    origin: "installed" | "development" | "trial";
+    origin: "installed" | "development";
     state: "starting" | "running" | "disabled" | "failed" | "stopped";
     error: string | null;
     capabilities: string[];
@@ -118,6 +112,13 @@ export interface PackageInfo {
         slot?: string;
         owner?: string;
     }[];
+    /** The manifest's display texts in the interface language (player 0.4.3). */
+    display?: {
+        name: string | null;
+        punchline: string | null;
+        description: string | null;
+        tags: string[];
+    };
 }
 /** Where an installed package came from (`packages.install` `source`). */
 export type WireSource = {
@@ -175,6 +176,12 @@ export interface WindowFacts {
     };
     /** The palette (`plugin.appearance`), with the `window.state` reply; a newer player may name a palette this SDK does not list. */
     appearance?: string;
+    /** The file resolvers' extensions (`plugin.resolvers.fileTypes`; player 0.4.2). */
+    fileTypes?: string[];
+    /** The saved interface language, `"system"` or a locale (player 0.4.3). */
+    language?: string;
+    /** The interface language of this run (player 0.4.3). */
+    locale?: string;
 }
 /** One timeline mark as the player merges them (`timeline.marks`). */
 export interface WireMark {
@@ -280,11 +287,20 @@ export interface WireSystemInfo {
         primary: boolean;
     }[];
 }
+/** Template arguments on the wire (`osd.show`, `osd.panel`, `dialogs.confirm`). */
+export type TemplateArgsJson = (string | number)[] | {
+    [name: string]: string | number;
+};
 export interface Transport {
     request<T>(method: string, params?: Json): Promise<T>;
     on(event: string, listener: (data: unknown) => void): () => void;
     /** Replaces the real local services (test host). */
     local?: LocalServices;
+    /**
+     * The interface language of this run (`plugin.i18n.locale`): the runner
+     * passes the player's `VESTRA_LOCALE`, the test host its `locale`.
+     */
+    locale?: string;
 }
 export declare function createWire(transport: Transport): {
     processing: {
@@ -310,6 +326,7 @@ export declare function createWire(transport: Transport): {
             cancelled: boolean;
             paths: string[];
         }>;
+        /** Message and detail are templates formatted with `args` (player 0.4.3). */
         confirm: (options: {
             [key: string]: Json;
         }) => Promise<{
@@ -355,6 +372,8 @@ export declare function createWire(transport: Transport): {
     /** The palette (`ui.theme` to change it). */
     appearance: {
         set: (theme: string) => Promise<void>;
+        /** The interface language for the next start (player 0.4.3). */
+        setLanguage: (language: string) => Promise<void>;
     };
     /** Settings pages in the player's options window (`ui.settings`). */
     settings: {
@@ -473,9 +492,10 @@ export declare function createWire(transport: Transport): {
         } | null) => Promise<void>;
         step: (direction: "next" | "previous") => Promise<void>;
     };
+    /** `text` is a template in the plugin's catalog, formatted with `args` (player 0.4.3). */
     osd: {
-        show: (text: string) => Promise<void>;
-        panel: (text: string | null) => Promise<void>;
+        show: (text: string, args?: TemplateArgsJson) => Promise<void>;
+        panel: (text: string | null, args?: TemplateArgsJson) => Promise<void>;
     };
     layout: {
         state: () => Promise<{
@@ -530,11 +550,6 @@ export declare function createWire(transport: Transport): {
         validate: (directory: string, apiVersion?: string) => Promise<PackageValidation>;
         /** Player 0.2.0: a `.vxp` file. */
         validateArchive: (file: string) => Promise<PackageValidation>;
-        /** `requestId` recovers a lost first reply in this owner session. */
-        trial: (token: string, requestId: string) => Promise<PackageTrial>;
-        trialStateByRequest: (requestId: string) => Promise<PackageTrial>;
-        trialState: (trialId: number) => Promise<PackageTrial>;
-        stopTrial: (trialId: number) => Promise<PackageTrial>;
         installed: (id: string) => Promise<InstalledPackage>;
         /** `source` and `replace` are sent only when given (player 0.2.0). */
         install: (token: string, expectedRevision: number, requestId: string, options?: {