Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.13.0 - 2025-02-28

Added

Support resolving multiple files wrapped by functions or promises
Add support for loading FileSystemFileHandle directly, close #52
Better name detecting strategy for files, fix #53
Add a new static method

Fixed

Add the missing await to avoid launching failures
Do not overwrite passed file name unexpectedly
Fix Response inside an object not being loaded
Improve types for resolvable files

0.12.1 - 2025-01-29

Fixed

Fix types of resolvable files are not correctly detected
Fix type declarations of resolvers in the parameter of Nostalgist.launch

0.12.0 - 2025-01-28

Added

Support loading resolvable files from parameters
Add support for saving and importing SRAM
Update default retroarch-emscripten-build version to v1.20.0

Fixed

Fix the exit method not working

0.11.0 - 2024-08-16

Fixed

fix the crash when AL and Browser are not accessible
improve the type declaration for the "rom" argument of the "launch" method

Changed

remove redundant dependencies
remove getBrowserFS

0.10.0 - 2024-07-24

Changed

update default retroarch-emscripten-build version to v1.19.1
add getEmscripten and getEmscriptenAL

0.9.2 - 2024-03-15

Fixed

fix the error when launching with a malformed link

0.9.1 - 2024-03-05

Fixed

better options merging strategy
improve ESM detection
register the exit process when cancelling after a real launch

0.9.0 - 2024-03-04

Added

add support for cancelling a launch via an AbortController
add beforeLaunch and onLaunch parameters to allow us to hook into the launching process
add getBrowserFS method for accessing the corresponding BFSEmscriptenFS object of the emulator
add a new method sendCommand for sending commands to RetroArch
add support for launching with an initial state

0.8.1 - 2024-02-24

Fixed

fix passing a custom canvas element not working properly

0.8.0 - 2024-02-07

Changed

update default retroarch-emscripten-build version to v1.17.0
disable some default inputs in RetroArch
when some of the passed config items are objects, like retroarchConfig, they will be merged with the default items instead of overwriting the default items entirely

Fixed

fix export name when using ESM build of retroarch

0.7.0 - 2024-01-28

Added

add support for shaders

Fixed

fix BIOS files not written to the system directory

0.6.0 - 2024-01-13

Added

add a new screenshot method (fa8fd06)
treat data url and blob url as absolute (ce4aed6)

0.5.1 - 2023-11-07

Fixed

fix canvas size (eb2d985)

0.5.0 - 2023-11-06

Added

add support for RetroArch nightly ESM builds, fix #10 (3cfeaa6)

0.4.2 - 2023-10-16

Fixed

fix a possible failure when writing config files (ee924cf)

0.4.1 - 2023-10-15

Fixed

fix bios not working properly (94824b5)
fix error while exiting and styles are not updated (546f24a)
fix misc small issues (a0a9546)

Added

add a new option emscriptenModule (ee2bbd5)
add some new methods about pressing button programmatically (46a9426)
expose vendors (04ccafd)

0.4.0 - 2023-10-15

Fixed

fix bios not working properly (adb9637)
fix misc small issues (43dba6f)

Added

add a new option emscriptenModule (24885e6)
add some new methods about pressing button programmatically (d46e453)
expose vendors (71bb325)

0.3.1 - 2023-10-12

Fixed

update default styles (6cc7b08)

0.3.0 - 2023-10-12

Added

implement the option retroarchCoreConfig (6ed2e7c)
shortcut methods now support File and { fileName, fileContent } as parameter (4da61ac)

0.2.0 - 2023-10-11

Added

add a new option respondToGlobalEvents (e541a96)
add support for setting style, update default style (afca83b)

0.1.7 - 2023-10-08

Added

add a removeCanvas option to exit method (c474fbc)
add support for setting custom initial size (21146fd)

0.1.6 - 2023-10-08

Fixed

fix static property (3b1170b)

0.1.5 - 2023-10-08

Fixed

fix core loading (9790327)