Separate pull- and -stream packages?

[dy]

Now many modules due to multiple interfaces look messy, esp. for understanding the API.

Should we split audio-speaker (and others) to

• pull-audio-speaker for pull-stream
• stream-audio-speaker or audio-speaker-stream for node stream
• audio-speaker for plain function
• [audio-speaker-cli for command-line?]

?

That would make API entrance easier, less single-package maintenance efforts, better docs, better isolation/independence, less weight of a single package, less naming conventions issues (like direct/stream/pull/etc), make for better tests (no need to cross-test stream versions), resolve naming issues (some audio-* modules are not streams already), allow for grouping stream-* and pull-* packages together to organize stacks, e.g. we could separate them in docs. Some people don't use streams, others don't use pull-streams, others don't know what streams are but want to output audio. I'd guess these are separate groups of users.

@jamen @ahdinosaur

[vectrixdevelops]

This seems a lot better in my opinion. Although I think we should split audio-speaker after the release-2.0 branch is finished and merged.

[jamen]

I 100% agree.

[jamen]

@connorhartley Why not before, just avoid an unnecessary release afterwards?

[dy]

@connorhartley we can go v2.0 along with splitting it. That would help you focusing only on functional interface btw.

[vectrixdevelops]

@jamen @dfcreative Sounds good.

[jamen]

I like the *-stream and *-cli convention opposed to stream-*/cli-* btw, but also like pull-*.

Whichever way it reads better.

[dy]

So the list:

• audio-generator → pull-audio-generator, audio-generator-stream
• audio-speaker → pull-audio-speaker, audio-speaker-stream
• audio-gain → pull-audio-gain, audio-gain-stream
• audio-oscillator → pull-audio-oscillator, audio-oscillator-stream
• audio-source → pull-audio-source, audio-source-stream
• audio-biquad → pull-audio-biquad, audio-biquad-stream
• web-audio-stream → pull-web-audio, web-audio-write, web-audio-read

[ahdinosaur]

👍 thumbs up!

[dy]

All possible entries:

• wasm, asm
• native binding
• browser / node main
• pull / push / stream
• cli / bin
• transform? plugin?