Is your feature request related to a problem?
Yes. Extension authors currently have preview-oriented guidance, but export audio behavior is not clearly documented.
Describe the solution you'd like
Update extension docs to clearly define extension audio behavior in preview and export.
Include:
- Expected
playSound() behavior by mode
- Export capture semantics
- Recommended event-driven pattern (
cursor:click)
- Guardrails and practical limits
Describe alternatives you've considered
Keeping implementation details implicit in code only. Rejected, slows contributor adoption and causes repeated confusion.
Additional context
Docs should reflect extension-first roadmap and reduce future issue churn.
Acceptance criteria
EXTENSIONS.md documents preview vs export audio semantics.
- Examples include event-driven click sound guidance.
- Limitations and warnings are explicit.
- Release notes entry calls out new export parity behavior.
Is your feature request related to a problem?
Yes. Extension authors currently have preview-oriented guidance, but export audio behavior is not clearly documented.
Describe the solution you'd like
Update extension docs to clearly define extension audio behavior in preview and export.
Include:
playSound()behavior by modecursor:click)Describe alternatives you've considered
Keeping implementation details implicit in code only. Rejected, slows contributor adoption and causes repeated confusion.
Additional context
Docs should reflect extension-first roadmap and reduce future issue churn.
Acceptance criteria
EXTENSIONS.mddocuments preview vs export audio semantics.