Release 1.4.0

.gitattributes

@@ -0,0 +1,2 @@
+test-data/** filter=lfs diff=lfs merge=lfs -text
+font/** filter=lfs diff=lfs merge=lfs -text

.github/ISSUE_TEMPLATE/bug_report_form.yml

@@ -49,10 +49,9 @@ body:
     label: Found in Version
     description: Which version of alphaTab are you using?
     options:
-    - 1.3-alpha
+    - 1.4 (alpha)
+    - 1.3    
     - 1.2
-    - 1.1
-    - 1.0
     - Other
   validations:
     required: true

.github/pull_request_template.md

@@ -8,8 +8,7 @@ Fixes #
 ### Checklist
 - [ ] I consent that this change becomes part of alphaTab under it's current or any future open source license
 - [ ] Changes are implemented
-- [ ] Existing builds tests pass
-- [ ] New tests were added
+- [ ] New tests were added <!-- if not test were added explain why, we typically expect new tests for PRs -->
 
 ## Further details
 - [ ] This is a breaking change

.github/workflows/build.yml

@@ -10,9 +10,11 @@ on:
 jobs:
   build_web:
     name: Build and Test Web
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -22,9 +24,11 @@ jobs:
 
   build_csharp:
     name: Build and Test C#
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -37,9 +41,20 @@ jobs:
 
   build_kotlin:
     name: Build and Test Kotlin
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
+    env:
+      OSSRH_USERNAME: ${{secrets.OSSRH_USERNAME}}
+      OSSRH_PASSWORD: ${{secrets.OSSRH_PASSWORD}}
+      OSSRH_USERTOKEN_USERNAME: ${{secrets.OSSRH_USERTOKEN_USERNAME}}
+      OSSRH_USERTOKEN_PASSWORD: ${{secrets.OSSRH_USERTOKEN_PASSWORD}}
+      SONATYPE_STAGING_PROFILE_ID: ${{secrets.SONATYPE_STAGING_PROFILE_ID}}
+      SONATYPE_SIGNING_KEY_ID: ${{secrets.SONATYPE_SIGNING_KEY_ID}}
+      SONATYPE_SIGNING_PASSWORD: ${{secrets.SONATYPE_SIGNING_PASSWORD}}
+      SONATYPE_SIGNING_KEY: ${{secrets.SONATYPE_SIGNING_KEY}}
     steps:
       - uses: actions/checkout@v4
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -52,9 +67,9 @@ jobs:
           path: |
             ~/.gradle/caches
             ~/.gradle/wrapper
-          key: ${{ runner.os }}-gradle-cache-v3-${{ github.job }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+          key: ${{ runner.os }}-gradle-cache-v5-${{ github.job }}-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
           restore-keys: |
-            ${{ runner.os }}-gradle-cache-v3-${{ github.job }}-
+            ${{ runner.os }}-gradle-cache-v5-${{ github.job }}-
       - run: npm install
       - run: npm run build-kotlin
       - run: npm run test-kotlin

.github/workflows/publish.yml

@@ -24,17 +24,18 @@ jobs:
     name: Web
     needs: check_sha
     if: needs.check_sha.outputs.hit == 'false'
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
           cache: 'npm'
 
-      - run: npm install
       - run: node ./scripts/update-version.js alpha ${{github.run_number}}
+      - run: npm install
       - run: npm run build
       - run: npm pack
 
@@ -51,10 +52,11 @@ jobs:
     name: C#
     needs: check_sha
     if: needs.check_sha.outputs.hit == 'false'
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -68,24 +70,24 @@ jobs:
       - run: node ./scripts/update-csharp-version.js alpha ${{github.run_number}}
       - run: npm run build-csharp
 
-      - run: dotnet nuget push src.csharp\AlphaTab\bin\Release\*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json
-      - run: dotnet nuget push src.csharp\AlphaTab.Windows\bin\Release\*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json
+      - run: dotnet nuget push src.csharp/AlphaTab/bin/Release/*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json
+      - run: dotnet nuget push src.csharp/AlphaTab.Windows/bin/Release/*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json
 
   nightly_kotlin_android:
     name: Kotlin (Android)
     needs: check_sha
     if: needs.check_sha.outputs.hit == 'false'
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     env:
-      OSSRH_USERNAME: ${{secrets.OSSRH_USERNAME}}
-      OSSRH_PASSWORD: ${{secrets.OSSRH_PASSWORD}}
-      SONATYPE_STAGING_PROFILE_ID: ${{secrets.SONATYPE_STAGING_PROFILE_ID}}
-      SONATYPE_SIGNING_KEY_ID: ${{secrets.SONATYPE_SIGNING_KEY_ID}}
-      SONATYPE_SIGNING_PASSWORD: ${{secrets.SONATYPE_SIGNING_PASSWORD}}
-      SONATYPE_SIGNING_KEY: ${{secrets.SONATYPE_SIGNING_KEY}}
+      ORG_GRADLE_PROJECT_mavenCentralUsername: ${{secrets.OSSRH_USERTOKEN_USERNAME}}
+      ORG_GRADLE_PROJECT_mavenCentralPassword: ${{secrets.OSSRH_USERTOKEN_PASSWORD}}
+      ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{secrets.SONATYPE_SIGNING_KEY_ID}}
+      ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{secrets.SONATYPE_SIGNING_PASSWORD}}
+      ORG_GRADLE_PROJECT_signingInMemoryKey: ${{secrets.SONATYPE_SIGNING_KEY}}
     steps:
       - uses: actions/checkout@v4
-
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -100,9 +102,9 @@ jobs:
       - run: node ./scripts/update-kotlin-version.js SNAPSHOT
       - run: npm run build-kotlin
 
-      - run: .\gradlew.bat publishAllPublicationsToSonatypeRepository closeAndReleaseSonatypeStagingRepository
+      - run: ./gradlew publishToMavenCentral
         working-directory: ./src.kotlin/alphaTab/
 
-      - run: .\gradlew.bat --stop
+      - run: ./gradlew --stop
         working-directory: ./src.kotlin/alphaTab/
 

.github/workflows/release.yml

@@ -7,9 +7,11 @@ on:
 jobs:
   release_web:
     name: Web
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -28,9 +30,11 @@ jobs:
 
   release_csharp:
     name: C#
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          lfs: true
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -42,22 +46,22 @@ jobs:
       - run: npm install
       - run: node ./scripts/update-csharp-version.js ${{github.run_number}}
       - run: npm run build-csharp
-      - run: dotnet nuget push src.csharp\AlphaTab\bin\Release\*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json --skip-duplicate
-      - run: dotnet nuget push src.csharp\AlphaTab.Windows\bin\Release\*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json --skip-duplicate
+      - run: dotnet nuget push src.csharp/AlphaTab/bin/Release/*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json --skip-duplicate
+      - run: dotnet nuget push src.csharp/AlphaTab.Windows/bin/Release/*.nupkg -k ${{secrets.NUGET_API_KEY}} -s https://api.nuget.org/v3/index.json --skip-duplicate
 
   release_kotlin_android:
     name: Kotlin (Android)
     runs-on: windows-latest
     env:
-      OSSRH_USERNAME: ${{secrets.OSSRH_USERNAME}}
-      OSSRH_PASSWORD: ${{secrets.OSSRH_PASSWORD}}
-      SONATYPE_STAGING_PROFILE_ID: ${{secrets.SONATYPE_STAGING_PROFILE_ID}}
-      SONATYPE_SIGNING_KEY_ID: ${{secrets.SONATYPE_SIGNING_KEY_ID}}
-      SONATYPE_SIGNING_PASSWORD: ${{secrets.SONATYPE_SIGNING_PASSWORD}}
-      SONATYPE_SIGNING_KEY: ${{secrets.SONATYPE_SIGNING_KEY}}
+      ORG_GRADLE_PROJECT_mavenCentralUsername: ${{secrets.OSSRH_USERTOKEN_USERNAME}}
+      ORG_GRADLE_PROJECT_mavenCentralPassword: ${{secrets.OSSRH_USERTOKEN_PASSWORD}}
+      ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{secrets.SONATYPE_SIGNING_KEY_ID}}
+      ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{secrets.SONATYPE_SIGNING_PASSWORD}}
+      ORG_GRADLE_PROJECT_signingInMemoryKey: ${{secrets.SONATYPE_SIGNING_KEY}}
     steps:
       - uses: actions/checkout@v4
-
+        with:
+          lfs: true      
       - uses: actions/setup-node@v4
         with:
           node-version: 'lts/*'
@@ -70,9 +74,9 @@ jobs:
       - run: npm install
       - run: node ./scripts/update-kotlin-version.js
       - run: npm run build-kotlin
-      - run: .\gradlew.bat publishAllPublicationsToSonatypeRepository closeAndReleaseSonatypeStagingRepository
+      - run: ./gradlew publishToMavenCentral
         working-directory: ./src.kotlin/alphaTab/
 
-      - run: .\gradlew.bat --stop
+      - run: ./gradlew --stop
         working-directory: ./src.kotlin/alphaTab/
 

.mocharc.json

@@ -4,7 +4,7 @@
     ],
     "node-option": [
         "experimental-specifier-resolution=node",
-        "import=tsx",
+        "import=tsx/esm",
         "no-warnings"
     ],
     "spec": "test/**/*.test.ts",

