js-dos 8.4.0 → 8.5.0

package/dist/emulators/types/dos/dosbox/ts/audio-worklet.d.ts

@@ -1 +1,2 @@
 export declare function createAudioPort(): Promise<MessagePort | undefined>;
+export declare const audioWorkletCode = "\nclass SampleRing {\n    constructor(capacity) {\n        this.samples = new Float32Array(capacity);\n        this.readPosition = 0;\n        this.writePosition = 0;\n        this.samplesCount = 0;\n    }\n\n    clear() {\n        this.readPosition = 0;\n        this.writePosition = 0;\n        this.samplesCount = 0;\n    }\n\n    length() {\n        return this.samplesCount;\n    }\n\n    push(sample) {\n        if (this.samplesCount === this.samples.length) {\n            this.discard(1);\n        }\n        this.samples[this.writePosition] = sample;\n        this.writePosition = (this.writePosition + 1) % this.samples.length;\n        this.samplesCount++;\n    }\n\n    pushArray(samples) {\n        for (let i = 0; i < samples.length; ++i) {\n            this.push(samples[i]);\n        }\n    }\n\n    peek(offset) {\n        return this.samples[(this.readPosition + offset) % this.samples.length];\n    }\n\n    shift() {\n        const sample = this.peek(0);\n        this.discard(1);\n        return sample;\n    }\n\n    discard(count) {\n        count = Math.min(count, this.samplesCount);\n        this.readPosition = (this.readPosition + count) % this.samples.length;\n        this.samplesCount -= count;\n    }\n}\n\nclass Processor extends AudioWorkletProcessor {\n    constructor() {\n        super();\n        this.outputRate = sampleRate;\n        this.sourceRate = sampleRate;\n        this.targetFrames = Math.max(1024, Math.round(this.outputRate * 2048 / 44100));\n        this.maxFrames = this.targetFrames * 4;\n        this.frameSize = 512;\n        this.hopSize = this.frameSize / 2;\n        this.searchSize = 64;\n        this.sourceQueue = new SampleRing(this.maxFrames * 4);\n        this.queue = new SampleRing(this.maxFrames);\n        this.outputQueue = new SampleRing(this.frameSize * 4);\n        this.tail = new Float32Array(this.hopSize);\n        this.sourcePosition = 0;\n        this.tempo = 1;\n        this.analysisDebt = 0;\n        this.started = false;\n        this.haveTail = false;\n        this.lastOutput = 0;\n\n        this.port.onmessage = (event) => {\n            const message = event.data;\n            if (message instanceof Float32Array) {\n                this.sourceQueue.pushArray(message);\n                this.resampleInput();\n            } else if (message && message.type === \"init\") {\n                this.initialize(message.sourceRate);\n            }\n        };\n    }\n\n    initialize(sourceRate) {\n        this.sourceRate = sourceRate > 0 ? sourceRate : this.outputRate;\n        this.sourceQueue.clear();\n        this.queue.clear();\n        this.outputQueue.clear();\n        this.sourcePosition = 0;\n        this.tempo = 1;\n        this.analysisDebt = 0;\n        this.started = false;\n        this.haveTail = false;\n        this.lastOutput = 0;\n    }\n\n    resampleInput() {\n        const step = this.sourceRate / this.outputRate;\n        while (this.sourcePosition + 1 < this.sourceQueue.length()) {\n            const index = Math.floor(this.sourcePosition);\n            const fraction = this.sourcePosition - index;\n            const first = this.sourceQueue.peek(index);\n            const second = this.sourceQueue.peek(index + 1);\n            this.queue.push(first + (second - first) * fraction);\n            this.sourcePosition += step;\n        }\n\n        const consumed = Math.floor(this.sourcePosition);\n        if (consumed > 0) {\n            this.sourceQueue.discard(consumed);\n            this.sourcePosition -= consumed;\n        }\n    }\n\n    prepareFirstFrame() {\n        if (this.queue.length() < this.frameSize) {\n            return false;\n        }\n        for (let i = 0; i < this.hopSize; ++i) {\n            this.outputQueue.push(this.queue.peek(i) * (i + 1) / this.hopSize);\n            this.tail[i] = this.queue.peek(this.hopSize + i);\n        }\n        this.haveTail = true;\n        return true;\n    }\n\n    updateTempo() {\n        const error = (this.queue.length() - this.targetFrames) / this.targetFrames;\n        const desired = Math.max(0.95, Math.min(1.05, 1 + error * 0.1));\n        const change = Math.max(-0.002, Math.min(0.002, desired - this.tempo));\n        this.tempo += change;\n    }\n\n    findBestFrame(expected) {\n        const minimum = Math.max(1, expected - this.searchSize);\n        const maximum = Math.min(\n            expected + this.searchSize,\n            this.queue.length() - this.frameSize,\n        );\n        if (maximum < minimum) {\n            return -1;\n        }\n\n        let bestPosition = Math.min(expected, maximum);\n        let bestScore = Number.POSITIVE_INFINITY;\n        for (let position = minimum; position <= maximum; ++position) {\n            let difference = 0;\n            for (let i = 0; i < this.hopSize; i += 4) {\n                const delta = this.tail[i] - this.queue.peek(position + i);\n                difference += delta * delta;\n            }\n            const distancePenalty = Math.abs(position - expected) * 0.002;\n            const score = difference + distancePenalty;\n            if (score < bestScore) {\n                bestScore = score;\n                bestPosition = position;\n            }\n        }\n        return bestPosition;\n    }\n\n    generateFrame() {\n        if (!this.haveTail) {\n            return this.prepareFirstFrame();\n        }\n\n        this.updateTempo();\n        const idealAdvance = this.hopSize * this.tempo;\n        const expected = Math.max(1, Math.round(idealAdvance + this.analysisDebt));\n        const position = this.findBestFrame(expected);\n        if (position < 0) {\n            return false;\n        }\n        this.analysisDebt += idealAdvance - position;\n        this.analysisDebt = Math.max(-this.searchSize, Math.min(this.searchSize, this.analysisDebt));\n\n        this.queue.discard(position);\n        for (let i = 0; i < this.hopSize; ++i) {\n            const mix = i / this.hopSize;\n            const sample = this.tail[i] * (1 - mix) + this.queue.peek(i) * mix;\n            this.outputQueue.push(sample);\n            this.tail[i] = this.queue.peek(this.hopSize + i);\n        }\n        return true;\n    }\n\n    stopForUnderflow() {\n        if (this.haveTail) {\n            this.queue.discard(this.hopSize);\n        }\n        this.started = false;\n        this.haveTail = false;\n        this.outputQueue.clear();\n        this.tempo = 1;\n        this.analysisDebt = 0;\n    }\n\n    writeTo(output) {\n        if (!this.started && this.queue.length() >= this.targetFrames) {\n            this.started = true;\n        }\n\n        while (this.started && this.outputQueue.length() < output.length) {\n            if (!this.generateFrame()) {\n                break;\n            }\n        }\n\n        let written = 0;\n        while (written < output.length && this.outputQueue.length() > 0) {\n            this.lastOutput = this.outputQueue.shift();\n            output[written++] = this.lastOutput;\n        }\n\n        if (written < output.length) {\n            const missing = output.length - written;\n            for (let i = 0; i < missing; ++i) {\n                output[written + i] = this.lastOutput * (1 - (i + 1) / missing);\n            }\n            this.lastOutput = 0;\n            if (this.started) {\n                this.stopForUnderflow();\n            }\n        }\n    }\n\n    bufferedFrames() {\n        return this.queue.length() + this.outputQueue.length();\n    }\n\n    process(inputs, outputs) {\n        const channels = outputs[0];\n        this.writeTo(channels[0]);\n        for (let channel = 1; channel < channels.length; ++channel) {\n            channels[channel].set(channels[0]);\n        }\n        return true;\n    }\n}\n\nregisterProcessor(\"jsdos-audio\", Processor);\n";

