@vestra-player/sdk 1.5.40 → 1.5.42

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.5.42
+
+**Who must change: nobody.** Documentation only: no API changes, `apiVersion` stays `vestra/1`, no player version needed. The package's code is the same as 1.5.41; the doc comments' `@see` links (27 in `src/plugin/types.ts`) now point at `docs/explanation/` instead of `docs/concepts/`. The site's page addresses stay the same, and the old _Concepts_ group address redirects to _Explanation_; `llms.txt` and `llms-full.txt` follow the new pages.
+
+- **The documentation follows Diátaxis.** The site's groups are Tutorials, How-to, Reference, Explanation, Guidelines, Examples and Upgrading, each with one kind of page whose shape `npm run docs:check` enforces (a tutorial has `Before you start`, numbered steps and `Next`; a how-to guide a goal, steps, a complete example and `See also`; explanation pages give no steps). _Concepts_ became _Explanation_ (the old address redirects); the migration notes moved to _Upgrading_ (`docs/upgrading/`), with every release's "who must change" in one generated table. New pages: tutorials _Add a window_, _Add settings and translations_, _Test, check, pack and publish_; _Troubleshooting_; reference pages _Error codes_, _Translations_ and _Test host_ (generated tables); explanation pages _GPU and software rendering_, _The player's Rust core_ and _How the player runs and talks to plugins_. Diagrams are Mermaid, and a check refuses link syntax in their labels.
+- **New tutorial _Write your own blur kernel_**: what the numbers of a 3×3 blur kernel do and why it is normalized; the kernel as an mpv user shader the plugin owns, applied with `plugin.video.shaders()`; the same kernel as a `convolution` node (the 9, 25 and 49 entry sizes, `row` and `column` kernels, `rdiv`, `bias` and `VIDEO_PROCESSING_LIMITS`) that also reaches processed snapshots; and `gblur` as the shortcut.
+- **New how-to guide _Keep a command's state without keeping the plugin running_**: find what keeps a plugin running with `TestHost.keepsRunning`, replace functions that read `plugin.player.state` with `plugin.when` conditions, keep the plugin's own state as values, and test it.
+- _Commands, menus and key bindings_ (explanation) explains `plugin.when`: why the player evaluates conditions, how they relate to idle stop, mirror and listening subscriptions, and `keepsRunning` / `listeningWhy`. _How a plugin runs_ says that listeners of `packages`, `bindings`, `appearance` and the resolvers' file types no longer keep a plugin running (player 0.5.21). _Video and audio processing_ describes the shader channel and the `convolution` and `lut3d` nodes.
+- _The player's Rust core_ shows the current window renderer choice (player 0.5.20): Direct3D 12 windows in CPU mode on Windows and their fallback to software windows. No page says any longer that only macOS renders on the GPU.
+
+## 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).
@@ -203,7 +220,7 @@ Fixes for Windows and for a vendored SDK, and built-ins that can no longer be di
 
 ## 1.5.17
 
-**Package rollback is removed**, as announced in 1.5.16: the player keeps no previous plugin version. `apiVersion` stays `vestra/1` (a patch release, as when 1.5.8 removed `PackageCandidate.trial()`); plugins that do not manage other plugins need no change. A plugin manager that still calls `rollback` or reads `previousVersion` no longer compiles. Migration: [Migrating off package rollback](docs/how-to/rollback-migration.md).
+**Package rollback is removed**, as announced in 1.5.16: the player keeps no previous plugin version. `apiVersion` stays `vestra/1` (a patch release, as when 1.5.8 removed `PackageCandidate.trial()`); plugins that do not manage other plugins need no change. A plugin manager that still calls `rollback` or reads `previousVersion` no longer compiles. Migration: [Migrating off package rollback](docs/upgrading/rollback-migration.md).
 
 - **Removed: `Packages.rollback`** and the wire method `packages.rollback`. The player already answers the method with `unsupported` ("unknown package method"). To go back to an older version of a third-party plugin, the user uninstalls it and installs that version's `.vxp`.
 - **Removed: `PluginInfo.previousVersion`** and the wire field `PackageInfo.previousVersion`; `packages.list` and `packages.changed` no longer carry it.
@@ -214,7 +231,7 @@ Fixes for Windows and for a vendored SDK, and built-ins that can no longer be di
 
 ## 1.5.16
 
