@castlabs/ui 7.15.0 → 7.16.0

package/dist/castlabs-ui.module.d.ts

@@ -57,6 +57,7 @@ declare module '@castlabs/ui/dist/castlabs-ui.module.js' {
     sort: (col?: number, order?: string) => 'ASC' | 'DESC' | 'NONE',
   }
   export function clDebounce (callback: any, ms?: number, key?: string): void
+  export function clSanitizeId (id: string): string
 
   export function clRandomString (length?: number, words?: string[]): string
   export function clRandomList (length?: number, words?: string[]): string[]

package/dist/castlabs-ui.module.js

@@ -1,4 +1,4 @@
-/* @castlabs/ui v7.15.0 */
+/* @castlabs/ui v7.16.0 */
 
 /*!
   * Bootstrap v5.3.8 (https://getbootstrap.com/)
@@ -1151,33 +1151,44 @@ export function clFormatFilesize (bytes) {
   return `${Math.floor(bytes / 1024 / 1024 / 1024)}GB`
 }
 
+/**
+ * Format an UTC date into our UI version.
+ *
+ * @param {Date} date Date to format.
+ * @return {string} Formatted date, e.g. '01 Aug 2021'.
+ */
+export function clFormatDateUTC (date) {
+  // we use toISOString() to discard timezone information in date object
+  const [yyyy, mm, dd] = date.toISOString().split(/[-T:.Z]/)
+  const mmm = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'][
+    mm - 1
+  ]
+  return `${dd} ${mmm} ${yyyy}`
+}
+
 /**
  * Format a date into our UI version.
  *
+ * @deprecated use clFormatDateUTC instead to avoid unexpected auto-timezone-shifts.
+ *
  * @param {Date} date Date to format.
  * @return {string} Formatted date, e.g. '01 Aug 2021'.
  */
 export function clFormatDate (date) {
-  const yyyy = new Intl.DateTimeFormat('en', { year: 'numeric' }).format(date)
-  const mmm = new Intl.DateTimeFormat('en', { month: 'short' }).format(date)
-  const dd = new Intl.DateTimeFormat('en', { day: '2-digit' }).format(date)
-  return `${dd} ${mmm} ${yyyy}`
+  return clFormatDateUTC(date)
 }
 
 /**
  * Format a time into our UI version.
  *
- * @param {Date} date Date to format. Only hours/minutes will be used.
+ * @param {Date} date Date to format, assumed to be UTC.
  * @param {boolean} seconds If true, seconds will be appended.
  * @return {string} Formatted date, e.g. '18:21' or '18:21:59' (incl. seconds).
  */
 export function clFormatTimeUTC (date, seconds = false) {
-  const [hh, mm, ss] = [
-    ('' + date.getUTCHours()).padStart(2, '0'),
-    ('' + date.getUTCMinutes()).padStart(2, '0'),
-    ('' + date.getUTCSeconds()).padStart(2, '0')
-  ]
-  return seconds ? `${hh}:${mm}:${ss}` : `${hh}:${mm}`
+  // we use toISOString() to discard timezone information in date object
+  const utc = date.toISOString().split(/[-T:.Z]/)
+  return seconds ? `${utc[3]}:${utc[4]}:${utc[5]}` : `${utc[3]}:${utc[4]}`
 }
 
 /**
@@ -1188,7 +1199,7 @@ export function clFormatTimeUTC (date, seconds = false) {
  * @return {string} Formatted date, e.g. '01 Aug 2021 18:21' or '01 Aug 2021 18:21:59' (incl. seconds).
  */
 export function clFormatDateTimeUTC (date, seconds = false) {
-  return `${clFormatDate(date)} ${clFormatTimeUTC(date, seconds)}`
+  return `${clFormatDateUTC(date)} ${clFormatTimeUTC(date, seconds)}`
 }
 
 /**
@@ -1511,6 +1522,13 @@ export function clTableSorterObjects (
 // --- misc --------------------------------------------------------------------
 // -----------------------------------------------------------------------------
 
+/**
+ * Remove characters from user-provided IDs that can’t appear in our UUIDs or (CS) urns.
+ */
+export function clSanitizeId (id) {
+  return id.replace(/[^A-Za-z0-9:_-]*/g, '')
+}
+
 /**
  * Debounce a method to be called not faster than x ms.
  *