Source-Owned Skin Shell and Poster Composition

[mihar-22]

Context

Canonical Skin output currently starts at the controls root. Packaged video and live-video Skins instead own the player container boundary, projected media content, optional poster/placeholder behavior, and the inert overlay used by controls and gestures.

React and HTML express this boundary differently: React accepts children, container props, poster render input, and placeholder styling; HTML projects default/poster slots through its Skin element. Canonical intent must preserve those public behaviors without exposing framework-specific markup.

Acceptance criteria

• Canonical source represents the Skin/container boundary without platform intrinsics.
• React output preserves children, container props, class/style customization, poster input, and placeholder behavior.
• HTML output preserves idiomatic media and poster projection without leaking generated internal identity.
• Default, Minimal, and live video compositions can reuse the same shell where behavior is shared.
• The visual overlay remains Skin-owned layout rather than a generic Core primitive.
• React and HTML package/source-owned fixtures cover poster visibility and container composition.
• Exact package, element, style, and registry closure is generated.

[mihar-22]

Audio Skins share the container ownership boundary but omit poster and video overlay behavior. The shell outcome should support that reduced variant without forcing video-only structure into audio.

[github-actions]

Triage notes

• Title updated to add the missing Feature: prefix; body content unchanged.
• Labels applied: components, skin, pkg:core, pkg:html, pkg:react — matching the pattern used on sibling source-owned component issues (Feature: Source-Owned Play Button #1967, Feature: Source-Owned Volume Controls #1968, Feature: Source-Owned Time Slider and Thumbnail Preview #1969, Feature: Source-Owned Seek Buttons #1982, Feature: Source-Owned Controls Layout #1983).
• No duplicate found. This is scoped to the Skin/container/poster shell boundary specifically, distinct from Add Content Poster to Player Metadata #1941 (Add Content Poster to Player Metadata, which resolves the data model precedence for contentPoster rather than the rendering/composition boundary) and from the closed Feature: Poster Placeholder / Blur-Up Image #1438/Skins: Add poster image prop/slot #992 (packaged poster placeholder/prop, pre-source-owned architecture).

Planning recommendations (not applied)

• This reads as a follow-up item under the parent sub-epic Epic: Canonical Skin Components and Composition #1949 (Epic: Canonical Skin Components and Composition) — its "Poster, Overlay, and Player Interactions" and "Default and Minimal Video Skin Composition" checklist items look like exactly this issue's scope. Recommend linking it there if epic linkage is being curated.
• Related design/audit context worth cross-referencing: Design: Audit Skin Markup and Primitive Gaps #1954 (Design: Audit Skin Markup and Primitive Gaps) and Design: Source-Owned Component Boundaries and Naming #1955 (Design: Source-Owned Component Boundaries and Naming) — both define the wrapper/primitive disposition rules this issue's shell composition should follow.
• Once implemented, parity/visual coverage likely belongs alongside Epic: Skin Parity, Cutover, and Rollout #1952 (Epic: Skin Parity, Cutover, and Rollout) and Chore: Extend the Video Skin Visual Matrix #1972 (Extend the Video Skin Visual Matrix).
• Siblings Source-Owned Buffering and Error Compositions #2105–Source-Owned Hotkey and Gesture Composition #2110 (Buffering/Error, Captions, Remote Playback/PiP, Skin Menu, Input Indicator, Hotkey/Gesture compositions) are also newly opened and untriaged with the same "Source-Owned ..." naming pattern — recommend triaging as a batch for consistent labeling/epic linkage.
• No milestone recommendation: the only open milestone is "GA" (due 2026-08-17, ~4 days out), which doesn't look like a realistic fit for this scope — worth a maintainer call on whether this is GA-blocking or deferred post-GA.
• Priority: not clearly implied by the issue body; deferring to maintainer judgment.