-**Package rollback is deprecated: the player keeps no previous plugin version.** `apiVersion` stays `vestra/1`; code still compiles, and plugins that do not manage other plugins need no change. 1.5.17 removes the deprecated symbols, as 1.5.8 removed `PackageCandidate.trial()` at patch level. Migration: [Migrating off package rollback](docs/how-to/rollback-migration.md).
+**Package rollback is deprecated: the player keeps no previous plugin version.** `apiVersion` stays `vestra/1`; code still compiles, and plugins that do not manage other plugins need no change. 1.5.17 removes the deprecated symbols, as 1.5.8 removed `PackageCandidate.trial()` at patch level. Migration: [Migrating off package rollback](docs/upgrading/rollback-migration.md).
 
 - **Deprecated: `Packages.rollback`** (removed in 1.5.17). The player no longer has `packages.rollback` and answers it with `unsupported` ("unknown package method"); the SDK still forwards the call, so the error reaches the caller. To go back to an older version of a third-party plugin, the user uninstalls it and installs that version's `.vxp`.
 - **Deprecated: `PluginInfo.previousVersion`** and the wire field `PackageInfo.previousVersion` (removed in 1.5.17): always `null`, since an upgrade replaces the package. The SDK reads a missing field as `null`.
@@ -292,7 +309,7 @@ Fixes for Windows and for a vendored SDK, and built-ins that can no longer be di
 
 ## 1.5.9
 
-**Translations** (player 0.4.3). Additive; `apiVersion` stays `vestra/1`, and plugins written for 1.5.8 need no change. One test-visible change: a core action's `declaration.path` in `TestHost` is now the player's English key (read `display` for what the menu shows). The player now shows its interface in English, Simplified Chinese, Japanese, Korean, German, French or Spanish, chosen at start-up; a plugin writes every text in English and ships one gettext file per language. Plugins write no translation code: the player translates. Guides: [Translate a plugin](docs/how-to/i18n.md), [Migrate a plugin to English source text](docs/how-to/i18n-migration.md); example: `examples/i18n`.
+**Translations** (player 0.4.3). Additive; `apiVersion` stays `vestra/1`, and plugins written for 1.5.8 need no change. One test-visible change: a core action's `declaration.path` in `TestHost` is now the player's English key (read `display` for what the menu shows). The player now shows its interface in English, Simplified Chinese, Japanese, Korean, German, French or Spanish, chosen at start-up; a plugin writes every text in English and ships one gettext file per language. Plugins write no translation code: the player translates. Guides: [Translate a plugin](docs/how-to/i18n.md), [Migrate a plugin to English source text](docs/upgrading/i18n-migration.md); example: `examples/i18n`.
 
 - **`plugin.i18n.locale`** (new `I18n`, `Locale`): the interface language of this run, `"en"`, `"zh-Hans"`, `"ja"`, `"ko"`, `"de"`, `"fr"` or `"es"`; it never changes while the player runs. `"en"` from older players.
 - **Templates with arguments**: `osd.show(text, args?)`, `OsdPanel.set(text, args?)` and `ConfirmOptions.args` (new `TemplateArgs`: an array for `{}` / `{0}`, an object for `{name}`). The player translates the template with the plugin's catalog, then fills it in. Without `args` the text shows as it is, so existing calls are unchanged; older players show the template unfilled.

package/README.md

