@hairy/utils 1.30.0 → 1.31.0

package/dist/index.cjs

@@ -49,7 +49,10 @@ __export(index_exports, {
   debounce: () => debounce_default,
   decimal: () => decimal,
   delay: () => delay,
+  dialsPhone: () => dialsPhone,
   dotCase: () => dotCase,
+  downloadBlobFile: () => downloadBlobFile,
+  downloadNetworkFile: () => downloadNetworkFile,
   find: () => find_default,
   formToObject: () => formToObject,
   formatNumeric: () => formatNumeric,
@@ -104,6 +107,8 @@ __export(index_exports, {
   noop: () => noop2,
   numerfix: () => numerfix,
   objectToForm: () => objectToForm,
+  off: () => off,
+  on: () => on,
   parseNumeric: () => parseNumeric,
   pascalCase: () => pascalCase,
   pascalSnakeCase: () => pascalSnakeCase,
@@ -114,8 +119,13 @@ __export(index_exports, {
   proxy: () => proxy,
   randomArray: () => randomArray,
   randomNumer: () => randomNumer,
+  readFileReader: () => readFileReader,
+  redirectTo: () => redirectTo,
   riposte: () => riposte,
+  selectImages: () => selectImages,
   sentenceCase: () => sentenceCase,
+  showOpenFilePicker: () => showOpenFilePicker,
+  showOpenImagePicker: () => showOpenImagePicker,
   snakeCase: () => snakeCase,
   to: () => to,
   trainCase: () => trainCase,
@@ -131,6 +141,81 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/browser/file.ts
+function showOpenFilePicker(option = {}) {
+  const { multiple = true, accept } = option;
+  return new Promise((resolve, reject) => {
+    const inputElement = document.createElement("input");
+    inputElement.type = "file";
+    inputElement.multiple = multiple;
+    accept && (inputElement.accept = accept);
+    inputElement.click();
+    const timer = setTimeout(reject, 20 * 1e3);
+    inputElement.addEventListener("change", (event) => {
+      const files = event.target.files;
+      if (files) {
+        resolve(Object.values(files));
+        clearTimeout(timer);
+      }
+    });
+  });
+}
+function showOpenImagePicker(options = {}) {
+  const { multiple = true } = options;
+  return showOpenFilePicker({ multiple, accept: "image/jpeg,image/x-png,image/gif" });
+}
+var selectImages = showOpenImagePicker;
+function downloadBlobFile(data, name) {
+  const blob = new Blob([data]);
+  const link = document.createElement("a");
+  const url = window.URL.createObjectURL(blob);
+  link.href = url;
+  link.download = name;
+  link.click();
+}
+function downloadNetworkFile(url, name) {
+  const a = document.createElement("a");
+  name && (a.download = name);
+  a.href = url;
+  a.click();
+}
+function readFileReader(formType, file) {
+  return new Promise((resolve, reject) => {
+    if (typeof FileReader === "undefined") {
+      console.warn("\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u4F7F\u7528 FileReader Api");
+      reject();
+    }
+    const reader = new FileReader();
+    reader[formType](file);
+    reader.onloadend = function() {
+      isNull(this.result) ? reject() : resolve(this.result);
+    };
+  });
+}
+
+// src/browser/util.ts
+function redirectTo(url, target = "_blank") {
+  const link = document.createElement("a");
+  link.href = url;
+  link.target = target;
+  link.click();
+  link.remove();
+}
+function dialsPhone(phoneNumber) {
+  const aTag = document.createElement("a");
+  aTag.setAttribute("href", `tel:${phoneNumber}`);
+  aTag.setAttribute("target", "_blank");
+  aTag.click();
+}
+function on(obj, ...args) {
+  if (obj && obj.addEventListener)
+    obj.addEventListener(...args);
+}
+function off(obj, ...args) {
+  if (obj && obj.removeEventListener)
+    obj.removeEventListener(...args);
+}
+
 // ../../node_modules/.pnpm/change-case@5.4.4/node_modules/change-case/dist/index.js
 var SPLIT_LOWER_UPPER_RE = /([\p{Ll}\d])(\p{Lu})/gu;
 var SPLIT_UPPER_UPPER_RE = /(\p{Lu})([\p{Lu}][\p{Ll}])/gu;
@@ -2808,10 +2893,10 @@ function isNative(value) {
 var isNative_default = isNative;
 
 // ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/isNull.js
-function isNull(value) {
+function isNull2(value) {
   return value === null;
 }
-var isNull_default = isNull;
+var isNull_default = isNull2;
 
 // ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/_baseIsRegExp.js
 var regexpTag5 = "[object RegExp]";
@@ -3370,7 +3455,10 @@ function whenever(value, callback) {
   debounce,
   decimal,
   delay,
+  dialsPhone,
   dotCase,
+  downloadBlobFile,
+  downloadNetworkFile,
   find,
   formToObject,
   formatNumeric,
@@ -3425,6 +3513,8 @@ function whenever(value, callback) {
   noop,
   numerfix,
   objectToForm,
+  off,
+  on,
   parseNumeric,
   pascalCase,
   pascalSnakeCase,
@@ -3435,8 +3525,13 @@ function whenever(value, callback) {
   proxy,
   randomArray,
   randomNumer,
+  readFileReader,
+  redirectTo,
   riposte,
+  selectImages,
   sentenceCase,
+  showOpenFilePicker,
+  showOpenImagePicker,
   snakeCase,
   to,
   trainCase,

package/dist/index.d.ts

@@ -2,77 +2,51 @@ export { clone, cloneDeep, cloneDeepWith, cloneWith, concat, debounce, find, isA
 import Bignumber from 'bignumber.js';
 export { default as Bignumber } from 'bignumber.js';
 
-/**
- * Supported locale values. Use `false` to ignore locale.
- * Defaults to `undefined`, which uses the host environment.
- */
-type Locale = string[] | string | false | undefined;
-/**
- * Options used for converting strings to pascal/camel case.
- */
-interface PascalCaseOptions extends Options {
-    mergeAmbiguousCharacters?: boolean;
+interface OpenFilePickerOptions {
+    /**
+     * select multiple files
+     */
+    multiple?: boolean;
+    /**
+     * Choose the default format for the file
+     */
+    accept?: string;
 }
 /**
- * Options used for converting strings to any case.
+ * Select multiple files
  */
-interface Options {
-    locale?: Locale;
-    split?: (value: string) => string[];
-    /** @deprecated Pass `split: splitSeparateNumbers` instead. */
-    separateNumbers?: boolean;
-    delimiter?: string;
-    prefixCharacters?: string;
-    suffixCharacters?: string;
+declare function showOpenFilePicker(option?: OpenFilePickerOptions): Promise<File[]>;
+interface OpenImagePickerOptions {
+    /**
+     * select multiple images
+     */
+    multiple?: boolean;
 }
 /**
- * Convert a string to space separated lower case (`foo bar`).
- */
-declare function noCase(input: string, options?: Options): string;
-/**
- * Convert a string to camel case (`fooBar`).
- */
-declare function camelCase(input: string, options?: PascalCaseOptions): string;
-/**
- * Convert a string to pascal case (`FooBar`).
- */
-declare function pascalCase(input: string, options?: PascalCaseOptions): string;
-/**
- * Convert a string to pascal snake case (`Foo_Bar`).
- */
-declare function pascalSnakeCase(input: string, options?: Options): string;
-/**
- * Convert a string to capital case (`Foo Bar`).
+ * Select multiple images
  */
-declare function capitalCase(input: string, options?: Options): string;
+declare function showOpenImagePicker(options?: OpenImagePickerOptions): Promise<File[]>;
+/** @deprecated use chooseFile */
+declare const selectImages: typeof showOpenImagePicker;
 /**
- * Convert a string to constant case (`FOO_BAR`).
+ * Generate Blob | string file and download it
+ * @param data Blob data, or string
+ * @param name file name
  */
-declare function constantCase(input: string, options?: Options): string;
+declare function downloadBlobFile(data: Blob | string, name: string): void;
 /**
- * Convert a string to dot case (`foo.bar`).
+ * Download network files
+ * @param url Download link
+ * @param name file name
  */
-declare function dotCase(input: string, options?: Options): string;
+declare function downloadNetworkFile(url: string, name?: string): void;
+type ReaderType = 'readAsArrayBuffer' | 'readAsBinaryString' | 'readAsDataURL' | 'readAsText';
 /**
- * Convert a string to kebab case (`foo-bar`).
- */
-declare function kebabCase(input: string, options?: Options): string;
-/**
- * Convert a string to path case (`foo/bar`).
- */
-declare function pathCase(input: string, options?: Options): string;
-/**
- * Convert a string to path case (`Foo bar`).
+ * Read File file
+ * @param formType Transform type
+ * @param file file object
  */
-declare function sentenceCase(input: string, options?: Options): string;
-/**
- * Convert a string to snake case (`foo_bar`).
- */
-declare function snakeCase(input: string, options?: Options): string;
-/**
- * Convert a string to header case (`Foo-Bar`).
- */
-declare function trainCase(input: string, options?: Options): string;
+declare function readFileReader<T extends ReaderType>(formType: T, file: File): Promise<T extends "readAsArrayBuffer" ? ArrayBuffer : string>;
 
 type Numeric = string | number | bigint;
 interface DynamicObject {
@@ -135,6 +109,83 @@ type Option<L extends Key = 'label', V extends Key = 'value', C extends Key = 'c
     [P in C]?: Option<L, V, C>[];
 };
 
+declare function redirectTo(url: string, target?: string): void;
+declare function dialsPhone(phoneNumber: string): void;
+declare function on<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['addEventListener']> | [string, Fn$1 | null, ...any]): void;
+declare function off<T extends Window | Document | HTMLElement | EventTarget>(obj: T | null, ...args: Parameters<T['removeEventListener']> | [string, Fn$1 | null, ...any]): void;
+
+/**
+ * Supported locale values. Use `false` to ignore locale.
+ * Defaults to `undefined`, which uses the host environment.
+ */
+type Locale = string[] | string | false | undefined;
+/**
+ * Options used for converting strings to pascal/camel case.
+ */
+interface PascalCaseOptions extends Options {
+    mergeAmbiguousCharacters?: boolean;
+}
+/**
+ * Options used for converting strings to any case.
+ */
+interface Options {
+    locale?: Locale;
+    split?: (value: string) => string[];
+    /** @deprecated Pass `split: splitSeparateNumbers` instead. */
+    separateNumbers?: boolean;
+    delimiter?: string;
+    prefixCharacters?: string;
+    suffixCharacters?: string;
+}
+/**
+ * Convert a string to space separated lower case (`foo bar`).
+ */
+declare function noCase(input: string, options?: Options): string;
+/**
+ * Convert a string to camel case (`fooBar`).
+ */
+declare function camelCase(input: string, options?: PascalCaseOptions): string;
+/**
+ * Convert a string to pascal case (`FooBar`).
+ */
+declare function pascalCase(input: string, options?: PascalCaseOptions): string;
+/**
+ * Convert a string to pascal snake case (`Foo_Bar`).
+ */
+declare function pascalSnakeCase(input: string, options?: Options): string;
+/**
+ * Convert a string to capital case (`Foo Bar`).
+ */
+declare function capitalCase(input: string, options?: Options): string;
+/**
+ * Convert a string to constant case (`FOO_BAR`).
+ */
+declare function constantCase(input: string, options?: Options): string;
+/**
+ * Convert a string to dot case (`foo.bar`).
+ */
+declare function dotCase(input: string, options?: Options): string;
+/**
+ * Convert a string to kebab case (`foo-bar`).
+ */
+declare function kebabCase(input: string, options?: Options): string;
+/**
+ * Convert a string to path case (`foo/bar`).
+ */
+declare function pathCase(input: string, options?: Options): string;
+/**
+ * Convert a string to path case (`Foo bar`).
+ */
+declare function sentenceCase(input: string, options?: Options): string;
+/**
+ * Convert a string to snake case (`foo_bar`).
+ */
+declare function snakeCase(input: string, options?: Options): string;
+/**
+ * Convert a string to header case (`Foo-Bar`).
+ */
+declare function trainCase(input: string, options?: Options): string;
+
 declare const BIG_INTS: {
     t: {
         v: number;
@@ -477,4 +528,4 @@ declare function riposte<T>(...args: [cond: boolean, value: T][]): T;
 declare function unwrap<T extends object>(value: T | (() => T)): T;
 declare function whenever<T, C extends (value: Exclude<T, null | undefined>) => any>(value: T, callback: C): ReturnType<C> | undefined;
 
-export { type AnyFn, type ArgumentsType, type Arrayable, type Awaitable, BIG_INTS, BigNum, type BooleanLike, type ConstructorType, type DecimalOptions, type DeepKeyof, type DeepMerge, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type ElementOf, type Fn$1 as Fn, type FormatGroupOptions, type FormatNumericOptions, type IfAny, type IsAny, type Key, type Looper, type MergeInsertions, type Noop, type Nullable, type NumberObject, type Numberish, type Numeric, type NumericObject, type Option, type PromiseFn, type PromiseType, type Promisify, type StringObject, type SymbolObject, type Typeof, arange, average, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dotCase, formToObject, formatNumeric, formatSize, formatUnit, getTypeof, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTruthy, isTypeof, isWeex, isWindow, jsonTryParse, kebabCase, loop, lt, lte, noCase, noop, numerfix, objectToForm, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, proxy, randomArray, randomNumer, riposte, sentenceCase, snakeCase, to, trainCase, unwrap, whenever, zerofill, zeromove };
+export { type AnyFn, type ArgumentsType, type Arrayable, type Awaitable, BIG_INTS, BigNum, type BooleanLike, type ConstructorType, type DecimalOptions, type DeepKeyof, type DeepMerge, type DeepPartial, type DeepReadonly, type DeepReplace, type DeepRequired, Deferred, type Delimiter, type Dimension, type DynamicObject, type ElementOf, type Fn$1 as Fn, type FormatGroupOptions, type FormatNumericOptions, type IfAny, type IsAny, type Key, type Looper, type MergeInsertions, type Noop, type Nullable, type NumberObject, type Numberish, type Numeric, type NumericObject, type OpenFilePickerOptions, type OpenImagePickerOptions, type Option, type PromiseFn, type PromiseType, type Promisify, type ReaderType, type StringObject, type SymbolObject, type Typeof, arange, average, camelCase, capitalCase, compose, constantCase, cover, decimal, delay, dialsPhone, dotCase, downloadBlobFile, downloadNetworkFile, formToObject, formatNumeric, formatSize, formatUnit, getTypeof, gt, gte, integer, isAndroid, isBrowser, isChrome, isEdge, isFF, isFormData, isIE, isIE11, isIE9, isIOS, isMobile, isPhantomJS, isTruthy, isTypeof, isWeex, isWindow, jsonTryParse, kebabCase, loop, lt, lte, noCase, noop, numerfix, objectToForm, off, on, parseNumeric, pascalCase, pascalSnakeCase, pathCase, percentage, pipe, plus, proxy, randomArray, randomNumer, readFileReader, redirectTo, riposte, selectImages, sentenceCase, showOpenFilePicker, showOpenImagePicker, snakeCase, to, trainCase, unwrap, whenever, zerofill, zeromove };

package/dist/index.global.js

@@ -1,5 +1,80 @@
 "use strict";
 (() => {
+  // src/browser/file.ts
+  function showOpenFilePicker(option = {}) {
+    const { multiple = true, accept } = option;
+    return new Promise((resolve, reject) => {
+      const inputElement = document.createElement("input");
+      inputElement.type = "file";
+      inputElement.multiple = multiple;
+      accept && (inputElement.accept = accept);
+      inputElement.click();
+      const timer = setTimeout(reject, 20 * 1e3);
+      inputElement.addEventListener("change", (event) => {
+        const files = event.target.files;
+        if (files) {
+          resolve(Object.values(files));
+          clearTimeout(timer);
+        }
+      });
+    });
+  }
+  function showOpenImagePicker(options = {}) {
+    const { multiple = true } = options;
+    return showOpenFilePicker({ multiple, accept: "image/jpeg,image/x-png,image/gif" });
+  }
+  var selectImages = showOpenImagePicker;
+  function downloadBlobFile(data, name) {
+    const blob = new Blob([data]);
+    const link = document.createElement("a");
+    const url = window.URL.createObjectURL(blob);
+    link.href = url;
+    link.download = name;
+    link.click();
+  }
+  function downloadNetworkFile(url, name) {
+    const a = document.createElement("a");
+    name && (a.download = name);
+    a.href = url;
+    a.click();
+  }
+  function readFileReader(formType, file) {
+    return new Promise((resolve, reject) => {
+      if (typeof FileReader === "undefined") {
+        console.warn("\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u4F7F\u7528 FileReader Api");
+        reject();
+      }
+      const reader = new FileReader();
+      reader[formType](file);
+      reader.onloadend = function() {
+        isNull(this.result) ? reject() : resolve(this.result);
+      };
+    });
+  }
+
+  // src/browser/util.ts
+  function redirectTo(url, target = "_blank") {
+    const link = document.createElement("a");
+    link.href = url;
+    link.target = target;
+    link.click();
+    link.remove();
+  }
+  function dialsPhone(phoneNumber) {
+    const aTag = document.createElement("a");
+    aTag.setAttribute("href", `tel:${phoneNumber}`);
+    aTag.setAttribute("target", "_blank");
+    aTag.click();
+  }
+  function on(obj, ...args) {
+    if (obj && obj.addEventListener)
+      obj.addEventListener(...args);
+  }
+  function off(obj, ...args) {
+    if (obj && obj.removeEventListener)
+      obj.removeEventListener(...args);
+  }
+
   // ../../node_modules/.pnpm/change-case@5.4.4/node_modules/change-case/dist/index.js
   var SPLIT_LOWER_UPPER_RE = /([\p{Ll}\d])(\p{Lu})/gu;
   var SPLIT_UPPER_UPPER_RE = /(\p{Lu})([\p{Lu}][\p{Ll}])/gu;
@@ -2677,10 +2752,10 @@
   var isNative_default = isNative;
 
   // ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/isNull.js
-  function isNull(value) {
+  function isNull2(value) {
     return value === null;
   }
-  var isNull_default = isNull;
+  var isNull_default = isNull2;
 
   // ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/_baseIsRegExp.js
   var regexpTag5 = "[object RegExp]";

package/dist/index.js

@@ -1,3 +1,78 @@
+// src/browser/file.ts
+function showOpenFilePicker(option = {}) {
+  const { multiple = true, accept } = option;
+  return new Promise((resolve, reject) => {
+    const inputElement = document.createElement("input");
+    inputElement.type = "file";
+    inputElement.multiple = multiple;
+    accept && (inputElement.accept = accept);
+    inputElement.click();
+    const timer = setTimeout(reject, 20 * 1e3);
+    inputElement.addEventListener("change", (event) => {
+      const files = event.target.files;
+      if (files) {
+        resolve(Object.values(files));
+        clearTimeout(timer);
+      }
+    });
+  });
+}
+function showOpenImagePicker(options = {}) {
+  const { multiple = true } = options;
+  return showOpenFilePicker({ multiple, accept: "image/jpeg,image/x-png,image/gif" });
+}
+var selectImages = showOpenImagePicker;
+function downloadBlobFile(data, name) {
+  const blob = new Blob([data]);
+  const link = document.createElement("a");
+  const url = window.URL.createObjectURL(blob);
+  link.href = url;
+  link.download = name;
+  link.click();
+}
+function downloadNetworkFile(url, name) {
+  const a = document.createElement("a");
+  name && (a.download = name);
+  a.href = url;
+  a.click();
+}
+function readFileReader(formType, file) {
+  return new Promise((resolve, reject) => {
+    if (typeof FileReader === "undefined") {
+      console.warn("\u5F53\u524D\u73AF\u5883\u4E0D\u652F\u6301\u4F7F\u7528 FileReader Api");
+      reject();
+    }
+    const reader = new FileReader();
+    reader[formType](file);
+    reader.onloadend = function() {
+      isNull(this.result) ? reject() : resolve(this.result);
+    };
+  });
+}
+
+// src/browser/util.ts
+function redirectTo(url, target = "_blank") {
+  const link = document.createElement("a");
+  link.href = url;
+  link.target = target;
+  link.click();
+  link.remove();
+}
+function dialsPhone(phoneNumber) {
+  const aTag = document.createElement("a");
+  aTag.setAttribute("href", `tel:${phoneNumber}`);
+  aTag.setAttribute("target", "_blank");
+  aTag.click();
+}
+function on(obj, ...args) {
+  if (obj && obj.addEventListener)
+    obj.addEventListener(...args);
+}
+function off(obj, ...args) {
+  if (obj && obj.removeEventListener)
+    obj.removeEventListener(...args);
+}
+
 // ../../node_modules/.pnpm/change-case@5.4.4/node_modules/change-case/dist/index.js
 var SPLIT_LOWER_UPPER_RE = /([\p{Ll}\d])(\p{Lu})/gu;
 var SPLIT_UPPER_UPPER_RE = /(\p{Lu})([\p{Lu}][\p{Ll}])/gu;
@@ -2675,10 +2750,10 @@ function isNative(value) {
 var isNative_default = isNative;
 
 // ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/isNull.js
-function isNull(value) {
+function isNull2(value) {
   return value === null;
 }
-var isNull_default = isNull;
+var isNull_default = isNull2;
 
 // ../../node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/_baseIsRegExp.js
 var regexpTag5 = "[object RegExp]";
@@ -3236,7 +3311,10 @@ export {
   debounce_default as debounce,
   decimal,
   delay,
+  dialsPhone,
   dotCase,
+  downloadBlobFile,
+  downloadNetworkFile,
   find_default as find,
   formToObject,
   formatNumeric,
@@ -3291,6 +3369,8 @@ export {
   noop2 as noop,
   numerfix,
   objectToForm,
+  off,
+  on,
   parseNumeric,
   pascalCase,
   pascalSnakeCase,
@@ -3301,8 +3381,13 @@ export {
   proxy,
   randomArray,
   randomNumer,
+  readFileReader,
+  redirectTo,
   riposte,
+  selectImages,
   sentenceCase,
+  showOpenFilePicker,
+  showOpenImagePicker,
   snakeCase,
   to,
   trainCase,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hairy/utils",
   "type": "module",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "description": "Library for anywhere",
   "author": "Hairyf <wwu710632@gmail.com>",
   "license": "MIT",