carta1 1.6.0 → 1.7.0

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/README.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # Carta1
2
2
 
3
3
  Carta1 is an ATRAC1 encoder and decoder in JavaScript. It converts PCM WAVE
4
- audio to Sony's AEA container, decodes AEA back to PCM WAVE, exposes stateful
4
+ audio to the AEA container, decodes AEA back to PCM WAVE, exposes stateful
5
5
  frame and stream APIs, and ships browser Web Worker bundles.
6
6
 
7
7
  ## Supported format
@@ -34,11 +34,6 @@ npm ci
34
34
  npm run check
35
35
  ```
36
36
 
37
- [Native CLI archives](docs/native.md) for Linux and macOS (x64 and ARM64) are
38
- built with Porffor and attached to GitHub Releases after exact WAV/AEA parity
39
- checks against the Node CLI. They run without Node.js. See the native guide
40
- for local builds, supported input formats, and verification.
41
-
42
37
  ## CLI
43
38
 
44
39
  Run the installed executable directly, or use `npx carta1` from a project that
@@ -47,7 +42,6 @@ depends on Carta1:
47
42
  ```bash
48
43
  carta1 --encode input.wav output.aea
49
44
  carta1 --decode input.aea output.wav
50
- carta1 --json input.aea structure.json
51
45
 
52
46
  npx carta1 --encode input.wav output.aea
53
47
  ```
@@ -60,7 +54,6 @@ signed 16-bit PCM WAVE output.
60
54
  | --------------------- | ---------------------------------------------------- |
61
55
  | `-e, --encode` | Encode PCM WAVE to AEA. |
62
56
  | `-d, --decode` | Decode AEA to PCM WAVE. |
63
- | `-j, --json` | Write AEA metadata and frame structure as JSON. |
64
57
  | `-q, --quiet` | Suppress normal output and progress. |
65
58
  | `-f, --force` | Overwrite an existing output file. |
66
59
  | `-t, --title <title>` | Set a UTF-8 AEA title (up to 255 encoded bytes). |
@@ -69,7 +62,7 @@ signed 16-bit PCM WAVE output.
69
62
  | `-V, --version` | Print the Carta1 version. |
70
63
  | `-h, --help` | Print command help. |
71
64
 
72
- Exactly one of `--encode`, `--decode`, and `--json` is required. The input and
65
+ Exactly one of `--encode` and `--decode` is required. The input and
73
66
  output are positional paths. Existing output is preserved unless `--force` is
74
67
  provided.
75
68
 
@@ -189,8 +182,8 @@ npm test # Run the test suite once
189
182
  npm run test:watch # Re-run tests while editing
190
183
  npm run lint # Check JavaScript and formatting
191
184
  npm run format # Apply repository formatting
192
- npm run build # Build browser bundles and the WME plugin
193
- npm run check # Run lint, tests, builds, and packaged WME checks
185
+ npm run build # Build browser bundles
186
+ npm run check # Run lint, tests, and browser builds
194
187
  ```
195
188
 
196
189
  Run `npm run check` before submitting a change. Pull requests and pushes run
@@ -206,53 +199,3 @@ implementation used to understand the ATRAC1 format and codec behavior.
206
199
  ## License
207
200
 
208
201
  ISC
209
-
210
- ## Experimental Web MiniDisc encoder plugin
211
-
212
- `npm run build` also emits `dist/carta1.wme`, alongside the three existing
213
- browser bundles. GitHub Releases attach the WME, all three JavaScript bundles,
214
- and their source maps. The npm package includes the same build outputs. Release
215
- CDN links are pinned to that release's version.
216
-
217
- **Carta1 (ATRAC1, experimental)** is an ATRAC1 codec for standard MD SP, not
218
- ATRAC3 LP2/LP4 or ATRAC3plus Hi-MD. Current Web MiniDisc API v1 does not support
219
- software ATRAC1 output: its SP modes request PCM for the recorder to encode in
220
- hardware. Installing this plugin does not enable Carta1 recording in the
221
- unmodified app. All current API v1 codecs (PCM, MP3, AT3, A3+) are explicitly
222
- reported as unsupported so there is no silent hardware-encoding fallback.
223
-
224
- ### Proposed host extension for testing
225
-
226
- The archive uses the standard API v1 SAR container and default encoder class,
227
- with the usual `init`, `deinit`, `getSupportFor`, `transcode`, and progress hooks.
228
- It adds two **proposed, nonstandard** export codec names, using the host's
229
- existing recording-mode names:
230
-
231
- | `exportParams.format` | PCM channels | Output |
232
- | -------------------------------- | ------------ | ---------------- |
233
- | `{ codec: 'SPS', bitrate: 292 }` | 2 | ATRAC1 stereo SP |
234
- | `{ codec: 'SPM', bitrate: 146 }` | 1 | ATRAC1 mono SP |
235
-
236
- Bitrates are nominal kbps; ATRAC1 uses 212-byte sound units per channel per
237
- 512 samples at 44.1 kHz. The host's built-in FFmpeg decodes/resamples sources
238
- and optionally applies ReplayGain; the existing Carta1 worker encodes them.
239
- `transcode` returns raw sound units **without the 2048-byte AEA header**.
240
- Stereo sound units alternate left/right. Canonical priming and drain units
241
- are retained; gapless is not advertised and AEA timeline metadata is omitted.
242
-
243
- A host implementing this proposal must extend its export-codec interface,
244
- preserve SPS/SPM through capability checks and transcoding instead of mapping
245
- them to PCM, and route the result to a compatible pre-encoded ATRAC1 transfer
246
- path (such as a supported device's homebrew SP uploader). It must handle channel
247
- mode, transfer framing/padding, and device capabilities there. Ordinary SP PCM
248
- upload must never receive these compressed bytes. Neither the proposed names
249
- nor device transfer compatibility are part of the current WMD API contract;
250
- the WMD team can revise them when implementing support. No host changes are
251
- included here.
252
-
253
- `npm run test:wme` exercises the built archive and its bundled worker for both
254
- proposed formats, comparing the returned raw bytes with `encodeAeaPcm` across
255
- independent tracks. Lifecycle and failure tests run in the normal test suite.
256
-
257
- The repository-only WME packager lives in `build/wme.js`. Build tooling is
258
- excluded from the npm package; the generated `dist/` assets are included.