{"_id":"@beatbax/plugin-exporter-arkos","_rev":"2-6d2254b1c635e7b34299644c34de8f4f","name":"@beatbax/plugin-exporter-arkos","dist-tags":{"latest":"0.2.1"},"versions":{"0.2.0":{"name":"@beatbax/plugin-exporter-arkos","version":"0.2.0","keywords":["beatbax","plugin","exporter","arkos","aks","aki","spectrum","ay","cpc"],"author":{"name":"BeatBax Contributors"},"license":"MIT","_id":"@beatbax/plugin-exporter-arkos@0.2.0","maintainers":[{"name":"kadraman","email":"kevinalee@me.com"}],"homepage":"https://github.com/kadraman/beatbax#readme","bugs":{"url":"https://github.com/kadraman/beatbax/issues"},"dist":{"shasum":"ab07ab24fe6c40b40bb45e94119005fc2dfc8e7d","tarball":"https://registry.npmjs.org/@beatbax/plugin-exporter-arkos/-/plugin-exporter-arkos-0.2.0.tgz","fileCount":55,"integrity":"sha512-pwIlm+LH1tc70TC6tgjzwU7ESVeqBh+BtnxCO27LNovP1BuiOBpF7qqLpzy5+lq41JwXUuK+trz2vXSZN/840w==","signatures":[{"sig":"MEQCIGTCJh8YJFxkEBqMFAEPqJQ+A+3yuIc1IKzRzgy8VXBiAiA2ZHwBrDLvIvngcO3HLx0oRWaeOxJRBJw8S0l2VyGM/g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":150905},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"448d313839d6038ac87786ec6eeaf8a7a44c3797","private":false,"scripts":{"test":"jest --config ./jest.config.cjs --passWithNoTests","build":"tsc -b","clean":"rimraf dist","pretest":"npm run build --if-present"},"_npmUser":{"name":"kadraman","email":"kevinalee@me.com"},"repository":{"url":"git+https://github.com/kadraman/beatbax.git","type":"git","directory":"packages/plugins/export-arkos"},"_npmVersion":"11.17.0","description":"Arkos Tracker 3 exporter plugin for BeatBax (.aks / .aki) — Spectrum-128 / Amstrad CPC.","directories":{},"_nodeVersion":"24.12.0","_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","rimraf":"^6.1.2","ts-jest":"^29.3.3","typescript":"^5.6.3","@types/jest":"^29.5.12","@types/node":"^22.7.4","@beatbax/engine":"*"},"peerDependencies":{"@beatbax/engine":">=0.18.0"},"_npmOperationalInternal":{"tmp":"tmp/plugin-exporter-arkos_0.2.0_1784475161385_0.6527513966175122","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@beatbax/plugin-exporter-arkos","version":"0.2.1","description":"Arkos Tracker 3 exporter plugin for BeatBax (.aks / .aki) — Spectrum-128 / Amstrad CPC.","private":false,"type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"keywords":["beatbax","plugin","exporter","arkos","aks","aki","spectrum","ay","cpc"],"repository":{"type":"git","url":"git+https://github.com/kadraman/beatbax.git","directory":"packages/plugins/export-arkos"},"license":"MIT","author":{"name":"BeatBax Contributors"},"scripts":{"clean":"rimraf dist","build":"tsc -b","test":"jest --config ./jest.config.cjs --passWithNoTests","pretest":"npm run build --if-present"},"peerDependencies":{"@beatbax/engine":">=0.18.0"},"devDependencies":{"@beatbax/engine":"*","@types/jest":"^29.5.12","@types/node":"^22.7.4","jest":"^29.7.0","rimraf":"^6.1.2","ts-jest":"^29.3.3","typescript":"^5.6.3"},"gitHead":"f5018b9fd456479ab63821734d336ea9c637c2ab","_id":"@beatbax/plugin-exporter-arkos@0.2.1","bugs":{"url":"https://github.com/kadraman/beatbax/issues"},"homepage":"https://github.com/kadraman/beatbax#readme","_nodeVersion":"24.12.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-QlUZ+1bQSIvR5R2MH1S1pX5lJHaE7KgRqc6wsEFbTdrGdjheaQLH/3mYfG2if7b5Q8c1OsntS4jDuti1UW/O4w==","shasum":"1fa289a3fa462835447198e99d3fd18b63cf06b8","tarball":"https://registry.npmjs.org/@beatbax/plugin-exporter-arkos/-/plugin-exporter-arkos-0.2.1.tgz","fileCount":55,"unpackedSize":151190,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDJ+7labn02ODnEj/BMygZmoCEgdw/ujYzU3bEFQK0GowIgeSRCV2ibzIYZi7aIjOMsCSvZtvX8/VSpgk5DF0TPARo="}]},"_npmUser":{"name":"kadraman","email":"kevinalee@me.com"},"directories":{},"maintainers":[{"name":"kadraman","email":"kevinalee@me.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/plugin-exporter-arkos_0.2.1_1787774036454_0.42167457401006825"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-19T15:32:41.206Z","modified":"2026-08-26T19:53:56.739Z","0.2.0":"2026-07-19T15:32:41.531Z","0.2.1":"2026-08-26T19:53:56.589Z"},"bugs":{"url":"https://github.com/kadraman/beatbax/issues"},"author":{"name":"BeatBax Contributors"},"license":"MIT","homepage":"https://github.com/kadraman/beatbax#readme","keywords":["beatbax","plugin","exporter","arkos","aks","aki","spectrum","ay","cpc"],"repository":{"type":"git","url":"git+https://github.com/kadraman/beatbax.git","directory":"packages/plugins/export-arkos"},"description":"Arkos Tracker 3 exporter plugin for BeatBax (.aks / .aki) — Spectrum-128 / Amstrad CPC.","maintainers":[{"name":"kadraman","email":"kevinalee@me.com"}],"readme":"# @beatbax/plugin-exporter-arkos\r\n\r\nArkos Tracker 3 exporter for BeatBax Spectrum-128 / Amstrad CPC songs.\r\n\r\nExports:\r\n\r\n- `.aks` — full song (AT3 `formatVersion` 3.0 plain XML) — default (CLI and desktop)\r\n- `.aki` — instrument bank only — CLI `export arkos --instruments`\r\n\r\nInstruments are embedded in the `.aks`. The `.aki` is an optional extract for\r\nreuse/import in other Arkos Tracker songs.\r\n\r\n## Usage\r\n\r\n```bash\r\n# Full song (same as desktop AKS export)\r\nnode bin/beatbax export arkos songs/spectrum-128/instruments/ay_synth_channels.bax\r\n\r\n# Instrument bank only\r\nnode bin/beatbax export arkos songs/spectrum-128/instruments/ay_synth_channels.bax --instruments\r\n```\r\n\r\n## v1 supported subset\r\n\r\nSupported:\r\n\r\n- `chip spectrum-128` / `chip cpc` / aliases (`spectrum`, `ay`, `amstrad-cpc`, …)\r\n- Up to 3 channels (`tone1` / `tone2` / `tone3`)\r\n- Notes, rests, sustains\r\n- Instrument `vol`, `noise_rate`, `tone_mix`, `tone`\r\n- Deterministic pattern/order lowering from resolved channel events\r\n\r\nInstrument sustain (v1): constant-`vol` instruments export as a **single looping cell**\r\nso Arkos holds the note for the full pattern row (matching BeatBax). Without the\r\nloop, AT3 would play one instrument frame then silence — notes sound clipped.\r\n\r\nRejected (fail-hard diagnostics):\r\n\r\n- `arp_env`, `pitch_env`, `vol_env`, `env_bass`, `env_shape`\r\n- `noise_frames`, `tone_frames`\r\n- Inline pattern effects\r\n\r\n## Register in app code\r\n\r\n```ts\r\nimport { exporterRegistry } from '@beatbax/engine';\r\nimport arkosExporterPlugin from '@beatbax/plugin-exporter-arkos';\r\n\r\nif (!exporterRegistry.has(arkosExporterPlugin.id)) {\r\n  exporterRegistry.register(arkosExporterPlugin);\r\n}\r\n```\r\n\r\n## Verification songs\r\n\r\n- `songs/spectrum-128/instruments/ay_synth_channels.bax`\r\n- `songs/spectrum-128/instruments/ay_noise_mixing.bax`\r\n- `songs/spectrum-128/instruments/ay_percussion_demo.bax` (may fail v1 if macros present)\r\n","readmeFilename":"README.md"}