media-devices 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## [UNRELEASED]
 
+## [0.5.0] - 2024-04-28
+
+### Changed
+
+- Reworked the build process to avoid an unmaintained plugin which affects how TypeScript definitions are published.
+- Publish as ESM package. Legacy entrypoints are maintained for compatibility.
+- Replaced packaged source files with a generated `.d.ts` definition for TypeScript.
+
+### Removed
+
+- Source files are no longer distributed with the package. You should not notice a difference.
+
 ## [0.4.0] - 2022-05-30
 
 ### Removed
@@ -55,7 +67,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 - A device list-diffing implementation of `ondevicechange`.
 - Support detection via `supportsMediaDevices()`.
 
-[Unreleased]: https://github.com/PsychoLlama/media-devices/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/PsychoLlama/media-devices/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/PsychoLlama/media-devices/compare/v0.4.0...v0.5.0
 [0.4.0]: https://github.com/PsychoLlama/media-devices/compare/v0.3.0...v0.4.0
 [0.3.0]: https://github.com/PsychoLlama/media-devices/compare/v0.2.0...v0.3.0
 [0.2.0]: https://github.com/PsychoLlama/media-devices/compare/v0.1.0...v0.2.0

package/README.md

@@ -4,7 +4,7 @@
 
   <div>
     <a href="https://github.com/PsychoLlama/media-devices/actions/workflows/main.yml">
-      <img src="https://img.shields.io/github/workflow/status/PsychoLlama/media-devices/CI/main" alt="Build status" />
+      <img src="https://img.shields.io/github/actions/workflow/status/PsychoLlama/media-devices/main.yml?branch=main" alt="Build status" />
     </a>
     <img src="https://img.shields.io/npm/types/media-devices" alt="Build status" />
     <a href="https://www.npmjs.com/package/media-devices">

package/dist/media-devices.d.ts

@@ -0,0 +1,129 @@
+declare const _default: DeviceManager;
+export default _default;
+
+declare interface DeviceAddEvent {
+    type: OperationType.Add;
+    device: DeviceInfo;
+}
+
+export declare type DeviceChange = DeviceAddEvent | DeviceRemoveEvent | DeviceUpdateEvent;
+
+declare interface DeviceChangeListener {
+    (update: {
+        changes: Array<DeviceChange>;
+        devices: Array<DeviceInfo>;
+    }): unknown;
+}
+
+export declare interface DeviceInfo {
+    /**
+     * The device list is obfuscated until you gain elevated permissions.
+     * Browsers will use an empty string for the device label until the first
+     * successful `getUserMedia(...)` request.
+     */
+    label: null | string;
+    /**
+     * A unique identifier persistent across sessions. Note: In Chromium
+     * browsers, this can be unset if you haven't received permission for the
+     * media resource yet.
+     */
+    deviceId: null | string;
+    /**
+     * A unique identifier grouping one or more devices together. Two devices
+     * with the same group ID symbolise that both devices belong to the same
+     * hardware, e.g. a webcam with an integrated microphone. Note: Safari
+     * doesn't support group IDs.
+     */
+    groupId: null | string;
+    /**
+     * Declares the type of media provided. This covers microphones, cameras,
+     * and speakers.
+     */
+    kind: DeviceKind;
+}
+
+export declare enum DeviceKind {
+    VideoInput = "videoinput",
+    AudioInput = "audioinput",
+    AudioOutput = "audiooutput"
+}
+
+/**
+ * Monitors the set of devices for changes and calculates convenient diffs
+ * between updates. Steps are taken to handle cross-browser quirks and
+ * attempts graceful integration with browser fingerprinting countermeasures.
+ */
+declare class DeviceManager {
+    private _knownDevices;
+    private _gainedScreenAccessOnce;
+    /**
+     * Specifies a function to be called whenever the list of available devices
+     * changes.
+     *
+     * Note: this is different from the native event. It passes the changeset
+     * and full list of devices as a parameter.
+     */
+    ondevicechange: null | DeviceChangeListener;
+    constructor();
+    /**
+     * Request a live media stream from audio and/or video devices. Streams are
+     * configurable through constraints.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia
+     */
+    getUserMedia: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
+    /**
+     * Ask the user to share their screen. Resolves with a media stream carrying
+     * video, and potentially audio from the application window.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia
+     */
+    getDisplayMedia: (constraints?: MediaStreamConstraints) => Promise<MediaStream>;
+    /**
+     * Lists every available hardware device, including microphones, cameras,
+     * and speakers (depending on browser support). May contain redacted
+     * information depending on application permissions.
+     */
+    enumerateDevices: () => Promise<Array<DeviceInfo>>;
+    /**
+     * Returns an object containing every media constraint supported by the
+     * browser.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getSupportedConstraints
+     */
+    getSupportedConstraints: () => MediaTrackSupportedConstraints;
+    private _checkForDeviceChanges;
+    /**
+     * Note: The device enumeration API may return null values for device IDs
+     * and labels. To avoid creating erroneous "Device Added" notifications,
+     * a best effort should be made to detect when devices are identical.
+     *
+     * Order is significant. Preferred devices are listed first, which helps
+     * correlate devices from permissioned requests with unpermissioned
+     * requests.
+     */
+    private _calculateDeviceDiff;
+}
+
+declare interface DeviceRemoveEvent {
+    type: OperationType.Remove;
+    device: DeviceInfo;
+}
+
+declare interface DeviceUpdateEvent {
+    type: OperationType.Update;
+    newInfo: DeviceInfo;
+    oldInfo: DeviceInfo;
+}
+
+export declare enum OperationType {
+    Add = "add",
+    Remove = "remove",
+    Update = "update"
+}
+
+/**
+ * Not all browsers support media devices, and some restrict access for
+ * insecure sites and private contexts. This is often reflected by removing
+ * the `mediaDevices` API entirely.
+ */
+export declare function supportsMediaDevices(): boolean;
+
+export { }

package/dist/media-devices.js

