dev-classes 1.2.3 → 1.3.4

package/README.md

@@ -0,0 +1,250 @@
+<h3 align="center">SocketApi</h3>
+
+```ts
+import { SocketApi } from 'dev-classes';
+
+SocketApi.init({
+  url: 'wss://...',
+  timeReConnect: 5000,
+  numberOfRepit: 5,
+  isReConnectNetworkOnline: true
+});
+
+SocketApi.on('status', (status) => { console.log('onStatus', status); });
+SocketApi.on('msg', (messages) => { console.log('onMessages', messages); });
+SocketApi.on('reConnect', (status) => { console.log('reConnect', status); });
+SocketApi.on('timeOffReConnect', (data) => { console.log('timeOffReConnect', data); });
+
+SocketApi.connect();
+//...
+
+```
+<h3 align="center">HTTPSApi</h3>
+
+```ts
+import { HTTPSApi, RequestPayloadHTTPSApi } from "dev-classes";
+
+HTTPSApi.init();
+
+HTTPSApi.on('fetch', (info) => { })
+HTTPSApi.request({keyAction: 'action1', request: {url: '...'}})
+
+```
+<h3 align="center">Color</h3>
+
+```ts
+
+type ColorRgb = [number, number, number];
+
+interface Color_P{
+  ColorRgb: ColorRgb;
+  ColorRgba: [...ColorRgb, number];
+  ColorHsla: Record<"h" | "s" | "l" | "a", number>;
+  TypeBrightness_OR:"BT601" | "BT709" | "BT2020"
+}
+
+interface ColorProps{
+  componentToHex: (c: number) => string;
+  rgbToHex(r: number, g: number, b: number): string;
+  rgbToHsv(r: number, g: number, b: number): Color_P['ColorRgb'];
+  hsvToRgb(h: number, s: number, v: number): Color_P['ColorRgb'];
+  rgbaToHsla(r: number, g: number, b: number, a: number): Color_P['ColorHsla'];
+  hslaToRgba(h: number, s: number, l: number, a: number): Color_P['ColorRgba'];
+  hslaStringToRgba(hsla: string): Color_P['ColorRgba'];
+  hexaToRgba(hexa: string): Color_P['ColorRgba'];
+  hexToRgb(hex: string): Color_P['ColorRgb'];
+  hexaToHsla(hexa: string): Color_P['ColorHsla'];
+  rgbaToHexa(rgba: Color_P['ColorRgba'] | Color_P['ColorRgb'] ): string;
+  hslaStringToHexa(hsla: string): string;
+  hslaStringToHex(hsla: string): string;
+  mixColors(color1: Color_P['ColorRgb'] , color2: Color_P['ColorRgb'], weight: number): Color_P['ColorRgb'];
+  getRgbByTypeBrightness(type: Color_P['TypeBrightness_OR']): Color_P['ColorRgb'];
+  getAverageColor(color1: Color_P['ColorRgb'], color2: Color_P['ColorRgb']): Color_P['ColorRgb'];
+  getAccentColor(baseHsv: number[], baseColor: Color_P['ColorRgb'], elementColor: Color_P['ColorRgb']): Color_P['ColorRgb']
+  changeColorAccent(baseHsv: number[], accentHsv: number[], color: Color_P['ColorRgb'], isDarkTheme: boolean): Color_P['ColorRgb'];
+  changeBrightness(color: Color_P['ColorRgb'], amount: number): Color_P['ColorRgb'];
+  hexBrightness(hex:string, amount: number):string;
+  getHexColorFromTelegramColor(color: number): string;  
+  getRgbColorFromTelegramColor(color: number): Color_P['ColorRgb'];
+  rgbaToRgb(rgba: Color_P['ColorRgba'], bg: Color_P['ColorRgb']): Color_P['ColorRgb'];
+  calculateBrightness(rgb: Color_P['ColorRgb'], type?:Color_P['TypeBrightness_OR']): number;
+  getTextColor(luminance: number): Color_P['ColorRgb']
+  calculateOpacity(luminance: number, targetContrast: number): number;
+  clamp(v: number, min: number, max: number): number;
+}
+
+```
+<h3 align="center">DateProcessing</h3>
+
+```ts
+
+interface DateProcessingProps{
+  getActiveColorClassInDiffDate(a:string, b:string, c:string):string
+  getClassByDifferenceDay(a:string, b:{className:string, diffDay:number}[]):string
+  getMinMaxDate(a:string, b:string, c:string):Record<'minDate' | 'maxDate' | 'minMaxMonth', string >
+  splitDateFromTime(a:string):string[]
+  getCorrectDateAndTime(a:string):[string, string]
+  reverseDate(a:string):string
+  correctionDataISO8601(a:string):string
+  isDateDMY(a:string):boolean
+  correctionDateAndRemoveYear(a:string, b?:Partial<{isYear:boolean}>):string
+  correctionDateWithOutCurrentYear(a:string, b?:Partial<{shortYear:boolean}>):string
+  correctionShortYear(a:string):string
+  correctionDate(a:string, b?:Partial<Record<'isRemoveYear'| 'shortYear' | 'withOutCurrentYear', boolean>>):string
+  hasDateLessPeriod(a:string, b: string, c?:{dateMinMax: '<=' | '>=' | '<' | '>'}):boolean
+  hasDateLessPeriods(a:string, b: string, c:string, d?:{dateMinMax: '<=' | '>=' | '<' | '>'}):Record<'one' | 'two', boolean>
+  getDi(a:string, b: string):number
+  getDifferenceDates(a:string, b: string):number
+  hasDateLessInNumber(a:string, b: string, c:number):boolean
+  correctionCurrentYear(a:[string], b?:number):string[]
+  getChunkFromDate(a:string, b:'day' | 'month' | 'year', c?:{isBeforeZero:boolean}):string
+  getNameMonthByNumber(a:number):(typeof itemsMonths)[number]
+  minMaxMountStr(a:Record<'minDate' | 'maxDate', string>): {minMaxMonth: string}
+  getDatesToCurrentDate(a:string[]):string[]
+  getDayOfWeek(a:string):(typeof itemsWeek)[number] | null
+  cropSecond(a:string):string
+  getRenderDate(a:string, b?:{withOutCurrentYear: boolean} ):'Сегодня' | 'Вчера' | 'Позавчера' | string 
+  getCurrentDate():string 
+  getDaysInMonth(a: number, b: number):number 
+  getCurrentYear():number 
+  getDateDeviation(date: string, config: Partial<Record<"day" | "month" | "year", number>>): string
+}
+
+```
+<h3 align="center">DelaysPromise</h3>
+
+```ts
+
+interface ControlAction{
+  stop(status?: boolean):void; 
+  getIsActiveEvent():boolean; 
+}
+interface  StartActionEveryConfigI {
+  interval: number,
+  cutoffTime?: number;//4000
+  countAction?:number;//example 5
+  watchIdInterval?(id:number | null):void;
+  controlAction?(control:ControlAction):void
+}
+
+interface OneOfPromiseReject{
+  status: boolean;
+  msg: string;
+}
+
+interface DelaysPromiseProps{
+  startActionEvery: (cb: () => boolean, config: StartActionEveryConfigI) => Promise<{status: boolean, msg: string}>
+  oneOf: (watchPromise: () => Promise<any>, potentialCaseCB: () => void, config: {second: number}) => void
+  oneOfPromise:(watchPromise: () => Promise<any>, cbPotentialReject: (p:OneOfPromiseReject) => OneOfPromiseReject, config: {second: number}) => Promise<any>
+}
+
+```
+<h3 align="center">Number</h3>
+
+```ts
+
+interface NumbersProps {
+  randomNumber: () => number;
+  getOnlyTheStringNumbers(dirtyString: string): string;
+  isNumber(charStr: string | number): boolean;
+}
+
+```
+<h3 align="center">Number</h3>
+
+```ts
+
+interface NumbersProps {
+  randomNumber: () => number;
+  getOnlyTheStringNumbers(dirtyString: string): string;
+  isNumber(charStr: string | number): boolean;
+}
+
+```
+<h3 align="center">Number</h3>
+
+```ts
+
+import { File } from 'dev-classes';
+
+File.download({
+  name: 'test',
+  base64: 'test',
+  format: 'pdf',
+})
+
+```
+<h3 align="center">Utils</h3>
+
+```ts
+
+interface UtilsProps {
+  events (status: 'add' | 'remove', who:EventTarget, entriesEvents, msg: string): Promise<string>;
+  sortDataByAlphabet(arrData: {[key: string]: any}[], sortKey: string): {[key: string]: any}[] ;
+  sortDataByDate(data:any[], keyDate: string): string[];
+  sortDataByDateAndTime(data:any[], keyDate: string): string[];
+  reverseDate(datePPR:string):string;
+  correctionDataISO8601(date:string):string; 
+  hasDateLessPeriod(date: string, period: string, option?:{ dateMinMax: '<=' | '>=' | '<' | '>'; } ): boolean;
+  getEndsWithArr(arr: any[], countEnd: number): any[];
+  deepMerge<T extends object = object>(...itemsOb: T[]): T
+}
+
+```
+<h3 align="center">NetworkInformation</h3>
+
+```ts
+
+import { NetworkInformation, NetworkInformationPC, NetworkInformationCordova } from 'dev-classes';
+
+const internet = new NetworkInformation([new NetworkInformationPC(), new NetworkInformationCordova()]);
+
+const online = () => {}
+const offline = () => {}
+internet.run((status) => {
+  status ? online() : offline();
+});
+
+```
+<h3 align="center">EventSubscribers</h3>
+
+```ts
+
+interface EventSubscribersProps<EventsProps>{
+  getSubscribers: () => {[K in keyof EventsProps]?: EventsProps[K][]}
+  subscribe: <K extends keyof EventsProps>(name: K, cb: EventsProps[K]) => void
+  unsubscribe: <K extends keyof EventsProps>(name: K, cb: EventsProps[K]) => void
+  publish: <K extends keyof EventsProps>(name: K, data: EventsProps[K] extends (...args: any[]) => any ? Parameters<EventsProps[K]>[0] : any) => void
+  resetSubscribers: () => void
+}
+
+
+import { EventSubscribers } from 'dev-classes';
+
+interface CustomEvents{
+  myEvent(status: boolean): void;
+} 
+
+class MyClass{
+  private static events = new EventSubscribers<CustomEvents>(["myEvent"]);
+  static on = MyClass.events.subscribe;
+  static off = MyClass.events.unsubscribe;
+
+  static runTime(num: number){
+    const id = setTimeout(() => {
+      let status = true;
+      //...
+      // if(/*.... */) { status = false; }
+      MyClass.events.publish('myEvent', status);
+      
+      clearTimeout(id);
+    }, num * 1000)
+  }
+}
+
+MyClass.on('myEvent', (status) => {
+  console.log(status)
+})
+MyClass.runTime(2);
+
+```

