@modplayjs/fmt-sid 0.0.0-stage → 0.2.2

package/dist/psiddigi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"psiddigi.d.ts","sourceRoot":"","sources":["../src/psiddigi.ts"],"names":[],"mappings":"AAoCA,qEAAqE;AACrE,wBAAgB,kBAAkB,IAAI,MAAM,CAqC3C"}

package/dist/psiddigi.js

@@ -0,0 +1,73 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Ported from: cRSID 1.58 libcRSID/C64/C64_SIDrouting.c:377-427 — the PSID
+// $D4xx digi player (PlaySID-sample extension).
+// (c) Hermit (Mihaly Horvath), license: WTF ("do what the frick you want").
+import { CRSpecC64, CRAudioLevels } from './c64types.js';
+import { cRSID, cRSID_C64 } from './instance.js';
+// PSIDdigiSpecs (C64_SIDrouting.c:379-389)
+const D418_VOL_RANGE = 0x10;
+const DIGI_MAX = D418_VOL_RANGE - 1;
+const DIGI_MASK = DIGI_MAX;
+const DIGI_MID = D418_VOL_RANGE / 2;
+const OUTPUT_RESOLUTION = 16;
+const SID_CHANNELS = 3 + 1;
+const NOMINAL_DIGI_RANGE = (1 << OUTPUT_RESOLUTION) / SID_CHANNELS; // 16384
+const DIGI_VOLUME = 128 /* 55 */;
+const DIGI_VOLUME_DENOM = 16;
+const NOMINAL_DIGI_MUL = NOMINAL_DIGI_RANGE / D418_VOL_RANGE; // 1024
+const DIGI_MUL = ((NOMINAL_DIGI_MUL * DIGI_VOLUME) / DIGI_VOLUME_DENOM) * CRAudioLevels.CRSID_PRESAT_ATT_DENOM / CRAudioLevels.CRSID_PRESAT_ATT_NOM;
+void CRSpecC64;
+/** The C function's static state (PlaybackEnabled, NybbleCounter,
+ *  RepeatCounter, SampleAddress, Output, PeriodCounter) — kept across calls.
+ *  The TS port stores them in a module-scope object with C semantics
+ *  (they are reset when $D41D is written). */
+const psidDigiState = {
+    PlaybackEnabled: 0,
+    NybbleCounter: 0,
+    RepeatCounter: 0,
+    SampleAddress: 0,
+    Output: 0,
+    PeriodCounter: 0,
+};
+/** cRSID_playPSIDdigi (C64_SIDrouting.c:377-427) — returns short. */
+export function cRSID_playPSIDdigi() {
+    const C64 = cRSID_C64;
+    const st = psidDigiState;
+    let Shifts;
+    if (C64.IObankWR[0xd41d]) {
+        st.PlaybackEnabled = C64.IObankWR[0xd41d] >= 0xfe ? 1 : 0;
+        st.PeriodCounter = 0;
+        st.NybbleCounter = 0;
+        st.SampleAddress = C64.IObankWR[0xd41e] + (C64.IObankWR[0xd41f] << 8);
+        st.RepeatCounter = C64.IObankWR[0xd43f];
+    }
+    C64.IObankWR[0xd41d] = 0;
+    if (st.PlaybackEnabled) {
+        const RatePeriod = C64.IObankWR[0xd45d] + (C64.IObankWR[0xd45e] << 8);
+        if (RatePeriod)
+            st.PeriodCounter += Math.trunc(C64.CPUfrequency / RatePeriod);
+        if (st.PeriodCounter >= C64.SampleRate) {
+            st.PeriodCounter -= C64.SampleRate;
+            if (st.SampleAddress < C64.IObankWR[0xd43d] + (C64.IObankWR[0xd43e] << 8)) {
+                if (st.NybbleCounter) {
+                    Shifts = C64.IObankWR[0xd47d] ? 4 : 0;
+                    ++st.SampleAddress;
+                }
+                else
+                    Shifts = C64.IObankWR[0xd47d] ? 0 : 4;
+                st.Output =
+                    (((C64.RAMbank[st.SampleAddress] >>> Shifts) & DIGI_MASK) - DIGI_MID) * DIGI_MUL; // * DIGI_VOLUME; // * (C64.IObankWR[0xD418]&0xF);
+                st.NybbleCounter ^= 1;
+            }
+            else if (st.RepeatCounter) {
+                st.SampleAddress = C64.IObankWR[0xd47f] + (C64.IObankWR[0xd47e] << 8);
+                st.RepeatCounter--;
+            }
+        }
+    }
+    return Math.trunc(st.Output / C64.Attenuation);
+}
+// The cRSID import documents parity with C's file-global cRSID use.
+void cRSID;
+//# sourceMappingURL=psiddigi.js.map

