@spaced-out/ui-design-system 0.4.15-beta.0 → 0.4.15

package/lib/utils/date-range-picker/timezones.js.flow

@@ -0,0 +1,269 @@
+// @flow strict
+
+// $FlowFixMe[untyped-import]
+import moment from 'moment-timezone';
+
+
+export const TIMEZONES = {
+  'Pacific/Niue': '(GMT-11:00) Niue',
+  'Pacific/Pago_Pago': '(GMT-11:00) Pago Pago',
+  'Pacific/Honolulu': '(GMT-10:00) Hawaii Time',
+  'Pacific/Rarotonga': '(GMT-10:00) Rarotonga',
+  'Pacific/Tahiti': '(GMT-10:00) Tahiti',
+  'Pacific/Marquesas': '(GMT-09:30) Marquesas',
+  'America/Anchorage': '(GMT-09:00) Alaska Time',
+  'Pacific/Gambier': '(GMT-09:00) Gambier',
+  'America/Los_Angeles': '(GMT-08:00) Pacific Time',
+  'America/Tijuana': '(GMT-08:00) Pacific Time - Tijuana',
+  'America/Vancouver': '(GMT-08:00) Pacific Time - Vancouver',
+  'America/Whitehorse': '(GMT-08:00) Pacific Time - Whitehorse',
+  'Pacific/Pitcairn': '(GMT-08:00) Pitcairn',
+  'America/Dawson_Creek': '(GMT-07:00) Mountain Time - Dawson Creek',
+  'America/Denver': '(GMT-07:00) Mountain Time',
+  'America/Edmonton': '(GMT-07:00) Mountain Time - Edmonton',
+  'America/Hermosillo': '(GMT-07:00) Mountain Time - Hermosillo',
+  'America/Mazatlan': '(GMT-07:00) Mountain Time - Chihuahua, Mazatlan',
+  'America/Phoenix': '(GMT-07:00) Mountain Time - Arizona',
+  'America/Yellowknife': '(GMT-07:00) Mountain Time - Yellowknife',
+  'America/Belize': '(GMT-06:00) Belize',
+  'America/Chicago': '(GMT-06:00) Central Time',
+  'America/Costa_Rica': '(GMT-06:00) Costa Rica',
+  'America/El_Salvador': '(GMT-06:00) El Salvador',
+  'America/Guatemala': '(GMT-06:00) Guatemala',
+  'America/Managua': '(GMT-06:00) Managua',
+  'America/Mexico_City': '(GMT-06:00) Central Time - Mexico City',
+  'America/Regina': '(GMT-06:00) Central Time - Regina',
+  'America/Tegucigalpa': '(GMT-06:00) Central Time - Tegucigalpa',
+  'America/Winnipeg': '(GMT-06:00) Central Time - Winnipeg',
+  'Pacific/Galapagos': '(GMT-06:00) Galapagos',
+  'America/Bogota': '(GMT-05:00) Bogota',
+  'America/Cancun': '(GMT-05:00) America Cancun',
+  'America/Cayman': '(GMT-05:00) Cayman',
+  'America/Guayaquil': '(GMT-05:00) Guayaquil',
+  'America/Havana': '(GMT-05:00) Havana',
+  'America/Iqaluit': '(GMT-05:00) Eastern Time - Iqaluit',
+  'America/Jamaica': '(GMT-05:00) Jamaica',
+  'America/Lima': '(GMT-05:00) Lima',
+  'America/Nassau': '(GMT-05:00) Nassau',
+  'America/New_York': '(GMT-05:00) Eastern Time',
+  'America/Panama': '(GMT-05:00) Panama',
+  'America/Port-au-Prince': '(GMT-05:00) Port-au-Prince',
+  'America/Rio_Branco': '(GMT-05:00) Rio Branco',
+  'America/Toronto': '(GMT-05:00) Eastern Time - Toronto',
+  'Pacific/Easter': '(GMT-05:00) Easter Island',
+  'America/Caracas': '(GMT-04:00) Caracas',
+  'America/Asuncion': '(GMT-03:00) Asuncion',
+  'America/Barbados': '(GMT-04:00) Barbados',
+  'America/Boa_Vista': '(GMT-04:00) Boa Vista',
+  'America/Campo_Grande': '(GMT-03:00) Campo Grande',
+  'America/Cuiaba': '(GMT-03:00) Cuiaba',
+  'America/Curacao': '(GMT-04:00) Curacao',
+  'America/Grand_Turk': '(GMT-04:00) Grand Turk',
+  'America/Guyana': '(GMT-04:00) Guyana',
+  'America/Halifax': '(GMT-04:00) Atlantic Time - Halifax',
+  'America/La_Paz': '(GMT-04:00) La Paz',
+  'America/Manaus': '(GMT-04:00) Manaus',
+  'America/Martinique': '(GMT-04:00) Martinique',
+  'America/Port_of_Spain': '(GMT-04:00) Port of Spain',
+  'America/Porto_Velho': '(GMT-04:00) Porto Velho',
+  'America/Puerto_Rico': '(GMT-04:00) Puerto Rico',
+  'America/Santo_Domingo': '(GMT-04:00) Santo Domingo',
+  'America/Thule': '(GMT-04:00) Thule',
+  'Atlantic/Bermuda': '(GMT-04:00) Bermuda',
+  'America/St_Johns': '(GMT-03:30) Newfoundland Time - St. Johns',
+  'America/Araguaina': '(GMT-03:00) Araguaina',
+  'America/Argentina/Buenos_Aires': '(GMT-03:00) Buenos Aires',
+  'America/Bahia': '(GMT-03:00) Salvador',
+  'America/Belem': '(GMT-03:00) Belem',
+  'America/Cayenne': '(GMT-03:00) Cayenne',
+  'America/Fortaleza': '(GMT-03:00) Fortaleza',
+  'America/Godthab': '(GMT-03:00) Godthab',
+  'America/Maceio': '(GMT-03:00) Maceio',
+  'America/Miquelon': '(GMT-03:00) Miquelon',
+  'America/Montevideo': '(GMT-03:00) Montevideo',
+  'America/Paramaribo': '(GMT-03:00) Paramaribo',
+  'America/Recife': '(GMT-03:00) Recife',
+  'America/Santiago': '(GMT-03:00) Santiago',
+  'America/Sao_Paulo': '(GMT-03:00) Sao Paulo',
+  'Antarctica/Palmer': '(GMT-03:00) Palmer',
+  'Antarctica/Rothera': '(GMT-03:00) Rothera',
+  'Atlantic/Stanley': '(GMT-03:00) Stanley',
+  'America/Noronha': '(GMT-02:00) Noronha',
+  'Atlantic/South_Georgia': '(GMT-02:00) South Georgia',
+  'America/Scoresbysund': '(GMT-01:00) Scoresbysund',
+  'Atlantic/Azores': '(GMT-01:00) Azores',
+  'Atlantic/Cape_Verde': '(GMT-01:00) Cape Verde',
+  'Africa/Abidjan': '(GMT+00:00) Abidjan',
+  'Africa/Accra': '(GMT+00:00) Accra',
+  'Africa/Bissau': '(GMT+00:00) Bissau',
+  'Africa/Casablanca': '(GMT+00:00) Casablanca',
+  'Africa/El_Aaiun': '(GMT+00:00) El Aaiun',
+  'Africa/Monrovia': '(GMT+00:00) Monrovia',
+  'America/Danmarkshavn': '(GMT+00:00) Danmarkshavn',
+  'Atlantic/Canary': '(GMT+00:00) Canary Islands',
+  'Atlantic/Faroe': '(GMT+00:00) Faeroe',
+  'Atlantic/Reykjavik': '(GMT+00:00) Reykjavik',
+  'Etc/GMT': '(GMT+00:00) GMT (no daylight saving)',
+  'Europe/Dublin': '(GMT+00:00) Dublin',
+  'Europe/Lisbon': '(GMT+00:00) Lisbon',
+  'Europe/London': '(GMT+00:00) London',
+  'Africa/Algiers': '(GMT+01:00) Algiers',
+  'Africa/Ceuta': '(GMT+01:00) Ceuta',
+  'Africa/Lagos': '(GMT+01:00) Lagos',
+  'Africa/Ndjamena': '(GMT+01:00) Ndjamena',
+  'Africa/Tunis': '(GMT+01:00) Tunis',
+  'Africa/Windhoek': '(GMT+02:00) Windhoek',
+  'Europe/Amsterdam': '(GMT+01:00) Amsterdam',
+  'Europe/Andorra': '(GMT+01:00) Andorra',
+  'Europe/Belgrade': '(GMT+01:00) Central European Time - Belgrade',
+  'Europe/Berlin': '(GMT+01:00) Berlin',
+  'Europe/Brussels': '(GMT+01:00) Brussels',
+  'Europe/Budapest': '(GMT+01:00) Budapest',
+  'Europe/Copenhagen': '(GMT+01:00) Copenhagen',
+  'Europe/Gibraltar': '(GMT+01:00) Gibraltar',
+  'Europe/Luxembourg': '(GMT+01:00) Luxembourg',
+  'Europe/Madrid': '(GMT+01:00) Madrid',
+  'Europe/Malta': '(GMT+01:00) Malta',
+  'Europe/Monaco': '(GMT+01:00) Monaco',
+  'Europe/Oslo': '(GMT+01:00) Oslo',
+  'Europe/Paris': '(GMT+01:00) Paris',
+  'Europe/Prague': '(GMT+01:00) Central European Time - Prague',
+  'Europe/Rome': '(GMT+01:00) Rome',
+  'Europe/Stockholm': '(GMT+01:00) Stockholm',
+  'Europe/Tirane': '(GMT+01:00) Tirane',
+  'Europe/Vienna': '(GMT+01:00) Vienna',
+  'Europe/Warsaw': '(GMT+01:00) Warsaw',
+  'Europe/Zurich': '(GMT+01:00) Zurich',
+  'Africa/Cairo': '(GMT+02:00) Cairo',
+  'Africa/Johannesburg': '(GMT+02:00) Johannesburg',
+  'Africa/Maputo': '(GMT+02:00) Maputo',
+  'Africa/Tripoli': '(GMT+02:00) Tripoli',
+  'Asia/Amman': '(GMT+02:00) Amman',
+  'Asia/Beirut': '(GMT+02:00) Beirut',
+  'Asia/Damascus': '(GMT+02:00) Damascus',
+  'Asia/Gaza': '(GMT+02:00) Gaza',
+  'Asia/Jerusalem': '(GMT+02:00) Jerusalem',
+  'Asia/Nicosia': '(GMT+02:00) Nicosia',
+  'Europe/Athens': '(GMT+02:00) Athens',
+  'Europe/Bucharest': '(GMT+02:00) Bucharest',
+  'Europe/Chisinau': '(GMT+02:00) Chisinau',
+  'Europe/Helsinki': '(GMT+02:00) Helsinki',
+  'Europe/Istanbul': '(GMT+03:00) Istanbul',
+  'Europe/Kaliningrad': '(GMT+02:00) Moscow-01 - Kaliningrad',
+  'Europe/Kyiv': '(GMT+02:00) Kyiv',
+  'Europe/Riga': '(GMT+02:00) Riga',
+  'Europe/Sofia': '(GMT+02:00) Sofia',
+  'Europe/Tallinn': '(GMT+02:00) Tallinn',
+  'Europe/Vilnius': '(GMT+02:00) Vilnius',
+  'Africa/Khartoum': '(GMT+03:00) Khartoum',
+  'Africa/Nairobi': '(GMT+03:00) Nairobi',
+  'Antarctica/Syowa': '(GMT+03:00) Syowa',
+  'Asia/Baghdad': '(GMT+03:00) Baghdad',
+  'Asia/Qatar': '(GMT+03:00) Qatar',
+  'Asia/Riyadh': '(GMT+03:00) Riyadh',
+  'Europe/Minsk': '(GMT+03:00) Minsk',
+  'Europe/Moscow': '(GMT+03:00) Moscow+00 - Moscow',
+  'Asia/Tehran': '(GMT+03:30) Tehran',
+  'Asia/Baku': '(GMT+04:00) Baku',
+  'Asia/Dubai': '(GMT+04:00) Dubai',
+  'Asia/Tbilisi': '(GMT+04:00) Tbilisi',
+  'Asia/Yerevan': '(GMT+04:00) Yerevan',
+  'Europe/Samara': '(GMT+04:00) Moscow+01 - Samara',
+  'Indian/Mahe': '(GMT+04:00) Mahe',
+  'Indian/Mauritius': '(GMT+04:00) Mauritius',
+  'Indian/Reunion': '(GMT+04:00) Reunion',
+  'Asia/Kabul': '(GMT+04:30) Kabul',
+  'Antarctica/Mawson': '(GMT+05:00) Mawson',
+  'Asia/Aqtau': '(GMT+05:00) Aqtau',
+  'Asia/Aqtobe': '(GMT+05:00) Aqtobe',
+  'Asia/Ashgabat': '(GMT+05:00) Ashgabat',
+  'Asia/Dushanbe': '(GMT+05:00) Dushanbe',
+  'Asia/Karachi': '(GMT+05:00) Karachi',
+  'Asia/Tashkent': '(GMT+05:00) Tashkent',
+  'Asia/Yekaterinburg': '(GMT+05:00) Moscow+02 - Yekaterinburg',
+  'Indian/Kerguelen': '(GMT+05:00) Kerguelen',
+  'Indian/Maldives': '(GMT+05:00) Maldives',
+  'Asia/Calcutta': '(GMT+05:30) India Standard Time',
+  'Asia/Colombo': '(GMT+05:30) Colombo',
+  'Asia/Katmandu': '(GMT+05:45) Katmandu',
+  'Antarctica/Vostok': '(GMT+06:00) Vostok',
+  'Asia/Almaty': '(GMT+06:00) Almaty',
+  'Asia/Bishkek': '(GMT+06:00) Bishkek',
+  'Asia/Dhaka': '(GMT+06:00) Dhaka',
+  'Asia/Omsk': '(GMT+06:00) Moscow+03 - Omsk, Novosibirsk',
+  'Asia/Thimphu': '(GMT+06:00) Thimphu',
+  'Indian/Chagos': '(GMT+06:00) Chagos',
+  'Asia/Rangoon': '(GMT+06:30) Rangoon',
+  'Indian/Cocos': '(GMT+06:30) Cocos',
+  'Antarctica/Davis': '(GMT+07:00) Davis',
+  'Asia/Bangkok': '(GMT+07:00) Bangkok',
+  'Asia/Hovd': '(GMT+07:00) Hovd',
+  'Asia/Jakarta': '(GMT+07:00) Jakarta',
+  'Asia/Krasnoyarsk': '(GMT+07:00) Moscow+04 - Krasnoyarsk',
+  'Asia/Saigon': '(GMT+07:00) Hanoi',
+  'Asia/Ho_Chi_Minh': '(GMT+07:00) Ho Chi Minh',
+  'Indian/Christmas': '(GMT+07:00) Christmas',
+  'Antarctica/Casey': '(GMT+08:00) Casey',
+  'Asia/Brunei': '(GMT+08:00) Brunei',
+  'Asia/Choibalsan': '(GMT+08:00) Choibalsan',
+  'Asia/Hong_Kong': '(GMT+08:00) Hong Kong',
+  'Asia/Irkutsk': '(GMT+08:00) Moscow+05 - Irkutsk',
+  'Asia/Kuala_Lumpur': '(GMT+08:00) Kuala Lumpur',
+  'Asia/Macau': '(GMT+08:00) Macau',
+  'Asia/Makassar': '(GMT+08:00) Makassar',
+  'Asia/Manila': '(GMT+08:00) Manila',
+  'Asia/Shanghai': '(GMT+08:00) China Time - Beijing',
+  'Asia/Singapore': '(GMT+08:00) Singapore',
+  'Asia/Taipei': '(GMT+08:00) Taipei',
+  'Asia/Ulaanbaatar': '(GMT+08:00) Ulaanbaatar',
+  'Australia/Perth': '(GMT+08:00) Western Time - Perth',
+  'Asia/Pyongyang': '(GMT+08:30) Pyongyang',
+  'Asia/Dili': '(GMT+09:00) Dili',
+  'Asia/Jayapura': '(GMT+09:00) Jayapura',
+  'Asia/Seoul': '(GMT+09:00) Seoul',
+  'Asia/Tokyo': '(GMT+09:00) Tokyo',
+  'Asia/Yakutsk': '(GMT+09:00) Moscow+06 - Yakutsk',
+  'Pacific/Palau': '(GMT+09:00) Palau',
+  'Australia/Adelaide': '(GMT+10:30) Central Time - Adelaide',
+  'Australia/Darwin': '(GMT+09:30) Central Time - Darwin',
+  'Antarctica/DumontDUrville': '(GMT+10:00) Dumont D\'Urville',
+  'Asia/Magadan': '(GMT+10:00) Moscow+07 - Magadan',
+  'Asia/Vladivostok': '(GMT+10:00) Moscow+07 - Vladivostok',
+  'Australia/Brisbane': '(GMT+10:00) Eastern Time - Brisbane',
+  'Asia/Sakhalin': '(GMT+11:00) Moscow+08 - Yuzhno-Sakhalin',
+  'Australia/Hobart': '(GMT+11:00) Eastern Time - Hobart',
+  'Australia/Sydney': '(GMT+11:00) Eastern Time - Melbourne, Sydney',
+  'Pacific/Chuuk': '(GMT+10:00) Truk',
+  'Pacific/Guam': '(GMT+10:00) Guam',
+  'Pacific/Port_Moresby': '(GMT+10:00) Port Moresby',
+  'Pacific/Efate': '(GMT+11:00) Efate',
+  'Pacific/Guadalcanal': '(GMT+11:00) Guadalcanal',
+  'Pacific/Kosrae': '(GMT+11:00) Kosrae',
+  'Pacific/Norfolk': '(GMT+11:00) Norfolk',
+  'Pacific/Noumea': '(GMT+11:00) Noumea',
+  'Pacific/Pohnpei': '(GMT+11:00) Ponape',
+  'Asia/Kamchatka': '(GMT+12:00) Moscow+09 - Petropavlovsk-Kamchatskiy',
+  'Pacific/Auckland': '(GMT+13:00) Auckland',
+  'Pacific/Fiji': '(GMT+13:00) Fiji',
+  'Pacific/Funafuti': '(GMT+12:00) Funafuti',
+  'Pacific/Kwajalein': '(GMT+12:00) Kwajalein',
+  'Pacific/Majuro': '(GMT+12:00) Majuro',
+  'Pacific/Nauru': '(GMT+12:00) Nauru',
+  'Pacific/Tarawa': '(GMT+12:00) Tarawa',
+  'Pacific/Wake': '(GMT+12:00) Wake',
+  'Pacific/Wallis': '(GMT+12:00) Wallis',
+  'Pacific/Apia': '(GMT+14:00) Apia',
+  'Pacific/Enderbury': '(GMT+13:00) Enderbury',
+  'Pacific/Fakaofo': '(GMT+13:00) Fakaofo',
+  'Pacific/Tongatapu': '(GMT+13:00) Tongatapu',
+  'Pacific/Kiritimati': '(GMT+14:00) Kiritimati',
+};
+
+export const addTimezoneStartOfDay = (date: string, timezone: string): string =>
+  moment.tz(date, timezone).startOf('d').toISOString();
+
+export const addTimezoneEndOfDay = (date: string, timezone: string): string =>
+  moment.tz(date, timezone).endOf('d').toISOString();
+
+export const getTodayInTimezone = (timezone: string): string =>
+  moment.tz(timezone).format('YYYY-MM-DD');

