docs(spf): HLS engine composition walkthrough + doc-driven cleanups#1512

Merged

cjpillsbury merged 36 commits intomainfrom

docs/spf-hls-engine-composition

May 5, 2026

Commits on May 5, 2026

docs(spf): WIP HLS engine composition explainer
cjpillsbury
committed
refactor(spf): sort features/ into behaviors, actors, primitives

cjpillsbury
and
claude
committed
refactor(spf): enforce DOM-freedom on src/core via subtree tsconfig

cjpillsbury
and
claude
committed
refactor(spf): make core type-tests DOM-free; drop tests exclude

cjpillsbury
and
claude
committed
refactor(spf): move dom/network to top-level src/network

cjpillsbury
and
claude
committed
refactor(spf): enforce DOM-freedom on src/media and src/network

cjpillsbury
and
claude
committed
refactor(spf): extract text-track actor types to media/actors

cjpillsbury
and
claude
committed
refactor(spf): move text-track-segment-loader factory to media/actors

cjpillsbury
and
claude
committed
refactor(spf): split text-track loader and host provider

cjpillsbury
and
claude
committed
refactor(spf): inject VTT parser via provider config, drop dom wrapper

cjpillsbury
and
claude
committed
refactor(spf): fold provideTextTrackActors teardown into effect cleanup

cjpillsbury
and
claude
committed
refactor(spf): rename parseVttSegment to resolveVttSegment and related names

cjpillsbury
and
claude
committed
refactor(spf)!: move HLS engine and SpfMedia to src/playback-engines/hls/

cjpillsbury
and
claude
committed
refactor(spf)!: rename HLS exports to simple-hls naming

cjpillsbury
and
claude
committed
refactor(spf): promote SPF behaviors and actor types to top-level

cjpillsbury
and
claude
committed
refactor(spf)!: eliminate src/dom/, redistribute by role

cjpillsbury
and
claude
committed
refactor(spf): consolidate behaviors, actors, and HLS engine under playback/

cjpillsbury
and
claude
committed
refactor(spf): make onMediaSourceReadyStateChange a callback-based primitive

cjpillsbury
and
claude
committed
refactor(spf): move select-tracks orchestrations to playback/behaviors/

cjpillsbury
and
claude
committed
refactor(utils,spf): move generateId to @videojs/utils/string

cjpillsbury
and
claude
committed
refactor(spf): drop core/network references from media tsconfigs

cjpillsbury
and
claude
committed
docs(spf): add src/CLAUDE.md capturing dependency boundaries and layout
cjpillsbury
committed
refactor(spf): rename provideTextTrackActors to setupTextTrackActors
cjpillsbury
committed
chore(spf): delete stale committed .d.ts/.d.ts.map artifacts in src/
cjpillsbury
committed
docs(spf): start hls-engine.md walkthrough (intro through stage 1)
cjpillsbury
committed
refactor(spf): move mediaSourceReadyState onto state, drop initial-value casts
cjpillsbury
committed
refactor(spf): drop the no-op destroyVttResolver line from HLS composition
cjpillsbury
committed
refactor(spf): split state.presentation into presentationUrl + presentation
cjpillsbury
committed
feat(spf): add explicit-typed overload to createComposition
cjpillsbury
committed
docs(spf): add stages 2 and 3 to hls-engine.md
cjpillsbury
committed
docs(spf): add stages 4 and 5 to hls-engine.md
cjpillsbury
committed
docs(spf): add stages 6 and 7 to hls-engine.md
cjpillsbury
committed
docs(spf): add stages 8 and 9 plus the createComposition appendix
cjpillsbury
committed
refactor(spf): drop *FromConfig suffix on engine wrappers; shadow imports
cjpillsbury
committed
refactor(spf): collapse presentationUrl back into single presentation slot

cjpillsbury
and
claude
committed
fix(spf): require both id and selectionSets in isResolvedPresentation

cjpillsbury
and
claude
committed