sculp-js 1.13.0 → 1.13.2

package/dist/types/download.d.ts

@@ -0,0 +1,47 @@
+import { LooseParams } from './qs';
+import { AnyObject, AsyncCallback } from './type';
+/**
+ * 通过打开新窗口的方式下载
+ * @param {string} url
+ * @param {LooseParams} params
+ */
+export declare function downloadURL(url: string, params?: LooseParams): void;
+/**
+ * 通过 A 链接的方式下载
+ * @param {string} href
+ * @param {string} filename
+ * @param {Function} callback
+ */
+export declare function downloadHref(href: string, filename: string, callback?: Function): void;
+/**
+ * 将大文件对象通过 A 链接的方式下载
+ * @param {Blob} blob
+ * @param {string} filename
+ * @param {Function} callback
+ */
+export declare function downloadBlob(blob: Blob, filename: string, callback?: Function): void;
+type CrossOriginDownloadParams = AsyncCallback & {
+    successCode?: number;
+};
+/**
+ * 根据URL下载文件（解决跨域a.download不生效问题)
+ *
+ * 可定制下载成功的状态码status(浏览器原生状态码)
+ *
+ * 支持下载操作成功、失败后的回调
+ * @param {string} url
+ * @param {string} filename
+ * @param {CrossOriginDownloadParams} options
+ */
+export declare function crossOriginDownload(url: string, filename: string, options?: CrossOriginDownloadParams): void;
+export type FileType = 'json' | 'csv' | 'xls' | 'xlsx';
+/**
+ * 将指定数据格式通过 A 链接的方式下载
+ * @param {AnyObject | AnyObject[]} data
+ * @param {FileType} fileType 支持 json/csv/xls/xlsx 四种格式
+ * @param {string} filename
+ * @param {string[]} [headers]
+ */
+export declare function downloadData(data: AnyObject | AnyObject[], fileType: FileType, filename: string, headers?: string[]): void;
+export {};
+//# sourceMappingURL=download.d.ts.map

package/dist/types/download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../src/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAmC,MAAM,QAAQ,CAAC;AAGnF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAatF;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAUpF;AACD,KAAK,yBAAyB,GAAG,aAAa,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1E;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,IAAI,CA+B5G;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,EAC7B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,IAAI,CA8BN"}

package/dist/types/easing.d.ts

@@ -0,0 +1,32 @@
+import { EasingFunction } from 'bezier-easing';
+export type EasingDefine = [number, number, number, number];
+export type EasingName = 'ease' | 'linear' | 'ease-in' | 'ease-out' | 'ease-in-out' | string;
+export { EasingFunction };
+type EasingDefines = Record<string, EasingDefine>;
+type EasingNameOrDefine = EasingName | EasingDefine;
+/**
+ * 设置缓存定义
+ * @param {string} name
+ * @param {EasingDefine} define
+ */
+export declare function setEasing(name: string, define: EasingDefine): void;
+/**
+ * 获取缓存定义
+ * @param {string} name
+ * @returns {EasingDefine | void}
+ */
+export declare function getEasing(name: string): EasingDefine | void;
+export declare function getEasing(): EasingDefines;
+/**
+ * 缓冲函数化，用于 js 计算缓冲进度
+ * @param {EasingNameOrDefine} [name=linear]
+ * @returns {EasingFunction}
+ */
+export declare function easingFunctional(name: EasingNameOrDefine): EasingFunction;
+/**
+ * 缓冲字符化，用于 css 设置缓冲属性
+ * @param {EasingNameOrDefine} name
+ * @returns {string}
+ */
+export declare function easingStringify(name: EasingNameOrDefine): string;
+//# sourceMappingURL=easing.d.ts.map

package/dist/types/easing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"easing.d.ts","sourceRoot":"","sources":["../../src/easing.ts"],"names":[],"mappings":"AAAA,OAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGvD,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAUlD,KAAK,kBAAkB,GAAG,UAAU,GAAG,YAAY,CAAC;AAEpD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAElE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;AAC7D,wBAAgB,SAAS,IAAI,aAAa,CAAC;AAM3C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAgBzE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAgBhE"}