package/dist/psiddigi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"psiddigi.js","sourceRoot":"","sources":["../src/psiddigi.ts"],"names":[],"mappings":"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"}

package/dist/settings.d.ts

@@ -0,0 +1,41 @@
+/** Chip model (0 = header default, 6581/8580 = forced). */
+export type SidModel = 0 | 6581 | 8580;
+/** Output mode: mono / full stereo / narrow stereo (2SID+ tunes only). */
+export type SidStereo = 0 | 1 | 3;
+/** All settable engine options. */
+export interface SidSettings {
+    /** master volume 0..255 (C: -volume). Live. */
+    volume: number;
+    /** cycle-based oversampled waveform emulation (C: -sidhq/-sidlight). Live. */
+    highQualitySID: boolean;
+    /** Sinc FIR resampler instead of the Chebyshev+averaging decimator
+     *  (C: -resamplehq/-resamplight). Only used when highQualitySID. Live. */
+    highQualityResampler: boolean;
+    /** channel mode for 2SID/3SID/4SID tunes (C: -mono/-stereo/-narrow). Live. */
+    stereo: SidStereo;
+    /** force a chip model (C: -sid6581/-sid8580); 0 = follow the header.
+     *  Init-time: applied on the next sidStartTune. */
+    model: SidModel;
+    /** force the video standard 0=NTSC 1=PAL; undefined = follow the header.
+     *  Init-time: applied on the next sidStartTune. */
+    videoStandard?: 0 | 1;
+}
+/** Read the current settings back (live values included). */
+export declare function getSidSettings(): SidSettings;
+/** Apply the live settings (everything except model/videoStandard). */
+export declare function applySidSettingsLive(s: Pick<SidSettings, 'volume' | 'highQualitySID' | 'highQualityResampler' | 'stereo'>): void;
+/** Set the init-time overrides consumed by cRSID_setC64 (model forces the
+ *  chip selection in cRSID_setSIDmodels; ForcedVideoStandard overrides the
+ *  header video standard after its decode). Applied on the next
+ *  sidStartTune. */
+export declare function setSidInitOverrides(model: SidModel, videoStandard?: 0 | 1): void;
+/** Internal: re-apply the stored overrides after cRSID_init (which resets
+ *  the globals). Called by sidStartTune. */
+export declare function sidApplyInitOverrides(): void;
+/** Apply everything: live fields immediately, init-time fields on the
+ *  next sidStartTune call. */
+export declare function applySidSettings(s: SidSettings): void;
+/** Number of SID chips the loaded tune uses (1..4). The channel-mode
+ *  setting (mono/stereo/narrow) only routes differently when > 1. */
+export declare function getSidChipCount(): number;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAiBA,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACvC,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElC,mCAAmC;AACnC,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,cAAc,EAAE,OAAO,CAAC;IACxB;8EAC0E;IAC1E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,8EAA8E;IAC9E,MAAM,EAAE,SAAS,CAAC;IAClB;uDACmD;IACnD,KAAK,EAAE,QAAQ,CAAC;IAChB;uDACmD;IACnD,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;CACvB;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,IAAI,WAAW,CAS5C;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,gBAAgB,GAAG,sBAAsB,GAAG,QAAQ,CAAC,GAAG,IAAI,CAQhI;AAMD;;;oBAGoB;AACpB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAGhF;AAED;4CAC4C;AAC5C,wBAAgB,qBAAqB,IAAI,IAAI,CAG5C;AAED;8BAC8B;AAC9B,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,CAGrD;AAED;qEACqE;AACrE,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/settings.js

