@dxtmisha/functional-basic 0.1.1 → 0.2.0

package/src/classes/GeoPhone.ts

@@ -1,272 +0,0 @@
-import { forEach } from '../functions/forEach'
-import { isFilled } from '../functions/isFilled'
-import { toArray } from '../functions/toArray'
-
-import { Geo } from './Geo'
-import {
-  type GeoPhoneValue,
-  type GeoPhoneMap,
-  type GeoPhoneMapInfo
-} from '../types/geoTypes'
-
-/**
- * A class for storing and processing phone number masks.
- *
- * Класс для хранения и обработка маски телефона.
- */
-export class GeoPhone {
-  protected static list: GeoPhoneValue[] = []
-  protected static map: Record<string, GeoPhoneMap> = {}
-
-  /**
-   * Getting an object with information about the phone code and country.
-   *
-   * Получение объекта с информацией о телефонном коде и стране.
-   * @param code country and language code/ код страны и языка
-   */
-  static get(code: string): GeoPhoneValue | undefined {
-    return this.list.find(item => code === item.value)
-  }
-
-  /**
-   * Getting information by phone.
-   *
-   * Получение информации по телефону.
-   * @param phone phone number/ номер телефон
-   */
-  static getByPhone(phone: string): GeoPhoneMapInfo {
-    let focus = this.map
-    let item: GeoPhoneMap | undefined
-    let value = ''
-
-    this.toNumber(phone).forEach((number) => {
-      if (
-        value === ''
-        && number in focus
-      ) {
-        item = focus[number]
-        focus = item?.next ?? {}
-      } else {
-        value += number
-      }
-    })
-
-    return {
-      item,
-      phone: value
-    }
-  }
-
-  /**
-   * Retrieves complete mask data by country code.
-   *
-   * Получает полные данные о маске по коду страны.
-   * @param code country and language code/ код страны и языка
-   */
-  static getByCode(code: string): GeoPhoneMap | undefined {
-    const item = this.get(code)
-
-    if (item) {
-      return this.getByPhone(item.phone.toString())?.item
-    }
-
-    return undefined
-  }
-
-  /**
-   * We get an array from a list of all phone numbers.
-   *
-   * Получаем массив из списка всех телефонных кодов.
-   */
-  static getList(): GeoPhoneValue[] {
-    return this.list
-  }
-
-  /**
-   * We get a map of a tree, sorted by its code.
-   *
-   * Получаем карту дерева, отсортированную по его коду.
-   */
-  static getMap(): Record<string, GeoPhoneMap> {
-    return this.map
-  }
-
-  /**
-   * Convert to phone mask.
-   *
-   * Преобразовать в маску телефона.
-   * @param phone phone number/ номер телефон
-   * @param masks a mask to transform a phone number/ маска для преобразования номер телефон
-   */
-  static toMask(
-    phone: string,
-    masks?: string[]
-  ): string | undefined {
-    if (
-      isFilled(phone)
-      && Array.isArray(masks)
-      && masks.length > 0
-    ) {
-      const value = this.removeZero(phone)
-      const length = value.length
-
-      for (const mask of masks) {
-        if (this.getUnnecessaryLength(mask) === length) {
-          return this.toStandard(value, mask)
-        }
-      }
-    }
-
-    return undefined
-  }
-
-  /**
-   * Deletes the country code from the input number.
-   *
-   * Удаляет код страны по входному номеру.
-   * @param phone phone number/ номер телефон
-   */
-  static removeZero(phone: string): string {
-    if (phone.match(/^0/)) {
-      return phone.replace(/^0/, '')
-    } else if (phone.match(/^89/)) {
-      return phone.replace(/^8/, '')
-    }
-
-    return phone
-  }
-
-  /**
-   * Returns the symbol by the internal country code.
-   *
-   * Возвращает символ по коду внутри страны.
-   * @param within internal country code/ код внутри страны
-   */
-  protected static getWithinSymbol(within: number | string): string {
-    switch (within) {
-      case 4:
-      case '4':
-        return '$'
-      case 8:
-      case '8':
-        return '~'
-    }
-
-    return '='
-  }
-
-  /**
-   * Deletes all characters that do not belong to the mask.
-   *
-   * Удаляет все символы, не относящиеся к маске.
-   * @param mask A mask to transform a phone number/ маска для преобразования номер телефон
-   */
-  protected static getUnnecessaryLength(mask: string): number {
-    return mask.replace(/[^*]+/ig, '').length
-  }
-
-  /**
-   * Creating a list for the map.
-   *
-   * Формирование списка для карты.
-   */
-  protected static makeList(): void {
-    const list = forEach(Geo.getList(), (item) => {
-      if (item?.phoneMask) {
-        return {
-          phone: (item?.phoneCode && Number(item.phoneCode.replace(/[^0-9]+/, ''))) || undefined,
-          within: item?.phoneWithin || 0,
-          mask: toArray(item.phoneMask),
-          value: item.country
-        }
-      }
-
-      return undefined
-    }) as GeoPhoneValue[]
-
-    this.list = list.sort((a, b) => (a.phone - b.phone))
-  }
-
-  /**
-   * Creating a map for search.
-   *
-   * Создание карты для поиска.
-   */
-  protected static makeMap(): void {
-    this.list.forEach((item) => {
-      item.mask.forEach((mask) => {
-        let focus = this.map
-        let value: GeoPhoneMap | undefined
-
-        this.toNumber(mask).forEach((number) => {
-          if (!(number in focus)) {
-            focus[number] = {
-              items: [],
-              info: undefined,
-              value: undefined,
-              mask: [],
-              maskFull: [],
-              next: {}
-            }
-          }
-
-          value = focus[number]
-          focus = value?.next ?? {}
-        })
-
-        if (value) {
-          if (value.value === undefined) {
-            value.info = item
-            value.value = item.value
-          }
-
-          const maskWithin = this.toWithin(mask, item.within)
-
-          value.mask.push(maskWithin)
-          value.maskFull.push(maskWithin.replace(/\d/ig, '*'))
-          value.items.push(item)
-        }
-      })
-    })
-  }
-
-  /**
-   * The method parses a string argument and returns a floating point number.
-   *
-   * Метод принимает строку в качестве аргумента и возвращает десятичное число.
-   * @param value the value to parse/ текстовая строка
-   */
-  protected static toNumber(value: string): string[] {
-    return value
-      .replace(/\D+/ig, '')
-      .split('')
-  }
-
-  /**
-   * Converts the phone to a standard.
-   *
-   * Преобразовывает телефон в стандарт.
-   * @param phone phone number/ номер телефон
-   * @param mask a mask to transform a phone number/ маска для преобразования номер телефон
-   */
-  protected static toStandard(phone: string, mask: string): string {
-    let character = 0
-    return mask.replace(/\*/ig, () => String(phone[character++]))
-  }
-
-  /**
-   * Replaces the first character with the internal country code
-   *
-   * Заменяет первый символ на код внутри страны.
-   * @param mask a mask to transform a phone number/ маска для преобразования номер телефон
-   * @param within internal country code/ код внутри страны
-   */
-  protected static toWithin(mask: string, within: number | string): string {
-    return mask.replace(/\*/, this.getWithinSymbol(within))
-  }
-
-  static {
-    this.makeList()
-    this.makeMap()
-  }
-}

