@opentripplanner/core-utils 4.11.6-alpha.1 → 5.0.0

package/lib/time.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/time.js"],"names":["OTP_API_DATE_FORMAT","OTP_API_DATE_FORMAT_DATE_FNS","OTP_API_TIME_FORMAT","formatDurationLikeMoment","seconds","showSeconds","localize","enabled","code","hours","Math","floor","minutes","secondsLeftOver","specLookup","xHours","xMinutes","xSeconds","locale","formatDistance","spec","val","undefined","format","toHoursMinutesSeconds","getTimeFormat","config","dateTime","timeFormat","getDateFormat","dateFormat","getLongDateFormat","longDateFormat","formatDuration","formatDurationWithSeconds","region","offsetTime","ms","options","offset","formatTime","formatSecondsAfterMidnight","time","Date","getUserTimezone","fallbackTimezone","process","env","NODE_ENV","TZ","Intl","DateTimeFormat","resolvedOptions","timeZone","getCurrentTime","timezone","now","getCurrentDate"],"mappings":"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","sourcesContent":["import {\n  startOfDay,\n  add,\n  format,\n  formatDuration as dateFnsFormatDuration\n} from \"date-fns\";\nimport { utcToZonedTime } from \"date-fns-tz\";\n\n// special constants for making sure the following date format is always sent to\n// OTP regardless of whatever the user has configured as the display format\nexport const OTP_API_DATE_FORMAT = \"YYYY-MM-DD\";\n// Date-Fns uses a different string format than moment.js\n// see https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md\nexport const OTP_API_DATE_FORMAT_DATE_FNS = \"yyyy-MM-dd\";\nexport const OTP_API_TIME_FORMAT = \"HH:mm\";\n\n/**\n * To ease the transition away from moment.js, this method uses date-fns to format durations\n * the way moment.js did.\n * @param {number}  seconds     The number of seconds to format\n * @param {boolean} showSeconds Whether to render seconds or not\n * @param {boolean} localize    If true, will create output like moment.js using date-fns locale.\n * Otherwise, uses date-fns default\n * @returns                   Formatted duration\n */\nfunction formatDurationLikeMoment(\n  seconds,\n  showSeconds,\n  localize = { enabled: true, code: \"en-US\" }\n) {\n  // date-fns doesn't do this automatically\n  if ((!showSeconds && seconds < 60) || seconds === 0) {\n    return \"0 min\";\n  }\n\n  const hours = Math.floor(seconds / 3600);\n  const minutes = Math.floor((seconds - hours * 3600) / 60);\n  const secondsLeftOver = showSeconds\n    ? seconds - hours * 3600 - minutes * 60\n    : 0;\n  const specLookup = {\n    xHours: \"hr\",\n    xMinutes: \"min\",\n    xSeconds: \"sec\"\n  };\n  const locale = localize\n    ? {\n        // Maintain backwards compatibility when called with localize=true\n        code: localize?.code || \"en-US\",\n        formatDistance: (spec, val) => {\n          return `${val} ${specLookup[spec]}`;\n        }\n      }\n    : undefined;\n\n  return dateFnsFormatDuration(\n    {\n      hours,\n      minutes,\n      seconds: secondsLeftOver\n    },\n    {\n      format: [\"hours\", \"minutes\", \"seconds\"],\n      locale\n    }\n  );\n}\n\n/**\n * Breaks up a duration in seconds into hours, minutes, and seconds.\n * @param {number} seconds The number of seconds to break up\n * @returns an object with fields with the corresponding, hours, minutes, seconds.\n */\nexport function toHoursMinutesSeconds(seconds) {\n  const hours = Math.floor(seconds / 3600);\n  const minutes = Math.floor((seconds - hours * 3600) / 60);\n  return {\n    hours,\n    minutes,\n    seconds: seconds - hours * 3600 - minutes * 60\n  };\n}\n\n/**\n * @param  {[type]} config the OTP config object found in store\n * @return {string}        the config-defined time formatter or HH:mm (24-hr time)\n */\nexport function getTimeFormat(config) {\n  return config?.dateTime?.timeFormat || OTP_API_TIME_FORMAT;\n}\n\nexport function getDateFormat(config) {\n  return config?.dateTime?.dateFormat || OTP_API_DATE_FORMAT;\n}\n\nexport function getLongDateFormat(config) {\n  return config?.dateTime?.longDateFormat || \"D MMMM YYYY\";\n}\n\n/**\n * Formats an elapsed time duration for display in narrative.\n * TODO: internationalization\n * @param {number} seconds duration in seconds\n * @returns {string} formatted text representation\n */\nexport function formatDuration(seconds) {\n  return formatDurationLikeMoment(seconds, false);\n}\n\n/**\n * Formats an elapsed time in seconds, minutes, hours duration for display in narrative\n * @param {number} seconds duration in seconds\n * @param {object} region  an object that allows internationalization of the time\n * @returns {string}       formatted text representation\n */\nexport function formatDurationWithSeconds(seconds, region) {\n  return formatDurationLikeMoment(seconds, { enabled: true, code: region });\n}\n\n/**\n * Offsets a time according to the provided time options\n * and returns the result.\n */\nexport function offsetTime(ms, options) {\n  return ms + (options?.offset || 0);\n}\n\n/**\n * Formats a time value for display in narrative\n * TODO: internationalization/timezone\n * @param {number} ms epoch time value in milliseconds\n * @returns {string} formatted text representation\n */\nexport function formatTime(ms, options) {\n  return format(\n    offsetTime(ms, options),\n    options?.format || OTP_API_TIME_FORMAT\n  );\n}\n\n/**\n * Formats a seconds after midnight value for display in narrative\n * @param  {number} seconds  time since midnight in seconds\n * @param  {string} timeFormat  A valid date-fns time format\n * @return {string}                   formatted text representation\n */\nexport function formatSecondsAfterMidnight(seconds, timeFormat) {\n  const time = add(startOfDay(new Date()), { seconds });\n  return format(time, timeFormat);\n}\n\n/**\n * Uses Intl.DateTimeFormat() api to get the user's time zone. In a test\n * environment, pulls timezone information from an env variable. Default to\n * GMT+0 if the Intl API is unavailable.\n */\nexport function getUserTimezone(fallbackTimezone = \"Etc/Greenwich\") {\n  if (process.env.NODE_ENV === \"test\") return process.env.TZ;\n  return Intl?.DateTimeFormat().resolvedOptions().timeZone || fallbackTimezone;\n}\n\n/**\n * Formats current time for use in OTP query\n * The conversion to the user's timezone is needed for testing purposes.\n */\nexport function getCurrentTime(timezone = getUserTimezone()) {\n  return format(utcToZonedTime(Date.now(), timezone), OTP_API_TIME_FORMAT);\n}\n\n/**\n * Formats current date for use in OTP query\n * The conversion to the user's timezone is needed for testing purposes.\n */\nexport function getCurrentDate(timezone = getUserTimezone()) {\n  return format(\n    utcToZonedTime(Date.now(), timezone),\n    OTP_API_DATE_FORMAT_DATE_FNS\n  );\n}\n"],"file":"time.js"}
+{"version":3,"sources":["../src/time.ts"],"names":["OTP_API_DATE_FORMAT","OTP_API_DATE_FORMAT_DATE_FNS","OTP_API_TIME_FORMAT","formatDurationLikeMoment","seconds","showSeconds","localize","enabled","code","hours","Math","floor","minutes","secondsLeftOver","specLookup","xHours","xMinutes","xSeconds","locale","formatDistance","spec","val","undefined","format","toHoursMinutesSeconds","getTimeFormat","config","dateTime","timeFormat","getDateFormat","dateFormat","getLongDateFormat","longDateFormat","offsetTime","ms","options","offset","formatSecondsAfterMidnight","time","Date","getUserTimezone","fallbackTimezone","process","env","NODE_ENV","TZ","Intl","DateTimeFormat","resolvedOptions","timeZone","getCurrentTime","timezone","now","getCurrentDate"],"mappings":"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","sourcesContent":["import { Config } from \"@opentripplanner/types\";\nimport {\n  startOfDay,\n  add,\n  format,\n  formatDuration as dateFnsFormatDuration\n} from \"date-fns\";\nimport { utcToZonedTime } from \"date-fns-tz\";\n\n/* eslint-disable import/no-cycle */\nimport {\n  formatTime,\n  formatDurationWithSeconds,\n  formatDuration\n} from \"./deprecated-with-types\";\n\nexport { formatTime, formatDuration, formatDurationWithSeconds };\n\n// special constants for making sure the following date format is always sent to\n// OTP regardless of whatever the user has configured as the display format\nexport const OTP_API_DATE_FORMAT = \"YYYY-MM-DD\";\n// Date-Fns uses a different string format than moment.js\n// see https://github.com/date-fns/date-fns/blob/master/docs/unicodeTokens.md\nexport const OTP_API_DATE_FORMAT_DATE_FNS = \"yyyy-MM-dd\";\nexport const OTP_API_TIME_FORMAT = \"HH:mm\";\n\n/**\n * To ease the transition away from moment.js, this method uses date-fns to format durations\n * the way moment.js did.\n * @param {number}  seconds     The number of seconds to format\n * @param {boolean} showSeconds Whether to render seconds or not\n * @param {boolean} localize    If true, will create output like moment.js using date-fns locale.\n * Otherwise, uses date-fns default\n * @returns                   Formatted duration\n */\nexport function formatDurationLikeMoment(\n  seconds: number,\n  showSeconds: boolean,\n  localize: { enabled: boolean; code: string } = {\n    enabled: true,\n    code: \"en-US\"\n  }\n): string {\n  // date-fns doesn't do this automatically\n  if ((!showSeconds && seconds < 60) || seconds === 0) {\n    return \"0 min\";\n  }\n\n  const hours = Math.floor(seconds / 3600);\n  const minutes = Math.floor((seconds - hours * 3600) / 60);\n  const secondsLeftOver = showSeconds\n    ? seconds - hours * 3600 - minutes * 60\n    : 0;\n  const specLookup = {\n    xHours: \"hr\",\n    xMinutes: \"min\",\n    xSeconds: \"sec\"\n  };\n  const locale = localize\n    ? {\n        // Maintain backwards compatibility when called with localize=true\n        code: localize?.code || \"en-US\",\n        formatDistance: (spec, val) => {\n          return `${val} ${specLookup[spec]}`;\n        }\n      }\n    : undefined;\n\n  return dateFnsFormatDuration(\n    {\n      hours,\n      minutes,\n      seconds: secondsLeftOver\n    },\n    {\n      format: [\"hours\", \"minutes\", \"seconds\"],\n      locale\n    }\n  );\n}\n\n/**\n * Breaks up a duration in seconds into hours, minutes, and seconds.\n * @param {number} seconds The number of seconds to break up\n * @returns an object with fields with the corresponding, hours, minutes, seconds.\n */\nexport function toHoursMinutesSeconds(seconds) {\n  const hours = Math.floor(seconds / 3600);\n  const minutes = Math.floor((seconds - hours * 3600) / 60);\n  return {\n    hours,\n    minutes,\n    seconds: seconds - hours * 3600 - minutes * 60\n  };\n}\n\n/**\n * @param  {[type]} config the OTP config object found in store\n * @return {string}        the config-defined time formatter or HH:mm (24-hr time)\n */\nexport function getTimeFormat(config: Config): string {\n  return config?.dateTime?.timeFormat || OTP_API_TIME_FORMAT;\n}\n\nexport function getDateFormat(config: Config): string {\n  return config?.dateTime?.dateFormat || OTP_API_DATE_FORMAT;\n}\n\nexport function getLongDateFormat(config: Config): string {\n  return config?.dateTime?.longDateFormat || \"D MMMM YYYY\";\n}\n/**\n * Offsets a time according to the provided time options\n * and returns the result.\n */\nexport function offsetTime(ms, options) {\n  return ms + (options?.offset || 0);\n}\n\n/**\n * Formats a seconds after midnight value for display in narrative\n * @param  {number} seconds  time since midnight in seconds\n * @param  {string} timeFormat  A valid date-fns time format\n * @return {string}                   formatted text representation\n */\nexport function formatSecondsAfterMidnight(\n  seconds: number,\n  timeFormat: string\n): string {\n  const time = add(startOfDay(new Date()), { seconds });\n  return format(time, timeFormat);\n}\n\n/**\n * Uses Intl.DateTimeFormat() api to get the user's time zone. In a test\n * environment, pulls timezone information from an env variable. Default to\n * GMT+0 if the Intl API is unavailable.\n */\nexport function getUserTimezone(fallbackTimezone = \"Etc/Greenwich\"): string {\n  if (process.env.NODE_ENV === \"test\") return process.env.TZ;\n  return Intl?.DateTimeFormat().resolvedOptions().timeZone || fallbackTimezone;\n}\n\n/**\n * Formats current time for use in OTP query\n * The conversion to the user's timezone is needed for testing purposes.\n */\nexport function getCurrentTime(timezone = getUserTimezone()): string {\n  return format(utcToZonedTime(Date.now(), timezone), OTP_API_TIME_FORMAT);\n}\n\n/**\n * Formats current date for use in OTP query\n * The conversion to the user's timezone is needed for testing purposes.\n */\nexport function getCurrentDate(timezone = getUserTimezone()): string {\n  return format(\n    utcToZonedTime(Date.now(), timezone),\n    OTP_API_DATE_FORMAT_DATE_FNS\n  );\n}\n"],"file":"time.js"}