@@ -0,0 +1,64 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Playback-settings surface for the cRSID engine — the C player's CLI
+// options (-sid6581/-sid8580, -mono/-stereo/-narrow, -sidhq/-sidlight,
+// -resamplehq/-resamplight, -volume) mapped onto the ported globals.
+//
+// Timing semantics (from the C source):
+//  - MainVolume, HighQualitySID, HighQualityResampler, Stereo are read
+//    through the per-sample shadow sync (host/audio.c generateSample) —
+//    they apply LIVE on the next sample.
+//  - SelectedSIDmodel and the video standard are consumed only by
+//    cRSID_setC64()/cRSID_setSIDmodels() during init — changing them
+//    requires a tune re-init (sidStartTune with overrides).
+import { cRSID, cRSID_C64 } from './instance.js';
+/** Read the current settings back (live values included). */
+export function getSidSettings() {
+    return {
+        volume: cRSID.MainVolume,
+        highQualitySID: cRSID.HighQualitySID !== 0,
+        highQualityResampler: cRSID.HighQualityResampler !== 0,
+        stereo: cRSID.Stereo,
+        model: cRSID.SelectedSIDmodel,
+        videoStandard: undefined, // not tracked post-init; re-init reads cRSID.VideoStandard
+    };
+}
+/** Apply the live settings (everything except model/videoStandard). */
+export function applySidSettingsLive(s) {
+    cRSID.MainVolume = Math.max(0, Math.min(255, Math.round(s.volume)));
+    cRSID.HighQualitySID = s.highQualitySID ? 1 : 0;
+    cRSID.HighQualityResampler = s.highQualitySID && s.highQualityResampler ? 1 : 0;
+    cRSID.Stereo = s.stereo;
+    // shadow update happens per-sample inside generateSample (loader.ts),
+    // matching the C host-thread sync — no action needed here.
+    void cRSID_C64;
+}
+/** Stored init-time overrides (cRSID_init resets the globals, so they are
+ *  re-applied inside sidStartTune after cRSID_init). */
+const sidInitOverrides = { model: 0 };
+/** Set the init-time overrides consumed by cRSID_setC64 (model forces the
+ *  chip selection in cRSID_setSIDmodels; ForcedVideoStandard overrides the
+ *  header video standard after its decode). Applied on the next
+ *  sidStartTune. */
+export function setSidInitOverrides(model, videoStandard) {
+    sidInitOverrides.model = model;
+    sidInitOverrides.videoStandard = videoStandard;
+}
+/** Internal: re-apply the stored overrides after cRSID_init (which resets
+ *  the globals). Called by sidStartTune. */
+export function sidApplyInitOverrides() {
+    cRSID.SelectedSIDmodel = sidInitOverrides.model;
+    cRSID.ForcedVideoStandard = sidInitOverrides.videoStandard;
+}
+/** Apply everything: live fields immediately, init-time fields on the
+ *  next sidStartTune call. */
+export function applySidSettings(s) {
+    applySidSettingsLive(s);
+    setSidInitOverrides(s.model, s.videoStandard);
+}
+/** Number of SID chips the loaded tune uses (1..4). The channel-mode
+ *  setting (mono/stereo/narrow) only routes differently when > 1. */
+export function getSidChipCount() {
+    return cRSID_C64.SIDchipCount;
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,sDAAsD;AACtD,sEAAsE;AACtE,uEAAuE;AACvE,qEAAqE;AACrE,EAAE;AACF,wCAAwC;AACxC,uEAAuE;AACvE,wEAAwE;AACxE,yCAAyC;AACzC,kEAAkE;AAClE,qEAAqE;AACrE,4DAA4D;AAG5D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA0BjD,6DAA6D;AAC7D,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,UAAU;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,CAAC;QAC1C,oBAAoB,EAAE,KAAK,CAAC,oBAAoB,KAAK,CAAC;QACtD,MAAM,EAAE,KAAK,CAAC,MAAmB;QACjC,KAAK,EAAE,KAAK,CAAC,gBAA4B;QACzC,aAAa,EAAE,SAAS,EAAE,2DAA2D;KACtF,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,oBAAoB,CAAC,CAAqF;IACxH,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpE,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACxB,sEAAsE;IACtE,2DAA2D;IAC3D,KAAK,SAAS,CAAC;AACjB,CAAC;AAED;wDACwD;AACxD,MAAM,gBAAgB,GAA+C,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAElF;;;oBAGoB;AACpB,MAAM,UAAU,mBAAmB,CAAC,KAAe,EAAE,aAAqB;IACxE,gBAAgB,CAAC,KAAK,GAAG,KAAK,CAAC;IAC/B,gBAAgB,CAAC,aAAa,GAAG,aAAa,CAAC;AACjD,CAAC;AAED;4CAC4C;AAC5C,MAAM,UAAU,qBAAqB;IACnC,KAAK,CAAC,gBAAgB,GAAG,gBAAgB,CAAC,KAAK,CAAC;IAChD,KAAK,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,aAAa,CAAC;AAC7D,CAAC;AAED;8BAC8B;AAC9B,MAAM,UAAU,gBAAgB,CAAC,CAAc;IAC7C,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxB,mBAAmB,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC;AAChD,CAAC;AAED;qEACqE;AACrE,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC,YAAY,CAAC;AAChC,CAAC"}

package/dist/sid.d.ts

@@ -0,0 +1,21 @@
+import type { CRC64instance, CRSIDinstance } from './c64types.js';
+/** cRSID_getSIDbase (SID.c:6-8). */
+export declare function cRSID_getSIDbase(sidNumber: number): number;
+/** cRSID_getSIDmodel (SID.c:10-12). */
+export declare function cRSID_getSIDmodel(sidNumber: number): number;
+/** cRSID_setSIDmodel (SID.c:13-15). */
+export declare function cRSID_setSIDmodel(C64: CRC64instance, sidNumber: number, value: number): number;
+/** cRSID_getSIDchannel (SID.c:17-19) — channel in stereo field
+ *  (left/right/middle). */
+export declare function cRSID_getSIDchannel(sidNumber: number): number;
+/** cRSID_getSIDlevel (SID.c:21-23). */
+export declare function cRSID_getSIDlevel(sidNumber: number): number;
+/** cRSID_createSIDchip (SID.c:25-39). */
+export declare function cRSID_createSIDchip(C64: CRC64instance, SID: CRSIDinstance, model: number, channel: number, baseaddress: number): void;
+/** cRSID_initSIDchip (SID.c:41-56). */
+export declare function cRSID_initSIDchip(_C64: CRC64instance, SID: CRSIDinstance): void;
+/** cRSID_emulateHQresampledSID (SID.c:58-64).
+ *  ('Paused' segfault-guard comment omitted: the TS port has no audio-thread
+ *  race; see the C source for the original guard.) */
+export declare function cRSID_emulateHQresampledSID(C64: CRC64instance, SID: CRSIDinstance, cycles: number): number;
+//# sourceMappingURL=sid.d.ts.map

package/dist/sid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sid.d.ts","sourceRoot":"","sources":["../src/sid.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAkB,MAAM,eAAe,CAAC;AAKlF,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED;2BAC2B;AAC3B,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3D;AASD,yCAAyC;AACzC,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,IAAI,CAcN;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAgB/E;AAED;;sDAEsD;AACtD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAI1G"}

package/dist/sid.js

@@ -0,0 +1,78 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Ported from: cRSID 1.58 libcRSID/C64/SID.c — SID emulation engine core.
+// (c) Hermit (Mihaly Horvath), license: WTF ("do what the frick you want").
+import { CRMemAddresses } from './c64types.js';
+import { cRSID_emulateHQwaves } from './sidoscwaves.js';
+import { cRSID_emulateHQresampledSIDoutputStage } from './sidoutputs.js';
+/** cRSID_getSIDbase (SID.c:6-8). */
+export function cRSID_getSIDbase(sidNumber) {
+    return cRSID_C64ref().SID[sidNumber].BaseAddress;
+}
+/** cRSID_getSIDmodel (SID.c:10-12). */
+export function cRSID_getSIDmodel(sidNumber) {
+    return cRSID_C64ref().SID[sidNumber].ChipModel;
+}
+/** cRSID_setSIDmodel (SID.c:13-15). */
+export function cRSID_setSIDmodel(C64, sidNumber, value) {
+    return (C64.SID[sidNumber].ChipModel = value);
+}
+/** cRSID_getSIDchannel (SID.c:17-19) — channel in stereo field
+ *  (left/right/middle). */
+export function cRSID_getSIDchannel(sidNumber) {
+    return cRSID_C64ref().SID[sidNumber].Channel;
+}
+/** cRSID_getSIDlevel (SID.c:21-23). */
+export function cRSID_getSIDlevel(sidNumber) {
+    return cRSID_C64ref().SID[sidNumber].Level;
+}
+/** Private-global access helper for the read-only getters above
+ *  (C reads the file-global cRSID_C64 directly). */
+import { cRSID_C64 } from './instance.js';
+function cRSID_C64ref() {
+    return cRSID_C64;
+}
+/** cRSID_createSIDchip (SID.c:25-39). */
+export function cRSID_createSIDchip(C64, SID, model, channel, baseaddress) {
+    SID.ChipModel = model;
+    SID.Channel = channel;
+    if (baseaddress >= 0xd400 && (baseaddress < 0xd800 || (0xde00 <= baseaddress && baseaddress <= 0xdfe0))) {
+        // check valid address, avoid Color-RAM
+        SID.BaseAddress = baseaddress;
+        SID.BasePtr = baseaddress;
+        SID.BasePtrRD = baseaddress;
+    }
+    else {
+        SID.BaseAddress = 0x0000;
+        SID.BasePtr = CRMemAddresses.CRSID_SID_SAFE_ADDRESS;
+        SID.BasePtrRD = CRMemAddresses.CRSID_SID_SAFE_ADDRESS;
+    } // NULL-ing not preferred as it can cause Segfault in sample-thread
+    cRSID_initSIDchip(C64, SID); // (and guarding against NULL BasePtr would take some precious cycles in SID-emulation functions)
+}
+/** cRSID_initSIDchip (SID.c:41-56). */
+export function cRSID_initSIDchip(_C64, SID) {
+    for (let Channel = 0; Channel < 21; Channel += 7) {
+        SID.ADSRstate[Channel] = 0;
+        SID.RateCounter[Channel] = 0;
+        SID.EnvelopeCounter[Channel] = 0;
+        SID.ExponentCounter[Channel] = 0;
+        SID.PhaseAccu[Channel] = 0;
+        SID.PrevPhaseAccu[Channel] = 0;
+        SID.NoiseLFSR[Channel] = 0x7fffff;
+        SID.PrevWavGenOut[Channel] = 0;
+        SID.PrevWavData[Channel] = 0;
+        SID.PrevSounDemonDigiWF[Channel] = 0x00;
+    }
+    SID.SyncSourceMSBrise = 0;
+    SID.RingSourceMSB = 0;
+    SID.PrevLowPass = SID.PrevBandPass = SID.PrevVolume = 0;
+}
+/** cRSID_emulateHQresampledSID (SID.c:58-64).
+ *  ('Paused' segfault-guard comment omitted: the TS port has no audio-thread
+ *  race; see the C source for the original guard.) */
+export function cRSID_emulateHQresampledSID(C64, SID, cycles) {
+    const waves = cRSID_emulateHQwaves(C64, SID, cycles);
+    SID.Output = cRSID_emulateHQresampledSIDoutputStage(C64, SID, waves); // * SID->Volume;
+    return SID.Output;
+}
+//# sourceMappingURL=sid.js.map

package/dist/sid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sid.js","sourceRoot":"","sources":["../src/sid.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,sDAAsD;AACtD,0EAA0E;AAC1E,4EAA4E;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,sCAAsC,EAAE,MAAM,iBAAiB,CAAC;AAEzE,oCAAoC;AACpC,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,WAAW,CAAC;AACpD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAAC,GAAkB,EAAE,SAAiB,EAAE,KAAa;IACpF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;AACjD,CAAC;AAED;2BAC2B;AAC3B,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,OAAO,CAAC;AAChD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,YAAY,EAAE,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,KAAK,CAAC;AAC9C,CAAC;AAED;oDACoD;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,SAAS,YAAY;IACnB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,mBAAmB,CACjC,GAAkB,EAClB,GAAkB,EAClB,KAAa,EACb,OAAe,EACf,WAAmB;IAEnB,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC;IACtB,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,WAAW,IAAI,MAAM,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,MAAM,IAAI,WAAW,IAAI,WAAW,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC;QACxG,uCAAuC;QACvC,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;QAC9B,GAAG,CAAC,OAAO,GAAG,WAAW,CAAC;QAC1B,GAAG,CAAC,SAAS,GAAG,WAAW,CAAC;IAC9B,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC;QACzB,GAAG,CAAC,OAAO,GAAG,cAAc,CAAC,sBAAsB,CAAC;QACpD,GAAG,CAAC,SAAS,GAAG,cAAc,CAAC,sBAAsB,CAAC;IACxD,CAAC,CAAC,mEAAmE;IACrE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,iGAAiG;AAChI,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,iBAAiB,CAAC,IAAmB,EAAE,GAAkB;IACvE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;QAClC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC/B,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7B,GAAG,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC1B,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC;IACtB,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,YAAY,GAAG,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED;;sDAEsD;AACtD,MAAM,UAAU,2BAA2B,CAAC,GAAkB,EAAE,GAAkB,EAAE,MAAc;IAChG,MAAM,KAAK,GAAmB,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACrE,GAAG,CAAC,MAAM,GAAG,sCAAsC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,iBAAiB;IACvF,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC"}

package/dist/sidadsr.d.ts

@@ -0,0 +1,9 @@
+import type { CRC64instance, CRSIDinstance } from './c64types.js';
+/** cRSID_ADSR_DAC_6581 (SID_ADSR.c:3-19) — used at output of ADSR envelope
+ *  generator (not used for wave-generator because of 8bit-only resolution). */
+export declare const cRSID_ADSR_DAC_6581: Uint8Array;
+/** cRSID_emulateADSRs (SID_ADSR.c:51-89).
+ *  C uses function-static PrevGate/AD/SR variables; they are write-before-read
+ *  in every call so they are locals here (same semantics, no cross-call state). */
+export declare function cRSID_emulateADSRs(_C64: CRC64instance, SID: CRSIDinstance, cycles: number): void;
+//# sourceMappingURL=sidadsr.d.ts.map

package/dist/sidadsr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidadsr.d.ts","sourceRoot":"","sources":["../src/sidadsr.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGlE;+EAC+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,UAiBhC,CAAC;AA8BH;;mFAEmF;AACnF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAkDhG"}

package/dist/sidadsr.js

@@ -0,0 +1,105 @@
+// SPDX-License-Identifier: BSD-3-Clause
+// Copyright (c) 2026 Bitti09 — modplayjs contributors
+// Ported from: cRSID 1.58 libcRSID/C64/SID_ADSR.c — ADSR envelope emulation.
+// (c) Hermit (Mihaly Horvath), license: WTF ("do what the frick you want").
+import { cRSID_C64 } from './instance.js';
+/** cRSID_ADSR_DAC_6581 (SID_ADSR.c:3-19) — used at output of ADSR envelope
+ *  generator (not used for wave-generator because of 8bit-only resolution). */
+export const cRSID_ADSR_DAC_6581 = new Uint8Array([
+    0x00, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x09, 0x09, 0x0b, 0x0b, 0x0d, 0x0d, 0x0f, 0x10, 0x12,
+    0x11, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18, 0x1a, 0x1a, 0x1c, 0x1c, 0x1e, 0x1e, 0x20, 0x21, 0x23,
+    0x21, 0x23, 0x24, 0x25, 0x26, 0x27, 0x28, 0x2a, 0x2a, 0x2c, 0x2c, 0x2e, 0x2e, 0x30, 0x31, 0x33,
+    0x32, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x3b, 0x3b, 0x3d, 0x3d, 0x3f, 0x3f, 0x41, 0x42, 0x44,
+    0x40, 0x42, 0x42, 0x44, 0x44, 0x46, 0x47, 0x49, 0x49, 0x4a, 0x4b, 0x4d, 0x4d, 0x4f, 0x50, 0x52,
+    0x51, 0x53, 0x53, 0x55, 0x55, 0x57, 0x58, 0x5a, 0x5a, 0x5b, 0x5c, 0x5e, 0x5e, 0x60, 0x61, 0x63,
+    0x61, 0x62, 0x63, 0x65, 0x65, 0x67, 0x68, 0x6a, 0x69, 0x6b, 0x6c, 0x6e, 0x6e, 0x70, 0x71, 0x73,
+    0x72, 0x73, 0x74, 0x76, 0x76, 0x78, 0x79, 0x7b, 0x7a, 0x7c, 0x7d, 0x7f, 0x7f, 0x81, 0x82, 0x84,
+    0x7b, 0x7d, 0x7e, 0x80, 0x80, 0x82, 0x83, 0x85, 0x84, 0x86, 0x87, 0x89, 0x89, 0x8b, 0x8c, 0x8d,
+    0x8c, 0x8e, 0x8f, 0x91, 0x91, 0x93, 0x94, 0x96, 0x95, 0x97, 0x98, 0x9a, 0x9a, 0x9c, 0x9d, 0x9e,
+    0x9c, 0x9e, 0x9f, 0xa1, 0xa1, 0xa3, 0xa4, 0xa5, 0xa5, 0xa7, 0xa8, 0xaa, 0xaa, 0xac, 0xac, 0xae,
+    0xad, 0xaf, 0xb0, 0xb2, 0xb2, 0xb4, 0xb5, 0xb6, 0xb6, 0xb8, 0xb9, 0xbb, 0xbb, 0xbd, 0xbd, 0xbf,
+    0xbb, 0xbd, 0xbe, 0xc0, 0xc0, 0xc2, 0xc2, 0xc4, 0xc4, 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xcb, 0xcd,
+    0xcc, 0xce, 0xcf, 0xd1, 0xd1, 0xd3, 0xd3, 0xd5, 0xd5, 0xd7, 0xd8, 0xd9, 0xda, 0xdb, 0xdc, 0xde,
+    0xdc, 0xde, 0xdf, 0xe1, 0xe1, 0xe3, 0xe3, 0xe5, 0xe5, 0xe7, 0xe8, 0xe9, 0xea, 0xeb, 0xec, 0xee,
+    0xed, 0xef, 0xf0, 0xf2, 0xf2, 0xf4, 0xf4, 0xf6, 0xf6, 0xf8, 0xf9, 0xfa, 0xfb, 0xfc, 0xfd, 0xff,
+]);
+// Specs (SID_ADSR.c:22-27)
+const SID_CHANNEL_SPACING = 7;
+const SID_CHANNEL_COUNT = 3;
+const CHANNEL2_INDEX = 2 * SID_CHANNEL_SPACING;
+const SID_CHANNELS_RANGE = SID_CHANNEL_SPACING * SID_CHANNEL_COUNT;
+void SID_CHANNEL_COUNT;
+void CHANNEL2_INDEX;
+// ADSRstateBits (SID_ADSR.c:28)
+const GATE_BITVAL = 0x01, ATTACK_BITVAL = 0x80, DECAYSUSTAIN_BITVAL = 0x40, HOLDZEROn_BITVAL = 0x10;
+/** ADSRprescalePeriods (SID_ADSR.c:30-33). */
+const ADSRprescalePeriods = new Int16Array([
+    9, 32, 63, 95, 149, 220, 267, 313, 392, 977, 1954, 3126, 3907, 11720, 19532, 31251,
+]);
+/** ADSRexponentPeriods (SID_ADSR.c:34-49) — pos0:1 pos6:30 pos14:16 pos26:8
+ *  pos54:4 pos93:2. Regenerated mechanically from the C source (256 entries). */
+const ADSRexponentPeriods = new Uint8Array([
+    1, 30, 30, 30, 30, 30, 30, 16, 16, 16, 16, 16, 16, 16, 16, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 8, 4, 4, 4, 4, 4,
+    4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 4, 2, 2, 2, 2, 2, 2, 2, 2, 2,
+    2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 2, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+    1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,
+]);
+/** cRSID_emulateADSRs (SID_ADSR.c:51-89).
+ *  C uses function-static PrevGate/AD/SR variables; they are write-before-read
+ *  in every call so they are locals here (same semantics, no cross-call state). */
+export function cRSID_emulateADSRs(_C64, SID, cycles) {
+    const W = cRSID_C64.IObankWR;
+    for (let Channel = 0; Channel < SID_CHANNELS_RANGE; Channel += SID_CHANNEL_SPACING) {
+        const ChannelPtr = SID.BasePtr + Channel;
+        const AD = W[ChannelPtr + 5];
+        const SR = W[ChannelPtr + 6];
+        const ADSRstatePtr = Channel;
+        const RateCounterPtr = Channel;
+        const EnvelopeCounterPtr = Channel;
+        const ExponentCounterPtr = Channel;
+        const PrevGate = SID.ADSRstate[ADSRstatePtr] & GATE_BITVAL;
+        if (PrevGate !== (W[ChannelPtr + 4] & GATE_BITVAL)) {
+            // gatebit-change?
+            if (PrevGate)
+                SID.ADSRstate[ADSRstatePtr] &= ~(GATE_BITVAL | ATTACK_BITVAL | DECAYSUSTAIN_BITVAL); // falling edge
+            else
+                SID.ADSRstate[ADSRstatePtr] = GATE_BITVAL | ATTACK_BITVAL | DECAYSUSTAIN_BITVAL | HOLDZEROn_BITVAL; // rising edge
+        }
+        let PrescalePeriod;
+        if (SID.ADSRstate[ADSRstatePtr] & ATTACK_BITVAL)
+            PrescalePeriod = ADSRprescalePeriods[AD >> 4];
+        else if (SID.ADSRstate[ADSRstatePtr] & DECAYSUSTAIN_BITVAL)
+            PrescalePeriod = ADSRprescalePeriods[AD & 0x0f];
+        else
+            PrescalePeriod = ADSRprescalePeriods[SR & 0x0f];
+        SID.RateCounter[RateCounterPtr] += cycles;
+        if (SID.RateCounter[RateCounterPtr] >= 0x8000)
+            SID.RateCounter[RateCounterPtr] -= 0x8000; // can wrap around (ADSR delay-bug: short 1st frame)
+        if (PrescalePeriod <= SID.RateCounter[RateCounterPtr] && SID.RateCounter[RateCounterPtr] < PrescalePeriod + cycles) {
+            // ratecounter shot (matches rateperiod) (in genuine SID ratecounter is LFSR)
+            SID.RateCounter[RateCounterPtr] -= PrescalePeriod; // reset rate-counter on period-match
+            if ((SID.ADSRstate[ADSRstatePtr] & ATTACK_BITVAL) ||
+                ++SID.ExponentCounter[ExponentCounterPtr] === ADSRexponentPeriods[SID.EnvelopeCounter[EnvelopeCounterPtr]]) {
+                SID.ExponentCounter[ExponentCounterPtr] = 0;
+                if (SID.ADSRstate[ADSRstatePtr] & HOLDZEROn_BITVAL) {
+                    if (SID.ADSRstate[ADSRstatePtr] & ATTACK_BITVAL) {
+                        ++SID.EnvelopeCounter[EnvelopeCounterPtr];
+                        if (SID.EnvelopeCounter[EnvelopeCounterPtr] === 0xff)
+                            SID.ADSRstate[ADSRstatePtr] &= ~ATTACK_BITVAL;
+                    }
+                    else if (!(SID.ADSRstate[ADSRstatePtr] & DECAYSUSTAIN_BITVAL) ||
+                        SID.EnvelopeCounter[EnvelopeCounterPtr] !== (SR & 0xf0) + (SR >> 4)) {
+                        --SID.EnvelopeCounter[EnvelopeCounterPtr]; // resid adds 1 cycle delay, we omit that mechanism here
+                        if (SID.EnvelopeCounter[EnvelopeCounterPtr] === 0)
+                            SID.ADSRstate[ADSRstatePtr] &= ~HOLDZEROn_BITVAL;
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=sidadsr.js.map

package/dist/sidadsr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidadsr.js","sourceRoot":"","sources":["../src/sidadsr.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,sDAAsD;AACtD,6EAA6E;AAC7E,4EAA4E;AAG5E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C;+EAC+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAe,IAAI,UAAU,CAAC;IAC5D,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;IAC9F,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CAC/F,CAAC,CAAC;AAEH,2BAA2B;AAC3B,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAC5B,MAAM,cAAc,GAAG,CAAC,GAAG,mBAAmB,CAAC;AAC/C,MAAM,kBAAkB,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AACnE,KAAK,iBAAiB,CAAC;AAAC,KAAK,cAAc,CAAC;AAE5C,gCAAgC;AAChC,MAAM,WAAW,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,EAAE,mBAAmB,GAAG,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;AAEpG,8CAA8C;AAC9C,MAAM,mBAAmB,GAAe,IAAI,UAAU,CAAC;IACrD,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;CACnF,CAAC,CAAC;AAEH;iFACiF;AACjF,MAAM,mBAAmB,GAAe,IAAI,UAAU,CAAC;IACrD,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC5G,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9F,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9F,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC9F,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAA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"}

package/dist/sidoscwaves.d.ts

@@ -0,0 +1,15 @@
+import type { CRC64instance, CRSIDinstance, CRSIDwavOutput } from './c64types.js';
+/**
+ * cRSID_emulateSID_light (SID_OscWaves.c:37-260) — lightweight (samplerate-
+ * paced) oscillator + waveform generation; calls the output stage at the end
+ * and returns the SID's master output.
+ *
+ * C static locals TestBit/Envelope/Steepness/PulsePeak are
+ * write-before-read per use — locals here (same semantics).
+ */
+export declare function cRSID_emulateSID_light(C64: CRC64instance, SID: CRSIDinstance): number;
+/** cRSID_emulateHQwaves (SID_OscWaves.c:281-445).
+ *  C static locals TestBit/Envelope/SIDwavOutput are write-before-read per
+ *  call — SIDwavOutput is returned, TestBit/Envelope are locals here. */
+export declare function cRSID_emulateHQwaves(C64: CRC64instance, SID: CRSIDinstance, cycles: number): CRSIDwavOutput;
+//# sourceMappingURL=sidoscwaves.d.ts.map

package/dist/sidoscwaves.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidoscwaves.d.ts","sourceRoot":"","sources":["../src/sidoscwaves.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAmGlF;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CA4LrF;AAyCD;;yEAEyE;AACzE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAiK3G"}