package/src/classes/Global.ts

@@ -1,32 +0,0 @@
-let global: Record<string, any>
-
-/**
- * Class for obtaining global data.
- *
- * Класс для получения глобальных данных.
- */
-export class Global {
-  /**
-   * Returns the value by its name.
-   *
-   * Возвращает значение по его имени.
-   * @param name property name/ название свойства
-   */
-  static get<R = any>(name: string): R {
-    return global && global?.[name]
-  }
-
-  /**
-   * Adds data, this method works only once.
-   *
-   * Добавляет данные, этот метод работает только 1 раз.
-   * @param data global data/ глобальные данные
-   */
-  static add(data: Record<string, any>) {
-    if (global !== undefined) {
-      return
-    }
-
-    global = { ...data }
-  }
-}

package/src/classes/Hash.ts

@@ -1,142 +0,0 @@
-import { executeFunction } from '../functions/executeFunction'
-import { forEach } from '../functions/forEach'
-import { getRequestString } from '../functions/getRequestString'
-import { isDomRuntime } from '../functions/isDomRuntime'
-import { transformation } from '../functions/transformation'
-
-/**
- * Working with data stored in hash.
- *
- * Работа с данными сохраненными в хеш.
- */
-export class Hash {
-  private static hash: Record<string, any> = {}
-  private static watch: Record<string, ((value: any) => void)[]> = {}
-  private static block = false
-
-  /**
-   * Get data from hash.
-   *
-   * Получение данных из хэша.
-   * @param name variable names/ названия переменных
-   * @param defaultValue value or function to change data/ значение или функция для изменения данных
-   */
-  static get<T>(
-    name: string,
-    defaultValue?: T | (() => T)
-  ): T {
-    if (
-      !(name in this.hash)
-      && defaultValue
-    ) {
-      this.set(name, defaultValue)
-    }
-
-    return this.hash[name]
-  }
-
-  /**
-   * Change data in hash.
-   *
-   * Изменение данных в хэше.
-   * @param name variable names/ названия переменных
-   * @param callback value or function to change data/ значение или функция для изменения данных
-   */
-  static set<T>(
-    name: string,
-    callback: T | (() => T)
-  ): void {
-    const value = executeFunction(callback)
-
-    if (value !== this.hash?.[name]) {
-      this.hash[name] = value
-      this.update()
-    }
-  }
-
-  /**
-   * Adding an event when data is changed.
-   *
-   * Добавление события при изменении данных.
-   * @param name variable names/ названия переменных
-   * @param callback the function is called when the data is changed/ функция вызывается при изменении данных
-   */
-  static addWatch<T>(
-    name: string,
-    callback: (value: T) => void
-  ): void {
-    if (name in this.watch) {
-      this.watch[name]?.push(callback)
-    } else {
-      this.watch[name] = [callback]
-    }
-  }
-
-  /**
-   * Update hash variable from URL string.
-   *
-   * Обновление переменной хэша из строки URL.
-   */
-  static reload(): void {
-    if (!this.block) {
-      const location = this.getLocation()
-
-      this.makeWatch(location)
-      this.hash = location
-    }
-  }
-
-  /**
-   * Obtaining data from the URL string.
-   *
-   * Получение данных из строки URL.
-   */
-  private static getLocation(): Record<string, any> {
-    const hash: Record<string, any> = {}
-
-    location.hash.replace(
-      /([\w-]+)[:=]([^;]+)/ig,
-      (...item: string[]) => {
-        hash[String(item[1])] = transformation(item[2])
-        return ''
-      }
-    )
-
-    return hash
-  }
-
-  /**
-   * Update hash string in URL.
-   *
-   * Обновление строки хэша в URL.
-   */
-  private static update(): void {
-    this.block = true
-    history.replaceState(null, '', `#${getRequestString(this.hash, '=', ';')}`)
-
-    requestAnimationFrame(() => {
-      this.block = false
-    })
-  }
-
-  /**
-   * Calling all functions whose data has changed.
-   *
-   * Вызов всех функций, у которых были изменены данные.
-   * @param location fresh data/ свежий данные
-   */
-  private static makeWatch(location: Record<string, any>): void {
-    forEach(this.watch, (item, name) => {
-      if (this.hash?.[name] !== location?.[name]) {
-        item.forEach(callback => callback(location[name]))
-      }
-    })
-  }
-
-  static {
-    if (isDomRuntime()) {
-      this.reload()
-      addEventListener('hashchange', () => this.reload())
-    }
-  }
-}