@@ -0,0 +1,136 @@
+var f = Object.defineProperty;
+var p = (e, t, n) => t in e ? f(e, t, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[t] = n;
+var r = (e, t, n) => (p(e, typeof t != "symbol" ? t + "" : t, n), n);
+function o() {
+  return typeof navigator < "u" && !!navigator.mediaDevices;
+}
+function c() {
+  if (!o())
+    throw new Error("The media devices API isn't supported here.");
+  return navigator.mediaDevices;
+}
+async function g() {
+  return (await c().enumerateDevices()).filter(h).map(m);
+}
+function h(e) {
+  return e.deviceId !== "default";
+}
+function m(e) {
+  return {
+    label: e.label || null,
+    kind: e.kind,
+    deviceId: e.deviceId || null,
+    groupId: e.groupId || null
+  };
+}
+var D = /* @__PURE__ */ ((e) => (e.VideoInput = "videoinput", e.AudioInput = "audioinput", e.AudioOutput = "audiooutput", e))(D || {});
+async function I(e) {
+  return c().getUserMedia(e);
+}
+class y {
+  constructor() {
+    r(this, "_knownDevices", []);
+    r(this, "_gainedScreenAccessOnce", !1);
+    /**
+     * Specifies a function to be called whenever the list of available devices
+     * changes.
+     *
+     * Note: this is different from the native event. It passes the changeset
+     * and full list of devices as a parameter.
+     */
+    r(this, "ondevicechange", null);
+    /**
+     * Request a live media stream from audio and/or video devices. Streams are
+     * configurable through constraints.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia
+     */
+    r(this, "getUserMedia", async (t) => {
+      const n = await I(t);
+      return this.enumerateDevices(), n;
+    });
+    /**
+     * Ask the user to share their screen. Resolves with a media stream carrying
+     * video, and potentially audio from the application window.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia
+     */
+    r(this, "getDisplayMedia", async (t) => {
+      const n = await c().getDisplayMedia(t);
+      return this._gainedScreenAccessOnce || (this._gainedScreenAccessOnce = !0, this.enumerateDevices()), n;
+    });
+    /**
+     * Lists every available hardware device, including microphones, cameras,
+     * and speakers (depending on browser support). May contain redacted
+     * information depending on application permissions.
+     */
+    r(this, "enumerateDevices", async () => {
+      const t = await g();
+      return this._checkForDeviceChanges(t), t;
+    });
+    /**
+     * Returns an object containing every media constraint supported by the
+     * browser.
+     * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getSupportedConstraints
+     */
+    r(this, "getSupportedConstraints", () => c().getSupportedConstraints());
+    o() && c().addEventListener("devicechange", () => this.ondevicechange ? this.enumerateDevices() : Promise.resolve());
+  }
+  _checkForDeviceChanges(t) {
+    var a;
+    const n = this._knownDevices;
+    this._knownDevices = t;
+    const i = this._calculateDeviceDiff(
+      t,
+      n
+    );
+    i.length && ((a = this.ondevicechange) == null || a.call(this, { changes: i, devices: t }));
+  }
+  /**
+   * Note: The device enumeration API may return null values for device IDs
+   * and labels. To avoid creating erroneous "Device Added" notifications,
+   * a best effort should be made to detect when devices are identical.
+   *
+   * Order is significant. Preferred devices are listed first, which helps
+   * correlate devices from permissioned requests with unpermissioned
+   * requests.
+   */
+  _calculateDeviceDiff(t, n) {
+    const i = n.slice(), a = [], l = t.filter((s) => {
+      const d = i.findIndex((u) => _(s, u));
+      if (d > -1) {
+        const [u] = i.splice(d, 1);
+        if (s.label !== u.label) {
+          const v = {
+            type: "update",
+            newInfo: s,
+            oldInfo: u
+          };
+          a.push(v);
+        }
+      }
+      return d === -1;
+    });
+    return [
+      ...a,
+      // A device was just removed.
+      ...i.map((s) => ({ type: "remove", device: s })),
+      // A device was just plugged in.
+      ...l.map((s) => ({ type: "add", device: s }))
+    ];
+  }
+}
+function _(e, t) {
+  if (t.deviceId)
+    return e.deviceId === t.deviceId;
+  function n(i) {
+    return `${i.kind}:${i.groupId}`;
+  }
+  return n(e) === n(t);
+}
+var k = /* @__PURE__ */ ((e) => (e.Add = "add", e.Remove = "remove", e.Update = "update", e))(k || {});
+const M = new y();
+export {
+  D as DeviceKind,
+  k as OperationType,
+  M as default,
+  o as supportsMediaDevices
+};

package/dist/media-devices.umd.cjs

@@ -0,0 +1 @@
+(function(t,i){typeof exports=="object"&&typeof module<"u"?i(exports):typeof define=="function"&&define.amd?define(["exports"],i):(t=typeof globalThis<"u"?globalThis:t||self,i(t["media-devices"]={}))})(this,function(t){"use strict";var k=Object.defineProperty;var A=(t,i,s)=>i in t?k(t,i,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[i]=s;var a=(t,i,s)=>(A(t,typeof i!="symbol"?i+"":i,s),s);function i(){return typeof navigator<"u"&&!!navigator.mediaDevices}function s(){if(!i())throw new Error("The media devices API isn't supported here.");return navigator.mediaDevices}async function p(){return(await s().enumerateDevices()).filter(h).map(g)}function h(e){return e.deviceId!=="default"}function g(e){return{label:e.label||null,kind:e.kind,deviceId:e.deviceId||null,groupId:e.groupId||null}}var f=(e=>(e.VideoInput="videoinput",e.AudioInput="audioinput",e.AudioOutput="audiooutput",e))(f||{});async function m(e){return s().getUserMedia(e)}class D{constructor(){a(this,"_knownDevices",[]);a(this,"_gainedScreenAccessOnce",!1);a(this,"ondevicechange",null);a(this,"getUserMedia",async n=>{const r=await m(n);return this.enumerateDevices(),r});a(this,"getDisplayMedia",async n=>{const r=await s().getDisplayMedia(n);return this._gainedScreenAccessOnce||(this._gainedScreenAccessOnce=!0,this.enumerateDevices()),r});a(this,"enumerateDevices",async()=>{const n=await p();return this._checkForDeviceChanges(n),n});a(this,"getSupportedConstraints",()=>s().getSupportedConstraints());i()&&s().addEventListener("devicechange",()=>this.ondevicechange?this.enumerateDevices():Promise.resolve())}_checkForDeviceChanges(n){var u;const r=this._knownDevices;this._knownDevices=n;const c=this._calculateDeviceDiff(n,r);c.length&&((u=this.ondevicechange)==null||u.call(this,{changes:c,devices:n}))}_calculateDeviceDiff(n,r){const c=r.slice(),u=[],_=n.filter(d=>{const l=c.findIndex(o=>I(d,o));if(l>-1){const[o]=c.splice(l,1);if(d.label!==o.label){const M={type:"update",newInfo:d,oldInfo:o};u.push(M)}}return l===-1});return[...u,...c.map(d=>({type:"remove",device:d})),..._.map(d=>({type:"add",device:d}))]}}function I(e,n){if(n.deviceId)return e.deviceId===n.deviceId;function r(c){return`${c.kind}:${c.groupId}`}return r(e)===r(n)}var v=(e=>(e.Add="add",e.Remove="remove",e.Update="update",e))(v||{});const y=new D;t.DeviceKind=f,t.OperationType=v,t.default=y,t.supportsMediaDevices=i,Object.defineProperties(t,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});

package/package.json

@@ -1,22 +1,24 @@
 {
   "name": "media-devices",
   "description": "Easily manage media devices in the browser.",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "license": "MIT",
   "author": "Jesse Gibson <JesseTheGibson@gmail.com>",
   "repository": "github:PsychoLlama/media-devices",
   "homepage": "https://github.com/PsychoLlama/media-devices#readme",
-  "module": "./dist/media-devices.es.js",
-  "main": "./dist/media-devices.umd.js",
+  "type": "module",
+  "module": "./dist/media-devices.js",
+  "main": "./dist/media-devices.umd.cjs",
+  "types": "./dist/media-devices.d.ts",
   "exports": {
     ".": {
-      "require": "./dist/media-devices.umd.js",
-      "import": "./dist/media-devices.es.js"
+      "types": "./dist/media-devices.d.ts",
+      "require": "./dist/media-devices.umd.cjs",
+      "import": "./dist/media-devices.js"
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "keywords": [
     "camera",
@@ -26,7 +28,7 @@
     "mediadevices"
   ],
   "scripts": {
-    "prepare": "vite build --sourcemap",
+    "prepare": "vite build",
     "test": "./bin/run-tests",
     "test:unit": "jest --color",
     "test:lint": "eslint src --ext ts --color",
@@ -81,19 +83,18 @@
     }
   },
   "devDependencies": {
-    "@types/jest": "27.5.1",
-    "@typescript-eslint/eslint-plugin": "5.27.0",
-    "@typescript-eslint/parser": "5.27.0",
-    "eslint": "8.16.0",
-    "husky": "8.0.1",
-    "jest": "28.1.0",
-    "jest-environment-jsdom": "28.1.0",
-    "lint-staged": "12.4.3",
-    "prettier": "2.6.2",
-    "size-limit": "7.0.8",
-    "ts-jest": "28.0.3",
-    "typescript": "4.7.2",
-    "vite": "2.9.9",
-    "vite-dts": "1.0.4"
+    "@types/jest": "29.5.12",
+    "@typescript-eslint/eslint-plugin": "7.7.1",
+    "@typescript-eslint/parser": "7.7.1",
+    "eslint": "8.57.0",
+    "husky": "9.0.11",
+    "jest": "29.7.0",
+    "jest-environment-jsdom": "29.7.0",
+    "lint-staged": "15.2.2",
+    "prettier": "3.2.5",
+    "ts-jest": "29.1.2",
+    "typescript": "5.4.5",
+    "vite": "5.2.10",
+    "vite-plugin-dts": "^3.7.3"
   }
 }

package/dist/media-devices.es.d.ts

@@ -1,2 +0,0 @@
-export * from "../src/index"
-export {default} from "../src/index"

package/dist/media-devices.es.js

@@ -1,132 +0,0 @@
-var __defProp = Object.defineProperty;
-var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField = (obj, key, value) => {
-  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-  return value;
-};
-function supportsMediaDevices() {
-  return typeof navigator !== "undefined" && !!navigator.mediaDevices;
-}
-function getMediaDevicesApi() {
-  if (!supportsMediaDevices()) {
-    throw new Error(`The media devices API isn't supported here.`);
-  }
-  return navigator.mediaDevices;
-}
-async function enumerateDevices() {
-  const devices = await getMediaDevicesApi().enumerateDevices();
-  return devices.filter(isPhysicalDevice).map(normalizeDeviceInfo);
-}
-function isPhysicalDevice(device) {
-  return device.deviceId !== "default";
-}
-function normalizeDeviceInfo(device) {
-  return {
-    label: device.label || null,
-    kind: device.kind,
-    deviceId: device.deviceId || null,
-    groupId: device.groupId || null
-  };
-}
-var DeviceKind = /* @__PURE__ */ ((DeviceKind2) => {
-  DeviceKind2["VideoInput"] = "videoinput";
-  DeviceKind2["AudioInput"] = "audioinput";
-  DeviceKind2["AudioOutput"] = "audiooutput";
-  return DeviceKind2;
-})(DeviceKind || {});
-async function getUserMedia(constraints) {
-  return getMediaDevicesApi().getUserMedia(constraints);
-}
-class DeviceManager {
-  constructor() {
-    __publicField(this, "_knownDevices", []);
-    __publicField(this, "_gainedScreenAccessOnce", false);
-    __publicField(this, "ondevicechange", null);
-    __publicField(this, "getUserMedia", async (constraints) => {
-      const stream = await getUserMedia(constraints);
-      this.enumerateDevices();
-      return stream;
-    });
-    __publicField(this, "getDisplayMedia", async (constraints) => {
-      const stream = await getMediaDevicesApi().getDisplayMedia(constraints);
-      if (!this._gainedScreenAccessOnce) {
-        this._gainedScreenAccessOnce = true;
-        this.enumerateDevices();
-      }
-      return stream;
-    });
-    __publicField(this, "enumerateDevices", async () => {
-      const devices = await enumerateDevices();
-      this._checkForDeviceChanges(devices);
-      return devices;
-    });
-    __publicField(this, "getSupportedConstraints", () => {
-      return getMediaDevicesApi().getSupportedConstraints();
-    });
-    if (supportsMediaDevices()) {
-      getMediaDevicesApi().addEventListener("devicechange", () => {
-        if (this.ondevicechange) {
-          return this.enumerateDevices();
-        }
-        return Promise.resolve();
-      });
-    }
-  }
-  _checkForDeviceChanges(newDevices) {
-    var _a;
-    const oldDevices = this._knownDevices;
-    this._knownDevices = newDevices;
-    const changes = this._calculateDeviceDiff(newDevices, oldDevices);
-    if (changes.length) {
-      (_a = this.ondevicechange) == null ? void 0 : _a.call(this, { changes, devices: newDevices });
-    }
-  }
-  _calculateDeviceDiff(newDevices, oldDevices) {
-    const removals = oldDevices.slice();
-    const updates = [];
-    const additions = newDevices.filter((newDevice) => {
-      const oldDeviceIndex = removals.findIndex((oldDevice) => {
-        return isIdenticalDevice(newDevice, oldDevice);
-      });
-      if (oldDeviceIndex > -1) {
-        const [oldDevice] = removals.splice(oldDeviceIndex, 1);
-        if (newDevice.label !== oldDevice.label) {
-          const update = {
-            type: OperationType.Update,
-            newInfo: newDevice,
-            oldInfo: oldDevice
-          };
-          updates.push(update);
-        }
-      }
-      return oldDeviceIndex === -1;
-    });
-    return [
-      ...updates,
-      ...removals.map((device) => {
-        return { type: OperationType.Remove, device };
-      }),
-      ...additions.map((device) => {
-        return { type: OperationType.Add, device };
-      })
-    ];
-  }
-}
-function isIdenticalDevice(newDevice, oldDevice) {
-  if (oldDevice.deviceId) {
-    return newDevice.deviceId === oldDevice.deviceId;
-  }
-  function toCrudeId(device) {
-    return `${device.kind}:${device.groupId}`;
-  }
-  return toCrudeId(newDevice) === toCrudeId(oldDevice);
-}
-var OperationType = /* @__PURE__ */ ((OperationType2) => {
-  OperationType2["Add"] = "add";
-  OperationType2["Remove"] = "remove";
-  OperationType2["Update"] = "update";
-  return OperationType2;
-})(OperationType || {});
-var index = new DeviceManager();
-export { DeviceKind, OperationType, index as default, supportsMediaDevices };
-//# sourceMappingURL=media-devices.es.js.map

package/dist/media-devices.es.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"media-devices.es.js","sources":["../src/support-detection.ts","../src/enumerate-devices.ts","../src/get-user-media.ts","../src/device-manager.ts","../src/index.ts"],"sourcesContent":["/**\n * Not all browsers support media devices, and some restrict access for\n * insecure sites and private contexts. This is often reflected by removing\n * the `mediaDevices` API entirely.\n */\nexport function supportsMediaDevices() {\n  return typeof navigator !== 'undefined' && !!navigator.mediaDevices;\n}\n\nexport function getMediaDevicesApi() {\n  if (!supportsMediaDevices()) {\n    throw new Error(`The media devices API isn't supported here.`);\n  }\n\n  return navigator.mediaDevices;\n}\n","import { getMediaDevicesApi } from './support-detection';\n\n/**\n * A normalization layer over `MediaDevices.enumerateDevices()`:\n * https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo\n *\n * The API is fraught with cross-browser quirks and fingerprinting blocks.\n * This interface seeks to normalize some of those quirks and make the\n * security tradeoffs obvious.\n */\nexport default async function enumerateDevices(): Promise<Array<DeviceInfo>> {\n  const devices = await getMediaDevicesApi().enumerateDevices();\n  return devices.filter(isPhysicalDevice).map(normalizeDeviceInfo);\n}\n\n/**\n * Chromium does this really annoying thing where it duplicates preferred\n * devices by substituting the ID with \"default\". No other browser does this,\n * and preferred devices are already represented by list order.\n *\n * Since those meta-devices don't add relevant information and risk confusing\n * device UIs, I simply remove them.\n */\nfunction isPhysicalDevice(device: MediaDeviceInfo) {\n  return device.deviceId !== 'default';\n}\n\n// Make nullable fields explicit.\nfunction normalizeDeviceInfo(device: MediaDeviceInfo): DeviceInfo {\n  return {\n    label: device.label || null,\n    kind: device.kind as DeviceKind,\n    deviceId: device.deviceId || null,\n    groupId: device.groupId || null,\n  };\n}\n\nexport interface DeviceInfo {\n  /**\n   * The device list is obfuscated until you gain elevated permissions.\n   * Browsers will use an empty string for the device label until the first\n   * successful `getUserMedia(...)` request.\n   */\n  label: null | string;\n\n  /**\n   * A unique identifier persistent across sessions. Note: In Chromium\n   * browsers, this can be unset if you haven't received permission for the\n   * media resource yet.\n   */\n  deviceId: null | string;\n\n  /**\n   * A unique identifier grouping one or more devices together. Two devices\n   * with the same group ID symbolise that both devices belong to the same\n   * hardware, e.g. a webcam with an integrated microphone. Note: Safari\n   * doesn't support group IDs.\n   */\n  groupId: null | string;\n\n  /**\n   * Declares the type of media provided. This covers microphones, cameras,\n   * and speakers.\n   */\n  kind: DeviceKind;\n}\n\nexport enum DeviceKind {\n  VideoInput = 'videoinput',\n  AudioInput = 'audioinput',\n  AudioOutput = 'audiooutput',\n}\n","import { getMediaDevicesApi } from './support-detection';\n\nexport default async function getUserMedia(\n  constraints: MediaStreamConstraints\n): Promise<MediaStream> {\n  return getMediaDevicesApi().getUserMedia(constraints);\n}\n","import enumerateDevices, { DeviceInfo } from './enumerate-devices';\nimport { getMediaDevicesApi, supportsMediaDevices } from './support-detection';\nimport getUserMedia from './get-user-media';\n\n/**\n * Monitors the set of devices for changes and calculates convenient diffs\n * between updates. Steps are taken to handle cross-browser quirks and\n * attempts graceful integration with browser fingerprinting countermeasures.\n */\nexport default class DeviceManager {\n  private _knownDevices: Array<DeviceInfo> = [];\n  private _gainedScreenAccessOnce = false;\n\n  /**\n   * Specifies a function to be called whenever the list of available devices\n   * changes.\n   *\n   * Note: this is different from the native event. It passes the changeset\n   * and full list of devices as a parameter.\n   */\n  ondevicechange: null | DeviceChangeListener = null;\n\n  constructor() {\n    // Listen for changes at the OS level. If the device list changes and\n    // someone's around to see it, refresh the device list. Refreshing has\n    // a side effect of performing a diff and telling all subscribers about\n    // the change.\n    if (supportsMediaDevices()) {\n      getMediaDevicesApi().addEventListener('devicechange', () => {\n        if (this.ondevicechange) {\n          return this.enumerateDevices();\n        }\n\n        return Promise.resolve();\n      });\n    }\n  }\n\n  /**\n   * Request a live media stream from audio and/or video devices. Streams are\n   * configurable through constraints.\n   * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia\n   */\n  getUserMedia = async (constraints: MediaStreamConstraints) => {\n    const stream = await getUserMedia(constraints);\n\n    // The browser considers us trusted after the first approved GUM query and\n    // allows access to more information in the device list, which is an\n    // implicit device change event. Refresh to update the cache.\n    //\n    // We do this for every GUM request because some browsers only allow\n    // access to the subset of devices you've been approved for. While\n    // reasonable from a security perspective, it means we're never sure if\n    // the cache is stale.\n    this.enumerateDevices();\n\n    return stream;\n  };\n\n  /**\n   * Ask the user to share their screen. Resolves with a media stream carrying\n   * video, and potentially audio from the application window.\n   * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia\n   */\n  getDisplayMedia = async (\n    constraints?: MediaStreamConstraints\n  ): Promise<MediaStream> => {\n    const stream = await getMediaDevicesApi().getDisplayMedia(constraints);\n\n    // Similar to `getUserMedia(...)`, granting access to your screen implies\n    // a certain level of trust. Some browsers will remove the fingerprinting\n    // protections after the first successful call. However, it's unlikely\n    // that another will tell us anything more, so we only refresh devices\n    // after the first success.\n    if (!this._gainedScreenAccessOnce) {\n      this._gainedScreenAccessOnce = true;\n      this.enumerateDevices();\n    }\n\n    return stream;\n  };\n\n  /**\n   * Lists every available hardware device, including microphones, cameras,\n   * and speakers (depending on browser support). May contain redacted\n   * information depending on application permissions.\n   */\n  enumerateDevices = async (): Promise<Array<DeviceInfo>> => {\n    const devices = await enumerateDevices();\n    this._checkForDeviceChanges(devices);\n\n    return devices;\n  };\n\n  /**\n   * Returns an object containing every media constraint supported by the\n   * browser.\n   * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getSupportedConstraints\n   */\n  getSupportedConstraints = (): MediaTrackSupportedConstraints => {\n    return getMediaDevicesApi().getSupportedConstraints();\n  };\n\n  private _checkForDeviceChanges(newDevices: Array<DeviceInfo>) {\n    const oldDevices = this._knownDevices;\n    this._knownDevices = newDevices; // Replace the old devices.\n\n    const changes: Array<DeviceChange> = this._calculateDeviceDiff(\n      newDevices,\n      oldDevices\n    );\n\n    if (changes.length) {\n      this.ondevicechange?.({ changes, devices: newDevices });\n    }\n  }\n\n  /**\n   * Note: The device enumeration API may return null values for device IDs\n   * and labels. To avoid creating erroneous \"Device Added\" notifications,\n   * a best effort should be made to detect when devices are identical.\n   *\n   * Order is significant. Preferred devices are listed first, which helps\n   * correlate devices from permissioned requests with unpermissioned\n   * requests.\n   */\n  private _calculateDeviceDiff(\n    newDevices: Array<DeviceInfo>,\n    oldDevices: Array<DeviceInfo>\n  ): Array<DeviceChange> {\n    const removals = oldDevices.slice();\n    const updates: Array<DeviceChange> = [];\n\n    // If a \"new\" device exists in the list of old devices, then it obviously\n    // wasn't just added and clearly we haven't removed it either. It's the\n    // same device.\n    const additions = newDevices.filter((newDevice) => {\n      const oldDeviceIndex = removals.findIndex((oldDevice) => {\n        return isIdenticalDevice(newDevice, oldDevice);\n      });\n\n      // Note: Nasty state mutation hides here.\n      // Maps/Sets are out of the question due to poor TS support. Plus IDs\n      // are far too unreliable in this context. Iteration and splice() are\n      // ugly and gross, but they work.\n      if (oldDeviceIndex > -1) {\n        const [oldDevice] = removals.splice(oldDeviceIndex, 1);\n\n        if (newDevice.label !== oldDevice.label) {\n          const update: DeviceUpdateEvent = {\n            type: OperationType.Update,\n            newInfo: newDevice,\n            oldInfo: oldDevice,\n          };\n\n          updates.push(update);\n        }\n      }\n\n      // Only count it as an \"addition\" if we couldn't find the same device in\n      // the older set.\n      return oldDeviceIndex === -1;\n    });\n\n    return [\n      ...updates,\n\n      // A device was just removed.\n      ...removals.map((device) => {\n        return { type: OperationType.Remove, device } as DeviceRemoveEvent;\n      }),\n\n      // A device was just plugged in.\n      ...additions.map((device) => {\n        return { type: OperationType.Add, device } as DeviceAddEvent;\n      }),\n    ];\n  }\n}\n\n/**\n * Due to fingerprinting countermeasures, the device ID might be an empty\n * string. We have to resort to vague comparisons. After the first successful\n * `getUserMedia(...)` query, the device ID for all related device kinds\n * should be revealed. In that case the new device will have an ID but the old\n * device won't. It should be safe to assume the inverse never happens.\n *\n * Note: Chromium browsers take a private stance by hiding your extra devices.\n * Even if you have a hundred cameras plugged in, until that first GUM query,\n * you'll only see the preferred one. Same for microphones and output devices.\n */\nfunction isIdenticalDevice(newDevice: DeviceInfo, oldDevice: DeviceInfo) {\n  if (oldDevice.deviceId) {\n    return newDevice.deviceId === oldDevice.deviceId;\n  }\n\n  // These are the only credible fields we have to go on. It may yield a false\n  // positive if you're changing devices before the first GUM query, but since\n  // the lists are ordered by priority, that should be unlikely. It's\n  // certainly preferable to \"new device\" false positives.\n  function toCrudeId(device: DeviceInfo) {\n    return `${device.kind}:${device.groupId}`;\n  }\n\n  return toCrudeId(newDevice) === toCrudeId(oldDevice);\n}\n\nexport type DeviceChange =\n  | DeviceAddEvent\n  | DeviceRemoveEvent\n  | DeviceUpdateEvent;\n\ninterface DeviceAddEvent {\n  type: OperationType.Add;\n  device: DeviceInfo;\n}\n\ninterface DeviceRemoveEvent {\n  type: OperationType.Remove;\n  device: DeviceInfo;\n}\n\ninterface DeviceUpdateEvent {\n  type: OperationType.Update;\n  newInfo: DeviceInfo;\n  oldInfo: DeviceInfo;\n}\n\nexport enum OperationType {\n  Add = 'add',\n  Remove = 'remove',\n  Update = 'update',\n}\n\ninterface DeviceChangeListener {\n  (update: {\n    changes: Array<DeviceChange>;\n    devices: Array<DeviceInfo>;\n  }): unknown;\n}\n","import DeviceManager from './device-manager';\n\nexport { supportsMediaDevices } from './support-detection';\nexport { DeviceKind } from './enumerate-devices';\nexport { OperationType } from './device-manager';\n\nexport type { DeviceInfo } from './enumerate-devices';\nexport type { DeviceChange } from './device-manager';\n\nexport default new DeviceManager();\n"],"names":[],"mappings":"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"}

package/dist/media-devices.umd.d.ts

@@ -1,2 +0,0 @@
-export * from "../src/index"
-export {default} from "../src/index"

package/dist/media-devices.umd.js

@@ -1,2 +0,0 @@
-(function(t,i){typeof exports=="object"&&typeof module!="undefined"?i(exports):typeof define=="function"&&define.amd?define(["exports"],i):(t=typeof globalThis!="undefined"?globalThis:t||self,i(t["media-devices"]={}))})(this,function(t){"use strict";var A=Object.defineProperty;var k=(t,i,s)=>i in t?A(t,i,{enumerable:!0,configurable:!0,writable:!0,value:s}):t[i]=s;var a=(t,i,s)=>(k(t,typeof i!="symbol"?i+"":i,s),s);function i(){return typeof navigator!="undefined"&&!!navigator.mediaDevices}function s(){if(!i())throw new Error("The media devices API isn't supported here.");return navigator.mediaDevices}async function p(){return(await s().enumerateDevices()).filter(h).map(g)}function h(e){return e.deviceId!=="default"}function g(e){return{label:e.label||null,kind:e.kind,deviceId:e.deviceId||null,groupId:e.groupId||null}}var f=(e=>(e.VideoInput="videoinput",e.AudioInput="audioinput",e.AudioOutput="audiooutput",e))(f||{});async function m(e){return s().getUserMedia(e)}class D{constructor(){a(this,"_knownDevices",[]);a(this,"_gainedScreenAccessOnce",!1);a(this,"ondevicechange",null);a(this,"getUserMedia",async n=>{const r=await m(n);return this.enumerateDevices(),r});a(this,"getDisplayMedia",async n=>{const r=await s().getDisplayMedia(n);return this._gainedScreenAccessOnce||(this._gainedScreenAccessOnce=!0,this.enumerateDevices()),r});a(this,"enumerateDevices",async()=>{const n=await p();return this._checkForDeviceChanges(n),n});a(this,"getSupportedConstraints",()=>s().getSupportedConstraints());i()&&s().addEventListener("devicechange",()=>this.ondevicechange?this.enumerateDevices():Promise.resolve())}_checkForDeviceChanges(n){var o;const r=this._knownDevices;this._knownDevices=n;const c=this._calculateDeviceDiff(n,r);c.length&&((o=this.ondevicechange)==null||o.call(this,{changes:c,devices:n}))}_calculateDeviceDiff(n,r){const c=r.slice(),o=[],_=n.filter(d=>{const v=c.findIndex(l=>I(d,l));if(v>-1){const[l]=c.splice(v,1);if(d.label!==l.label){const M={type:u.Update,newInfo:d,oldInfo:l};o.push(M)}}return v===-1});return[...o,...c.map(d=>({type:u.Remove,device:d})),..._.map(d=>({type:u.Add,device:d}))]}}function I(e,n){if(n.deviceId)return e.deviceId===n.deviceId;function r(c){return`${c.kind}:${c.groupId}`}return r(e)===r(n)}var u=(e=>(e.Add="add",e.Remove="remove",e.Update="update",e))(u||{}),y=new D;t.DeviceKind=f,t.OperationType=u,t.default=y,t.supportsMediaDevices=i,Object.defineProperties(t,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})});
-//# sourceMappingURL=media-devices.umd.js.map

package/dist/media-devices.umd.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"media-devices.umd.js","sources":["../src/support-detection.ts","../src/enumerate-devices.ts","../src/get-user-media.ts","../src/device-manager.ts","../src/index.ts"],"sourcesContent":["/**\n * Not all browsers support media devices, and some restrict access for\n * insecure sites and private contexts. This is often reflected by removing\n * the `mediaDevices` API entirely.\n */\nexport function supportsMediaDevices() {\n  return typeof navigator !== 'undefined' && !!navigator.mediaDevices;\n}\n\nexport function getMediaDevicesApi() {\n  if (!supportsMediaDevices()) {\n    throw new Error(`The media devices API isn't supported here.`);\n  }\n\n  return navigator.mediaDevices;\n}\n","import { getMediaDevicesApi } from './support-detection';\n\n/**\n * A normalization layer over `MediaDevices.enumerateDevices()`:\n * https://developer.mozilla.org/en-US/docs/Web/API/MediaDeviceInfo\n *\n * The API is fraught with cross-browser quirks and fingerprinting blocks.\n * This interface seeks to normalize some of those quirks and make the\n * security tradeoffs obvious.\n */\nexport default async function enumerateDevices(): Promise<Array<DeviceInfo>> {\n  const devices = await getMediaDevicesApi().enumerateDevices();\n  return devices.filter(isPhysicalDevice).map(normalizeDeviceInfo);\n}\n\n/**\n * Chromium does this really annoying thing where it duplicates preferred\n * devices by substituting the ID with \"default\". No other browser does this,\n * and preferred devices are already represented by list order.\n *\n * Since those meta-devices don't add relevant information and risk confusing\n * device UIs, I simply remove them.\n */\nfunction isPhysicalDevice(device: MediaDeviceInfo) {\n  return device.deviceId !== 'default';\n}\n\n// Make nullable fields explicit.\nfunction normalizeDeviceInfo(device: MediaDeviceInfo): DeviceInfo {\n  return {\n    label: device.label || null,\n    kind: device.kind as DeviceKind,\n    deviceId: device.deviceId || null,\n    groupId: device.groupId || null,\n  };\n}\n\nexport interface DeviceInfo {\n  /**\n   * The device list is obfuscated until you gain elevated permissions.\n   * Browsers will use an empty string for the device label until the first\n   * successful `getUserMedia(...)` request.\n   */\n  label: null | string;\n\n  /**\n   * A unique identifier persistent across sessions. Note: In Chromium\n   * browsers, this can be unset if you haven't received permission for the\n   * media resource yet.\n   */\n  deviceId: null | string;\n\n  /**\n   * A unique identifier grouping one or more devices together. Two devices\n   * with the same group ID symbolise that both devices belong to the same\n   * hardware, e.g. a webcam with an integrated microphone. Note: Safari\n   * doesn't support group IDs.\n   */\n  groupId: null | string;\n\n  /**\n   * Declares the type of media provided. This covers microphones, cameras,\n   * and speakers.\n   */\n  kind: DeviceKind;\n}\n\nexport enum DeviceKind {\n  VideoInput = 'videoinput',\n  AudioInput = 'audioinput',\n  AudioOutput = 'audiooutput',\n}\n","import { getMediaDevicesApi } from './support-detection';\n\nexport default async function getUserMedia(\n  constraints: MediaStreamConstraints\n): Promise<MediaStream> {\n  return getMediaDevicesApi().getUserMedia(constraints);\n}\n","import enumerateDevices, { DeviceInfo } from './enumerate-devices';\nimport { getMediaDevicesApi, supportsMediaDevices } from './support-detection';\nimport getUserMedia from './get-user-media';\n\n/**\n * Monitors the set of devices for changes and calculates convenient diffs\n * between updates. Steps are taken to handle cross-browser quirks and\n * attempts graceful integration with browser fingerprinting countermeasures.\n */\nexport default class DeviceManager {\n  private _knownDevices: Array<DeviceInfo> = [];\n  private _gainedScreenAccessOnce = false;\n\n  /**\n   * Specifies a function to be called whenever the list of available devices\n   * changes.\n   *\n   * Note: this is different from the native event. It passes the changeset\n   * and full list of devices as a parameter.\n   */\n  ondevicechange: null | DeviceChangeListener = null;\n\n  constructor() {\n    // Listen for changes at the OS level. If the device list changes and\n    // someone's around to see it, refresh the device list. Refreshing has\n    // a side effect of performing a diff and telling all subscribers about\n    // the change.\n    if (supportsMediaDevices()) {\n      getMediaDevicesApi().addEventListener('devicechange', () => {\n        if (this.ondevicechange) {\n          return this.enumerateDevices();\n        }\n\n        return Promise.resolve();\n      });\n    }\n  }\n\n  /**\n   * Request a live media stream from audio and/or video devices. Streams are\n   * configurable through constraints.\n   * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getUserMedia\n   */\n  getUserMedia = async (constraints: MediaStreamConstraints) => {\n    const stream = await getUserMedia(constraints);\n\n    // The browser considers us trusted after the first approved GUM query and\n    // allows access to more information in the device list, which is an\n    // implicit device change event. Refresh to update the cache.\n    //\n    // We do this for every GUM request because some browsers only allow\n    // access to the subset of devices you've been approved for. While\n    // reasonable from a security perspective, it means we're never sure if\n    // the cache is stale.\n    this.enumerateDevices();\n\n    return stream;\n  };\n\n  /**\n   * Ask the user to share their screen. Resolves with a media stream carrying\n   * video, and potentially audio from the application window.\n   * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getDisplayMedia\n   */\n  getDisplayMedia = async (\n    constraints?: MediaStreamConstraints\n  ): Promise<MediaStream> => {\n    const stream = await getMediaDevicesApi().getDisplayMedia(constraints);\n\n    // Similar to `getUserMedia(...)`, granting access to your screen implies\n    // a certain level of trust. Some browsers will remove the fingerprinting\n    // protections after the first successful call. However, it's unlikely\n    // that another will tell us anything more, so we only refresh devices\n    // after the first success.\n    if (!this._gainedScreenAccessOnce) {\n      this._gainedScreenAccessOnce = true;\n      this.enumerateDevices();\n    }\n\n    return stream;\n  };\n\n  /**\n   * Lists every available hardware device, including microphones, cameras,\n   * and speakers (depending on browser support). May contain redacted\n   * information depending on application permissions.\n   */\n  enumerateDevices = async (): Promise<Array<DeviceInfo>> => {\n    const devices = await enumerateDevices();\n    this._checkForDeviceChanges(devices);\n\n    return devices;\n  };\n\n  /**\n   * Returns an object containing every media constraint supported by the\n   * browser.\n   * See: https://developer.mozilla.org/en-US/docs/Web/API/MediaDevices/getSupportedConstraints\n   */\n  getSupportedConstraints = (): MediaTrackSupportedConstraints => {\n    return getMediaDevicesApi().getSupportedConstraints();\n  };\n\n  private _checkForDeviceChanges(newDevices: Array<DeviceInfo>) {\n    const oldDevices = this._knownDevices;\n    this._knownDevices = newDevices; // Replace the old devices.\n\n    const changes: Array<DeviceChange> = this._calculateDeviceDiff(\n      newDevices,\n      oldDevices\n    );\n\n    if (changes.length) {\n      this.ondevicechange?.({ changes, devices: newDevices });\n    }\n  }\n\n  /**\n   * Note: The device enumeration API may return null values for device IDs\n   * and labels. To avoid creating erroneous \"Device Added\" notifications,\n   * a best effort should be made to detect when devices are identical.\n   *\n   * Order is significant. Preferred devices are listed first, which helps\n   * correlate devices from permissioned requests with unpermissioned\n   * requests.\n   */\n  private _calculateDeviceDiff(\n    newDevices: Array<DeviceInfo>,\n    oldDevices: Array<DeviceInfo>\n  ): Array<DeviceChange> {\n    const removals = oldDevices.slice();\n    const updates: Array<DeviceChange> = [];\n\n    // If a \"new\" device exists in the list of old devices, then it obviously\n    // wasn't just added and clearly we haven't removed it either. It's the\n    // same device.\n    const additions = newDevices.filter((newDevice) => {\n      const oldDeviceIndex = removals.findIndex((oldDevice) => {\n        return isIdenticalDevice(newDevice, oldDevice);\n      });\n\n      // Note: Nasty state mutation hides here.\n      // Maps/Sets are out of the question due to poor TS support. Plus IDs\n      // are far too unreliable in this context. Iteration and splice() are\n      // ugly and gross, but they work.\n      if (oldDeviceIndex > -1) {\n        const [oldDevice] = removals.splice(oldDeviceIndex, 1);\n\n        if (newDevice.label !== oldDevice.label) {\n          const update: DeviceUpdateEvent = {\n            type: OperationType.Update,\n            newInfo: newDevice,\n            oldInfo: oldDevice,\n          };\n\n          updates.push(update);\n        }\n      }\n\n      // Only count it as an \"addition\" if we couldn't find the same device in\n      // the older set.\n      return oldDeviceIndex === -1;\n    });\n\n    return [\n      ...updates,\n\n      // A device was just removed.\n      ...removals.map((device) => {\n        return { type: OperationType.Remove, device } as DeviceRemoveEvent;\n      }),\n\n      // A device was just plugged in.\n      ...additions.map((device) => {\n        return { type: OperationType.Add, device } as DeviceAddEvent;\n      }),\n    ];\n  }\n}\n\n/**\n * Due to fingerprinting countermeasures, the device ID might be an empty\n * string. We have to resort to vague comparisons. After the first successful\n * `getUserMedia(...)` query, the device ID for all related device kinds\n * should be revealed. In that case the new device will have an ID but the old\n * device won't. It should be safe to assume the inverse never happens.\n *\n * Note: Chromium browsers take a private stance by hiding your extra devices.\n * Even if you have a hundred cameras plugged in, until that first GUM query,\n * you'll only see the preferred one. Same for microphones and output devices.\n */\nfunction isIdenticalDevice(newDevice: DeviceInfo, oldDevice: DeviceInfo) {\n  if (oldDevice.deviceId) {\n    return newDevice.deviceId === oldDevice.deviceId;\n  }\n\n  // These are the only credible fields we have to go on. It may yield a false\n  // positive if you're changing devices before the first GUM query, but since\n  // the lists are ordered by priority, that should be unlikely. It's\n  // certainly preferable to \"new device\" false positives.\n  function toCrudeId(device: DeviceInfo) {\n    return `${device.kind}:${device.groupId}`;\n  }\n\n  return toCrudeId(newDevice) === toCrudeId(oldDevice);\n}\n\nexport type DeviceChange =\n  | DeviceAddEvent\n  | DeviceRemoveEvent\n  | DeviceUpdateEvent;\n\ninterface DeviceAddEvent {\n  type: OperationType.Add;\n  device: DeviceInfo;\n}\n\ninterface DeviceRemoveEvent {\n  type: OperationType.Remove;\n  device: DeviceInfo;\n}\n\ninterface DeviceUpdateEvent {\n  type: OperationType.Update;\n  newInfo: DeviceInfo;\n  oldInfo: DeviceInfo;\n}\n\nexport enum OperationType {\n  Add = 'add',\n  Remove = 'remove',\n  Update = 'update',\n}\n\ninterface DeviceChangeListener {\n  (update: {\n    changes: Array<DeviceChange>;\n    devices: Array<DeviceInfo>;\n  }): unknown;\n}\n","import DeviceManager from './device-manager';\n\nexport { supportsMediaDevices } from './support-detection';\nexport { DeviceKind } from './enumerate-devices';\nexport { OperationType } from './device-manager';\n\nexport type { DeviceInfo } from './enumerate-devices';\nexport type { DeviceChange } from './device-manager';\n\nexport default new DeviceManager();\n"],"names":[],"mappings":"kaAKuC,YAAA,CACrC,MAAO,OAAO,YAAc,aAAe,CAAC,CAAC,UAAU,YACzD,CAEqC,YAAA,CAC/B,GAAA,CAAC,IACG,KAAA,IAAI,OAAM,6CAA6C,EAG/D,MAAO,WAAU,YACnB,CCL6E,kBAAA,CAE3E,MAAO,AADS,MAAM,GAAmB,EAAE,iBAAiB,GAC7C,OAAO,CAAgB,EAAE,IAAI,CAAmB,CACjE,CAUA,WAA0B,EAAyB,CACjD,MAAO,GAAO,WAAa,SAC7B,CAGA,WAA6B,EAAqC,CACzD,MAAA,CACL,MAAO,EAAO,OAAS,KACvB,KAAM,EAAO,KACb,SAAU,EAAO,UAAY,KAC7B,QAAS,EAAO,SAAW,IAAA,CAE/B,CAgCY,GAAA,IAAA,GACG,GAAA,WAAA,aACA,EAAA,WAAA,aACC,EAAA,YAAA,cAHJ,IAAA,GAAA,CAAA,CAAA,ECjEZ,iBACE,EACsB,CACf,MAAA,GAAqB,EAAA,aAAa,CAAW,CACtD,CCGA,MAAqB,CAAc,CAajC,aAAc,CAZN,uBAAmC,CAAA,GAC3C,iCAAkC,IASlC,wBAA8C,MAuB9C,sBAAe,KAAO,IAAwC,CACtD,KAAA,GAAS,KAAM,GAAa,CAAW,EAU7C,YAAK,iBAAiB,EAEf,CAAA,GAQT,yBAAkB,KAChB,IACyB,CACzB,KAAM,GAAS,KAAM,GAAmB,EAAE,gBAAgB,CAAW,EAOjE,MAAC,MAAK,yBACR,MAAK,wBAA0B,GAC/B,KAAK,iBAAiB,GAGjB,CAAA,GAQT,0BAAmB,SAAwC,CACnD,KAAA,GAAU,KAAM,KACtB,YAAK,uBAAuB,CAAO,EAE5B,CAAA,GAQT,iCAA0B,IACjB,EAAA,EAAqB,2BAzE5B,AAAI,KACiB,EAAA,EAAE,iBAAiB,eAAgB,IAChD,KAAK,eACA,KAAK,mBAGP,QAAQ,SAChB,CAEL,CAmEQ,uBAAuB,EAA+B,OAC5D,KAAM,GAAa,KAAK,cACxB,KAAK,cAAgB,EAErB,KAAM,GAA+B,KAAK,qBACxC,EACA,CACF,EAEA,AAAI,EAAQ,QACV,SAAK,iBAAL,kBAAsB,CAAE,UAAS,QAAS,CAAY,GAE1D,CAWQ,qBACN,EACA,EACqB,CACf,KAAA,GAAW,EAAW,QACtB,EAA+B,CAAA,EAK/B,EAAY,EAAW,OAAO,AAAC,GAAc,CACjD,KAAM,GAAiB,EAAS,UAAU,AAAC,GAClC,EAAkB,EAAW,CAAS,CAC9C,EAMD,GAAI,EAAiB,GAAI,CACvB,KAAM,CAAC,GAAa,EAAS,OAAO,EAAgB,CAAC,EAEjD,GAAA,EAAU,QAAU,EAAU,MAAO,CACvC,KAAM,GAA4B,CAChC,KAAM,EAAc,OACpB,QAAS,EACT,QAAS,CAAA,EAGX,EAAQ,KAAK,CAAM,CACrB,CACF,CAIA,MAAO,KAAmB,EAAA,CAC3B,EAEM,MAAA,CACL,GAAG,EAGH,GAAG,EAAS,IAAI,AAAC,GACR,EAAE,KAAM,EAAc,OAAQ,QAAO,EAC7C,EAGD,GAAG,EAAU,IAAI,AAAC,GACT,EAAE,KAAM,EAAc,IAAK,QAAO,EAC1C,CAAA,CAEL,CACF,CAaA,WAA2B,EAAuB,EAAuB,CACvE,GAAI,EAAU,SACL,MAAA,GAAU,WAAa,EAAU,SAO1C,WAAmB,EAAoB,CAC9B,MAAA,GAAG,EAAO,QAAQ,EAAO,SAClC,CAEA,MAAO,GAAU,CAAS,IAAM,EAAU,CAAS,CACrD,CAuBY,GAAA,IAAA,GACJ,GAAA,IAAA,MACG,EAAA,OAAA,SACA,EAAA,OAAA,SAHC,IAAA,GAAA,CAAA,CAAA,EC3NG,EAAA,GAAI"}