From fed2baf27882cda0e19ae0e972f7335a162c36eb Mon Sep 17 00:00:00 2001 From: ukimsanov Date: Wed, 5 Aug 2026 11:32:21 -0700 Subject: [PATCH] docs: correct composition offset rationale; pin nav fix; label-in-name MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - html-schema: the previous clause claimed a composition host's data-media-start is never read. It is: readElementPlaybackStart (media.ts:16) resolves data-playback-start ?? data-media-start and timeline.ts calls it on composition clips. Rewrote to the accurate reason both reviewers gave — composition hosts are only inspected by the playback-start-first readers, media-start works as a fallback, but playback-start is what Studio writes/normalises to. - motion test: pin the HoverVideo click-suppression (preventDefault + stopPropagation). Removing it left the gate 12/12; now it fails. This is the bug that escaped static review and only surfaced by driving the live preview. - replica-compare: fold the visible 'Sound off/on' text into the aria-label so the accessible name contains it (WCAG 2.5.3, Rames). Round-5 findings from Magi and Rames. --- docs/reference/html-schema.mdx | 2 +- docs/snippets/replica-compare.jsx | 8 ++++---- scripts/check-docs-snippet-motion.test.mjs | 13 +++++++++++++ 3 files changed, 18 insertions(+), 5 deletions(-) diff --git a/docs/reference/html-schema.mdx b/docs/reference/html-schema.mdx index 3b77b8027..c71613c98 100644 --- a/docs/reference/html-schema.mdx +++ b/docs/reference/html-schema.mdx @@ -122,7 +122,7 @@ Audio has no visual lifecycle. | Attribute | Applies to | Meaning | | --- | --- | --- | -| `data-media-start` / `data-playback-start` | Video, audio, nested composition | Offset into the source file, used by trim and split. Two groups of readers disagree, so the right name depends on the element. **Read only `data-media-start`:** the timing compiler, the HTML parser, `hyperframes validate` (which only inspects `