package/dist/classes/Color/Color.d.ts

@@ -1,20 +1,14 @@
-type ColorRgb = [number, number, number];
-export interface ColorProps {
-    ColorRgb: ColorRgb;
-    ColorRgba: [...ColorRgb, number];
-    ColorHsla: Record<"h" | "s" | "l" | "a", number>;
-    TypeBrightness_OR: "BT601" | "BT709" | "BT2020";
-}
+import { ColorProps } from './Color.types';
+
 export declare class Color {
     private static componentToHex;
-    static getNumberRGB: (getComputedStyleRGB: string) => number[] | RegExpMatchArray;
-    static rgbToHex: (r: any, g: any, b: any) => string;
+    static rgbToHex: ColorProps['rgbToHex'];
     /**
      * https://stackoverflow.com/a/54070620/6758968
      * r, g, b in [0, 255]
      * @returns h in [0,360) and s, v in [0,1]
      */
-    static rgbToHsv(r: number, g: number, b: number): [number, number, number];
+    static rgbToHsv: ColorProps['rgbToHsv'];
     /**
      * https://stackoverflow.com/a/54024653/6758968
      * @param h [0, 360]
@@ -22,11 +16,11 @@ export declare class Color {
      * @param v [0, 1]
      * @returns r, g, b in [0, 255]
      */
-    static hsvToRgb(h: number, s: number, v: number): ColorProps['ColorRgb'];
+    static hsvToRgb: ColorProps['hsvToRgb'];
     /**
      * @returns h [0, 360], s [0, 100], l [0, 100], a [0, 1]
      */
-    static rgbaToHsla(r: number, g: number, b: number, a?: number): ColorProps['ColorHsla'];
+    static rgbaToHsla: ColorProps['rgbaToHsla'];
     /**
      * Converts an HSL color value to RGB. Conversion formula
      * adapted from http://en.wikipedia.org/wiki/HSL_color_space.
@@ -36,32 +30,29 @@ export declare class Color {
      * @param   {number}  l       The lightness [0, 1]
      * @return  {Array}           The RGB representation [0, 255]
      */
-    static hslaToRgba(h: number, s: number, l: number, a: number): ColorProps['ColorRgba'];
-    static hslaStringToRgba(hsla: string): [number, number, number, number];
-    static hexaToRgba(hexa: string): [number, number, number, number];
-    static hexToRgb(hex: string): ColorRgb;
-    static hexaToHsla(hexa: string): Record<"h" | "s" | "l" | "a", number>;
-    static rgbaToHexa(rgba: ColorProps['ColorRgba'] | ColorProps['ColorRgb']): string;
-    static hslaStringToHexa(hsla: string): string;
-    static hslaStringToHex(hsla: string): string;
+    static hslaToRgba: ColorProps['hslaToRgba'];
+    static hslaStringToRgba: ColorProps['hslaStringToRgba'];
+    static hexaToRgba: ColorProps['hexaToRgba'];
+    static hexaToHsla: ColorProps['hexaToHsla'];
+    static hexToRgb: ColorProps['hexToRgb'];
+    static rgbaToHexa: ColorProps['rgbaToHexa'];
+    static hslaStringToHexa: ColorProps['hslaStringToHexa'];
+    static hslaStringToHex: ColorProps['hslaStringToHex'];
     /**
      * @param weight [0, 1]
      */
-    static mixColors(color1: ColorProps['ColorRgb'], color2: ColorProps['ColorRgb'], weight: number): ColorRgb;
-    static getRgbByTypeBrightness(type: ColorProps['TypeBrightness_OR']): number[];
-    static computePerceivedBrightness(color: ColorProps['ColorRgb'], type?: ColorProps['TypeBrightness_OR']): number;
-    static getAverageColor(color1: ColorProps['ColorRgb'], color2: ColorProps['ColorRgb']): ColorProps['ColorRgb'];
-    static getAccentColor(baseHsv: number[], baseColor: ColorProps['ColorRgb'], elementColor: ColorProps['ColorRgb']): ColorProps['ColorRgb'];
-    static changeColorAccent(baseHsv: number[], accentHsv: number[], color: ColorProps['ColorRgb'], isDarkTheme: boolean): ColorRgb;
-    static changeBrightness(color: ColorProps['ColorRgb'], amount: number): ColorRgb;
-    static hexBrightness(hex: string, amount: number): string;
-    static getHexColorFromTelegramColor(color: number): string;
-    static getRgbColorFromTelegramColor(color: number): ColorRgb;
-    static getColorsFromWallPaper(wallPaper: any): string;
-    static rgbaToRgb(rgba: ColorProps['ColorRgba'], bg: ColorProps['ColorRgb']): ColorProps['ColorRgb'];
-    static calculateLuminance(rgb: ColorProps['ColorRgb'], type?: ColorProps['TypeBrightness_OR']): number;
-    static getTextColor(luminance: number): ColorProps['ColorRgb'];
-    static calculateOpacity(luminance: number, targetContrast: number): number;
-    static clamp(v: number, min: number, max: number): number;
+    static mixColors: ColorProps['mixColors'];
+    static getRgbByTypeBrightness: ColorProps['getRgbByTypeBrightness'];
+    static getAverageColor: ColorProps['getAverageColor'];
+    static getAccentColor: ColorProps['getAccentColor'];
+    static changeColorAccent: ColorProps['changeColorAccent'];
+    static changeBrightness: ColorProps['changeBrightness'];
+    static hexBrightness: ColorProps['hexBrightness'];
+    static getHexColorFromTelegramColor: ColorProps['getHexColorFromTelegramColor'];
+    static getRgbColorFromTelegramColor: ColorProps['getRgbColorFromTelegramColor'];
+    static rgbaToRgb: ColorProps['rgbaToRgb'];
+    static calculateBrightness: ColorProps['calculateBrightness'];
+    static getTextColor: ColorProps['getTextColor'];
+    static calculateOpacity: ColorProps['calculateOpacity'];
+    static clamp: ColorProps['clamp'];
 }
-export {};