v10/internal/design/spf/index.md

status, date, last-reviewed

status	date	last-reviewed
active	2026-03-11	2026-07-15

SPF design index

SPF is the framework-neutral streaming layer behind Video.js playback engines. Source and tests own behavior; these records preserve durable rationale and future capability boundaries.

Sources of truth

• Current behavior and contracts: packages/spf/src and colocated tests.
• Public surface and package guides: packages/spf/README.md and packages/spf/docs/.
• Dependency rules: packages/spf/src/AGENTS.md.

Do not copy current types, file inventories, or engine composition code into design records.

Architecture

• Architecture
• Primitives
• Signals
• Actor and reactor factories
• Presentation modeling
• Text tracks
• Track switching
• Conventions

Registries

• Feature clusters group capabilities and cross-cutting patterns.
• Use-case compositions cover engine variants for delivery scenarios.
• Individual records use draft, partial, or implemented status based on source evidence.

Maintenance

• Replace shipped implementation plans with decisions, consequences, and source links.
• Delete superseded research and temporary phase tracking.
• Keep a future brief only when it names a durable boundary or unresolved decision.