[sgabenov]

Note

AI-authored disclosure (alphatab-ai-authored-v1)

Portions of this content were authored by an AI agent. The agent has read
AGENTS.md and the human submitter accepts responsibility for
compliance with the rules in that document.

Issues

Fixes #3023

The issue has not yet been triaged or accepted.

Proposed changes

When a GP export contains embedded backing audio, include the Guitar Pro
visibility preference that opens its audio panel. This makes the panel
discoverable when the exported score is opened. Exports without embedded audio
do not receive this preference. The change does not implement audio encoding,
waveform generation, synchronization or playback.

Add an archive-level test for scores with and without an embedded asset and
document the behavior.

Validation

• In Guitar Pro 8.1.4 Build 43 on Windows, an unmodified develop export of a
  synthetic score with embedded audio opened without the audio panel; the same
  score exported from this branch opened with the panel visible. This check did
  not establish audio playback or synchronization.
• All 28 tests in Gp7Exporter.test.ts passed on Windows with two CRLF snapshots
  temporarily normalized to LF; their original bytes were restored afterward.
• build-web and the website build passed after building the required local
  documentation dependencies.

Checklist

• I consent that this change becomes part of alphaTab under its current or any future open source license
• This PR is linked to an accepted issue
• Changes are implemented
• New tests were added
• I have read AGENTS.md if an AI helped draft any part of this PR

AI authorship disclosure

• No AI agent authored any part of this PR (description, code, tests, or commit messages)
• An AI agent contributed to this PR. The AI-authored disclosure block
  (alphatab-ai-authored-v1) is present at the top of this body, and I have
  personally reviewed every change and can explain each one

Further details

• This is a breaking change
• Docs / release notes updated in website/