js-dos 8.3.20 → 8.4.1

package/.codex

@@ -0,0 +1,5 @@
+After making code changes, always run:
+
+    yarn run eslint src --ext ts,tsx --fix
+
+Make sure the command passes before considering the task complete.

package/{ChangeLog.md → CHANGELOG.md}

@@ -4,6 +4,46 @@ Note that version numbers do not necessarily reflect the amount of changes betwe
 
 Not all changes are documented here. To examine the full set of changes between versions, you can use git to browse the changes between the tags.
 
+8.4.1 - 13.07.2026
+------------------
+
+* Improve sockdrive in direct mode
+* Fix for #303
+* Fix for #310
+* Fix for #426
+
+
+8.4.0 - 19.06.2026
+------------------
+
+* Updated emulators to 8.4.0
+* Added full 3Dfx acceleration support in browser through WebGL-backed rendering
+* Replaced HumbleNet with WebRTC-NET for browser networking and IPX multiplayer
+* Added support for shared network instances
+* Added support for starting an IPX server and connecting to an IPX address
+* Added audioWorklet mode
+* Added experimental JSPI backend support
+* Added sockdrive preload modes and improved sockdrive persist handling
+* Improved sockdrive range loading reliability
+* Added information about GLFX status
+* Added support for background rendering (disabled by default)
+* Replaced IndexedDB storage with OPFS for bundles and local filesystem changes
+* Removed auth/cloud code and added fsChanges hooks for custom save storage
+* Added OPFS explorer and storage usage statistics
+* Added turbo frame with CPU metrics, speed, cycles, fast forward and frame skip controls
+* Added support for fast forward during boot
+* Added special keys UI for Alt+Tab and Ctrl+Alt+Del
+* Added Simplified Chinese language
+* Added support for right mouse button on Bluetooth mice
+* Improved pointer events handling and pointer lock with unadjusted movement fallback
+* Fixed long mouse click handling with pointer events
+* Fixed Pause key handling
+* Applied initFs even when url is set
+* Disabled speed control when CPU auto-adjust is deselected
+* Updated WebAssembly build tooling to Emscripten SDK 5.0.2 and Node.js 22.x
+* Removed custom Binaryen override from the build workflow
+* Updated deployment documentation and Brotli packaging script
+
 8.3.20 - 31.05.2025
 -------------------
 
@@ -49,4 +89,4 @@ Not all changes are documented here. To examine the full set of changes between
 * Implement `fsDeleteFile` - able to delete files and folders
 * Emulators compiled with Emscripten 4.0.2
 * js-dos now automatically switch to dark mode if it’s enabled in your system.
-* Various UI/UX improvements
+* Various UI/UX improvements

package/README.deployment.md

@@ -13,7 +13,7 @@ rm -rf /tmp/$VERSION
 ## Release version
 
 ```
-rm -rf build && \
+rm -rf dist && \
     yarn run vite build --base /latest --sourcemap true --minify terser && \
     aws s3 --endpoint-url=https://storage.yandexcloud.net sync --acl public-read \
     dist s3://jsdos/latest --delete 
@@ -26,15 +26,44 @@ Clear the CDN cache (v8.js-dos.com) in dashboard, pattern:
 
 ## DOS.Zone (early access) version
 
+
+### Move latest version to named version
+
+```sh
+VERSION=<version-number>
+mkdir /tmp/$VERSION
+aws s3 --endpoint-url=https://storage.yandexcloud.net sync s3://br-bundles/js-dos/latest /tmp/$VERSION
+aws s3 --endpoint-url=https://storage.yandexcloud.net sync --acl public-read /tmp/$VERSION s3://br-bundles/js-dos/8.xx/$VERSION
+rm -rf /tmp/$VERSION
+```
+
+### Deploy new one
 ```
-rm -rf build && \
+rm -rf dist && \
     yarn run vite build --base /js-dos/latest --sourcemap true --minify terser && \
+    rm dist/emulators/sockdrive* && \
     python scripts/brotli-dist.py && \
     aws s3 --endpoint-url=https://storage.yandexcloud.net sync --acl public-read \