@@ -57,7 +57,7 @@ export default async function activate(plugin: Plugin) {
 }
 ```
 
-Run `npx vestra-plugin pack` to check and package it, or start the player with `--plugin <folder>` to try it right away. This is [`examples/hello`](https://github.com/vestrasys/vestra-player-sdk/tree/main/examples/hello); [Getting started](https://vestrasys.github.io/vestra-player-sdk/documents/Getting_started.html) adds a window, tests and packaging.
+Run `npx vestra-plugin pack` to check and package it, or start the player with `--plugin <folder>` to try it right away. This is [`examples/hello`](https://github.com/vestrasys/vestra-player-sdk/tree/main/examples/hello); the [Tutorials](https://vestrasys.github.io/vestra-player-sdk/documents/Tutorials.html) build a plugin in four lessons: [Getting started](https://vestrasys.github.io/vestra-player-sdk/documents/Getting_started.html) (a menu item and an on-screen message), then a window, settings and translations, and tests, packing and publishing.
 
 ## Examples
 
@@ -79,12 +79,13 @@ Complete, tested plugins in [`examples/`](https://github.com/vestrasys/vestra-pl
 
 The [documentation site](https://vestrasys.github.io/vestra-player-sdk/) is the one place for everything a plugin author needs:
 
-- **[Tutorials](https://vestrasys.github.io/vestra-player-sdk/documents/Tutorials.html)**: [Getting started](https://vestrasys.github.io/vestra-player-sdk/documents/Getting_started.html), from an empty folder to a packed plugin.
-- **[Concepts](https://vestrasys.github.io/vestra-player-sdk/documents/Concepts.html)**: how a plugin runs, commands and key bindings, playback, video and audio processing, the interface.
-- **[How-to guides](https://vestrasys.github.io/vestra-player-sdk/documents/How-to_guides.html)**: testing, translating and publishing a plugin, responsive sliders, remembering window state.
-- **[Guidelines](https://vestrasys.github.io/vestra-player-sdk/documents/Guidelines.html)**: rules for the interface and the menus.
+- **[Tutorials](https://vestrasys.github.io/vestra-player-sdk/documents/Tutorials.html)**: four lessons that build one plugin, starting with [Getting started](https://vestrasys.github.io/vestra-player-sdk/documents/Getting_started.html): a menu item, a window, settings and translations, tests and the store; then a lesson on writing your own blur kernel (a GPU shader and a convolution node).
+- **[How-to guides](https://vestrasys.github.io/vestra-player-sdk/documents/How-to_guides.html)**: one task each (goal, steps, complete example): playback, storage, subtitles, sliders, window state, the GPU switch, menu state that needs no running plugin (`plugin.when`), translating, testing, publishing; and troubleshooting.
+- **[Reference](https://vestrasys.github.io/vestra-player-sdk/documents/Reference.html)**: capabilities, manifest fields, limits, menus and bindings, platforms, theme, error codes, translations, the test host, and the [command line](https://vestrasys.github.io/vestra-player-sdk/documents/Command_line.html) (`vestra-plugin check`, `test`, `build`, `pack`, `i18n extract`, `i18n check`).
+- **[Explanation](https://vestrasys.github.io/vestra-player-sdk/documents/Explanation.html)**: how a plugin runs, commands and key bindings, playback, video and audio processing, the interface, GPU and software rendering, the player's Rust core and how it runs and talks to plugins.
+- **[Guidelines](https://vestrasys.github.io/vestra-player-sdk/documents/Guidelines.html)**: rules for every plugin, the interface and the menus.
 - **[Examples](https://vestrasys.github.io/vestra-player-sdk/documents/Examples.html)**: the walkthroughs above.
-- **[Reference](https://vestrasys.github.io/vestra-player-sdk/documents/Reference.html)**: capabilities, manifest fields, limits, menus and bindings, platforms, theme, and the [command line](https://vestrasys.github.io/vestra-player-sdk/documents/Command_line.html) (`vestra-plugin check`, `test`, `build`, `pack`, `i18n extract`, `i18n check`).
+- **[Upgrading](https://vestrasys.github.io/vestra-player-sdk/documents/Upgrading.html)**: what to change when a release deprecates or removes something, with the migration checklists and every release's "who must change".
 - **[API](https://vestrasys.github.io/vestra-player-sdk/modules/_vestra-player_sdk.html)**: every type and member of `@vestra-player/sdk` and `@vestra-player/sdk/testing`.
 
 ## Compatibility

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

@@ -520,7 +520,7 @@ export interface Scope extends Disposable {
  * `dataDirectory`.
  *
  * @capability That of each module (see the modules).
- * @see [How a plugin runs](../../docs/concepts/plugins.md)
+ * @see [How a plugin runs](../../docs/explanation/plugins.md)
  * @since 1.0.0
  * @category Plugin
  */
@@ -540,7 +540,7 @@ export interface Plugin extends Scope {
      * {@link PluginInfo.dataDirectory}). Write files atomically (to a
      * temporary name, then rename); for JSON settings prefer
      * {@link Scope.storage}. Throws `unavailable` when the player provided
-     * none. See [How a plugin runs](../../docs/concepts/plugins.md#the-data-directory).
+     * none. See [How a plugin runs](../../docs/explanation/plugins.md#the-data-directory).
      */
     readonly dataDirectory: string;
 }
@@ -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
@@ -918,7 +918,7 @@ export interface CommandButton {
  * order, group or binding. The same path registered twice, or a path that
  * is both an item and a submenu, fails with `conflict` (through `ready`).
  *
- * @see {@link Commands.add}, [Commands, menus and key bindings](../../docs/concepts/commands.md)
+ * @see {@link Commands.add}, [Commands, menus and key bindings](../../docs/explanation/commands.md)
  * @since 1.0.0
  * @category Commands
  */
@@ -1085,7 +1085,7 @@ export interface CommandOptions {
  * exportCommand.set({ enabled: () => plugin.player.state.phase === "ready" });
  * ```
  *
