@operato/utils 8.0.0-alpha.37 → 8.0.0-beta.1

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/gesture-helper.ts

@@ -1,147 +0,0 @@
-export type GestureEventPinch = CustomEvent<{ scale: number; centerX: number; centerY: number }>
-export type GestureEventDrag = CustomEvent<{
-  deltaX: number
-  deltaY: number
-  clientX: number
-  clientY: number
-  end: boolean
-}>
-export type GestureEventDoubleTap = CustomEvent<{ x: number; y: number }>
-
-export class GestureHelper {
-  private __pointers = new Map<number, { x: number; y: number }>()
-  private __lastTapTime = 0
-  private __lastPinchDistance = 0
-  private __dragStart: { x: number; y: number } | null = null
-  private element: Element
-
-  constructor(element: Element) {
-    this.element = element
-    this.init()
-  }
-
-  private init() {
-    this.element.addEventListener('pointerdown', this.handlePointerDown as EventListener)
-  }
-
-  dispose() {
-    this.element.removeEventListener('pointerdown', this.handlePointerDown as EventListener)
-    this.removeGlobalListeners()
-  }
-
-  private handlePointerDown = (e: PointerEvent) => {
-    e.preventDefault()
-    const point = { x: e.clientX, y: e.clientY }
-    this.__pointers.set(e.pointerId, point)
-
-    this.addGlobalListeners()
-  }
-
-  private handlePointerMove = (e: PointerEvent) => {
-    e.preventDefault()
-    const point = { x: e.clientX, y: e.clientY }
-    this.__pointers.set(e.pointerId, point)
-
-    if (this.__pointers.size === 2) {
-      this.handlePinch()
-    } else if (this.__pointers.size === 1) {
-      this.handleDrag(point, false)
-    }
-  }
-
-  private handlePointerUp = (e: PointerEvent) => {
-    const point = { x: e.clientX, y: e.clientY }
-    this.__pointers.delete(e.pointerId)
-
-    if (this.__dragStart) {
-      this.handleDrag(point, true)
-    }
-
-    if (this.__pointers.size === 0) {
-      this.removeGlobalListeners()
-      this.__dragStart = null
-      this.__lastPinchDistance = 0
-      this.handleTap(point)
-    }
-  }
-
-  private handlePinch() {
-    const pointers = Array.from(this.__pointers.values()) as { x: number; y: number }[]
-    const currentDistance = this.getDistance(pointers[0], pointers[1])
-
-    if (this.__lastPinchDistance) {
-      const scale = currentDistance / this.__lastPinchDistance
-      const center = {
-        x: (pointers[0].x + pointers[1].x) / 2,
-        y: (pointers[0].y + pointers[1].y) / 2
-      }
-
-      this.element.dispatchEvent(
-        new CustomEvent('pinch', {
-          detail: { scale, centerX: center.x, centerY: center.y }
-        })
-      )
-    }
-
-    this.__lastPinchDistance = currentDistance
-  }
-
-  private handleDrag(point: { x: number; y: number }, end: boolean) {
-    if (this.__dragStart) {
-      const deltaX = point.x - this.__dragStart.x
-      const deltaY = point.y - this.__dragStart.y
-
-      this.element.dispatchEvent(
-        new CustomEvent('drag', {
-          detail: { deltaX, deltaY, clientX: point.x, clientY: point.y, end }
-        })
-      )
-
-      if (end) {
-        this.__dragStart = null
-      } else {
-        this.__dragStart = point
-      }
-    } else if (!end && this.__pointers.size === 1) {
-      /* dragging을 시작하려면, pointer 개수가 1개인 것을 (지연)확인해야한다. */
-      setTimeout(() => {
-        if (this.__pointers.size === 1 && !this.__dragStart) {
-          this.__dragStart = point
-        }
-      }, 30)
-    }
-  }
-
-  private handleTap(point: { x: number; y: number }) {
-    const currentTime = performance.now()
-    const timeSinceLastTap = currentTime - this.__lastTapTime
-
-    if (timeSinceLastTap < 300) {
-      this.element.dispatchEvent(
-        new CustomEvent('doubletap', {
-          detail: { x: point.x, y: point.y }
-        })
-      )
-    }
-
-    this.__lastTapTime = currentTime
-  }
-
-  private getDistance(p1: { x: number; y: number }, p2: { x: number; y: number }): number {
-    const dx = p1.x - p2.x
-    const dy = p1.y - p2.y
-    return Math.sqrt(dx * dx + dy * dy)
-  }
-
-  private addGlobalListeners() {
-    document.addEventListener('pointermove', this.handlePointerMove as EventListener)
-    document.addEventListener('pointerup', this.handlePointerUp as EventListener)
-    document.addEventListener('pointercancel', this.handlePointerUp as EventListener)
-  }
-
-  private removeGlobalListeners() {
-    document.removeEventListener('pointermove', this.handlePointerMove as EventListener)
-    document.removeEventListener('pointerup', this.handlePointerUp as EventListener)
-    document.removeEventListener('pointercancel', this.handlePointerUp as EventListener)
-  }
-}

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)