package/lib/ui.d.ts

@@ -0,0 +1,13 @@
+export declare function isMobile(): boolean;
+/**
+ * Returns true if the user is using a [redacted] browser
+ */
+export declare function isIE(): boolean;
+/**
+ * Enables scrolling for a specified selector, while disabling scrolling for all
+ * other targets. This is adapted from https://stackoverflow.com/a/41601290/915811
+ * and intended to fix issues with iOS elastic scrolling, e.g.,
+ * https://github.com/conveyal/trimet-mod-otp/issues/92.
+ */
+export declare function enableScrollForSelector(selector: string): void;
+//# sourceMappingURL=ui.d.ts.map

package/lib/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAEA,wBAAgB,QAAQ,IAAI,OAAO,CAKlC;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,OAAO,CAE9B;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CA4C9D"}

package/lib/ui.js

@@ -21,7 +21,7 @@ function isMobile() {
 
 
 function isIE() {
-  return _bowser.default.name === "Internet Explorer";
+  return _bowser.default.parse(navigator.userAgent).browser === "Internet Explorer";
 }
 /**
  * Enables scrolling for a specified selector, while disabling scrolling for all

package/lib/ui.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/ui.js"],"names":["isMobile","test","navigator","userAgent","isIE","bowser","name","enableScrollForSelector","selector","overlay","document","querySelector","clientY","isOverlayTotallyScrolled","scrollHeight","scrollTop","clientHeight","disableRubberBand","event","clientYDelta","targetTouches","preventDefault","addEventListener","length"],"mappings":";;;;;;;;;;;AAAA;;AAEO,SAASA,QAAT,GAAoB;AACzB;AACA,SAAO,iEAAiEC,IAAjE,CACLC,SAAS,CAACC,SADL,CAAP;AAGD;AAED;AACA;AACA;;;AACO,SAASC,IAAT,GAAgB;AACrB,SAAOC,gBAAOC,IAAP,KAAgB,mBAAvB;AACD;AAED;AACA;AACA;AACA;AACA;AACA;;;AACO,SAASC,uBAAT,CAAiCC,QAAjC,EAA2C;AAChD,QAAMC,OAAO,GAAGC,QAAQ,CAACC,aAAT,CAAuBH,QAAvB,CAAhB;AACA,MAAII,OAAO,GAAG,IAAd,CAFgD,CAE5B;;AAEpB,WAASC,wBAAT,GAAoC;AAClC;AACA,WAAOJ,OAAO,CAACK,YAAR,GAAuBL,OAAO,CAACM,SAA/B,IAA4CN,OAAO,CAACO,YAA3D;AACD;;AAED,WAASC,iBAAT,CAA2BC,KAA3B,EAAkC;AAChC,UAAMC,YAAY,GAAGD,KAAK,CAACE,aAAN,CAAoB,CAApB,EAAuBR,OAAvB,GAAiCA,OAAtD;;AAEA,QAAIH,OAAO,CAACM,SAAR,KAAsB,CAAtB,IAA2BI,YAAY,GAAG,CAA9C,EAAiD;AAC/C;AACAD,MAAAA,KAAK,CAACG,cAAN;AACD;;AAED,QAAIR,wBAAwB,MAAMM,YAAY,GAAG,CAAjD,EAAoD;AAClD;AACAD,MAAAA,KAAK,CAACG,cAAN;AACD;AACF;;AAEDZ,EAAAA,OAAO,CAACa,gBAAR,CACE,YADF,EAEE,UAASJ,KAAT,EAAgB;AACd,QAAIA,KAAK,CAACE,aAAN,CAAoBG,MAApB,KAA+B,CAAnC,EAAsC;AACpC;AACAX,MAAAA,OAAO,GAAGM,KAAK,CAACE,aAAN,CAAoB,CAApB,EAAuBR,OAAjC;AACD;AACF,GAPH,EAQE,KARF;AAWAH,EAAAA,OAAO,CAACa,gBAAR,CACE,WADF,EAEE,UAASJ,KAAT,EAAgB;AACd,QAAIA,KAAK,CAACE,aAAN,CAAoBG,MAApB,KAA+B,CAAnC,EAAsC;AACpC;AACAN,MAAAA,iBAAiB,CAACC,KAAD,CAAjB;AACD;AACF,GAPH,EAQE,KARF;AAUD","sourcesContent":["import bowser from \"bowser\";\n\nexport function isMobile() {\n  // TODO: consider using 3rd-party library?\n  return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(\n    navigator.userAgent\n  );\n}\n\n/**\n * Returns true if the user is using a [redacted] browser\n */\nexport function isIE() {\n  return bowser.name === \"Internet Explorer\";\n}\n\n/**\n * Enables scrolling for a specified selector, while disabling scrolling for all\n * other targets. This is adapted from https://stackoverflow.com/a/41601290/915811\n * and intended to fix issues with iOS elastic scrolling, e.g.,\n * https://github.com/conveyal/trimet-mod-otp/issues/92.\n */\nexport function enableScrollForSelector(selector) {\n  const overlay = document.querySelector(selector);\n  let clientY = null; // remember Y position on touch start\n\n  function isOverlayTotallyScrolled() {\n    // https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollHeight#Problems_and_solutions\n    return overlay.scrollHeight - overlay.scrollTop <= overlay.clientHeight;\n  }\n\n  function disableRubberBand(event) {\n    const clientYDelta = event.targetTouches[0].clientY - clientY;\n\n    if (overlay.scrollTop === 0 && clientYDelta > 0) {\n      // element is at the top of its scroll\n      event.preventDefault();\n    }\n\n    if (isOverlayTotallyScrolled() && clientYDelta < 0) {\n      // element is at the top of its scroll\n      event.preventDefault();\n    }\n  }\n\n  overlay.addEventListener(\n    \"touchstart\",\n    function(event) {\n      if (event.targetTouches.length === 1) {\n        // detect single touch\n        clientY = event.targetTouches[0].clientY;\n      }\n    },\n    false\n  );\n\n  overlay.addEventListener(\n    \"touchmove\",\n    function(event) {\n      if (event.targetTouches.length === 1) {\n        // detect single touch\n        disableRubberBand(event);\n      }\n    },\n    false\n  );\n}\n"],"file":"ui.js"}
+{"version":3,"sources":["../src/ui.ts"],"names":["isMobile","test","navigator","userAgent","isIE","bowser","parse","browser","enableScrollForSelector","selector","overlay","document","querySelector","clientY","isOverlayTotallyScrolled","scrollHeight","scrollTop","clientHeight","disableRubberBand","event","clientYDelta","targetTouches","preventDefault","addEventListener","length"],"mappings":";;;;;;;;;;;AAAA;;AAEO,SAASA,QAAT,GAA6B;AAClC;AACA,SAAO,iEAAiEC,IAAjE,CACLC,SAAS,CAACC,SADL,CAAP;AAGD;AAED;AACA;AACA;;;AACO,SAASC,IAAT,GAAyB;AAC9B,SAAOC,gBAAOC,KAAP,CAAaJ,SAAS,CAACC,SAAvB,EAAkCI,OAAlC,KAA8C,mBAArD;AACD;AAED;AACA;AACA;AACA;AACA;AACA;;;AACO,SAASC,uBAAT,CAAiCC,QAAjC,EAAyD;AAC9D,QAAMC,OAAO,GAAGC,QAAQ,CAACC,aAAT,CAAuBH,QAAvB,CAAhB;AACA,MAAII,OAAO,GAAG,IAAd,CAF8D,CAE1C;;AAEpB,WAASC,wBAAT,GAA6C;AAC3C;AACA,WAAOJ,OAAO,CAACK,YAAR,GAAuBL,OAAO,CAACM,SAA/B,IAA4CN,OAAO,CAACO,YAA3D;AACD;;AAED,WAASC,iBAAT,CAA2BC,KAA3B,EAA8C;AAC5C,UAAMC,YAAY,GAAGD,KAAK,CAACE,aAAN,CAAoB,CAApB,EAAuBR,OAAvB,GAAiCA,OAAtD;;AAEA,QAAIH,OAAO,CAACM,SAAR,KAAsB,CAAtB,IAA2BI,YAAY,GAAG,CAA9C,EAAiD;AAC/C;AACAD,MAAAA,KAAK,CAACG,cAAN;AACD;;AAED,QAAIR,wBAAwB,MAAMM,YAAY,GAAG,CAAjD,EAAoD;AAClD;AACAD,MAAAA,KAAK,CAACG,cAAN;AACD;AACF;;AAEDZ,EAAAA,OAAO,CAACa,gBAAR,CACE,YADF,EAEE,UAASJ,KAAT,EAA4B;AAC1B,QAAIA,KAAK,CAACE,aAAN,CAAoBG,MAApB,KAA+B,CAAnC,EAAsC;AACpC;AACAX,MAAAA,OAAO,GAAGM,KAAK,CAACE,aAAN,CAAoB,CAApB,EAAuBR,OAAjC;AACD;AACF,GAPH,EAQE,KARF;AAWAH,EAAAA,OAAO,CAACa,gBAAR,CACE,WADF,EAEE,UAASJ,KAAT,EAA4B;AAC1B,QAAIA,KAAK,CAACE,aAAN,CAAoBG,MAApB,KAA+B,CAAnC,EAAsC;AACpC;AACAN,MAAAA,iBAAiB,CAACC,KAAD,CAAjB;AACD;AACF,GAPH,EAQE,KARF;AAUD","sourcesContent":["import bowser from \"bowser\";\n\nexport function isMobile(): boolean {\n  // TODO: consider using 3rd-party library?\n  return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(\n    navigator.userAgent\n  );\n}\n\n/**\n * Returns true if the user is using a [redacted] browser\n */\nexport function isIE(): boolean {\n  return bowser.parse(navigator.userAgent).browser === \"Internet Explorer\";\n}\n\n/**\n * Enables scrolling for a specified selector, while disabling scrolling for all\n * other targets. This is adapted from https://stackoverflow.com/a/41601290/915811\n * and intended to fix issues with iOS elastic scrolling, e.g.,\n * https://github.com/conveyal/trimet-mod-otp/issues/92.\n */\nexport function enableScrollForSelector(selector: string): void {\n  const overlay = document.querySelector(selector);\n  let clientY = null; // remember Y position on touch start\n\n  function isOverlayTotallyScrolled(): boolean {\n    // https://developer.mozilla.org/en-US/docs/Web/API/Element/scrollHeight#Problems_and_solutions\n    return overlay.scrollHeight - overlay.scrollTop <= overlay.clientHeight;\n  }\n\n  function disableRubberBand(event: TouchEvent) {\n    const clientYDelta = event.targetTouches[0].clientY - clientY;\n\n    if (overlay.scrollTop === 0 && clientYDelta > 0) {\n      // element is at the top of its scroll\n      event.preventDefault();\n    }\n\n    if (isOverlayTotallyScrolled() && clientYDelta < 0) {\n      // element is at the top of its scroll\n      event.preventDefault();\n    }\n  }\n\n  overlay.addEventListener(\n    \"touchstart\",\n    function(event: TouchEvent) {\n      if (event.targetTouches.length === 1) {\n        // detect single touch\n        clientY = event.targetTouches[0].clientY;\n      }\n    },\n    false\n  );\n\n  overlay.addEventListener(\n    \"touchmove\",\n    function(event: TouchEvent) {\n      if (event.targetTouches.length === 1) {\n        // detect single touch\n        disableRubberBand(event);\n      }\n    },\n    false\n  );\n}\n"],"file":"ui.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opentripplanner/core-utils",
-  "version": "4.11.6-alpha.1",
+  "version": "5.0.0",
   "description": "Core functionality that is shared among numerous UI components",
   "engines": {
     "node": ">=13"
@@ -26,5 +26,8 @@
     "qs": "^6.9.1"
   },
   "gitHead": "0af1b7cda60bd4252b219dcf893e01c2acb2ed5d",
+  "scripts": {
+    "tsc": "tsc"
+  },
   "devDependencies": {}
 }