- * @see {@link Commands.add}, [Commands, menus and key bindings](../../docs/concepts/commands.md)
+ * @see {@link Commands.add}, [Commands, menus and key bindings](../../docs/explanation/commands.md)
  * @since 1.0.0
  * @category Commands
  */
@@ -1171,7 +1171,7 @@ export interface Command extends Disposable {
  * });
  * ```
  *
- * @see {@link Command}, {@link CommandOptions}, [Commands, menus and key bindings](../../docs/concepts/commands.md)
+ * @see {@link Command}, {@link CommandOptions}, [Commands, menus and key bindings](../../docs/explanation/commands.md)
  * @since 1.0.0
  * @category Commands
  */
@@ -1261,7 +1261,7 @@ export interface Commands {
  * }));
  * ```
  *
- * @see {@link Ui.image}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link Ui.image}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -1471,7 +1471,7 @@ export type Props = Record<string, PropValue>;
  *
  * {@includeCode ../../examples/markdown/ui/document.slint}
  *
- * @see {@link ImageRef}, {@link MarkdownRef}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link ImageRef}, {@link MarkdownRef}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -1736,7 +1736,7 @@ export interface Ui {
  *
  * {@includeCode ../../examples/bookmark/ui/bookmark.slint}
  *
- * @see {@link Window}, {@link Panel}, {@link SettingsPage}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md), [Keep a slider responsive while dragging](../../docs/how-to/slider.md)
+ * @see {@link Window}, {@link Panel}, {@link SettingsPage}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md), [Keep a slider responsive while dragging](../../docs/how-to/slider.md)
  * @since 1.0.0
  * @category UI
  */
@@ -1947,7 +1947,7 @@ export interface View {
  * });
  * ```
  *
- * @see {@link Windows.create}, {@link View}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md), [Remember a window's state between runs](../../docs/how-to/window-state.md)
+ * @see {@link Windows.create}, {@link View}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md), [Remember a window's state between runs](../../docs/how-to/window-state.md)
  * @since 1.0.0
  * @category UI
  */
@@ -2129,7 +2129,7 @@ export interface Window extends View, Disposable {
  *
  * {@includeCode ../../examples/bookmark/main.ts#window,command}
  *
- * @see {@link Window}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link Window}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -2534,7 +2534,7 @@ export interface SidebarSlot extends PanelSlot {
  *
  * {@includeCode ../../examples/panel-menu/ui/panel.slint}
  *
- * @see {@link Panels.mount}, {@link PanelSlot}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link Panels.mount}, {@link PanelSlot}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -2972,7 +2972,7 @@ export type ThemeId = "vestra" | "vestra-light";
  * });
  * ```
  *
- * @see [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md) (theme tokens)
+ * @see [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md) (theme tokens)
  * @since 1.0.0
  * @category UI
  */
@@ -3493,7 +3493,7 @@ export type SettingsCategory = "general" | "playback" | "subtitles" | "video" |
  * }
  * ```
  *
- * @see {@link Settings.page}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link Settings.page}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -3554,7 +3554,7 @@ export type SettingsPage = View & Disposable & {
  * page.on("resumeToggled", (on: boolean) => store.save({ ...store.value, resume: on }));
  * ```
  *
