@operato/utils 7.1.1 → 7.1.32

package/src/cookie.ts

@@ -1,44 +0,0 @@
-/**
- * Sets a cookie with the given name, value, and expiration days.
- *
- * @param {string} cname - The name of the cookie.
- * @param {string} cvalue - The value to be stored in the cookie.
- * @param {number} exdays - The number of days until the cookie expires.
- */
-export function setCookie(cname: string, cvalue: string, exdays: number) {
-  var d = new Date()
-  d.setTime(d.getTime() + exdays * 24 * 60 * 60 * 1000)
-  var expires = 'expires=' + d.toUTCString()
-  document.cookie = cname + '=' + cvalue + ';' + expires + ';path=/'
-}
-
-/**
- * Retrieves the value of a cookie with the given name.
- *
- * @param {string} cname - The name of the cookie to retrieve.
- * @returns {string} - The value of the cookie, or an empty string if the cookie is not found.
- */
-export function getCookie(cname: string) {
-  var name = cname + '='
-  var decodedCookie = decodeURIComponent(document.cookie)
-  var ca = decodedCookie.split(';')
-  for (var i = 0; i < ca.length; i++) {
-    var c = ca[i]
-    while (c.charAt(0) == ' ') {
-      c = c.substring(1)
-    }
-    if (c.indexOf(name) == 0) {
-      return c.substring(name.length, c.length)
-    }
-  }
-  return ''
-}
-
-/**
- * Deletes a cookie with the given name.
- *
- * @param {string} name - The name of the cookie to delete.
- */
-export function deleteCookie(name: string) {
-  document.cookie = name + '=; expires=Thu, 01 Jan 1970 00:00:01 GMT;'
-}

package/src/decode-html.ts

@@ -1,5 +0,0 @@
-export function decodeHTML(html: string) {
-  var txt = document.createElement('textarea');
-  txt.innerHTML = html;
-  return txt.value;
-}

package/src/detect-overflow.ts

@@ -1,18 +0,0 @@
-/**
- * Detects if the content of an HTMLElement overflows its boundaries.
- *
- * @param {HTMLElement} el - The HTMLElement to check for overflow.
- * @returns {boolean} - `true` if overflow is detected, `false` otherwise.
- * @deprecated This function is no longer recommended for use and has been replaced by 'hasOverflow'.
- */
-export function detectOverflow(el: HTMLElement) {
-  var styleOverflow = el.style.overflow
-
-  if (!styleOverflow || styleOverflow === 'visible') el.style.overflow = 'hidden'
-
-  var overflowed = el.clientWidth < el.scrollWidth || el.clientHeight < el.scrollHeight
-
-  el.style.overflow = styleOverflow
-
-  return overflowed
-}

package/src/encode-form-params.ts

@@ -1,24 +0,0 @@
-/**
- * encode form parameter string from object
- * @param {Object} obj target object
- */
-export function encodeFormParams(obj: { [key: string]: any }) {
-  return Object.keys(obj)
-    .map(k => `${encodeURIComponent(k)}=${encodeURIComponent(obj[k])}`)
-    .join('&')
-}
-
-/**
- * encode url parameter string from object
- * replace null value to ''
- * @param {Object} obj target object
- */
-export function encodeUrlParams(urlParams: { [key: string]: any }) {
-  return Object.keys(urlParams)
-    .filter((key: string) => {
-      // ignore empty
-      return !!urlParams[key]
-    })
-    .map(key => `${key}=${encodeURIComponent(urlParams[key] || '')}`)
-    .join('&')
-}

package/src/file-drop-helper.ts