package/src/__tests__/__snapshots__/route.js.snap

@@ -35,18 +35,18 @@ Array [
 
 exports[`util > route routeComparator should prioritize routes with valid sortOrder 1`] = `
 Array [
-  Object {
-    "longName": "Around town",
-    "mode": "BUS",
-    "shortName": "20",
-    "sortOrder": 2,
-  },
   Object {
     "longName": "Around another town",
     "shortName": "3",
     "sortOrder": -999,
     "type": 3,
   },
+  Object {
+    "longName": "Around town",
+    "mode": "BUS",
+    "shortName": "20",
+    "sortOrder": 2,
+  },
 ]
 `;
 
@@ -191,6 +191,30 @@ Array [
     "shortName": "IC",
     "sortOrder": 2,
   },
+  Object {
+    "longName": "A-line",
+    "mode": "BUS",
+    "shortName": "A",
+    "sortOrder": -999,
+  },
+  Object {
+    "longName": "B-line",
+    "mode": "BUS",
+    "shortName": "B",
+    "sortOrder": -999,
+  },
+  Object {
+    "longName": "Loop route",
+    "mode": "BUS",
+    "shortName": "2",
+    "sortOrder": -999,
+  },
+  Object {
+    "longName": "Around another town",
+    "shortName": "3",
+    "sortOrder": -999,
+    "type": 3,
+  },
   Object {
     "longName": "Local route",
     "mode": "BUS",
@@ -239,30 +263,6 @@ Array [
     "shortName": "10",
     "sortOrder": 10,
   },
-  Object {
-    "longName": "A-line",
-    "mode": "BUS",
-    "shortName": "A",
-    "sortOrder": -999,
-  },
-  Object {
-    "longName": "B-line",
-    "mode": "BUS",
-    "shortName": "B",
-    "sortOrder": -999,
-  },
-  Object {
-    "longName": "Loop route",
-    "mode": "BUS",
-    "shortName": "2",
-    "sortOrder": -999,
-  },
-  Object {
-    "longName": "Around another town",
-    "shortName": "3",
-    "sortOrder": -999,
-    "type": 3,
-  },
   Object {
     "longName": "A meandering route",
     "mode": "BUS",

package/src/deprecated-with-types.ts

@@ -0,0 +1,62 @@
+/* eslint-disable import/no-cycle */
+import { TimeOptions } from "@opentripplanner/types";
+import { format } from "date-fns";
+
+import { logDeprecationWarning } from "./deprecated";
+import {
+  formatDurationLikeMoment,
+  offsetTime,
+  OTP_API_TIME_FORMAT
+} from "./time";
+
+// time.ts
+
+/**
+ * Formats a time value for display in narrative
+ * TODO: internationalization/timezone
+ * @param {number} ms epoch time value in milliseconds
+ * @returns {string} formatted text representation
+ */
+export function formatTime(ms: number, options: TimeOptions): string {
+  logDeprecationWarning("formatTime", "formatjs");
+
+  return format(
+    offsetTime(ms, options),
+    options?.format || OTP_API_TIME_FORMAT
+  );
+}
+
+/**
+ * Formats an elapsed time duration for display in narrative.
+ * TODO: internationalization
+ * @param {number} seconds duration in seconds
+ * @returns {string} formatted text representation
+ */
+// TS TODO: region as type?
+export function formatDuration(seconds: number, region: string): string {
+  logDeprecationWarning("formatDuration", "formatjs");
+
+  return formatDurationLikeMoment(seconds, false, {
+    enabled: true,
+    code: region
+  });
+}
+
+/**
+ * Formats an elapsed time in seconds, minutes, hours duration for display in narrative
+ * @param {number} seconds duration in seconds
+ * @param {object} region  an object that allows internationalization of the time
+ * @returns {string}       formatted text representation
+ */
+// TS TODO: region as type?
+export function formatDurationWithSeconds(
+  seconds: number,
+  region: string
+): string {
+  logDeprecationWarning("formatDurationWithSeconds", "formatjs");
+
+  return formatDurationLikeMoment(seconds, true, {
+    enabled: true,
+    code: region
+  });
+}

package/src/{index.js → index.ts}

@@ -1,26 +1,22 @@
 import * as itinerary from "./itinerary";
 import * as map from "./map";
-import * as messages from "./messages";
 import * as profile from "./profile";
 import * as query from "./query";
 import * as queryParams from "./query-params";
 import * as route from "./route";
 import * as storage from "./storage";
 import * as time from "./time";
-import * as types from "./types";
 import * as ui from "./ui";
 
 const core = {
   itinerary,
   map,
-  messages,
   profile,
   query,
   queryParams,
   route,
   storage,
   time,
-  types,
   ui
 };
 

package/src/{itinerary.js → itinerary.ts}

@@ -1,4 +1,14 @@
 import polyline from "@mapbox/polyline";
+import {
+  Company,
+  Config,
+  ElevationProfile,
+  FlexBookingInfo,
+  Itinerary,
+  LatLngArray,
+  Leg,
+  Step
+} from "@opentripplanner/types";
 import turfAlong from "@turf/along";
 
 import {
@@ -40,13 +50,16 @@ export const transitModes = [
  * @return {Array}  List of all transit modes defined in config; otherwise default mode list
  */
 
-export function getTransitModes(config) {
+export function getTransitModes(config: Config): string[] {
   if (!config || !config.modes || !config.modes.transitModes)
     return transitModes;
-  return config.modes.transitModes.map(tm => tm.mode);
+
+  return config.modes.transitModes.map(tm =>
+    typeof tm !== "string" ? tm.mode : tm
+  );
 }
 
-export function isTransit(mode) {
+export function isTransit(mode: string): boolean {
   return transitModes.includes(mode) || mode === "TRANSIT";
 }
 
@@ -55,7 +68,7 @@ export function isTransit(mode) {
  * calling ahead for the service to run. "mustPhone" is the only
  * property of boardRule which encodes this info.
  */
-export function isReservationRequired(leg) {
+export function isReservationRequired(leg: Leg): boolean {
   return leg.boardRule === "mustPhone";
 }
 /**
@@ -63,53 +76,53 @@ export function isReservationRequired(leg) {
  * asking the driver to let the user off. "coordinateWithDriver" is the only
  * property of alightRule which encodes this info.
  */
-export function isContinuousDropoff(leg) {
+export function isContinuousDropoff(leg: Leg): boolean {
   return leg.alightRule === "coordinateWithDriver";
 }
 /**
  * The two rules checked by the above two functions are the only values
  * returned by OTP when a leg is a flex leg.
  */
-export function isFlex(leg) {
+export function isFlex(leg: Leg): boolean {
   return isReservationRequired(leg) || isContinuousDropoff(leg);
 }
 
-export function isAdvanceBookingRequired(info) {
+export function isAdvanceBookingRequired(info: FlexBookingInfo): boolean {
   return info?.latestBookingTime?.daysPrior > 0;
 }
-export function legDropoffRequiresAdvanceBooking(leg) {
+export function legDropoffRequiresAdvanceBooking(leg: Leg): boolean {
   return isAdvanceBookingRequired(leg.dropOffBookingInfo);
 }
 
-export function isWalk(mode) {
+export function isWalk(mode: string): boolean {
   if (!mode) return false;
 
   return mode === "WALK";
 }
 
-export function isBicycle(mode) {
+export function isBicycle(mode: string): boolean {
   if (!mode) return false;
 
   return mode === "BICYCLE";
 }
 
-export function isBicycleRent(mode) {
+export function isBicycleRent(mode: string): boolean {
   if (!mode) return false;
 
   return mode === "BICYCLE_RENT";
 }
 
-export function isCar(mode) {
+export function isCar(mode: string): boolean {
   if (!mode) return false;
   return mode.startsWith("CAR");
 }
 
-export function isMicromobility(mode) {
+export function isMicromobility(mode: string): boolean {
   if (!mode) return false;
   return mode.startsWith("MICROMOBILITY") || mode.startsWith("SCOOTER");
 }
 
-export function isAccessMode(mode) {
+export function isAccessMode(mode: string): boolean {
   return (
     isWalk(mode) ||
     isBicycle(mode) ||
@@ -123,7 +136,7 @@ export function isAccessMode(mode) {
  * @param  {string}  modesStr a comma-separated list of OTP modes
  * @return {boolean} whether any of the modes are transit modes
  */
-export function hasTransit(modesStr) {
+export function hasTransit(modesStr: string): boolean {
   return modesStr.split(",").some(mode => isTransit(mode));
 }
 
@@ -131,7 +144,7 @@ export function hasTransit(modesStr) {
  * @param  {string}  modesStr a comma-separated list of OTP modes
  * @return {boolean} whether any of the modes are car-based modes
  */
-export function hasCar(modesStr) {
+export function hasCar(modesStr: string): boolean {
   return modesStr.split(",").some(mode => isCar(mode));
 }
 
@@ -139,7 +152,7 @@ export function hasCar(modesStr) {
  * @param  {string}  modesStr a comma-separated list of OTP modes
  * @return {boolean} whether any of the modes are bicycle-based modes
  */
-export function hasBike(modesStr) {
+export function hasBike(modesStr: string): boolean {
   return modesStr
     .split(",")
     .some(mode => isBicycle(mode) || isBicycleRent(mode));
@@ -149,7 +162,7 @@ export function hasBike(modesStr) {
  * @param  {string}  modesStr a comma-separated list of OTP modes
  * @return {boolean} whether any of the modes are micromobility-based modes
  */
-export function hasMicromobility(modesStr) {
+export function hasMicromobility(modesStr: string): boolean {
   return modesStr.split(",").some(mode => isMicromobility(mode));
 }
 
@@ -157,7 +170,7 @@ export function hasMicromobility(modesStr) {
  * @param  {string}  modesStr a comma-separated list of OTP modes
  * @return {boolean} whether any of the modes is a hailing mode
  */
-export function hasHail(modesStr) {
+export function hasHail(modesStr: string): boolean {
   return modesStr.split(",").some(mode => mode.indexOf("_HAIL") > -1);
 }
 
@@ -165,11 +178,11 @@ export function hasHail(modesStr) {
  * @param  {string}  modesStr a comma-separated list of OTP modes
  * @return {boolean} whether any of the modes is a rental mode
  */
-export function hasRental(modesStr) {
+export function hasRental(modesStr: string): boolean {
   return modesStr.split(",").some(mode => mode.indexOf("_RENT") > -1);
 }
 
-export function getMapColor(mode) {
+export function getMapColor(mode: string): string {
   mode = mode || this.get("mode");
   if (mode === "WALK") return "#444";
   if (mode === "BICYCLE") return "#0073e5";
@@ -183,7 +196,7 @@ export function getMapColor(mode) {
   return "#aaa";
 }
 
-export function toSentenceCase(str) {
+export function toSentenceCase(str: string): string {
   if (str == null) {
     return "";
   }
@@ -194,7 +207,7 @@ export function toSentenceCase(str) {
 /**
  * Derive the company string based on mode and network associated with leg.
  */
-export function getCompanyFromLeg(leg) {
+export function getCompanyFromLeg(leg: Leg): string {
   if (!leg) return null;
   const { from, mode, rentedBike, rentedCar, rentedVehicle, tncData } = leg;
   if (mode === "CAR" && rentedCar) {
@@ -216,12 +229,12 @@ export function getCompanyFromLeg(leg) {
   return null;
 }
 
-export function getItineraryBounds(itinerary) {
+export function getItineraryBounds(itinerary: Itinerary): LatLngArray[] {
   let coords = [];
   itinerary.legs.forEach(leg => {
     const legCoords = polyline
       .toGeoJSON(leg.legGeometry.points)
-      .coordinates.map(c => [c[1], c[0]]);
+      .coordinates.map((c: number[]) => [c[1], c[0]]);
     coords = [...coords, ...legCoords];
   });
   return coords;
@@ -230,7 +243,7 @@ export function getItineraryBounds(itinerary) {
 /**
  * Return a coords object that encloses the given leg's geometry.
  */
-export function getLegBounds(leg) {
+export function getLegBounds(leg: Leg): number[] {
   const coords = polyline
     .toGeoJSON(leg.legGeometry.points)
     .coordinates.map(c => [c[1], c[0]]);
@@ -246,7 +259,7 @@ export function getLegBounds(leg) {
 
 /* Returns an interpolated lat-lon at a specified distance along a leg */
 
-export function legLocationAtDistance(leg, distance) {
+export function legLocationAtDistance(leg: Leg, distance: number): number[] {
   if (!leg.legGeometry) return null;
 
   try {
@@ -264,7 +277,10 @@ export function legLocationAtDistance(leg, distance) {
 
 /* Returns an interpolated elevation at a specified distance along a leg */
 
-export function legElevationAtDistance(points, distance) {
+export function legElevationAtDistance(
+  points: number[][],
+  distance: number
+): number {
   // Iterate through the combined elevation profile
   let traversed = 0;
   // If first point distance is not zero, insert starting point at zero with
@@ -302,7 +318,10 @@ export function legElevationAtDistance(points, distance) {
 
 // Iterate through the steps, building the array of elevation points and
 // keeping track of the minimum and maximum elevations reached
-export function getElevationProfile(steps, unitConversion = 1) {
+export function getElevationProfile(
+  steps: Step[],
+  unitConversion = 1
+): ElevationProfile {
   let minElev = 100000;
   let maxElev = -100000;
   let traversed = 0;
@@ -349,11 +368,14 @@ export function getElevationProfile(steps, unitConversion = 1) {
  *
  * @see https://stackoverflow.com/questions/118241/calculate-text-width-with-javascript/21015393#21015393
  */
-export function getTextWidth(text, font = "22px Arial") {
+export function getTextWidth(text: string, font = "22px Arial"): number {
+  // Create custom type for function including re-used canvas object
+  type GetTextWidth = typeof getTextWidth & { canvas: HTMLCanvasElement };
+
   // re-use canvas object for better performance
   const canvas =
-    getTextWidth.canvas ||
-    (getTextWidth.canvas = document.createElement("canvas"));
+    (getTextWidth as GetTextWidth).canvas ||
+    ((getTextWidth as GetTextWidth).canvas = document.createElement("canvas"));
   const context = canvas.getContext("2d");
   context.font = font;
   const metrics = context.measureText(text);
@@ -364,7 +386,10 @@ export function getTextWidth(text, font = "22px Arial") {
  * Get the configured company object for the given network string if the company
  * has been defined in the provided companies array config.
  */
-export function getCompanyForNetwork(networkString, companies = []) {
+export function getCompanyForNetwork(
+  networkString: string,
+  companies: Company[] = []
+): Company {
   const company = companies.find(co => co.id === networkString);
   if (!company) {
     console.warn(
@@ -382,7 +407,10 @@ export function getCompanyForNetwork(networkString, companies = []) {
  * @param  {Array<object>}  [companies=[]] An optional list of the companies config.
  * @return {string}  A label for use in presentation on a website.
  */
-export function getCompaniesLabelFromNetworks(networks, companies = []) {
+export function getCompaniesLabelFromNetworks(
+  networks: string[],
+  companies: Company[] = []
+): string {
   return networks
     .map(network => getCompanyForNetwork(network, companies))
     .filter(co => !!co)
@@ -390,12 +418,18 @@ export function getCompaniesLabelFromNetworks(networks, companies = []) {
     .join("/");
 }
 
-export function getTNCLocation(leg, type) {
+export function getTNCLocation(leg: Leg, type: string): string {
   const location = leg[type];
   return `${location.lat.toFixed(5)},${location.lon.toFixed(5)}`;
 }
 
-export function calculatePhysicalActivity(itinerary) {
+export function calculatePhysicalActivity(
+  itinerary: Itinerary
+): {
+  bikeDuration: number;
+  caloriesBurned: number;
+  walkDuration: number;
+} {
   let walkDuration = 0;
   let bikeDuration = 0;
   itinerary.legs.forEach(leg => {