- * @see {@link SettingsPage}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link SettingsPage}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -3746,7 +3746,7 @@ export interface BackdropSlot {
  *
  * {@includeCode ../../examples/panel-menu/ui/panel.slint}
  *
- * @see {@link Panel}, {@link PanelSlot}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link Panel}, {@link PanelSlot}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -4469,7 +4469,7 @@ export interface ConfirmOptions {
  * }
  * ```
  *
- * @see [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -4683,7 +4683,7 @@ export interface AudioTrack {
  * Without `events`, {@link Player.state} only updates at start and after
  * this plugin's own operations.
  *
- * @see {@link Player.state}, [Playback state, controls and sources](../../docs/concepts/playback.md)
+ * @see {@link Player.state}, [Playback state, controls and sources](../../docs/explanation/playback.md)
  * @since 1.0.0
  * @category Playback
  */
@@ -4816,7 +4816,7 @@ export interface Chapter {
  * });
  * ```
  *
- * @see [Playback state, controls and sources](../../docs/concepts/playback.md)
+ * @see [Playback state, controls and sources](../../docs/explanation/playback.md)
  * @since 1.0.0
  * @category Playback
  */
@@ -5335,7 +5335,7 @@ export interface PlaybackStats {
  * `events` to follow changes made elsewhere; `producer.av` for
  * {@link Player.openStream}.
  *
- * @see [Playback state, controls and sources](../../docs/concepts/playback.md), [Control playback](../../docs/how-to/control-playback.md)
+ * @see [Playback state, controls and sources](../../docs/explanation/playback.md), [Control playback](../../docs/how-to/control-playback.md)
  * @since 1.0.0
  * @category Playback
  */
@@ -6298,7 +6298,7 @@ export interface OsdPanelOptions {
  * say("Blur on");
  * ```
  *
- * @see {@link OsdPanel}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/concepts/ui.md)
+ * @see {@link OsdPanel}, [Windows, panels, settings pages, dialogs and the OSD](../../docs/explanation/ui.md)
  * @since 1.0.0
  * @category UI
  */
@@ -6463,7 +6463,7 @@ interface Filter<T> extends Disposable {
  * never throws: a refused chain shows as `failed` in `status`.
  *
  * @capability processing.video, playback.read and events
- * @see [Video and audio processing](../../docs/concepts/processing.md)
+ * @see [Video and audio processing](../../docs/explanation/processing.md)
  * @since 1.0.0
  * @category Processing
  */
@@ -6492,7 +6492,7 @@ export type VideoFilter = Filter<VideoNode[]>;
  * result, `retry` applies it again, `dispose` withdraws it.
  *
  * @capability processing.audio, playback.read and events
- * @see [Video and audio processing](../../docs/concepts/processing.md)
+ * @see [Video and audio processing](../../docs/explanation/processing.md)
  * @since 1.0.0
  * @category Processing
  */
@@ -6551,7 +6551,7 @@ export interface ViewSettings {
  *
  * @capability processing.video, playback.read and events (like
  * {@link VideoFilter})
- * @see [Video and audio processing](../../docs/concepts/processing.md)
+ * @see [Video and audio processing](../../docs/explanation/processing.md)
  * @since 1.0.0
  * @category Processing
  */
@@ -6662,7 +6662,7 @@ export interface RenderSettings {
  *
  * @capability processing.video, playback.read and events (like
  * {@link VideoFilter})
- * @see [Video and audio processing](../../docs/concepts/processing.md)
+ * @see [Video and audio processing](../../docs/explanation/processing.md)
  * @since 1.0.0
  * @category Processing
  */
@@ -6766,7 +6766,7 @@ export interface RenderOptions extends Disposable {
  *
  * @capability processing.video
  * @player 0.5.20; older players refuse the request.
- * @see [Video and audio processing](../../docs/concepts/processing.md)
+ * @see [Video and audio processing](../../docs/explanation/processing.md)
  * @since 1.5.39
  * @category Processing
  */
@@ -7977,7 +7977,7 @@ export interface Resolver extends Disposable {
  * another plugin), so the plugin does not intercept opens itself.
  *
  * @capability source.resolve (file resolvers also `producer.av`)
- * @see [Playback state, controls and sources](../../docs/concepts/playback.md)
+ * @see [Playback state, controls and sources](../../docs/explanation/playback.md)
  * @since 1.0.0
  * @category Sources
  */
@@ -8751,7 +8751,7 @@ export interface BindingInfo extends BindingRef {
  * applies the change at once to every running plugin.
  *
  * @capability bindings.manage
- * @see [Commands, menus and key bindings](../../docs/concepts/commands.md)
+ * @see [Commands, menus and key bindings](../../docs/explanation/commands.md)
  * @since 1.0.0
  * @category Commands
  */