@qvac/audiogen-ggml 0.4.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +28 -0
- package/README.md +24 -7
- package/binding.js +34 -3
- package/package.json +6 -8
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.4.1] - 2026-09-16
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- Raise the `speech-cpp` floor to `2026-09-11`. The pinned engine adds an
|
|
15
|
+
optional Apple-only Core ML sidecar for the ACE-Step VAE decoder
|
|
16
|
+
(`AUDIOGEN_COREML`); the prebuilds keep it disabled, so published behavior
|
|
17
|
+
is unchanged until a build opts in.
|
|
18
|
+
|
|
19
|
+
- The binding loader now verifies that `require.addon()` returned an AudioGen
|
|
20
|
+
native binding before using it. If the result is the JavaScript package entry,
|
|
21
|
+
loading falls through to `#host-addon`; the resolved platform package is
|
|
22
|
+
validated as well, and the original lookup failure is retained as the error
|
|
23
|
+
cause for clearer diagnostics. Without this the wrong module was returned
|
|
24
|
+
verbatim and the first symptom was `createInstance is not a function` deep in
|
|
25
|
+
a model load. Local source-build behaviour is unchanged.
|
|
26
|
+
|
|
27
|
+
### Fixed
|
|
28
|
+
|
|
29
|
+
- Mobile platform packages (`@qvac/audiogen-ggml-android-arm64`,
|
|
30
|
+
`@qvac/audiogen-ggml-ios`) are no longer `os`-filtered `optionalDependencies`
|
|
31
|
+
of the meta package. No build host ever reports a mobile `os`, so installers
|
|
32
|
+
could never select them during a cross-build and mobile bundles failed
|
|
33
|
+
verification with missing prebuilds. They now publish without install filters;
|
|
34
|
+
mobile applications declare the target's platform package as a direct
|
|
35
|
+
dependency pinned to the exact meta package version.
|
|
36
|
+
|
|
37
|
+
|
|
10
38
|
## [0.4.0] - 2026-09-11
|
|
11
39
|
|
|
12
40
|
### Added
|
package/README.md
CHANGED
|
@@ -43,8 +43,8 @@ MiniMax-Music3 is available only in the Linux, macOS, and Windows prebuilds.
|
|
|
43
43
|
### Platform packages
|
|
44
44
|
|
|
45
45
|
`@qvac/audiogen-ggml` is a meta package that ships the JavaScript wrapper
|
|
46
|
-
only. The native prebuild for each host lives in a version-locked
|
|
47
|
-
package selected at install time through `os`/`cpu` filtered
|
|
46
|
+
only. The native prebuild for each desktop host lives in a version-locked
|
|
47
|
+
platform package selected at install time through `os`/`cpu` filtered
|
|
48
48
|
`optionalDependencies`:
|
|
49
49
|
|
|
50
50
|
| Host | Package |
|
|
@@ -54,17 +54,34 @@ package selected at install time through `os`/`cpu` filtered
|
|
|
54
54
|
| darwin-arm64 | `@qvac/audiogen-ggml-darwin-arm64` |
|
|
55
55
|
| darwin-x64 | `@qvac/audiogen-ggml-darwin-x64` |
|
|
56
56
|
| win32-x64 | `@qvac/audiogen-ggml-win32-x64` |
|
|
57
|
-
| android-arm64 | `@qvac/audiogen-ggml-android-arm64` |
|
|
58
|
-
| ios (device + simulators) | `@qvac/audiogen-ggml-ios` |
|
|
59
57
|
|
|
60
|
-
Do not depend on platform packages directly. Supported installers are
|
|
61
|
-
pnpm, bun, and Yarn Berry. Yarn v1 and `--omit=optional` installs skip
|
|
62
|
-
platform package and fail at require time with an error naming the missing
|
|
58
|
+
Do not depend on desktop platform packages directly. Supported installers are
|
|
59
|
+
npm 7+, pnpm, bun, and Yarn Berry. Yarn v1 and `--omit=optional` installs skip
|
|
60
|
+
the platform package and fail at require time with an error naming the missing
|
|
63
61
|
package; a locally built `prebuilds/` directory in the package root always
|
|
64
62
|
takes precedence. Use `require('@qvac/audiogen-ggml').resolveBackendsDir()`
|
|
65
63
|
to locate the directory holding the host's prebuilt binaries and dynamically
|
|
66
64
|
loaded ggml backends.
|
|
67
65
|
|
|
66
|
+
Mobile targets are cross-built, so no install host ever matches their `os`,
|
|
67
|
+
and `optionalDependencies` filtering can never select them. Mobile
|
|
68
|
+
applications must declare the target's platform package as a direct
|
|
69
|
+
dependency, pinned to the exact `@qvac/audiogen-ggml` version:
|
|
70
|
+
|
|
71
|
+
| Target | Package |
|
|
72
|
+
| --- | --- |
|
|
73
|
+
| android-arm64 | `@qvac/audiogen-ggml-android-arm64` |
|
|
74
|
+
| ios (device + simulators) | `@qvac/audiogen-ggml-ios` |
|
|
75
|
+
|
|
76
|
+
```json
|
|
77
|
+
{
|
|
78
|
+
"dependencies": {
|
|
79
|
+
"@qvac/audiogen-ggml": "x.y.z",
|
|
80
|
+
"@qvac/audiogen-ggml-android-arm64": "x.y.z"
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
68
85
|
The published linux-x64 prebuild bundles the CUDA backend next to Vulkan; the
|
|
69
86
|
linux-arm64 and Windows prebuilds ship Vulkan, and there CUDA is opt-in at
|
|
70
87
|
build time via `npm run build:cuda` (or `bare-make generate -D ENABLE_CUDA=ON`;
|
package/binding.js
CHANGED
|
@@ -1,18 +1,49 @@
|
|
|
1
1
|
module.exports = loadAddon()
|
|
2
2
|
|
|
3
|
+
// The split meta package has no local prebuild. Some runtimes return this
|
|
4
|
+
// package's Javascript entry from require.addon() instead of throwing, so
|
|
5
|
+
// validate the result before accepting it as the native binding.
|
|
6
|
+
|
|
3
7
|
function loadAddon() {
|
|
8
|
+
let cause = null
|
|
9
|
+
|
|
4
10
|
try {
|
|
5
|
-
|
|
11
|
+
const addon = require.addon()
|
|
12
|
+
if (isNativeBinding(addon)) return addon
|
|
13
|
+
cause = new Error(
|
|
14
|
+
'@qvac/audiogen-ggml: require.addon() answered with a module that is not the native binding ' +
|
|
15
|
+
'(no createInstance function), so the prebuild in this package was treated as absent.'
|
|
16
|
+
)
|
|
6
17
|
} catch (err) {
|
|
7
|
-
|
|
18
|
+
cause = err
|
|
8
19
|
}
|
|
20
|
+
|
|
21
|
+
return loadPlatformPackageAddon(cause)
|
|
9
22
|
}
|
|
10
23
|
|
|
11
24
|
function loadPlatformPackageAddon(cause) {
|
|
25
|
+
let addon
|
|
26
|
+
|
|
12
27
|
try {
|
|
13
|
-
|
|
28
|
+
addon = require('#host-addon')
|
|
14
29
|
} catch (err) {
|
|
15
30
|
if (err.cause === undefined) err.cause = cause
|
|
16
31
|
throw err
|
|
17
32
|
}
|
|
33
|
+
|
|
34
|
+
if (!isNativeBinding(addon)) {
|
|
35
|
+
const err = new Error(
|
|
36
|
+
'@qvac/audiogen-ggml resolved #host-addon to a module that is not the native binding: ' +
|
|
37
|
+
'it has no createInstance function. Check that the platform package for this host ' +
|
|
38
|
+
'is installed and is not shadowed by another module of the same name.'
|
|
39
|
+
)
|
|
40
|
+
err.cause = cause
|
|
41
|
+
throw err
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
return addon
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function isNativeBinding(addon) {
|
|
48
|
+
return addon !== null && typeof addon === 'object' && typeof addon.createInstance === 'function'
|
|
18
49
|
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@qvac/audiogen-ggml",
|
|
3
|
-
"version": "0.4.
|
|
3
|
+
"version": "0.4.1",
|
|
4
4
|
"description": "Audio generation (music) addon for qvac",
|
|
5
5
|
"addon": true,
|
|
6
6
|
"engines": {
|
|
@@ -173,12 +173,10 @@
|
|
|
173
173
|
},
|
|
174
174
|
"types": "index.d.ts",
|
|
175
175
|
"optionalDependencies": {
|
|
176
|
-
"@qvac/audiogen-ggml-linux-x64": "0.4.
|
|
177
|
-
"@qvac/audiogen-ggml-linux-arm64": "0.4.
|
|
178
|
-
"@qvac/audiogen-ggml-darwin-arm64": "0.4.
|
|
179
|
-
"@qvac/audiogen-ggml-darwin-x64": "0.4.
|
|
180
|
-
"@qvac/audiogen-ggml-win32-x64": "0.4.
|
|
181
|
-
"@qvac/audiogen-ggml-android-arm64": "0.4.0",
|
|
182
|
-
"@qvac/audiogen-ggml-ios": "0.4.0"
|
|
176
|
+
"@qvac/audiogen-ggml-linux-x64": "0.4.1",
|
|
177
|
+
"@qvac/audiogen-ggml-linux-arm64": "0.4.1",
|
|
178
|
+
"@qvac/audiogen-ggml-darwin-arm64": "0.4.1",
|
|
179
|
+
"@qvac/audiogen-ggml-darwin-x64": "0.4.1",
|
|
180
|
+
"@qvac/audiogen-ggml-win32-x64": "0.4.1"
|
|
183
181
|
}
|
|
184
182
|
}
|