package/lib/utils/dom/dom.js

@@ -110,18 +110,14 @@ function pxToNumber(px) {
 
 // TODO (kyle): add more handler types?
 
-function listen(target, handlers,
-// @ts-ignore
-options) {
+function listen(target, handlers, options) {
   let hook = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : 'addEventListener';
   for (const eventName in handlers) {
-    // @ts-ignore - TS2345 - Argument of type '((arg1: Event) => unknown) | undefined' is not assignable to parameter of type 'EventListenerOrEventListenerObject | null'.
+    // $FlowFixMe indexing valid EventTarget properties
     target[hook](eventName, handlers[eventName], options);
   }
 }
-function forget(target, events,
-// @ts-ignore
-options) {
+function forget(target, events, options) {
   return listen(target, events, options, 'removeEventListener');
 }
 function stopEvent(event) {
@@ -137,8 +133,8 @@ function cancelEvent(event) {
 function requestPointerLock(element) {
   return new Promise((resolve, reject) => {
     const handleChange = () => {
+      // $FlowIssue
       if (document.pointerLockElement === element) {
-        // @ts-ignore - TS2794 - Expected 1 arguments, but got 0. Did you forget to include 'void' in your type argument to 'Promise'?
         resolve();
         removeHandlers();
       }
@@ -148,12 +144,14 @@ function requestPointerLock(element) {
       removeHandlers();
     };
     const removeHandlers = () => {
-      // @ts-ignore - TS2554 - Expected 3 arguments, but got 2.
+      // $FlowFixMe
       forget(document, {
         pointerlockchange: handleChange,
         pointerlockerror: handleError
       });
     };
+
+    // $FlowFixMe
     listen(document, {
       pointerlockchange: handleChange,
       pointerlockerror: handleError

package/lib/utils/dom/dom.js.flow

@@ -0,0 +1,238 @@
+// @flow strict
+
+export type Placement = 'top' | 'left' | 'right' | 'bottom';
+export type ArrowPosition = 'start' | 'center' | 'end';
+export type Justify = ArrowPosition;
+
+export type PositionedPlacement = {
+  placement: Placement,
+  x: number,
+  y: number,
+};
+
+export function createElement(
+  document: Document,
+  type: string,
+  props: {[string]: mixed, ...},
+): HTMLElement {
+  const el = document.createElement(type);
+  return Object.assign(el, props);
+}
+
+export function pageHeight(): number {
+  const {body, documentElement} = window.document;
+  return Math.max(
+    body.scrollHeight,
+    body.clientHeight,
+    documentElement.scrollHeight,
+    documentElement.clientHeight,
+  );
+}
+
+export function getFixedAnchorPosition(
+  element: HTMLElement,
+  placement: Placement = 'top',
+  pad?: number = 0,
+  justify?: Justify = 'center',
+): PositionedPlacement {
+  const rect = element.getBoundingClientRect();
+
+  const docX = rect.left;
+  const docY = rect.top;
+
+  let x, y;
+
+  switch (placement) {
+  case 'bottom':
+    y = docY + rect.height + pad;
+    switch (justify) {
+    case 'start':
+      x = docX;
+      break;
+    case 'center':
+      x = docX + rect.width / 2;
+      break;
+    case 'end':
+    default:
+      x = docX + rect.width;
+      break;
+    }
+    break;
+  case 'left':
+    x = docX - pad;
+    switch (justify) {
+    case 'start':
+      y = docY;
+      break;
+    case 'center':
+      y = docY + rect.height / 2;
+      break;
+    case 'end':
+    default:
+      y = docY + rect.height;
+      break;
+    }
+    break;
+  case 'right':
+    x = docX + rect.width + pad;
+    y = docY + rect.height / 2;
+    break;
+  default:
+    y = docY - pad;
+    switch (justify) {
+    case 'start':
+      x = docX;
+      break;
+    case 'center':
+      x = docX + rect.width / 2;
+      break;
+    case 'end':
+    default:
+      x = docX + rect.width;
+      break;
+    }
+    break;
+  }
+
+  return {x, y, placement};
+}
+
+export function getAnchorPosition(
+  element: HTMLElement,
+  placement?: Placement = 'top',
+  pad?: number = 0,
+  justify?: Justify = 'center',
+): PositionedPlacement {
+  const position = getFixedAnchorPosition(element, placement, pad, justify);
+  const documentStyle = window.document.documentElement.style;
+  return {
+    ...position,
+    x: position.x + window.pageXOffset - pxToNumber(documentStyle.paddingLeft),
+    y: position.y + window.pageYOffset - pxToNumber(documentStyle.paddingTop),
+  };
+}
+
+export function pxToNumber(px: string): number {
+  return parseFloat(px.replace('px', '') || '0');
+}
+
+// TODO (kyle): add more handler types?
+type Handlers = $Shape<{
+  click: (MouseEvent) => mixed,
+  mousedown: (MouseEvent) => mixed,
+  mouseup: (MouseEvent) => mixed,
+  pointerdown: (PointerEvent) => mixed,
+  pointerup: (PointerEvent) => mixed,
+  pointercancel: (PointerEvent) => mixed,
+  [string]: (Event) => mixed,
+}>;
+export function listen(
+  target: EventTarget,
+  handlers: Handlers,
+  options?: EventListenerOptionsOrUseCapture,
+  hook: 'addEventListener' | 'removeEventListener' = 'addEventListener',
+) {
+  for (const eventName in handlers) {
+    // $FlowFixMe indexing valid EventTarget properties
+    target[hook](eventName, handlers[eventName], options);
+  }
+}
+
+export function forget(
+  target: EventTarget,
+  events: Handlers,
+  options: EventListenerOptionsOrUseCapture,
+): void {
+  return listen(target, events, options, 'removeEventListener');
+}
+
+type MixedEvent = SyntheticEvent<EventTarget> | Event;
+export function stopEvent(event: MixedEvent) {
+  event.stopPropagation();
+}
+export function stopEventImmediately(event: SyntheticEvent<EventTarget>) {
+  event.nativeEvent.stopImmediatePropagation();
+}
+export function cancelEvent(event: MixedEvent) {
+  event.stopPropagation();
+  event.preventDefault();
+}
+
+export function requestPointerLock(element: Element): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const handleChange = () => {
+      // $FlowIssue
+      if (document.pointerLockElement === element) {
+        resolve();
+        removeHandlers();
+      }
+    };
+    const handleError = () => {
+      reject();
+      removeHandlers();
+    };
+    const removeHandlers = () => {
+      // $FlowFixMe
+      forget(document, {
+        pointerlockchange: handleChange,
+        pointerlockerror: handleError,
+      });
+    };
+
+    // $FlowFixMe
+    listen(document, {
+      pointerlockchange: handleChange,
+      pointerlockerror: handleError,
+    });
+
+    element.requestPointerLock();
+  });
+}
+
+export function checkDateInputSupport(): boolean {
+  const input = window.document.createElement('input');
+  input.setAttribute('type', 'date');
+
+  const notADateValue = 'not-a-date';
+  input.setAttribute('value', notADateValue);
+
+  return input.value !== notADateValue;
+}
+//reference: https://stackoverflow.com/a/10199306
+
+export const getListPasteHandler = ({
+  listItemSeparatorRegex = /[\,\n]/,
+  handleValue,
+}: {
+  listItemSeparatorRegex?: RegExp,
+  handleValue?: (string[]) => mixed,
+}): ((ClipboardEvent) => mixed) => {
+  const handlePaste = (event: ClipboardEvent) => {
+    const value = event.clipboardData?.getData('text');
+    if (!value || !value.length) {
+      return;
+    }
+    //do nothing if the copied string fails the regex test
+    if (!listItemSeparatorRegex.test(value)) {
+      return;
+    }
+    event.preventDefault();
+    const parsedValues = value
+      .split(listItemSeparatorRegex)
+      .reduce((acc, val) => {
+        const newVal = val.trim();
+        if (
+          // value exists
+          !!newVal.length &&
+          // value not already in queue
+          !acc.includes(newVal)
+        ) {
+          acc.push(newVal);
+        }
+        return acc;
+      }, []);
+    handleValue?.(parsedValues);
+  };
+
+  return handlePaste;
+};

package/lib/utils/dom/index.js.flow

@@ -0,0 +1,3 @@
+// @flow strict
+
+export * from './dom';

package/lib/utils/helpers/helpers.js.flow

@@ -0,0 +1,53 @@
+// @flow strict
+
+export const uuid = (): string => {
+  let dt = new Date().getTime();
+
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+    const r = (dt + Math.random() * 16) % 16 | 0;
+    dt = Math.floor(dt / 16);
+    return (c === 'x' ? r : (r & 0x3) | 0x8).toString(16);
+  });
+};
+
+export const range = (start: number, end: number): Array<number> => {
+  const length = end - start + 1;
+  return Array.from({length}, (_, i) => start + i);
+};
+
+export const convertFileSize = (fileSize: number = 0): string => {
+  let sizeInBytes = fileSize;
+  // Check if the file size is less than 1024
+  if (sizeInBytes < 0) {
+    sizeInBytes = Math.abs(sizeInBytes);
+  }
+
+  // Handle the case where the file size is 0 or negative
+  if (sizeInBytes <= 0) {
+    return '0 B';
+  }
+
+  // Check if the file size is less than 1024
+  if (sizeInBytes < 1024) {
+    // Return the file size in bytes
+    return sizeInBytes.toString() + ' B';
+  }
+
+  // Check if the file size is less than 1048576
+  else if (sizeInBytes < 1048576) {
+    // Return the file size in KB
+    return (sizeInBytes / 1024).toFixed(1) + ' KB';
+  }
+
+  // Check if the file size is less than 1073741824
+  else if (sizeInBytes < 1073741824) {
+    // Return the file size in MB
+    return (sizeInBytes / 1048576).toFixed(1) + ' MB';
+  }
+
+  // Otherwise, the file size is greater than or equal to 1073741824
+  else {
+    // Return the file size in GB
+    return (sizeInBytes / 1073741824).toFixed(1) + ' GB';
+  }
+};

package/lib/utils/helpers/index.js.flow

@@ -0,0 +1,3 @@
+// @flow strict
+
+export * from './helpers';

package/lib/utils/index.js.flow

@@ -0,0 +1,16 @@
+// @flow strict
+
+export * from './array';
+export * from './charts';
+export * from './classify';
+export * from './click-away';
+export * from './date-range-picker';
+export * from './dom';
+export * from './helpers';
+export * from './makeClassNameComponent';
+export * from './menu';
+export * from './merge-refs';
+export * from './rating';
+export * from './score-bar';
+export * from './string';
+export * from './tokens';

package/lib/utils/makeClassNameComponent/index.js.flow

@@ -0,0 +1,3 @@
+// @flow strict
+
+export * from './makeClassNameComponent';