@operato/utils 8.0.0-beta.0 → 8.0.0-beta.1

package/CHANGELOG.md

@@ -3,6 +3,15 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.0.0-beta.1](https://github.com/hatiolab/operato/compare/v8.0.0-beta.0...v8.0.0-beta.1) (2025-01-08)
+
+
+### :bug: Bug Fix
+
+* missing .npmignore ([be05985](https://github.com/hatiolab/operato/commit/be05985abfae4af53501f718dd52932099f7fbcb))
+
+
+
 ## [8.0.0-beta.0](https://github.com/hatiolab/operato/compare/v8.0.0-alpha.56...v8.0.0-beta.0) (2025-01-07)
 
 **Note:** Version bump only for package @operato/utils

package/package.json

@@ -2,7 +2,7 @@
   "name": "@operato/utils",
   "description": "Webcomponent utils following open-wc recommendations",
   "author": "heartyoh",
-  "version": "8.0.0-beta.0",
+  "version": "8.0.0-beta.1",
   "main": "dist/src/index.js",
   "module": "dist/src/index.js",
   "exports": {
@@ -127,5 +127,5 @@
   "dependencies": {
     "lodash-es": "^4.17.21"
   },
-  "gitHead": "c4e9cc245659d050a9ffd66542083a6daad4bcb9"
+  "gitHead": "d5b28a2e9deb632c0dc80132f6a7196dd6fe4220"
 }

package/.editorconfig

@@ -1,29 +0,0 @@
-# EditorConfig helps developers define and maintain consistent
-# coding styles between different editors and IDEs
-# editorconfig.org
-
-root = true
-
-
-[*]
-
-# Change these settings to your own preference
-indent_style = space
-indent_size = 2
-
-# We recommend you to keep these unchanged
-end_of_line = lf
-charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false
-
-[*.json]
-indent_size = 2
-
-[*.{html,js,md}]
-block_comment_start = /**
-block_comment = *
-block_comment_end = */

package/.storybook/main.js

@@ -1,3 +0,0 @@
-module.exports = {
-  stories: ['../dist/stories/**/*.stories.{js,md,mdx}'],
-};

package/.storybook/preview.js

@@ -1,52 +0,0 @@
-import { i18next } from '@operato/i18n'
-
-export const globalTypes = {
-  locale: {
-    name: 'Locale',
-    description: 'Internationalization locale',
-    toolbar: {
-      icon: 'globe',
-      items: [
-        { value: 'en', right: '🇺🇸', title: 'English' },
-        { value: 'ko', right: '🇰🇷', title: '한국어' },
-        { value: 'zh', right: '🇨🇳', title: '中文' },
-        { value: 'ja', right: '🇯🇵', title: '日本語' },
-        { value: 'ms', right: '🇲🇾', title: 'Bahasa Melayu' }
-      ],
-      showName: true
-    }
-  },
-  theme: {
-    name: 'Theme',
-    description: 'Global theme for components',
-    toolbar: {
-      icon: 'paintbrush',
-      items: [
-        { value: 'light', title: 'Light' },
-        { value: 'dark', title: 'Dark' }
-      ],
-      showName: true
-    }
-  }
-}
-
-export const decorators = [
-  (Story, context) => {
-    const { locale, theme } = context.globals
-
-    if (locale) {
-      i18next.changeLanguage(locale)
-    }
-
-    // Set the theme class for the document
-    if (theme === 'dark') {
-      document.documentElement.classList.add('dark')
-      document.documentElement.classList.remove('light')
-    } else {
-      document.documentElement.classList.add('light')
-      document.documentElement.classList.remove('dark')
-    }
-
-    return Story()
-  }
-]

package/.storybook/server.mjs

@@ -1,8 +0,0 @@
-import { storybookPlugin } from '@web/dev-server-storybook';
-import baseConfig from '../web-dev-server.config.mjs';
-
-export default /** @type {import('@web/dev-server').DevServerConfig} */ ({
-  ...baseConfig,
-  open: '/',
-  plugins: [storybookPlugin({ type: 'web-components' }), ...baseConfig.plugins],
-});

package/src/adjust-list-param.ts

@@ -1,79 +0,0 @@
-/**
- * Type definition for available filter operators that can be used in query filters.
- */
-declare type FilterOperator =
-  | 'search'
-  | 'eq'
-  | 'between'
-  | 'gte'
-  | 'lte'
-  | 'is_not_true'
-  | 'in'
-  | 'like'
-  | 'i_like'
-  | 'noteq'
-  | 'is_empty_num_id'
-  | 'is_blank'
-  | 'is_present'
-  | 'is_not_false'
-  | 'is_true'
-  | 'is_false'
-  | 'is_not_null'
-  | 'is_null'
-  | 'notin_with_null'
-  | 'notin'
-  | 'gt'
-  | 'lt'
-  | 'i_nlike'
-  | 'nlike'
-
-/**
- * Type definition for a query filter that can be applied to filter data.
- */
-declare type QueryFilter = {
-  name: string
-  operator: FilterOperator
-  value: any
-}
-
-/**
- * Type definition for sorting parameters that can be applied to sort data in a query.
- */
-declare type QuerySorter = {
-  name: string
-  desc?: boolean
-}
-
-/**
- * Type definition for pagination parameters that can be applied to paginate query results.
- */
-declare type QueryPaginator = {
-  page?: number
-  limit?: number
-}
-
-/**
- * A utility function to adjust query filters based on changes provided in `filtersChange`.
- *
- * @param {QueryFilter[]} filters - The current query filters.
- * @param {QueryFilter[]} filtersChange - The changes to be applied to the filters.
- * @param {boolean} replaceIf - A flag indicating whether to replace existing filters if a filter with the same name exists.
- * @returns {QueryFilter[]} The adjusted query filters.
- */
-export function adjustFilters(
-  filters: QueryFilter[],
-  filtersChange: QueryFilter[],
-  replaceIf: boolean = true
-): QueryFilter[] {
-  var filtersNew = [...filters]
-
-  filtersChange.forEach(change => {
-    const idx = (filtersNew || []).findIndex(f => f.name === change.name)
-    if (idx !== -1 && !replaceIf) {
-      return
-    }
-    idx !== -1 ? filtersNew.splice(idx, 1, change) : filtersNew.push(change)
-  })
-
-  return filtersNew
-}

package/src/async-lock.ts

@@ -1,27 +0,0 @@
-/**
- * A simple asynchronous lock utility class that allows controlling access to a critical section.
- * It provides a mechanism to create a lock and wait for its release using promises.
- */
-export class AsyncLock {
-  unlock?: any
-  promise? = new Promise(resolve => (this.unlock = resolve))
-
-  /**
-   * Creates an instance of the AsyncLock class.
-   *
-   * @param {boolean} [lock=false] - Optional parameter to lock the instance immediately upon creation.
-   */
-  constructor(lock: boolean = false) {
-    if (lock) {
-      this.lock()
-    }
-  }
-
-  /**
-   * Locks the instance, making it awaitable until unlocked.
-   * A new promise is created for the lock, and the existing unlock function is replaced with a new one.
-   */
-  lock() {
-    this.promise = new Promise(resolve => (this.unlock = resolve))
-  }
-}

package/src/clipboard.ts

@@ -1,41 +0,0 @@
-/**
- * Copies the specified text to the clipboard.
- *
- * @param {string} textToCopy - The text to be copied to the clipboard.
- * @param {string} [type] - Optional MIME type for the clipboard data (e.g., 'text/plain', 'text/html').
- * @returns {Promise<void>} - A promise that resolves when the text is successfully copied to the clipboard.
- */
-export async function copyToClipboard(textToCopy: string, type?: string): Promise<void> {
-  if (navigator.clipboard && window.isSecureContext) {
-    if (type && type !== 'text/plain') {
-      /* According to experience, chrome seems to support text/html. */
-      return navigator.clipboard.write([
-        new ClipboardItem({
-          [type]: new Blob([textToCopy], { type }),
-          'text/plain': new Blob([textToCopy], { type: 'text/plain' })
-        })
-      ])
-    } else {
-      return navigator.clipboard.write([
-        new ClipboardItem({
-          'text/plain': new Blob([textToCopy], { type: 'text/plain' })
-        })
-      ])
-    }
-  } else {
-    let textArea = document.createElement('textarea')
-
-    textArea.value = textToCopy
-    textArea.style.position = 'fixed'
-    textArea.style.left = '-999999px'
-    textArea.style.top = '-999999px'
-    document.body.appendChild(textArea)
-    textArea.focus()
-    textArea.select()
-
-    return new Promise((res, rej) => {
-      document.execCommand('copy') ? res() : rej()
-      textArea.remove()
-    })
-  }
-}

package/src/closest-element.ts

@@ -1,24 +0,0 @@
-/*
- * inspired by https://stackoverflow.com/questions/54520554/custom-element-getrootnode-closest-function-crossing-multiple-parent-shadowd
- */
-
-/**
- * Finds the closest ancestor element of the given base element that matches the provided CSS selector.
- *
- * @param {string} selector - The CSS selector to search for.
- * @param {Element} base - The base element to start the search from.
- * @returns {Element | null} - The closest ancestor element matching the selector, or null if none is found.
- */
-export function closestElement(selector: string, base: Element) {
-  function __closestFrom(el: Element | Window | Document | null): Element | null {
-    if (!el || el === document || el === window) {
-      return null
-    }
-    if ((el as Slottable).assignedSlot) {
-      el = (el as Slottable).assignedSlot
-    }
-    let found = (el as Element).closest(selector)
-    return found ? found : __closestFrom(((el as Element).getRootNode() as ShadowRoot).host)
-  }
-  return __closestFrom(base)
-}

package/src/context-path.ts

@@ -1,42 +0,0 @@
-/**
- * A regular expression pattern used to parse the pathname into different parts.
- * It captures the contextPath, prefix, domain, and path.
- * Example: /contextPathPrefix/domain/path/to/resource
- */
-var CONTEXT_PATH_PREFIX = 'domain|business'
-
-/**
- * Parses the given pathname and extracts information about the contextPath, prefix, domain, and path.
- *
- * @param {string} pathname - The pathname to parse.
- * @returns {object} - An object containing the parsed information:
- *   - contextPath: The context path portion of the pathname.
- *   - prefix: The prefix portion of the pathname.
- *   - domain: The domain portion of the pathname.
- *   - path: The remaining path after contextPath, prefix, and domain.
- */
-export function getPathInfo(pathname: string) {
-  var regexp = new RegExp(`(/(${CONTEXT_PATH_PREFIX})/([^/]+))?(/?.*)`)
-  var matched = pathname.match(regexp)
-  var contextPath = matched?.[1] || ''
-  var prefix = matched?.[2] || ''
-  var domain = matched?.[3] || ''
-  var path = matched?.[4]
-
-  return {
-    contextPath,
-    prefix,
-    domain,
-    path
-  }
-}
-
-/**
- * Sets the context path prefix used for parsing pathnames.
- *
- * @param {string} contextPathPrefix - The new context path prefix to set.
- */
-export function setContextPathPrefix(contextPathPrefix?: string) {
-  console.log('context-path-prefix was just set to ', `'${contextPathPrefix || 'domain|business'}'`)
-  CONTEXT_PATH_PREFIX = contextPathPrefix || 'domain|business'
-}

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
-}