webamp 1.4.3-beta.5 → 2.0.0

package/package.json

@@ -1,28 +1,45 @@
 {
   "name": "webamp",
-  "version": "1.4.3-beta.5",
+  "version": "2.0.0",
   "description": "Winamp 2 implemented in HTML5 and JavaScript",
-  "main": "built/webamp.bundle.js",
   "files": [
-    "built/webamp.bundle.js",
-    "built/webamp.bundle.min.js",
-    "built/webamp.bundle.min.js.map",
-    "built/webamp.lazy-bundle.js",
-    "built/webamp.lazy-bundle.min.js",
-    "built/webamp.lazy-bundle.min.js.map",
-    "index.d.ts"
+    "built",
+    "!built/types/demo",
+    "!built/*.html",
+    "!built/tsBuilt"
   ],
+  "types": "built/types/js/webamp.d.ts",
+  "browser": "built/webamp.bundle.min.mjs",
+  "browserslist": "> 0.5%, last 2 versions, Firefox ESR, not dead",
+  "targets": {
+    "demo-site": {
+      "source": "demo/index.html"
+    }
+  },
+  "exports": {
+    ".": {
+      "require": "./built/webamp.bundle.min.js",
+      "import": "./built/webamp.bundle.min.mjs",
+      "types": "./built/types/js/webamp.d.ts",
+      "default": "./built/webamp.bundle.min.mjs"
+    },
+    "./lazy": {
+      "require": "./built/webamp.lazy-bundle.js",
+      "import": "./built/webamp.lazy-bundle.min.mjs",
+      "types": "./built/types/js/webampLazy.d.ts",
+      "default": "./built/webamp.lazy-bundle.min.mjs"
+    }
+  },
   "scripts": {
     "lint-fix": "eslint . --ext ts,tsx,js --fix",
     "lint": "eslint . --ext ts,tsx,js",
     "type-check": "tsc",
-    "build": "webpack --config=demo/config/webpack.prod.js",
-    "build-library": "webpack --config=config/webpack.library.js",
-    "prepublishOnly": "npm run build-library",
-    "serve": "http-server ./demo/built",
-    "start": "webpack-dev-server --open --config=demo/config/webpack.dev.js",
-    "stats": "webpack --config=demo/config/webpack.prod.js --json > stats.json",
-    "stats-library": "webpack --config=config/webpack.library.js --json > stats.json",
+    "build": "vite build --emptyOutDir",
+    "build-library": "node ./scripts/rollup.mjs",
+    "prepublishOnly": "npm run build-library && npm run type-check",
+    "publish-next": "yarn publish --new-version=\"0.0.0-next-$(git rev-parse --short HEAD)\" --tag next",
+    "serve": "http-server ./dist/demo-site",
+    "start": "vite",
     "test": "jest --config=config/jest.unit.js",
     "tdd": "jest --config=config/jest.unit.js --watch",
     "format": "prettier --write \"**/*.{js,ts,tsx,d.ts,css}\"",
@@ -50,78 +67,50 @@
   },
   "homepage": "https://github.com/captbaritone/webamp/",
   "devDependencies": {
-    "@babel/core": "^7.7.2",
-    "@babel/node": "^7.0.0",
-    "@babel/plugin-proposal-class-properties": "^7.0.0",
-    "@babel/plugin-proposal-nullish-coalescing-operator": "^7.4.4",
-    "@babel/plugin-proposal-object-rest-spread": "^7.0.0",
-    "@babel/plugin-proposal-optional-chaining": "^7.6.0",
-    "@babel/plugin-syntax-dynamic-import": "^7.0.0",
-    "@babel/plugin-transform-modules-commonjs": "^7.0.0",
-    "@babel/plugin-transform-runtime": "^7.0.0",
-    "@babel/polyfill": "^7.7.0",
-    "@babel/preset-env": "^7.7.1",
-    "@babel/preset-react": "^7.7.0",
-    "@babel/preset-typescript": "^7.7.2",
-    "@babel/runtime": "^7.7.2",
-    "@sentry/browser": "5.9.1",
+    "@parcel/reporter-bundle-analyzer": "^2.8.2",
+    "@rollup/plugin-babel": "^6.0.4",
+    "@rollup/plugin-commonjs": "^25.0.8",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-replace": "^5.0.5",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
     "@types/classnames": "^2.2.6",
-    "@types/css-font-loading-module": "^0.0.2",
     "@types/fscreen": "^1.0.1",
     "@types/invariant": "^2.2.29",
-    "@types/jest": "^23.3.2",
+    "@types/jest": "^27.0.3",
     "@types/jszip": "^3.1.5",
     "@types/lodash": "^4.14.116",
     "@types/lodash-es": "^4.17.1",
-    "@types/react": "^16.8.13",
-    "@types/react-dom": "^16.8.4",
+    "@types/react": "^18.0.26",
+    "@types/react-dom": "^18.0.10",
     "@types/react-redux": "^7.1.1",
     "@types/webaudioapi": "^0.0.27",
-    "@typescript-eslint/eslint-plugin": "^2.6.1",
-    "@typescript-eslint/parser": "^2.7.0",
-    "babel-core": "7.0.0-bridge.0",
-    "babel-eslint": "^9.0.0-beta.3",
-    "babel-jest": "^23.4.2",
-    "babel-loader": "^8.0.4",
-    "caniuse-lite": "^1.0.30001154",
+    "@typescript-eslint/eslint-plugin": "^7.1.0",
+    "@typescript-eslint/parser": "^7.1.0",
     "canvas-mock": "0.0.0",
-    "copy-webpack-plugin": "^4.6.0",
-    "css-loader": "^1.0.1",
-    "cssnano": "^4.1.10",
     "data-uri-to-buffer": "^2.0.0",
-    "eslint": "^6.5.1",
-    "eslint-plugin-import": "^2.18.2",
-    "eslint-plugin-prettier": "^3.1.0",
-    "eslint-plugin-react": "^7.16.0",
-    "eslint-plugin-react-hooks": "^2.1.2",
-    "file-loader": "^2.0.0",
-    "git-revision-webpack-plugin": "^3.0.3",
     "glob": "^7.1.4",
-    "html-webpack-inline-svg-plugin": "^2.3.0",
-    "html-webpack-plugin": "^4.5.0",
     "http-server": "^0.11.1",
     "imagemin": "^6.1.0",
     "imagemin-optipng": "^6.0.0",
-    "jest": "^24.9.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
     "jest-image-snapshot": "^2.12.0",
-    "jest-puppeteer": "^4.4.0",
-    "postcss": "^8.2.10",
-    "postcss-loader": "^3.0.0",
-    "prettier": "^2.3.0",
-    "puppeteer": "^1.15.0",
+    "jest-puppeteer": "^10.0.1",
+    "parcel": "^2.8.2",
+    "postcss": "^8.4.21",
+    "postcss-import": "^16.1.0",
+    "puppeteer": "^22.2.0",
     "react-test-renderer": "^17.0.1",
-    "redux-devtools-extension": "^2.13.2",
-    "redux-sentry-middleware": "^0.1.3",
-    "redux-thunk": "^2.3.0",
+    "rollup": "^4.18.0",
+    "rollup-plugin-polyfill-node": "^0.13.0",
+    "rollup-plugin-postcss": "^4.0.2",
+    "rollup-plugin-visualizer": "^5.12.0",
     "style-loader": "^0.23.1",
-    "terser-webpack-plugin": "^1.4.3",
-    "typescript": "^3.7.2",
+    "typescript": "^5.3.3",
     "url-loader": "^1.1.2",
-    "webpack": "^4.41.2",
-    "webpack-bundle-analyzer": "^4.3.0",
-    "webpack-cli": "^3.1.2",
-    "webpack-dev-server": "^3.8.2",
-    "webpack-merge": "^4.1.2"
+    "vite": "^5.2.12"
   },
   "jest": {
     "globalSetup": "jest-environment-puppeteer/setup",
@@ -134,20 +123,24 @@
     "trailingComma": "es5"
   },
   "dependencies": {
+    "@sentry/browser": "5.9.1",
     "ani-cursor": "^0.0.4",
     "butterchurn": "^3.0.0-beta.3",
     "butterchurn-presets": "3.0.0-beta.4",
     "classnames": "^2.2.5",
     "fscreen": "^1.0.2",
     "invariant": "^2.2.3",
-    "jszip": "^3.1.3",
+    "jszip": "^3.10.1",
     "lodash": "^4.17.21",
     "milkdrop-preset-converter-aws": "^0.1.6",
     "music-metadata-browser": "^0.6.1",
-    "react": "^17.0.1",
-    "react-dom": "^17.0.1",
-    "react-redux": "^7.2.2",
-    "redux": "^4.0.5",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "react-redux": "^8.0.5",
+    "redux": "^5.0.0-alpha.0",
+    "redux-devtools-extension": "^2.13.9",
+    "redux-sentry-middleware": "^0.1.3",
+    "redux-thunk": "^2.4.0",
     "reselect": "^3.0.1",
     "tinyqueue": "^1.2.3",
     "winamp-eqf": "^1.0.0"

package/CHANGELOG.md

@@ -1,198 +0,0 @@
-## NEXT
-
-### Features
-
-- Support `.ani` cursors in skins [#1035](https://github.com/captbaritone/webamp/pull/1035), [blog post](https://jordaneldredge.com/blog/rendering-animated-ani-cursors-in-the-browser/).
-- Improved support for mobile/touch screen interaction: volume, balance and position sliders, marquee, playlist and window dragging/resizing/focusing. [#1098](https://github.com/captbaritone/webamp/pull/1098)/[#1099](https://github.com/captbaritone/webamp/pull/1099)
-
-### Bug Fixes
-
-- Fix a number of edge cases where the close and minimize buttons in the equalizer window could render the wrong sprite [#1046](https://github.com/captbaritone/webamp/pull/1046)
-- Fix a bug where unminified bundle was accidentally minified.
-- Treat skin files with forward slashes in their filename as directories [#1052](https://github.com/captbaritone/webamp/pull/1052)
-- Fix a bug where the Milkdrop window could not be moved in some cases [#1068](https://github.com/captbaritone/webamp/pull/1068)
-- Fix a bug where the visualizer in the Playlist window was not hidden when audio was stopped. [#1072](https://github.com/captbaritone/webamp/pull/1072)
-- Fix a bug where the marquee was one pixel too narrow [#1087](https://github.com/captbaritone/webamp/pull/1087)
-
-## 1.4.2
-
-### Bug Fixes
-
-- Add `webamp.close()` method to public TypeScript types.
-
-## 1.4.1
-
-### Features
-
-- New Webamp instance method: `.setSkinFromUrl(url)`. See [usage.md](./docs/usage.md) for more details.
-- New Webamp instance method: `.close()`. See [usage.md](./docs/usage.md) for more details.
-
-### Bug Fixes
-
-- Fix a bug where skins missing some images would fail to load [2e8392](https://github.com/captbaritone/webamp/commit/2e83920ca1597ad9704f01cc950d59a52c25635c)
-- Clicking on the lightning icon in the main window now correctly opens our about page in a new tab [#794](https://github.com/captbaritone/webamp/pull/794)
-- Skin `.ini` files can use `=` as a comment separator [577b5e3](https://github.com/captbaritone/webamp/commit/577b5e3c177f2f3ee06f9fbc6aac212adfbbc8c8)
-- We nolonger cycle Milkdrop presets when media is not playing [#799](https://github.com/captbaritone/webamp/pull/799)
-- Guard against some kinds of malformed `region.txt` files [0bd8b0](https://github.com/captbaritone/webamp/commit/0bd8b09ecff9f00873fc13dcd2a5662bf3efff61)
-
-## 1.4.0
-
-### Features
-
-- Added optional configuration option `handleTrackDropEvent` which lets you decide how drop events get converted into tracks.
-- New Webamp instance methods: `.stop()`, `.getMediaStatus()`, and `.seekToTime(seconds)`. See [usage.md](./docs/usage.md) for more details.
-- Windows are now layered in the order in which they were focused ([5ee1a4](https://github.com/captbaritone/webamp/commit/5ee1a4f7b024d9e667c41d24c961404e463009c4))
-- When focusing something other than Webamp, it's now possible for no windows to be selected ([6132ac](https://github.com/captbaritone/webamp/commit/6132acdf2cd42b56bf757fa101fc08203e84fd67))
-
-### Bug Fixes:
-
-- Fix a bug where context menus could appear in the wrong location ([95db2d](https://github.com/captbaritone/webamp/commit/95db2d08b6b189f5b9da577d23aca44b04c462a8))
-- Fix a bug where pressing next/previous when stopped would play the track ([#740](https://github.com/captbaritone/webamp/issues/730))
-- Fix a bug where `webamp.dispose` would error if the `#webamp` node had been reparented to anything other than `document.body`.
-- Fix a bug where tracks dropped in the main window were not autoplayed ([f8167d](https://github.com/captbaritone/webamp/commit/f8167dd32209e1a71958190abc037df79642a2cb))
-
-### Internal Improvements:
-
-- Upgraded [React Redux](https://github.com/reduxjs/react-redux) ([c3c3ad](https://github.com/captbaritone/webamp/commit/c3c3ad69abacdc34b58f3385b39b2634e9271590))
-- Several improvements to the performance of rendering Redux updates ([c75214](https://github.com/captbaritone/webamp/commit/c75214dcd7475b27f24c159cda26117a143ff740), [73f87b](https://github.com/captbaritone/webamp/commit/73f87be7c34acf5d0d5227a2a1b0e9718da11875), [4322aa](https://github.com/captbaritone/webamp/commit/4322aade4b5a60926c280e1807c4592cf915b497), [e89aa2](https://github.com/captbaritone/webamp/commit/e89aa266121ba7f890b96351d2da46314b7589e7),)
-
-## 1.3.1 [CURRENT]
-
-### Bug Fixes:
-
-- Fix issue where `music-metadata-browser` was not imported correctly, and id3 tags could not be read. ([324fc2](https://github.com/captbaritone/webamp/commit/324fc29ca6c94fa54091608323842ba0604e0b4c))
-
-## 1.3.0
-
-This release is far overdue. In the last six months we've made a huge number of improvements to Webamp.
-
-We've fixed multiple longstanding bugs and continued to inch closer to pixel-perfect parity with Winamp. We've added several methods which make it easier to use Webamp in your project. In addition, we've continued to invest in the code by refactoring code to make it more maintainable, and converting the entire project from vanilla JavaScript to TypeScript which should help reduce the number of "dumb" bugs.
-
-See a full list below:
-
-### Features:
-
-- Added methods to the webamp instance to control playback. See the [Usage Docs](./docs/usage.md) for more information:
-  - `webamp.play()`
-  - `webamp.pause()`
-  - `webamp.previousTrack()`
-  - `webamp.nextTrack()`
-  - `webamp.seekForward(seconds)`
-  - `webamp.seekBackward(seconds)`
-- Our ID3 parsing library [jsmediatags](https://github.com/aadsm/jsmediatags) has been replaced by [music-metadata-browser](https://www.npmjs.com/package/music-metadata-browser). This means we now support a broader range of media types, and also that the bitrate and sample rate displayed are now functional
-- The default skin is now included in the Skins section of the options menu by default
-- Implemented the "Options" sub context menu. Click the "O" in the "clutter bar" or select "Options" from the main context menu to see it
-- The equlizer graph is nolonger antialiased. It is now pixelated like real Winamp
-- Added a `.reopen()` method to reopen Webamp after you've closed it ([47ba520](https://github.com/captbaritone/webamp/commit/47ba520c2422d8e4842468a32ca13492845183cd))
-- Stip diacritic marks from song description so it displays better in the marquee ([2b2598](https://github.com/captbaritone/webamp/commit/2b2598329d3891ee8a976b8169066586110a767a))
-
-### Bug Fixes:
-
-- Fixed a longstanding bug where mono audio files would only play in the right channel ([4fd802](https://github.com/captbaritone/webamp/commit/4fd802f96efabb98c3c1573819eed37fec630f90))
-- Fixed a bug ([#687](https://github.com/captbaritone/webamp/issues/687)) where `webamp.appendTracks()` would cause currently playing media to pause.
-- Avoid sticking a file `<input>` into the global DOM ([343686](https://github.com/captbaritone/webamp/commit/343686f7454c4ece95b520fa3ddbf3ecc0198100))
-- Fix a bug where tracks dragged into the playlist were added at the wrong location ([b074e0](https://github.com/captbaritone/webamp/commit/b074e0eff35ac8b1b34efa902681aa19ba2b8629))
-- Fix a bug where skin cursors were not being shown for the equalizer sliders ([65bb59d](https://github.com/captbaritone/webamp/commit/65bb59353dc2da858440a3d753aec02fb771f0cc))
-- The Marquee text is nolonger blury when in "Double Size" mode ([4b5320](https://github.com/captbaritone/webamp/commit/4b53209e0cc0a9e0cd84821d012c1770a940063c))
-- Scrolling in the Equalizer window nolonger changes the volume ([48a937](https://github.com/captbaritone/webamp/commit/48a937da8722ccfd3c2e9df378a847c453c36864))
-- Clicking anywhere in a equalizer slider now makes the button depress ([20e681](20e6811e6f59e82a5765c38b0b33fbed2eb575ee)
-- Parsing of the `viscolor.txt` file in skins is now more permissive, allowing us to support more skins ([0d29ff](0d29ffe3f4b20505005346cbc97d0cdf85664619))
-- The hotkeys to seek forward/backwards 10 tracks now works propery ([7d9ef4](https://github.com/captbaritone/webamp/commit/7d9ef4287f7294f6bdc1db89b717592cf4e48f17))
-- Fix a bug where the preamp level was not applied until you changed it ([f03c88](https://github.com/captbaritone/webamp/commit/f03c88c6d89fd51cbc0538841bb3227accfa0431))
-- Fix a bug where `.eqf` values were encoded incorrectly ([c634cd](https://github.com/captbaritone/webamp/commit/c634cd8b947e5d2d8b94b38023bc20097737a995))
-- Preamp and EQ now boost/attenuate the same way original winamp 2 did ([#748](https://github.com/captbaritone/webamp/pull/748))
-
-### Internal Improvements:
-
-- Webamp is now written in [TypeScript](https://www.typescriptlang.org/).
-- Upraded to React and began using a few [hooks](https://reactjs.org/docs/hooks-overview.html).
-- We nolonger depend upon [cardinal-spline-js](https://www.npmjs.com/package/cardinal-spline-js), we use our own implementation.
-
-## 1.2.0
-
-### Features
-
-- Users can register an `onWillClose` callback, which is passed a `cancel` function. The `cancel` function can be called to prevent Webamp from closing. [#655](https://github.com/captbaritone/webamp/pull/655)
-
-### Internal changes
-
-- Webamp is now mostly built with [TypeScript](https://www.typescriptlang.org/).
-
-## 1.1.2
-
-### Changes
-
-Webamp is no-longer rendered into the DOM node you pass into `webamp.renderWhenReady()`. Instead, Webamp is rendred as a direct child of the `<body>` tag. The passed DOM node is still used for positioning. Webamp will attempt to center itself within that DOM node when it renders.
-
-### Features
-
-- Allow consumers to specify a z-index when constructing Webamp.
-
-### Fixes
-
-- Fixes positioning of context menus in context menu targets when they are spawned while scrolled.
-- Improve performance of CharacterString, which gets rendered on every marquee step.
-
-## 1.1.1
-
-### Fixes
-
-- Fixes the marquee text when the host page globally sets `box-sizing`.
-- Fixes the initial layout when the container is not at the top of the page.
-- Fixes the positioning of context menus created when scrolled down the page.
-
-## 1.1.0
-
-### Breaking
-
-- Webamp will attempt to center itself within the node it is rendered into, rather than within the entire page.
-- Webamp now includes the default skin directly in the JS bundle, so you don't need host it separately, or pass a URL as part of the initialztiaon.
-
-### Features
-
-- Equalizer sliders now "stick" slightly at zero.
-- Context menus on all windows.
-- Toggle window visibility via context menus.
-- Users can now hard code the duration of initial tracks. This saves Webamp from having to make an HTTP request to check the duration.
-
-### Fixed
-
-- Marquee now displays one additional character: https://github.com/captbaritone/webamp/issues/543
-- Track numbers in playlist are now padded to the length of the longest track number.
-- Fix close buttons in Playlist and Equalizer in shade mode.
-- Skins that omit assets will now fallback to using the default version of that asset.
-- Fix seeking forward via hotkeys.
-
-## 1.0.0
-
-**Important:** The NPM module as **moved** from `winamp2-js` to `webamp`. You will need to update your `package.json` to point to the new module.
-
-### Breaking
-
-- Project renamed from "Winamp2-js" to "Webamp".
-- UMD module exports as `window.Webamp` instead of `window.winamp2js`. When used via `<script>` tag.
-- Deprecated: The misspelled `Webmap` construction option `avaliableSkins` has been deprecated in favor of `availableSkins`. `avaliableSkins` will continue to work, but will log a deprecation warning. [#533](https://github.com/captbaritone/webamp/pull/533) by [@remigallego](https://github.com/remigallego)
-
-### Added
-
-- Instance method to be notified when Webamp is closed `webamp.onClose(callback)`.
-- Instance method to be notified when Webamp is minmized `webamp.onMinimize(callback)`.
-- Support for skins that use `.png` sprite sheets instead of `.bmp`. This saves 15kb for the default skin on the demo page. ([b88e87](https://github.com/captbaritone/winamp2-js/commit/b88e87b6584fd9db2e2295addab7bba0c1acd226))
-- We now attempt to detect mono audio files. Previously mono files would report as stereo and play only in the left channel.
-
-### Fixed
-
-- Shrink visualizer by one pixel to match Winamp. [#536](https://github.com/captbaritone/winamp2-js/issues/536) by [@The1Freeman](https://github.com/The1Freeman)
-- Remove Google Analytics tracking module from NPM module. ([aeb9522](https://github.com/captbaritone/winamp2-js/commit/aeb9522a47ac4032f0f73fe7828c3ef01728d6aa))
-
-## 0.0.6
-
-- Added: `winamp.appendTracks()`.
-- Added: `winamp.setTracksToPlay()`.
-- Changed: We no-longer try to center on window resize.
-- Meta: Added real [documentation](./docs/usage.md)!
-- Meta: Remove lots of garbage from the NPM build.
-
-## Prehistory
-
-In all older versions, the API was not stable enough to merit a changelog.

package/index.d.ts

@@ -1,277 +0,0 @@
-interface TrackInfo {
-  /**
-   * Name to be used until ID3 tags can be resolved.
-   *
-   * If the track has a `url`, and this property is not given,
-   * the filename will be used instead.
-   *
-   * Example: `'My Song'`
-   */
-  defaultName?: string;
-
-  /**
-   * Data to be used _instead_ of trying to fetch ID3 tags.
-   *
-   * Example: `{ artist: 'Jordan Eldredge', title: "Jordan's Song" }`
-   */
-  metaData?: {
-    artist: string;
-    title: string;
-    album?: string;
-  };
-
-  /**
-   * Duration (in seconds) to be used instead of fetching enough of the file to measure its length.
-   *
-   * Example: 95
-   */
-  duration?: number;
-}
-
-interface URLTrack extends TrackInfo {
-  /**
-   * Source URL of the track
-   *
-   * Note: This URL must be served the with correct CORs headers.
-   *
-   * Example: `'https://example.com/song.mp3'`
-   */
-  url: string | URL;
-}
-
-interface BlobTrack extends TrackInfo {
-  /**
-   * Blob source of the track
-   */
-  blob: Blob;
-}
-
-interface LoadedURLTrack {
-  url: string;
-  metaData: {
-    artist: string | null;
-    title: string | null;
-    album: string | null;
-    albumArtUrl: string | null;
-  };
-}
-
-/**
- * Many methods on the webamp instance deal with track.
- *
- * Either `url` or `blob` must be specified
- */
-type Track = URLTrack | BlobTrack;
-
-interface Options {
-  /**
-   * An object representing the initial skin to use.
-   *
-   * If omitted, the default skin, included in the bundle, will be used.
-   * Note: This URL must be served the with correct CORs headers.
-   *
-   * Example: `{ url: './path/to/skin.wsz' }`
-   */
-  initialSkin?: {
-    url: string;
-  };
-
-  /**
-   * An array of `Track`s to prepopulate the playlist with.
-   */
-  initialTracks?: Track[];
-
-  /**
-   * An array of objects representing available skins.
-   *
-   * These will appear in the "Options" menu under "Skins".
-   * Note: These URLs must be served with the correct CORs headers.
-   *
-   * Example: `[ { url: "./green.wsz", name: "Green Dimension V2" } ]`
-   */
-  availableSkins?: { url: string; name: string }[];
-
-  /**
-   * Should global hotkeys be enabled?
-   *
-   * Default: `false`
-   */
-  enableHotkeys?: boolean;
-
-  /**
-   * An array of additional file pickers.
-   *
-   * These will appear in the "Options" menu under "Play".
-   *
-   * In the offical version, this option is used to provide a "Dropbox" file picker.
-   */
-  filePickers?: [
-    {
-      /**
-       * The name that will appear in the context menu.
-       *
-       * Example: `"My File Picker..."`
-       */
-      contextMenuName: string;
-
-      /**
-       * A function which returns a Promise that resolves to an array of `Track`s
-       *
-       * Example: `() => Promise.resolve([{ url: './rick_roll.mp3' }])`
-       */
-      filePicker: () => Promise<Track[]>;
-
-      /**
-       * Indicates if this options should be made available when the user is offline.
-       */
-      requiresNetwork: boolean;
-    }
-  ];
-  zIndex?: number;
-
-  handleTrackDropEvent?: (
-    e: React.DragEvent<HTMLDivElement>
-  ) => Track[] | null | Promise<Track[] | null>;
-}
-
-export default class Webamp {
-  constructor(options: Options);
-
-  /**
-   * Returns a true if the current browser supports the features that Webamp depends upon.
-   *
-   * It is recommended to check this before you attempt to instantiate an instance of Winamp.
-   */
-  public static browserIsSupported(): boolean;
-
-  /**
-   * Add an array of `Track`s to the end of the playlist.
-   */
-  public appendTracks(tracks: Track[]): void;
-
-  /**
-   * Replace the playlist with an array of `Track`s and begin playing the first track.
-   */
-  public setTracksToPlay(tracks: Track[]): void;
-
-  /**
-   * Play the previous track
-   */
-  public previousTrack(): void;
-
-  /**
-   * Play the next track
-   */
-  public nextTrack(): void;
-
-  /**
-   * Seek forward n seconds in the curent track
-   */
-  public seekForward(seconds: number): void;
-
-  /**
-   * Seek backward n seconds in the curent track
-   */
-  public seekBackward(seconds: number): void;
-
-  /**
-   * Seek to a given time within the current track
-   */
-  public seekToTime(seconds: number): void;
-
-  /**
-   * Pause the current tack
-   */
-  public pause(): void;
-
-  /**
-   * Play the current tack
-   */
-  public play(): void;
-
-  /**
-   * Stop the currently playing audio. Equivilant to pressing the "stop" button
-   */
-  public stop(): void;
-
-  /**
-   * Webamp will wait until it has fetched the skin and fully parsed it and then render itself.
-   *
-   * Webamp is rendered into a new DOM node at the end of the <body> tag with the id `#webamp`.
-   *
-   * If a domNode is passed, Webamp will place itself in the center of that DOM node.
-   *
-   * @returns A promise is returned which will resolve after the render is complete.
-   */
-  public renderWhenReady(domNode: HTMLElement): Promise<void>;
-
-  /**
-   * A callback which will be called when a new track starts loading.
-   *
-   * This can happen on startup when the first track starts buffering, or when a subsequent track starts playing.
-   * The callback will be called with an object `({url: 'https://example.com/track.mp3'})` containing the URL of the track.
-   * Note: If the user drags in a track, the URL may be an ObjectURL.
-   *
-   * @returns An "unsubscribe" function. Useful if at some point in the future you want to stop listening to these events.
-   */
-  public onTrackDidChange(
-    cb: (trackInfo: LoadedURLTrack | null) => void
-  ): () => void;
-
-  /**
-   * Get the current "playing" status.
-   */
-  public getMediaStatus(): "PLAYING" | "STOPPED" | "PAUSED";
-
-  /**
-   * A callback which will be called when Webamp is _about to_ close. Returns an
-   * "unsubscribe" function. The callback will be passed a `cancel` function
-   * which you can use to conditionally prevent Webamp from being closed.
-   *
-   * @returns An "unsubscribe" function. Useful if at some point in the future you want to stop listening to these events.
-   */
-  public onWillClose(cb: (cancel: () => void) => void): () => void;
-
-  /**
-   * A callback which will be called when Webamp is closed.
-   *
-   * @returns An "unsubscribe" function. Useful if at some point in the future you want to stop listening to these events.
-   */
-  public onClose(cb: () => void): () => void;
-
-  /**
-   * Equivalent to selection "Close" from Webamp's options menu. Once closed,
-   * you can open it again with `.reopen()`.
-   */
-  public close(): void;
-
-  /**
-   * After `.close()`ing this instance, you can reopen it by calling this method.
-   */
-  public reopen(): void;
-
-  /**
-   * A callback which will be called when Webamp is minimized.
-   *
-   * @returns An "unsubscribe" function. Useful if at some point in the future you want to stop listening to these events.
-   */
-  public onMinimize(callback: () => any): () => void;
-
-  public setSkinFromUrl(url: string): void;
-
-  /**
-   * Returns a promise that resolves when the skin is done loading.
-   */
-  public skinIsLoaded(): Promise<void>;
-
-  /**
-   * **Note:** _This method is not fully functional. It is currently impossible to
-   * clean up a Winamp instance. This method makes an effort, but it still leaks
-   * the whole instance. In the future the behavior of this method will improve,
-   * so you might as well call it._
-   *
-   * When you are done with a Webamp instance, call this method and Webamp will
-   * attempt to clean itself up to avoid memory leaks.
-   */
-  public dispose(): void;
-}