package/src/classes/Icons.ts

@@ -1,165 +0,0 @@
-import { forEach } from '../functions/forEach'
-import { isDomRuntime } from '../functions/isDomRuntime'
-
-import { Api } from './Api'
-
-export type IconsItem = string | Promise<string | any>
-
-const ICONS_KEY = '__UI_ICON'
-const ICONS_WAIT = 320
-const ICONS_LOAD = '--LOAD--'
-
-/**
- * Class for managing icons.
- *
- * Класс для управления иконками.
- */
-export class Icons {
-  protected static icons: Record<string, IconsItem> = {}
-  protected static url: string = '/icons/'
-
-  static {
-    if (isDomRuntime()) {
-      if (!(ICONS_KEY in window)) {
-        (window as any)[ICONS_KEY] = {}
-      }
-
-      this.icons = (window as any)[ICONS_KEY]
-    }
-  }
-
-  /**
-   * Checks if the given icon is in the list of connected icons.
-   *
-   * Проверяет, есть ли данная иконка в списке подключенных иконок.
-   * @param index icon name/ название иконки
-   */
-  static is(index: string): boolean {
-    return index in this.icons || this.getName(index) in this.icons
-  }
-
-  /**
-   * Returns the icon by the name.
-   *
-   * Возвращает иконку по названию.
-   * @param index icon name/ название иконки
-   * @param url path to the storage location of the icon, if the icon does not exist/
-   * путь к месту хранения иконки, если иконка не существует
-   * @param wait waiting time for picture loading/
-   * время ожидания загрузки картинки
-   */
-  static async get(
-    index: string,
-    url = '',
-    wait: number = 1000 * 60 * 3
-  ): Promise<string> {
-    const icon = this.icons?.[this.getName(index)]
-      ?? this.icons?.[index]
-      ?? `${index.replace(/^@/, url ?? this.url)}.svg`
-
-    if (typeof icon === 'string') {
-      if (
-        icon === ICONS_LOAD
-        && wait > 0
-      ) {
-        await this.wait()
-        return this.get(index, url, wait - ICONS_WAIT)
-      }
-
-      return icon
-    }
-
-    return await icon
-  }
-
-  /**
-   * Returns a list of names of all registered icons.
-   *
-   * Возвращает список названий всех зарегистрированных иконок.
-   */
-  static getNameList(): string[] {
-    return forEach(this.icons, (_, name) => {
-      return name.replace(/^@/, '')
-    })
-  }
-
-  /**
-   * Returns a global link.
-   *
-   * Возвращает глобальную ссылку.
-   */
-  static getUrlGlobal() {
-    return `${Api.isLocalhost() ? '' : ''}${this.url}`
-  }
-
-  /**
-   * Adding custom icons.
-   *
-   * Добавление пользовательских иконок.
-   * @param index icon name/ название иконки
-   * @param file path to the file/ путь к файлу
-   */
-  static add(index: string, file: IconsItem): void {
-    this.icons[this.getName(index)] = file
-  }
-
-  /**
-   * Adding custom icons in loading mode.
-   *
-   * Добавление пользовательских иконок в режиме загрузки.
-   * @param index icon name/ название иконки
-   */
-  static addLoad(index: string): void {
-    this.icons[this.getName(index)] = ICONS_LOAD
-  }
-
-  /**
-   * Adding custom global icons.
-   *
-   * Добавление пользовательских глобальных иконок.
-   * @param index icon name/ название иконки
-   * @param file path to the file/ путь к файлу
-   */
-  static addGlobal(index: string, file: string): void {
-    this.icons[this.getName(index)] = `${this.getUrlGlobal()}${file}`
-  }
-
-  /**
-   * Adding an icon by the list.
-   *
-   * Добавление иконки по списку.
-   * @param list list of icons/ список иконки
-   */
-  static addByList(list: Record<string, IconsItem>): void {
-    forEach(list, (file, index) => this.add(index, file))
-  }
-
-  /**
-   * Changes the file path.
-   *
-   * Изменяет путь к файлу.
-   * @param url new file path/ новый путь к файлу
-   */
-  static setUrl(url: string): void {
-    this.url = url
-  }
-
-  /**
-   * Returns the icon name.
-   *
-   * Возвращает название иконки.
-   * @param index icon name/ название иконки
-   */
-  protected static getName(index: string): string {
-    return `@${index}`
-  }
-
-  /**
-   * Script execution delay.
-   *
-   * Задержка выполнения скрипта.
-   */
-  protected static wait(): Promise<void> {
-    return new Promise(resolve => setTimeout(() => resolve(), ICONS_WAIT))
-  }
-}