@@ -1,62 +0,0 @@
-/**
- * judge callback function for FileDropHelper.set
- */
-type JudgeCallback = () => boolean
-
-/**
- * file drop assist class
- */
-export class FileDropHelper {
-  /**
-   * 파일 드롭 영역에서의 file drag&drop과 관련된 이벤트에 대한 처리를 설정한다.
-   * @param dropArea file drag&drop target area
-   * @param [judge] file drag&drop과 관련된 이벤트에 대한 judge callback function
-   */
-  static set(dropArea: HTMLElement, judge?: JudgeCallback) {
-    var preventDefaults = (e: Event) => {
-      if (!judge || judge()) {
-        e.preventDefault()
-        e.stopPropagation()
-      }
-    }
-
-    var highlight = (e: Event) => {
-      if (!judge || judge()) {
-        dropArea.classList.add('candrop')
-      }
-    }
-
-    var unhighlight = (e: Event) => {
-      if (!judge || judge()) {
-        dropArea.classList.remove('candrop')
-      }
-    }
-
-    ;['dragenter', 'dragover', 'dragleave', 'drop'].forEach(event => {
-      dropArea.addEventListener(event, preventDefaults, false)
-    })
-    ;['dragenter', 'dragover'].forEach(event => {
-      dropArea.addEventListener(event, highlight, false)
-    })
-    ;['dragleave', 'drop'].forEach(event => {
-      dropArea.addEventListener(event, unhighlight, false)
-    })
-
-    dropArea.addEventListener(
-      'drop',
-      e => {
-        if (!judge || judge()) {
-          let dt = e.dataTransfer!
-          let files = dt.files
-
-          dropArea.dispatchEvent(
-            new CustomEvent('file-drop', {
-              detail: [...Array.from(files)]
-            })
-          )
-        }
-      },
-      false
-    )
-  }
-}

package/src/format.ts

