docs(agents): mirror the advanced-subtitle controls contract into AGENTS.md

Codex review on #1471 flagged that AGENTS.md's Shared Player Controls
section still described the pre-subtitle controls surface while CLAUDE.md
was updated; both bootstrap files now carry the same contract summary.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
4grayandClaude Fable 5 committed 2026-08-23 00:02:59 +02:00
1 parent 10bd5acd6f
commit 46d10c9fbc
1 file changed
+16
+16
View File
@@ -176,6 +176,22 @@ Key files:
engine-neutral `PlayerController` contract, standalone
`app-player-controls`, generic web-video adapter/helper, and component-scoped
`WEB_PLAYER_SHARED_CONTROLS` rollout token.
- The subtitle menu carries capability-gated advanced subtitle support
(#1408): external subtitle file loading, a ±0.5 s timing-offset row, and
size/color styling persisted in the shared `subtitleStyle` localStorage key.
HTML5/ArtPlayer implement it through the neutral source bridge (`.srt`/`.vtt`
via a DOM file picker with encoding detection, native `TextTrack` rendering,
`::cue` styling, delay only while the loaded file is the selected track;
picks are source-generation-guarded and engine deselection precedes external
track activation). The canonical style shape and clamp/normalize rules are
shared with the main process via `@iptvnator/shared/interfaces`
(`subtitle-style.util.ts`). Embedded MPV frame-copy implements it through
helper protocol commands (`sub-add`/`sub-delay`/`sub-scale`/`sub-color`,
main-process file dialog, ASS supported, delay for all tracks). Video.js
shared mode, vendor-chrome paths, native-view, and the Linux out-of-process
path advertise no such capability and render no UI. Contract details:
`docs/architecture/player-controls-contract.md` ("Advanced subtitle
support").
- In fullscreen, `app-player-controls` shows a pointer-transparent media-title
overlay at the top while controls are revealed (`mediaTitle` input:
movie/channel/series name, plus an `S01E03` second line for episodes). Series