package/dist/emulators/types/dos/dosbox/ts/direct.d.ts

@@ -1,3 +1,4 @@
 import { WasmModule } from "../../../impl/modules";
 import { TransportLayer, Net } from "../../../protocol/protocol";
+import "../../../sockdrive/sockdrive";
 export declare function dosDirect(wasmModule: WasmModule, sessionId: string, canvas?: OffscreenCanvas, audioWorklet?: boolean, net?: Net): Promise<TransportLayer>;

package/dist/emulators/types/emulators.d.ts

@@ -15,6 +15,8 @@ export interface BackendOptions {
     canvas?: OffscreenCanvas;
     audioWorklet?: boolean;
     sockdrivePreload?: "all" | "default" | "none";
+    sockdriveOpfsRoot?: string;
+    mcpServerPort?: number;
     net?: Net;
 }
 export type InitBundleEntry = Uint8Array;
@@ -37,8 +39,10 @@ export interface Emulators {
     dosboxWorker: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
     dosboxXNode: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
     dosboxXDirect: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
+    dosboxXJspiDirect: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
     dosboxXWorker: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
     dosboxXJspiWorker: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
+    dosboxXDebugWorker: (init: InitFs, options?: BackendOptions) => Promise<CommandInterface>;
     backend: (init: InitFs, transportLayer: TransportLayer, options?: BackendOptions) => Promise<CommandInterface>;
 }
 export interface CommandInterface {

package/dist/emulators/types/impl/emulators-impl.d.ts

@@ -9,6 +9,7 @@ declare class EmulatorsImpl implements Emulators {
     wdosboxJs: string;
     wdosboxxJs: string;
     wdosboxxJsJspi: string;
+    wdosboxxJsDebug: string;
     private wasmModulesPromise?;
     bundle(): Promise<DosBundle>;
     bundleConfig(bundle: InitBundleEntry): Promise<DosConfig | null>;
@@ -18,8 +19,10 @@ declare class EmulatorsImpl implements Emulators {
     dosboxWorker(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
     dosboxXNode(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
     dosboxXDirect(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
+    dosboxXJspiDirect(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
     dosboxXWorker(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
     dosboxXJspiWorker(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
+    dosboxXDebugWorker(init: InitFs, options?: BackendOptions): Promise<CommandInterface>;
     backend(init: InitFs, transportLayer: TransportLayer, options?: BackendOptions): Promise<CommandInterface>;
     wasmModules(): Promise<IWasmModules>;
     dosDirect(init: InitFs): Promise<CommandInterface>;

package/dist/emulators/types/impl/modules.d.ts

@@ -6,6 +6,7 @@ export interface IWasmModules {
     dosbox: () => Promise<WasmModule>;
     dosboxx: () => Promise<WasmModule>;
     dosboxxJspi: () => Promise<WasmModule>;
+    dosboxxDebug: () => Promise<WasmModule>;
 }
 interface Globals {
     exports: {
@@ -30,16 +31,19 @@ export declare class WasmModulesImpl implements IWasmModules {
     private wdosboxJs;
     private wdosboxxJs;
     private wdosboxxJsJspi;
+    private wdosboxxJsDebug;
     private libzipPromise?;
     private dosboxPromise?;
     private dosboxxPromise?;
     private dosboxxJspiPromise?;
+    private dosboxxDebugPromise?;
     wasmSupported: boolean;
-    constructor(pathPrefix: string, pathSuffix: string, wdosboxJs: string, wdosboxxJs: string, wdosboxxJsJspi: string);
+    constructor(pathPrefix: string, pathSuffix: string, wdosboxJs: string, wdosboxxJs: string, wdosboxxJsJspi: string, wdosboxxJsDebug: string);
     libzip(): Promise<WasmModule>;
     dosbox(): Promise<WasmModule>;
     dosboxx(): Promise<WasmModule>;
     dosboxxJspi(): Promise<WasmModule>;
+    dosboxxDebug(): Promise<WasmModule>;
     private loadModule;
 }
 export declare function loadWasmModule(url: string, moduleName: string, onprogress: (stage: string, total: number, loaded: number) => void): Promise<WasmModule>;

package/dist/emulators/types/protocol/mini-lz4.d.ts

@@ -0,0 +1,3 @@
+export declare const compressBound: any;
+export declare const compress: any;
+export declare const uncompress: any;

package/dist/emulators/types/sockdrive/sockdrive-store.d.ts

@@ -0,0 +1,36 @@
+export interface Store {
+    keys: () => Promise<number[]>;
+    put: (key: number, data: Uint8Array) => Promise<void>;
+    getSync: (key: number) => Uint8Array | null;
+    getAsync: (key: number) => Promise<Uint8Array | null>;
+}
+export declare class NoStore implements Store {
+    store: Map<number, Uint8Array>;
+    put(key: number, data: Uint8Array): Promise<void>;
+    getSync(key: number): Uint8Array | null;
+    getAsync(_: number): Promise<Uint8Array | null>;
+    keys(): Promise<number[]>;
+}
+export declare class OpfsStore implements Store {
+    private dir;
+    private index;
+    private syncMode;
+    private blockHandle;
+    private metaHandle;
+    private blockSize;
+    private metaSize;
+    private blockLength;
+    private metaEntry;
+    private asyncOpPromise;
+    private constructor();
+    static create(url: string, blockLength: number, opfsRoot: string): Promise<OpfsStore>;
+    private init;
+    private loadIndex;
+    keys(): Promise<number[]>;
+    put(key: number, data: Uint8Array): Promise<void>;
+    getSync(key: number): Uint8Array | null;
+    getAsync(key: number): Promise<Uint8Array | null>;
+}
+export declare function getStore(url: string, blockLength: number, opfsRoot: string): Promise<Store>;
+export declare function readUint32(container: Uint8Array, offset: number): number;
+export declare function writeUint32(container: Uint8Array, value: number, offset: number): number;

package/dist/emulators/types/sockdrive/sockdrive.d.ts

@@ -0,0 +1,29 @@
+interface DriveInfo {
+    ahead_read: number;
+    range_count: number;
+    dropped_ranges: number[];
+    preload_ranges: number[] | "_";
+    small_ranges: number[];
+    cylinders: number;
+    heads: number;
+    sectors: number;
+    sector_size: number;
+    size: number;
+    name: string;
+    url: string;
+    preloadSizeInBytes: number;
+    sizeInBytes: number;
+    readInBytes: number;
+    writeInBytes: number;
+}
+export interface Drive {
+    info: DriveInfo;
+    range(sector: number): number;
+    readRangeAsync(range: number): void;
+    ready(): void;
+    write(sector: number, buffer: Uint8Array): void;
+    persist(): Promise<Uint8Array | null>;
+}
+export declare function sockdrive(url: string, persistedSectors: Uint8Array | null, preloadMode: "all" | "default" | "none", _onNewRange: (range: number, buffer: Uint8Array) => void, opfsRoot: string): Promise<Drive>;
+export declare function traverseSockdriveChanges(encoded: Uint8Array, callback: (url: string, changes: Uint8Array) => void): boolean;
+export {};