Files

@hypit/audio-program

Renderer-facing continuous audio Programme on one exact local temporal Domain.

The Programme preserves source, nested Programme, restrict, mix, process and shared-upstream topology. It chooses an explicit terminal sample rate independently of any video frame rate. Every Programme node has one signal output, so internal references name only the node instead of repeating a literal port. It declares the render-timeline-audio capability. A media source leaf contains only the selected PreparedAudioSource and its Prepared-local-to-source relation. Placement and occurrence sampling exist only on a parent nested Programme use. Process automation exists only as package-owned Process programmes and complete Programme-to-Control Maps. Target sample spans and total sample count remain projections of exact ranges and the Programme Domain instead of duplicate video-frame fields.

AudioProgram is one closed signal graph. Source, nested Programme, Restrict, Mix and package-owned Process nodes are its complete execution topology. A nested Programme node applies one exact target-local-to-child-local TemporalMap; it may also carry the package-owned reconstruction policy for that particular mapped read. It keeps the child signal closed instead of rendering it to a temporary Media identity. Media is therefore a leaf source, not the universal representation of every signal. Process ports are freely named by their programme format. Process nodes also carry complete Programme-to-Control temporal Maps; value meaning and interpolation remain owned by the package that owns the process programme. A concrete Provider may support a narrower subset and must reject unsupported ports or programmes at its capability boundary. Process nodes additionally preserve the AVIR Operator's per-input before/after support, state/pre-roll, latency and tail; the current Local Audio Provider executes only pointwise Gain and rejects non-pointwise contracts accurately.

The local renderer traverses nested Programme nodes recursively, discovers only the media leaves demanded by the selected output range, and evaluates each child through its explicit map. Nested programmes must use the same selected terminal sample rate; this is a renderer-facing signal constraint, not an authored Clock.

It does not turn a relation into trim, loop or playbackRate modes. A selected Renderer privately lowers the preserved graph and maps according to its signal capability and reports unsupported Process formats or map shapes through its request-local Endpoint support decision. This package does not choose that Provider, own media bytes, author Audio Tracks, reconstruct the origin of a map, or mux the rendered signal into a delivery container.

There is no AudioProgramClip, Composition -> AudioProgram compiler or legacy Track bridge. Typed upstream lowering must supply an AudioProgram directly. This deliberately prevents media identity from regaining placement, sampling, gain, fade, envelope or reconstruction fields merely to keep an older author model running.