-    dist s3://br-bundles/js-dos/latest --delete 
+    dist s3://br-bundles/js-dos/latest
 ```
 
 Clear the CDN cache (br.cdn.js-dos.com) in dashboard, pattern:
 ```
 /js-dos/latest,/js-dos/latest/*
+```
+
+### Deploy nigthly
+
+```
+rm -rf dist && \
+    yarn run vite build --base /js-dos/nightly --sourcemap true --minify terser && \
+    rm dist/emulators/sockdrive* && \
+    python scripts/brotli-dist.py && \
+    aws s3 --endpoint-url=https://storage.yandexcloud.net sync --acl public-read \
+    dist s3://br-bundles/js-dos/nightly --delete 
+```
+
+Clear the CDN cache (br.cdn.js-dos.com) in dashboard, pattern:
+```
+/js-dos/nightly,/js-dos/nightly/*
 ```

package/README.md

@@ -1,28 +1,46 @@
-# js-dos v8
+# js-dos
 [![Build](https://github.com/caiiiycuk/js-dos/actions/workflows/build.yml/badge.svg?branch=8.xx)](https://github.com/caiiiycuk/js-dos/actions/workflows/build.yml)
 
-The simplest API to run **DOS/Win** 9x programs in browser or node. js-dos provides full-featured DOS player that can be easily installed and used to get your DOS program up
-and running in browser quickly. js-dos provide many advanced features like multiplayer and cloud storage. All available features are enabled for any integration and free.
+The simplest API to run **DOS/Win 9x** programs in browser or node.
+
+js-dos is a frontend for [emulators](https://github.com/caiiiycuk/emulators) that provides nice UI and infrastructure
+to run DOS or Windows programs in browser.
+
+It provides full-featured **DOS player** that can be easily installed and used to get your DOS program up and running in
+browser quickly. js-dos provides many advanced features like multiplayer, save/load, and large disk streaming.
+All available features are enabled for any integration and free.
+
+The unique capabilities:
+* The only browser solution with accelerated [**3Dfx**](https://js-dos.com/3dfx.html) rendering through a WebGL-backed renderer
+* Full [**IPX** networking](https://js-dos.com/networking.html) stack in browser, powered by WebRTC-NET, with IPX server creation, direct
+  peer/alias connections, and shared network instances
+* **Windows 9x** support through DOSBox-X, including prebuilt Windows 95/98 system images and support for Windows games
+  with DirectX and 3Dfx drivers
+* **Sockdrive V2** for large disk images: backendless streaming drives, preload modes, and improved persistence handling
+* Modern local persistence based on **OPFS**, with local filesystem changes, storage usage information, and `fsChanges`
+  hooks for custom save storage
 
 The key features:
 * Works in **worker** or render thread
 * Support execution in Node and Browsers
 * Multiple backends: DOSBox, DOSBox-X
 * Mobile support (v8 - WIP, v7 - production)
-* Able to run very big games (like Diablo, etc.)
+* Able to run huge games (like Diablo, etc.)
 * Multiplayer support
-* Cloud storage
+* Save/load support with local persistence and custom storage integrations
 * WebAssembly and pure JS versions
-  
+* AudioWorklet mode and experimental JSPI backend support
+* [Turbo controls](https://js-dos.com/turbo.html) with CPU metrics, speed, cycles, fast forward, and frame skip controls
+
+> If you want to build custom DOS player, then please use [emulators](https://js-dos.com/threejs.html) packages instead.
+
 ## Demo
 
-* [Win 95](https://v8.js-dos.com) - plain Windows 95 with D3D & 3Dfx
 * [DOS.Zone](https://dos.zone) - community portal with 1900+ dos games
-* [Multiplayer](https://dos.zone/multiplayer) - multiplayer games (Doom, Heroes 2, etc.)
-* [Dune 2000](https://dos.zone/dune-2000/)
-* [Diablo I](https://dos.zone/diablo-1996/)
- 
-[![Watch the video](https://github.com/caiiiycuk/js-dos/assets/1727152/a2b481cb-43b1-44aa-8b71-2181d351bb1a)](https://youtu.be/lhFrAe5YrJE)
+* [3Dfx](https://dos.zone/3dfx/)
+* [Multiplayer](https://dos.zone/mp)
+* [NFS](https://dos.zone/the-need-for-speed-sep-1995/)
+* [Age Of Empries II](https://dos.zone/age-of-empires2/)
 
 ## Documentation
 
@@ -33,20 +51,15 @@ The key features:
 
 ## Support
 
-If you enjoy using js-dos, we would greatly appreciate your support through subscribing to our [js-dos subscription](https://v8.js-dos.com/key/). 
-By subscribing, you not only enhance your own experience with exclusive benefits but also contribute to the continued development 
-and maintenance of our platform. Your subscription helps us grow and provide even better services to all our valued users.
-
-Alternatively you can do one time donation:
-
-| [Visa / MasterCard / МИР](https://pay.cloudtips.ru/p/894f907b)  | [Buy Me A Coffee!](https://buymeacoffee.com/caiiiycuk) | 
-|-----------------------------------------------------------------|--------------------------------------------------------|
-| ![CloudTips](https://cdn.dos.zone/custom/qr/cloud_tips_256.png) | ![BMC](https://cdn.dos.zone/custom/qr/bmc_qr_256.png)  |
-
+| [Subscription / Подписка](https://cloudsdk.dev/)                                   | [Visa / MasterCard / МИР](https://pay.cloudtips.ru/p/894f907b) | [Buy Me A Coffee!](https://buymeacoffee.com/caiiiycuk) |
+|------------------------------------------------------------------------------------|-----------------------------------------------------------------|--------------------------------------------------------|
+| <img src="https://dos.zone/assets/qr-jsdos.png" alt="js-dos qr code" width="128" /> | <img src="https://cdn.dos.zone/custom/qr/cloud_tips_256.png" alt="cloud tips qr code" width="128" /> | <img src="https://cdn.dos.zone/custom/qr/bmc_qr_256.png" alt="bmc qr code" width="128" /> |
+| js-dos                                                                             | Cloud Tips                                                      | @caiiiycuk                                             |
 
-| BTC                                                    | ETH                                                   | 
-|--------------------------------------------------------|-------------------------------------------------------|
-| ![BTC](https://cdn.dos.zone/custom/qr/btc_pub_256.png) | ![ETH](https://cdn.dos.zone/custom/qr/eth-qr_256.png) |
+| BTC | ETH |
+|-----|-----|
+| <img src="https://cdn.dos.zone/custom/qr/btc_pub_256.png" alt="btc qr code" width="128" /> | <img src="https://cdn.dos.zone/custom/qr/eth-qr_256.png" alt="eth qr code" width="128" /> |
+| 1EngssY81sziuQyb9JGXURG3WDajyC8kW6 | 0x54FEBE29Cd700f88468032b33c33CdcD7c7cCa53 |
 
 
 ## Development