@@ -1,123 +0,0 @@
-/*
- * Source Code from https://github.com/Mottie/javascript-number-formatter
- * 소스코드 출처 : https://github.com/Mottie/javascript-number-formatter
- */
-
-/**
- * Formats a number according to the given mask.
- *
- * ```example
- * var formattedValue = format('+$#,##0.00', 12345.67);
- * console.log(formattedValue); // Output: +$12,345.67
- * ```
- *
- * @param {any} mask - The formatting mask to apply.
- * @param {any} value - The value to format.
- * @returns {string} - The formatted string.
- */
-export function format(mask: string, value: number): string {
-  if (!mask || isNaN(+value)) {
-    return value.toString() // return as it is.
-  }
-
-  let isNegative: boolean,
-    result: string | RegExpMatchArray | null,
-    decimal: string,
-    group: string,
-    posLeadZero: number,
-    posTrailZero: number,
-    posSeparator: number,
-    part: string[],
-    szSep: string[],
-    integer: string,
-    // find prefix/suffix
-    len = mask.length,
-    start = mask.search(/[0-9\-\+#]/),
-    prefix = start > 0 ? mask.substring(0, start) : '',
-    // reverse string: not an ideal method if there are surrogate pairs
-    str = mask.split('').reverse().join(''),
-    end = str.search(/[0-9\-\+#]/),
-    offset = len - end,
-    substr = mask.substring(offset, offset + 1),
-    indx = offset + (substr === '.' || substr === ',' ? 1 : 0),
-    suffix = end > 0 ? mask.substring(indx, len) : '',
-    splittedMask: string[],
-    splittedValue: string[],
-    stringValue: string
-
-  // mask with prefix & suffix removed
-  mask = mask.substring(start, indx)
-
-  // convert any string to number according to formation sign.
-  value = mask.charAt(0) === '-' ? -value : +value
-  isNegative = value < 0 ? ((value = -value), true) : false // process only abs(), and turn on flag.
-
-  // search for separator for grp & decimal, anything not digit, not +/- sign, not #.
-  result = mask.match(/[^\d\-\+#]/g)
-  decimal = '.' // ( result && result[ result.length - 1 ] ) || '.'; // ','는 소수점이 되지 않게 함
-  group = (result && result[1] && result[0]) || ',' // treat the left most symbol as group separator
-
-  // split the decimal for the format string if any.
-  splittedMask = mask.split(decimal)
-  // Fix the decimal first, toFixed will auto fill trailing zero.
-  value = parseFloat(value.toFixed((splittedMask[1] && splittedMask[1].length) || 0))
-  stringValue = +value + '' // convert number to string to trim off *all* trailing decimal zero(es)
-
-  // fill back any trailing zero according to format
-  posTrailZero = (splittedMask[1] && splittedMask[1].lastIndexOf('0')) || 0 // look for last zero in format
-  part = stringValue.split('.')
-  // integer will get !part[1]
-  if (!part[1] || (part[1] && part[1].length <= posTrailZero)) {
-    stringValue = (+value).toFixed(posTrailZero + 1)
-  }
-  szSep = splittedMask[0].split(group) // look for separator
-  splittedMask[0] = szSep.join('') // join back without separator for counting the pos of any leading 0.
-
-  posLeadZero = (splittedMask[0] && splittedMask[0].indexOf('0')) || 0
-  if (posLeadZero > -1) {
-    while (part[0].length < splittedMask[0].length - posLeadZero) {
-      part[0] = '0' + part[0]
-    }
-  } else if (+part[0] === 0) {
-    part[0] = ''
-  }
-
-  splittedValue = stringValue.split('.')
-  splittedValue[0] = part[0]
-
-  // process the first group separator from decimal (.) only, the rest ignore.
-  // get the length of the last slice of split result.
-  posSeparator = (szSep[1] && szSep[szSep.length - 1].length) || 0
-  if (posSeparator) {
-    integer = splittedValue[0]
-    str = ''
-    offset = integer.length % posSeparator
-    len = integer.length
-    for (indx = 0; indx < len; indx++) {
-      str += integer.charAt(indx) // ie6 only support charAt for sz.
-      // -posSeparator so that won't trail separator on full length
-      /* jshint -W018 */
-      if (!((indx - offset + 1) % posSeparator) && indx < len - posSeparator) {
-        str += group
-      }
-    }
-    splittedValue[0] = str
-  }
-  splittedValue[1] = splittedMask[1] && splittedValue[1] ? decimal + splittedValue[1] : ''
-
-  // remove negative sign if result is zero
-  result = splittedValue.join('')
-  if (result === '0' || result === '') {
-    // remove negative sign if result is zero
-    isNegative = false
-  }
-
-  // 앞에 +가 붙는다면 양수일 경우에도 +를 표기해줌
-  let fixedPlusSign: string
-
-  if (splittedMask[0].substring(0, 1) === '+') fixedPlusSign = isNegative ? '-' : '+'
-  else fixedPlusSign = isNegative ? '-' : ''
-
-  // put back any negation, combine integer and fraction, and add back prefix & suffix
-  return prefix + (fixedPlusSign + result) + suffix
-}

package/src/fullscreen.ts

@@ -1,82 +0,0 @@
-/**
- * 풀스크린 전환 이후와 풀스크린 해제 이후에 호출되는 콜백함수
- * @callback FullscreenCallback
- */
-export type FullscreenCallback = () => void
-
-/**
- * 엘리먼트를 풀스크린으로 표시되도록 한다.
- * @param {HTMLElement} element 대상 엘리먼트
- * @param {FullscreenCallback} afterfull 풀스크린이 된 이후에 호출되는 콜백함수
- * @param {FullscreenCallback} afterfinish 풀스크린이 해제된 이후에 호출되는 콜백함수
- */
-export function fullscreen(element: HTMLElement, afterfull?: FullscreenCallback, afterfinish?: FullscreenCallback) {
-  var org_width = element.style.width
-  var org_height = element.style.height
-
-  function _fullscreen_callback(e: Event) {
-    if (
-      !document.fullscreenElement &&
-      //@ts-ignore
-      !document.mozFullScreen &&
-      //@ts-ignore
-      !document.webkitIsFullScreen &&
-      //@ts-ignore
-      !document.msFullscreenElement
-    ) {
-      ;['fullscreenchange', 'webkitfullscreenchange', 'MSFullscreenChange'].forEach(event =>
-        document.removeEventListener(event, _fullscreen_callback)
-      )
-
-      element.style.width = org_width
-      element.style.height = org_height
-
-      afterfinish && afterfinish()
-    } else {
-      element.style.width = '100%'
-      element.style.height = '100%'
-
-      afterfull && afterfull()
-    }
-  }
-
-  ;['fullscreenchange', 'webkitfullscreenchange', 'MSFullscreenChange'].forEach(event =>
-    document.addEventListener(event, _fullscreen_callback)
-  )
-
-  if (element.requestFullscreen) element.requestFullscreen()
-  //@ts-ignore
-  else if (element.webkitRequestFullScreen) element.webkitRequestFullScreen()
-  //@ts-ignore
-  else if (element.mozRequestFullScreen) element.mozRequestFullScreen()
-  //@ts-ignore
-  else if (element.msRequestFullscreen) element.msRequestFullscreen()
-}
-
-export function exitfullscreen() {
-  if (document.exitFullscreen) document.exitFullscreen()
-  //@ts-ignore
-  else if (document.mozCancelFullScreen) document.mozCancelFullScreen()
-  //@ts-ignore
-  else if (document.webkitCancelFullScreen) document.webkitCancelFullScreen()
-  //@ts-ignore
-  else if (document.msExitFullscreen) document.msExitFullscreen()
-}
-
-export function togglefullscreen(
-  element: HTMLElement,
-  afterfull?: FullscreenCallback,
-  afterfinish?: FullscreenCallback
-) {
-  if (
-    !document.fullscreenElement &&
-    //@ts-ignore
-    !document.mozFullScreen &&
-    //@ts-ignore
-    !document.webkitIsFullScreen &&
-    //@ts-ignore
-    !document.msFullscreenElement
-  )
-    fullscreen(element, afterfull, afterfinish)
-  else exitfullscreen()
-}

package/src/has-overflow.ts

@@ -1,22 +0,0 @@
-/**
- * Detects if the content of an HTMLElement overflows its boundaries.
- *
- * @param {HTMLElement} el - The HTMLElement to check for overflow.
- * @returns {boolean} - `true` if overflow is detected, `false` otherwise.
- */
-export function hasOverflow(el: HTMLElement): boolean {
-  const computedStyle = getComputedStyle(el)
-  const originalOverflow = computedStyle.overflow
-
-  if (originalOverflow === 'visible') {
-    el.style.overflow = 'hidden'
-  }
-
-  const isOverflowing = el.clientWidth < el.scrollWidth || el.clientHeight < el.scrollHeight
-
-  if (originalOverflow === 'visible') {
-    el.style.overflow = ''
-  }
-
-  return isOverflowing
-}

package/src/index.ts

@@ -1,25 +0,0 @@
-export * from './sleep.js'
-export * from './async-lock.js'
-export * from './file-drop-helper.js'
-export * from './context-path.js'
-export * from './os.js'
-export * from './swipe-listener.js'
-export * from './fullscreen.js'
-export * from './parse-jwt.js'
-export * from './password-pattern.js'
-export * from './closest-element.js'
-export * from './detect-overflow.js' /* deprecated by 'has-overflow' */
-export * from './has-overflow.js'
-export * from './timecapsule/index.js'
-export * from './clipboard.js'
-export * from './format.js'
-export * from './adjust-list-param.js'
-export * from './is-unvalued.js'
-export * from './stringify-bignum.js'
-export * from './encode-form-params.js'
-export * from './cookie.js'
-export * from './number-parser.js'
-export * from './longpressable.js'
-export * from './decode-html.js'
-
-export * from './reactive-controllers'

package/src/is-unvalued.ts

@@ -1,10 +0,0 @@
-/**
- * It judges whether it is false except 0, false. Returns true in case of undefined, null, NaN, '', {}, [].
- *
- * @param value
- * @returns boolean
- */
-export function isUnvalued(value: any) {
-  /* value == null same as (value === undefined || value === null) */
-  return value == null || value !== 0 || value !== false || value.length === 0 || Object.keys(value).length === 0
-}

package/src/logger.ts

@@ -1,32 +0,0 @@
-const ERROR = '[ERROR]'
-const WARN = '[WARN]'
-const DEBUG = '[DEBUG]'
-
-/**
- * Logs an error message with optional stack trace.
- *
- * @param {...any} args - The error message and optional additional data.
- */
-export var error = (...args: any[]) => {
-  var trace = [] as string[]
-  args.forEach(arg => arg && arg.stack && trace.push(arg.stack))
-  console.error(ERROR, ...args, trace.join(' '))
-}
-
-/**
- * Logs a warning message with optional stack trace.
- *
- * @param {...any} args - The warning message and optional additional data.
- */
-export var warn = (...args: any[]) => {
-  var trace = [] as string[]
-  args.forEach(arg => arg && arg.stack && trace.push(arg.stack))
-  console.warn(WARN, ...args, trace.join(' '))
-}
-
-/**
- * Logs a debug message.
- *
- * @param {...any} args - The debug message and optional additional data.
- */
-export var debug = (...args: any[]) => console.log(DEBUG, ...args)

package/src/longpressable.ts

@@ -1,101 +0,0 @@
-/**
- * @license Copyright © HatioLab Inc. All rights reserved.
- */
-
-/* Inspired by https://github.com/john-doherty/long-press-event */
-
-var timer = null as any
-
-// check if we're using a touch screen
-//@ts-ignore
-const isTouch = 'ontouchstart' in window || navigator.maxTouchPoints > 0 || navigator.msMaxTouchPoints > 0
-
-// switch to touch events if using a touch screen
-const mouseDown = isTouch ? 'touchstart' : 'mousedown'
-const mouseOut = isTouch ? 'touchcancel' : 'mouseout'
-const mouseUp = isTouch ? 'touchend' : 'mouseup'
-const mouseMove = isTouch ? 'touchmove' : 'mousemove'
-
-/*
- * Fires the 'long-press' event on element
- * @returns {void}
- */
-function fireLongPressEvent(this: HTMLElement) {
-  clearLongPressTimer()
-
-  // fire the long-press event
-  var suppressClickEvent = this.dispatchEvent(new CustomEvent('long-press', { bubbles: true, cancelable: true }))
-
-  if (suppressClickEvent) {
-    // temporarily intercept and clear the next click
-    this.addEventListener(
-      mouseUp,
-      function clearMouseUp(e) {
-        this.removeEventListener(mouseUp, clearMouseUp, true)
-        cancelEvent(e)
-      },
-      true
-    )
-  }
-}
-
-/*
- * method responsible for starting the long press timer
- * @param {event} e - event object
- * @returns {void}
- */
-function startLongPressTimer(e: Event) {
-  clearLongPressTimer(e)
-
-  var el = e.target as HTMLElement
-
-  // get delay from html attribute if it exists, otherwise default to 1500
-  var longPressDelayInMs = parseInt(el.getAttribute('data-long-press-delay') || '600', 10)
-
-  // start the timer
-  timer = setTimeout(fireLongPressEvent.bind(el), longPressDelayInMs)
-}
-
-/*
- * method responsible for clearing a pending long press timer
- * @param {event} e - event object
- * @returns {void}
- */
-function clearLongPressTimer(e?: Event) {
-  clearTimeout(timer)
-  timer = null
-}
-
-/*
- * Cancels the current event
- * @param {object} e - browser event object
- * @returns {void}
- */
-function cancelEvent(e: Event) {
-  e.stopImmediatePropagation()
-  e.preventDefault()
-  e.stopPropagation()
-}
-
-/**
- * method set target element to be able to respond longpress event
- * @param {HTMLElement} element target element
- */
-export const longpressable = (element: HTMLElement) => {
-  // hook events that clear a pending long press event
-  element.addEventListener(mouseOut, clearLongPressTimer, true)
-  element.addEventListener(mouseUp, clearLongPressTimer, true)
-  element.addEventListener(mouseMove, clearLongPressTimer, true)
-  element.addEventListener('wheel', clearLongPressTimer, true)
-  element.addEventListener('scroll', clearLongPressTimer, true)
-
-  // hook events that can trigger a long press event
-  element.addEventListener(mouseDown, startLongPressTimer, true) // <- start
-
-  // cancel context for touch display
-  if (mouseDown.indexOf('touch') === 0) {
-    element.addEventListener('contextmenu', cancelEvent, true)
-  } else {
-    element.addEventListener('contextmenu', clearLongPressTimer, true)
-  }
-}

package/src/mixins/index.ts

@@ -1 +0,0 @@
-export { default as InfiniteScrollable } from './infinite-scrollable.js'

package/src/mixins/infinite-scrollable.ts

@@ -1,67 +0,0 @@
-import debounce from 'lodash-es/debounce'
-
-type Constructor = new (...args: any[]) => {}
-
-/**
- * A higher-order function that enhances a base class with infinite scrolling functionality.
- *
- * @template TBase - The base class constructor type.
- * @param {TBase} Base - The base class to enhance with infinite scrolling.
- * @returns {TBase & InfiniteScrollable} - The extended class with infinite scrolling capabilities.
- */
-export default function InfiniteScrollable<TBase extends Constructor>(Base: TBase) {
-  return class Scrolling extends Base {
-    /**
-     * Default options for infinite scrolling.
-     *
-     * @type {object}
-     * @property {number} threshold - The threshold value to trigger loading more items.
-     * @property {number} limit - The limit of items to load per page.
-     * @property {string} totalProp - The property name for the total number of items.
-     * @property {string} pageProp - The property name for the current page number.
-     */
-    _infiniteScrollOptions = {
-      threshold: 20,
-      limit: 30,
-      totalProp: '_total',
-      pageProp: '_page'
-    }
-
-    /**
-     * Event handler for the scroll event with debouncing.
-     *
-     * @param {Event} e - The scroll event object.
-     */
-    onScroll = debounce(e => {
-      //@ts-ignore inheritted class should have scrollTargetEl property
-      var el = this.scrollTargetEl
-      if (!el) {
-        console.warn('scroll target element is not defined.')
-        return
-      }
-
-      var { threshold = 0, limit, totalProp, pageProp } = this._infiniteScrollOptions
-
-      if (
-        (this as any)[pageProp] < (this as any)[totalProp] / limit &&
-        el.scrollHeight - el.clientHeight <= el.scrollTop + threshold
-      ) {
-        this.scrollAction()
-      }
-    }, 300)
-
-    // commented due to TS2611 error
-    // get scrollTargetEl(): HTMLElement | null {
-    //   console.warn('scroll target element is not defined.')
-
-    //   return null
-    // }
-
-    /**
-     * An async function to handle scroll action when the threshold is reached.
-     */
-    async scrollAction() {
-      console.warn('scroll action not implemented.')
-    }
-  }
-}

package/src/number-parser.ts

@@ -1,24 +0,0 @@
-// 숫자라면 숫자값을, 아니면 null을 반환
-// 0         = true
-// '0'       = true
-// 123       = true
-// "123"     = true
-// -123      = true
-// "-123"    = true
-// true      = false
-// false     = false
-// ""        = false
-// null      = false
-// undefined = false
-// {}        = false
-// []        = false
-export function parseToNumberOrNull(value: any): number | null {
-  let result: number | null = null
-
-  // 숫자나 스트링이면서 NaN이 아니면 숫자로 변환
-  if ((typeof value === 'string' || typeof value === 'number') && value !== '' && !isNaN(value as number)) {
-    result = Number(value)
-  }
-
-  return result
-}