LICENSE

@@ -1,3 +1,8 @@
+alphaTab is licensed under MPL-2.0.
+Copyright © 2025, Daniel Kuschny and Contributors, All rights reserved.
+
+See LICENSE.header for further licenses of integrated submodules.
+
 Mozilla Public License Version 2.0
 ==================================
 

LICENSE.header

@@ -6,8 +6,40 @@ This Source Code Form is subject to the terms of the Mozilla Public
 License, v. 2.0. If a copy of the MPL was not distributed with this
 file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
-SoundFont loading and Audio Synthesis based on TinySoundFont (licensed under MIT)
-Copyright (C) 2017, 2018 Bernhard Schelling (https://github.com/schellingb/TinySoundFont)
+Integrated Libraries:
 
-TinySoundFont is based on SFZero (licensed under MIT)
-Copyright (C) 2012 Steve Folta (https://github.com/stevefolta/SFZero)
+    Library: TinySoundFont
+    License: MIT
+    Copyright: Copyright (C) 2017, 2018 Bernhard Schelling
+    URL: https://github.com/schellingb/TinySoundFont
+    Purpose: SoundFont loading and Audio Synthesis
+
+    Library: SFZero
+    License: MIT
+    Copyright: Copyright (C) 2012 Steve Folta ()
+    URL: https://github.com/stevefolta/SFZero
+    Purpose: TinySoundFont is based on SFZEro
+
+    Library: Haxe Standard Library
+    License: MIT
+    Copyright: Copyright (C)2005-2025 Haxe Foundation
+    URL: https://github.com/HaxeFoundation/haxe/tree/development/std
+    Purpose: XML Parser & Zip Inflate Algorithm
+
+    Library: SharpZipLib
+    License: MIT
+    Copyright: Copyright © 2000-2018 SharpZipLib Contributors
+    URL: https://github.com/icsharpcode/SharpZipLib
+    Purpose: Zip Deflate Algorithm for writing compressed Zips
+
+    Library: NVorbis
+    License: MIT
+    Copyright: Copyright (c) 2020 Andrew Ward
+    URL: https://github.com/NVorbis/NVorbis
+    Purpose: Vorbis Stream Decoding
+
+    Library: libvorbis
+    License: BSD-3-Clause
+    Copyright: Copyright (c) 2002-2020 Xiph.org Foundation
+    URL: https://github.com/xiph/vorbis
+    Purpose: NVorbis adopted some code from libvorbis.

README.md

@@ -39,11 +39,11 @@ Node.js using `require` (UMD) | Access to all low level APIs and SVG rendering |
 .net standard 2.0 | Access to all low level APIs and multiple render engines (SVG, GDI+, SkiaSharp) | 1.0-latest
 .netcoreapp3.1 (WPF) | Full experience including low level APIs, Background Workers, Audio Playback (through NAudio), SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. | 1.0-1.2.2
 .netcoreapp3.1 (WinForms) | Full experience including low level APIs, Background Workers, Audio Playback (through NAudio), SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. Reduced UI level integration related to transparency and animations. | 1.0-1.2.2
-Browsers using ES6 Modules (ESM) | Full experience including low level APIs, Background Workers, Audio Playback, SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. | 1.3 (pre-release :warning:)
-Node.js using `import` (ESM) | Access to all low level APIs and SVG rendering | 1.3 (pre-release :warning:)
-.net8.0-windows (WPF) | Full experience including low level APIs, Background Workers, Audio Playback (through NAudio), SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. | 1.3 (pre-release :warning:)
-.net8.0-windows (WinForms) | Full experience including low level APIs, Background Workers, Audio Playback (through NAudio), SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. Reduced UI level integration related to transparency and animations. | 1.3 (pre-release :warning:)
-Android (Kotlin) | Full experience including low level APIs, Background Workers, Audio Playback, Android Canvas and SVG rendering. UI level integration for user interaction and automatic resizing. Reduced UI level integration related to transparency and animations. | 1.3 (pre-release :warning:)
+Browsers using ES6 Modules (ESM) | Full experience including low level APIs, Background Workers, Audio Playback, SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. | 1.3
+Node.js using `import` (ESM) | Access to all low level APIs and SVG rendering | 1.3
+.net8.0-windows (WPF) | Full experience including low level APIs, Background Workers, Audio Playback (through NAudio), SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. | 1.3
+.net8.0-windows (WinForms) | Full experience including low level APIs, Background Workers, Audio Playback (through NAudio), SVG and HTML5 rendering. UI level integration for user interaction and automatic resizing. Reduced UI level integration related to transparency and animations. | 1.3
+Android (Kotlin) | Full experience including low level APIs, Background Workers, Audio Playback, Android Canvas and SVG rendering. UI level integration for user interaction and automatic resizing. Reduced UI level integration related to transparency and animations. | 1.3
 
 ## Thanks to...