package/dist/types/file.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 判断是否支持canvas
+ * @returns {boolean}
+ */
+export declare function supportCanvas(): boolean;
+/**
+ * 选择本地文件
+ * @param {string} accept 上传的文件类型，用于过滤
+ * @param {Function} changeCb 选择文件回调
+ * @returns {HTMLInputElement}
+ */
+export declare function chooseLocalFile(accept: string, changeCb: (FileList: any) => any): void;
+type ImageType = 'image/jpeg' | 'image/png' | 'image/webp';
+export interface ICompressOptions {
+    /** 压缩质量 0 ~ 1 之间*/
+    quality?: number;
+    /** 图片类型 */
+    mime?: ImageType;
+    maxSize?: number;
+    minFileSizeKB?: number;
+}
+export interface ICompressImgResult {
+    file: File;
+    bufferArray?: Uint8Array;
+    origin?: File;
+    beforeSrc?: string;
+    afterSrc?: string;
+    beforeKB?: number;
+    afterKB?: number;
+}
+/**
+ * Web端：等比例压缩图片批量处理 (小于minFileSizeKB：50，不压缩), 支持压缩全景图或长截图
+ *
+ *        1. 默认根据图片原始size及宽高适当地调整quality、width、height
+ *        2. 可指定压缩的图片质量 quality（若不指定则根据原始图片大小来计算）, 来适当调整width、height
+ *        3. 可指定压缩的图片最大宽高 maxSize（若不指定则根据原始图片宽高来计算）, 满足大屏幕图片展示的场景
+ *
+ * @param {File | FileList} file 图片或图片数组
+ * @param {ICompressOptions} options 压缩图片配置项，default: {mime:'image/jpeg', minFileSizeKB: 50}
+ * @returns {Promise<ICompressImgResult | ICompressImgResult[] | null>}
+ */
+export declare function compressImg(file: File | FileList, options?: ICompressOptions): Promise<ICompressImgResult | ICompressImgResult[] | null>;
+export {};
+//# sourceMappingURL=file.d.ts.map

package/dist/types/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/file.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,KAAA,KAAK,GAAG,GAAG,IAAI,CAcjF;AAED,KAAK,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwFD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,IAAI,GAAG,QAAQ,EACrB,OAAO,GAAE,gBAA4D,GACpE,OAAO,CAAC,kBAAkB,GAAG,kBAAkB,EAAE,GAAG,IAAI,CAAC,CA+F3D"}

package/dist/types/func.d.ts

@@ -0,0 +1,50 @@
+import { AnyFunc } from './type';
+export interface DebounceFunc<F extends AnyFunc> {
+    (...args: Parameters<F>): void;
+    cancel: () => void;
+}
+/**
+ * 防抖函数
+ * 当函数被连续调用时，该函数并不执行，只有当其全部停止调用超过一定时间后才执行1次。
+ * 例如：上电梯的时候，大家陆陆续续进来，电梯的门不会关上，只有当一段时间都没有人上来，电梯才会关门。
+ * @param {F} func
+ * @param {number} wait
+ * @returns {DebounceFunc<F>}
+ */
+export declare const debounce: <F extends AnyFunc>(func: F, wait?: number) => DebounceFunc<F>;
+export interface ThrottleFunc<F extends AnyFunc> {
+    (...args: Parameters<F>): void;
+    cancel: () => void;
+}
+/**
+ * 节流函数
+ * 节流就是节约流量，将连续触发的事件稀释成预设评率。 比如每间隔1秒执行一次函数，无论这期间触发多少次事件。
+ * 这有点像公交车，无论在站点等车的人多不多，公交车只会按时来一班，不会来一个人就来一辆公交车。
+ * @param {F} func
+ * @param {number} wait
+ * @param {boolean} immediate
+ * @returns {ThrottleFunc<F>}
+ */
+export declare const throttle: <F extends AnyFunc>(func: F, wait: number, immediate?: boolean) => ThrottleFunc<F>;
+export interface OnceFunc<F extends AnyFunc> {
+    (...args: Parameters<F>): ReturnType<F>;
+}
+/**
+ * 单次函数
+ * @param {AnyFunc} func
+ * @returns {AnyFunc}
+ */
+export declare const once: <F extends AnyFunc = AnyFunc>(func: F) => OnceFunc<F>;
+/**
+ * 设置全局变量
+ * @param {string | number | symbol} key
+ * @param val
+ */
+export declare function setGlobal(key: string | number | symbol, val?: any): void;
+/**
+ * 获取全局变量
+ * @param {string | number | symbol} key
+ * @param val
+ */
+export declare function getGlobal<T>(key: string | number | symbol): T | void;
+//# sourceMappingURL=func.d.ts.map

package/dist/types/func.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"func.d.ts","sourceRoot":"","sources":["../../src/func.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAW,MAAM,QAAQ,CAAC;AAEpD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO;IAC7C,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,sCAAuC,MAAM,oBAkBjE,CAAC;AAEF,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,OAAO;IAC7C,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,qCAAsC,MAAM,cAAc,OAAO,oBAwCrF,CAAC;AAEF,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,OAAO;IACzC,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;CACzC;AAED;;;;GAIG;AACH,eAAO,MAAM,IAAI,uDAWhB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,QAMjE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,IAAI,CAKpE"}

package/dist/types/index.d.ts

@@ -0,0 +1,28 @@
+export * from './array';
+export * from './clipboard';
+export * from './cookie';
+export * from './date';
+export * from './dom';
+export * from './download';
+export * from './object';
+export * from './path';
+export * from './qs';
+export * from './string';
+export * from './type';
+export * from './url';
+export * from './async';
+export * from './file';
+export * from './watermark';
+export * from './func';
+export * from './random';
+export * from './number';
+export * from './unique';
+export * from './tooltip';
+export * from './tree';
+export * from './math';
+export * from './base64';
+export * from './validator';
+export * from './variable';
+export * from './cloneDeep';
+export * from './easing';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,MAAM,CAAC;AACrB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC"}