package/src/classes/Loading.ts

@@ -1,90 +0,0 @@
-import { isDomRuntime } from '../functions/isDomRuntime'
-
-import { EventItem } from './EventItem'
-
-import {
-  type ElementOrString,
-  type EventListenerDetail
-} from '../types/basicTypes'
-
-type LoadingDetail = {
-  loading: boolean
-}
-
-const LOADING_EVENT_NAME = 'ui-loading'
-
-/**
- * Class for working with global loading.
- *
- * Класс для работы с глобальной загрузкой.
- */
-export class Loading {
-  protected static value = 0
-  protected static event?: EventItem<Window, CustomEvent>
-
-  /**
-   * Check if the loader is active now.
-   *
-   * Проверить, активен ли сейчас загрузчик.
-   */
-  static is(): boolean {
-    return this.value > 0
-  }
-
-  /**
-   * Shows the loader.
-   *
-   * Показывает загрузчик.
-   */
-  static show(): void {
-    this.value++
-    this.dispatch()
-  }
-
-  /**
-   * Hides the loader.
-   *
-   * Скрывает загрузчик.
-   */
-  static hide(): void {
-    if (this.is()) {
-      this.value--
-      this.dispatch()
-    }
-  }
-
-  /**
-   * Event registration to listen for data changes.
-   *
-   * Регистрация события для прослушивания изменений данных.
-   * @param listener the object that receives a notification (an object that implements the
-   * Event interface) when an event of the specified type occurs/ объект, который принимает
-   * уведомление, когда событие указанного типа произошло
-   * @param element element/ элемент
-   */
-  static registrationEvent(
-    listener: EventListenerDetail<CustomEvent, LoadingDetail>,
-    element?: ElementOrString<HTMLElement>
-  ) {
-    if (isDomRuntime()) {
-      new EventItem(window, LOADING_EVENT_NAME, listener)
-        .setElementControl(element)
-        .start()
-    }
-  }
-
-  /**
-   * Calls the event listener.
-   *
-   * Вызывает слушателя событий.
-   */
-  protected static dispatch(): void {
-    this.event?.dispatch({ loading: this.is() } as LoadingDetail)
-  }
-
-  static {
-    if (isDomRuntime()) {
-      this.event = new EventItem(window, LOADING_EVENT_NAME)
-    }
-  }
-}