mazey 4.10.0 → 4.10.2

package/lib/debug.d.ts

@@ -1,74 +0,0 @@
-/**
- * EN: Custom console printing (`console`).
- *
- * ZH: 生成自定义控制台打印。
- *
- * Usage:
- *
- * ```javascript
- * import { genCustomConsole } from "mazey";
- *
- * const cusConsole = genCustomConsole("[MazeyLog]");
- * cusConsole.log("I am string.");
- * cusConsole.info("I am boolean.", true);
- * cusConsole.info("I am number.", 123, 456);
- * cusConsole.info("I am object.", { a: 123, b: 456});
- * ```
- *
- * Output:
- *
- * ```text
- * [MazeyLog] I am string.
- * [MazeyLog] I am boolean. true
- * [MazeyLog] I am number. 123 456
- * [MazeyLog] I am object. {a: 123, b: 456}
- * ```
- *
- * @param {string} prefix The prefix string.
- * @param {object} options The options object.
- * @param {boolean} options.enabled Whether logging is enabled.
- * @param {boolean} options.isClosed Deprecated, Use "enabled" instead.
- * @param {boolean} options.showWrap Whether to show the wrap.
- * @param {boolean} options.showDate Whether to show the date.
- * @param {string} options.locales A locale string.
- * @param {boolean} options.isStringifyObject Whether to stringify the object.
- * @param {function} options.logFn The function with Log.
- * @param {function} options.errorFn The function with Error.
- * @returns {object} The custom console object.
- * @category Debug
- */
-export declare function genCustomConsole(prefix?: string, options?: {
-    enabled?: boolean;
-    isClosed?: boolean;
-    showWrap?: boolean;
-    showDate?: boolean;
-    locales?: string;
-    isStringifyObject?: boolean;
-    logFn?: () => void;
-    errorFn?: () => void;
-}): Console;
-/**
- * @hidden
- */
-export declare const mazeyCon: Console;
-/**
- * EN: Print logs with Time.
- *
- * ZH: 打印带有时间的日志。
- *
- * Usage:
- *
- * ```javascript
- * timeCon("I am string.");
- * ```
- *
- * Output:
- *
- * ```text
- * 2024年11月2日周六 09:24:40 I am string.
- * ```
- *
- * @hidden
- */
-export declare const timeCon: Console;
-//# sourceMappingURL=debug.d.ts.map

package/lib/debug.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,SAAK,EACX,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CAGtB,GACA,OAAO,CAoFT;AAED;;GAEG;AACH,eAAO,MAAM,QAAQ,SAA8B,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,OAAO,SAAsF,CAAC"}

package/lib/dom.d.ts

@@ -1,232 +0,0 @@
-import type { MazeyElement } from "./typing";
-/**
- * Modify `class`: determine `class`.
- *
- * Usage:
- *
- * ```javascript
- * import { hasClass, addClass, removeClass } from "mazey";
- *
- * const dom = document.querySelector("#box");
- * // Determine `class`
- * hasClass(dom, "test");
- * // Add `class`
- * addClass(dom, "test");
- * // Remove `class`
- * removeClass(dom, "test");
- * ```
- *
- * @category DOM
- */
-export declare function hasClass(obj: MazeyElement, cls: string): boolean;
-/**
- * Add `class` to the element. The second parameter can be a single class name or an array of class names.
- *
- * Basic Usage:
- *
- * ```javascript
- * import { addClass } from "mazey";
- *
- * const ele = document.querySelector("#box");
- * addClass(ele, "test");
- * ```
- *
- * Output:
- *
- * ```html
- * <div id="box" class="test"></div>
- * ```
- *
- * Advanced Usage:
- *
- * ```javascript
- * import { addClass, genBrowserAttrs } from "mazey";
- *
- * const ele = document.querySelector("html");
- * addClass(ele, genBrowserAttrs());
- * ```
- *
- * Output:
- *
- * ```html
- * <html class="windows desktop webkit chrome"></html>
- * ```
- *
- * @category DOM
- */
-export declare function addClass(ele: MazeyElement, cls: string | string[]): void;
-/**
- * Alias of `addClass`.
- *
- * @hidden
- */
-export declare function setClass(ele: HTMLElement, cls: string): void;
-/**
- * Modify `class`: remove `class`.
- *
- * Usage:
- *
- * ```javascript
- * import { hasClass, addClass, removeClass } from "mazey";
- *
- * const dom = document.querySelector("#box");
- * // Determine `class`
- * hasClass(dom, "test");
- * // Add `class`
- * addClass(dom, "test");
- * // Remove `class`
- * removeClass(dom, "test");
- * ```
- *
- * @category DOM
- */
-export declare function removeClass(obj: MazeyElement, cls: string): void;
-/**
- * EN: Add `<style>` in `<head>`.
- *
- * ZH: 添加样式标签; style: 样式标签内的字符串; id: `<style>` 标签的 `id`; 返回: 添加成功/失败。
- *
- * Usage:
- *
- * Example 1: Add the `<style>` with `id`, and repeated invoking will update the content instead of adding a new one.
- *
- * ```javascript
- * import { addStyle } from "mazey";
- *
- * addStyle(
- *   `
- *     body {
- *       background-color: #333;
- *     }
- *   `,
- *   {
- *     id: "test",
- *   }
- * );
- * ```
- *
- * Output:
- *
- * ```html
- * <style id="test">
- *   body {
- *     background-color: #333;
- *   }
- * </style>
- * ```
- *
- * Example 2: Add the `<style>` without `id`, and repeated invoking will add a new one.
- *
- * ```javascript
- * import { addStyle } from "mazey";
- *
- * addStyle(
- *   `
- *     body {
- *       background-color: #444;
- *     }
- *   `
- * );
- * ```
- *
- * Output:
- *
- * ```html
- * <style>
- *   body {
- *     background-color: #444;
- *   }
- * </style>
- * ```
- *
- * @category DOM
- */
-export declare function addStyle(style: string, options?: {
-    id?: string;
-}): boolean;
-/**
- * Sets the width and height of all images on the page based on their `src` attribute.
- * The `src` attribute should contain `width` and/or `height` values in the format "width=100" or "height=100".
- * If jQuery is available, this function uses jQuery to select the images. Otherwise, it uses pure JavaScript.
- *
- * Usage:
- *
- * ```html
- * <img src="image.jpg?width=100px&height=200px">
- * ```
- *
- * ```javascript
- * import { setImgSizeBySrc } from "mazey";
- *
- * setImgSizeBySrc();
- * ```
- *
- * Output:
- *
- * ```html
- * <img src="image.jpg?width=100px&height=200px" width="100px" height="200px">
- * ```
- *
- * @returns {boolean} - Returns `true` if images were found and their dimensions were set, otherwise `false`.
- * @category DOM
- */
-export declare function setImgSizeBySrc(): boolean;
-/**
- * Alias of `setImgSizeBySrc`.
- *
- * @hidden
- */
-export declare function setImgWidHeiBySrc(): boolean;
-/**
- * Generate the inline style string from the given parameters. The first parameter is the query selector, and the second parameter is the style array.
- *
- * Usage:
- *
- * ```javascript
- * const ret1 = genStyleString(".a", [ "color:red" ]);
- * const ret2 = genStyleString("#b", [ "color:red", "font-size:12px" ]);
- * console.log(ret1);
- * console.log(ret2);
- * ```
- *
- * Output:
- *
- * ```text
- * .a{color:red;}
- * #b{color:red;font-size:12px;}
- * ```
- *
- * @param {string} selector
- * @param {array} styleArray
- * @returns {string} The inline style string.
- * @category DOM
- */
-export declare function genStyleString(selector: string, styleArray: Array<string>): string;
-/**
- * Get the value of the meta tag by the given name.
- *
- * Usage:
- *
- * ```html
- * <meta name="keywords" content="mazey,web,frontend">
- * ```
- *
- * ```javascript
- * import { getPageMeta } from "mazey";
- *
- * const keywords = getPageMeta("keywords");
- * console.log(keywords);
- * ```
- *
- * Output:
- *
- * ```text
- * mazey,web,frontend
- * ```
- *
- * @param {string} name - The name of the meta tag.
- * @returns {string} The content of the meta tag.
- * @category DOM
- */
-export declare function getPageMeta(name: string): string;
-//# sourceMappingURL=dom.d.ts.map

package/lib/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAahE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA2BxE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAYhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAe,GAAG,OAAO,CA+BtF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,IAAI,OAAO,CA6CzC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,CAMlF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/lib/event.d.ts

@@ -1,101 +0,0 @@
-import type { DefineListeners, MazeyFn, MazeyObject } from "./typing";
-/**
- * Prevent bubbling.
- *
- * Usage:
- *
- * ```javascript
- * import { cancelBubble } from "mazey";
- *
- * const ret1 = cancelBubble(e);
- * ```
- *
- * @category Event
- */
-export declare function cancelBubble(e: Event): void;
-/**
- * Get the defined listeners.
- *
- * Usage:
- *
- * ```javascript
- * import { getDefineListeners } from "mazey";
- *
- * const ret = getDefineListeners();
- * console.log(ret);
- * ```
- *
- * Output:
- *
- * ```text
- * {}
- * ```
- *
- * @category Event
- * @hidden
- */
-export declare function getDefineListeners(): DefineListeners;
-/**
- * Add event.
- *
- * Usage:
- *
- * ```javascript
- * import { addEvent } from "mazey";
- *
- * addEvent("test", (e) => {
- *  console.log("test event:", e);
- * });
- * fireEvent("test");
- * ```
- *
- * Output:
- *
- * ```javascript
- * test event: { type: "test" }
- * ```
- *
- * @param type
- * @param fn
- * @category Event
- */
-export declare function addEvent(type: string, fn: MazeyFn): void;
-/**
- * Fire/Invoke event.
- *
- * Usage:
- *
- * ```javascript
- * import { fireEvent } from "mazey";
- *
- * fireEvent("test");
- * ```
- *
- * @param type The event type.
- * @param params The event parameters.
- * @category Event
- */
-export declare function fireEvent(type: string, params?: MazeyObject): void;
-/**
- * Alias of `fireEvent`.
- *
- * @hidden
- */
-export declare function invokeEvent(type: string): void;
-/**
- * Remove event.
- *
- * Usage:
- *
- * ```javascript
- * import { removeEvent } from "mazey";
- *
- * removeEvent("test");
- * ```
- *
- * @param type
- * @param fn
- * @category Event
- */
-export declare function removeEvent(type: string, fn: MazeyFn): void;
-//# sourceMappingURL=event.d.ts.map

package/lib/event.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../src/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAS3C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAOpD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAQxD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAUlE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAe3D"}

package/lib/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * @author Cheng
- */
-export * from "./calc";
-export * from "./util";
-export * from "./url";
-export * from "./dom";
-export * from "./event";
-export * from "./store";
-export * from "./load";
-export * from "./perf";
-export * from "./browser";
-export * from "./debug";
-//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,OAAO,CAAC;AACtB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/lib/load.d.ts

@@ -1,186 +0,0 @@
-import type { MazeyFnParams, MazeyFnReturn, LoadScriptReturns } from "./typing";
-/**
- * EN: Load a CSS file from the server.
- *
- * ZH: 动态加载 CSS 文件。
- *
- * Usage:
- *
- * ```javascript
- * import { loadCSS } from "mazey";
- *
- * loadCSS(
- *     "http://example.com/path/example.css",
- *     {
- *       id: "iamid", // Optional, link ID, default none
- *     }
- *   )
- *   .then(
- *     res => {
- *       console.log(`Load CSS Success: ${res}`);
- *     }
- *   )
- *   .catch(
- *     err => {
- *       console.error(`Load CSS Fail: ${err.message}`)
- *     }
- *   );
- * ```
- *
- * Output:
- *
- * ```text
- * Load CSS Success: loaded
- * ```
- *
- * @param {string} url -- css资源路径
- * @param {string} options.id -- link标签id
- * @returns {Promise<string>} true -- 加载成功
- * @category Load
- */
-export declare function loadCSS(url: string, options?: {
-    id?: string;
-}): Promise<unknown>;
-/**
- * EN: Load a JavaScript file from the server and execute it.
- *
- * ZH: 动态加载 JavaScript 文件。
- *
- * Usage:
- *
- * ```javascript
- * import { loadScript } from "mazey";
- *
- * loadScript(
- *     "http://example.com/static/js/plugin-2.1.1.min.js",
- *     {
- *       id: "iamid", // (Optional) script ID, default none
- *       timeout: 5000, // (Optional) timeout, default `5000`
- *     }
- *   )
- *   .then(
- *     res => {
- *       console.log(`Load JavaScript script: ${res}`);
- *     }
- *   )
- *   .catch(
- *     err => {
- *       console.error(`Load JavaScript script: ${err.message}`);
- *     }
- *   );
- * ```
- *
- * Output:
- *
- * ```text
- * Load JavaScript script: loaded
- * ```
- *
- * @param {string} url -- JavaScript 资源路径
- * @param {string} options.id -- DOM ID
- * @param {function} options.callback -- 加载后回调函数
- * @param {number} options.timeout -- 超时时长
- * @param {boolean} options.isDefer -- 是否添加 defer 标签
- * @param {boolean} options.isAsync -- 是否添加 async 标签
- * @param {boolean} options.isCrossOrigin -- 是否跨域
- * @param {object} options.attributes -- 其他属性
- * @param {string} options.cssUrl -- CSS 资源路径
- * @returns {Promise<string>} -- true 成功
- * @category Load
- */
-export declare function loadScript(url: string, options?: {
-    id?: string;
-    callback?: (...params: MazeyFnParams) => MazeyFnReturn;
-    timeout?: number;
-    isDefer?: boolean;
-    isAsync?: boolean;
-    isCrossOrigin?: boolean;
-    attributes?: Record<string, string> | null;
-    cssUrl?: string;
-}): LoadScriptReturns;
-/**
- * EN: Check whether the page is loaded successfully (Keep the compatibility if the browser's `load` event has been triggered).
- *
- * ZH: 页面加载完成。
- *
- * Usage:
- *
- * ```javascript
- * import { windowLoaded } from "mazey";
- *
- * windowLoaded()
- *   .then(res => {
- *     console.log(`Load Success: ${res}`);
- *   })
- *   .catch(err => {
- *     console.log(`Load Timeout or Fail: ${err.message}`);
- *   });
- * ```
- *
- * Output:
- *
- * ```text
- * Load Success: load
- * ```
- *
- * @param {number} timeout 超时时间 / 单位：毫秒，默认：30000(30 秒)
- * @returns {Promise<string>} document is loaded? "complete" "load" / "timeout"
- * @category Load
- */
-export declare function windowLoaded(timeout?: number): Promise<string | Error>;
-/**
- * Load an image from the given URL.
- *
- * The target image will be loaded in the background, and the Promise status will change after the image is loaded. If the image fails to load, the Promise status will change to `reject` with the error object. If the image is loaded successfully, the Promise status will change to `resolve` with the image object. This method can be used to preload images and cache them in the browser. It can also be used to implement lazy loading of images.
- *
- * Note that this method will not add the image to the DOM.
- *
- * Usage:
- *
- * ```javascript
- * import { loadImage } from "mazey";
- *
- * loadImage("https://example.com/example.png")
- *   .then((img) => {
- *     console.log(img);
- *   })
- *   .catch((err) => {
- *     console.log(err);
- *   });
- * ```
- *
- * @param {string} url - The URL of the image to load.
- * @returns {Promise} A Promise that resolves with the loaded image or rejects with an error.
- * @category Load
- */
-export declare function loadImage(url: string): Promise<HTMLImageElement>;
-/**
- * Load a script from the given URL if it (`window["attribute"]`) has not already been loaded.
- *
- * Usage:
- *
- * ```javascript
- * import { loadScriptIfUndefined } from "mazey";
- *
- * loadScriptIfUndefined("xyz", "https://example.com/lib/xyz.min.js")
- *   .then(() => {
- *     console.log("xyz is loaded.");
- *   })
- *   .catch(err => {
- *     console.log("Failed to load xyz.", err);
- *   });
- * ```
- *
- * Output:
- *
- * ```text
- * xyz is loaded.
- * ```
- *
- * @param {string} windowAttribute - The name of the window attribute to check (e.g. `jQuery`, `axios`, etc.).
- * @param {string} url - The URL of the script to load.
- * @returns {Promise} A Promise that resolves when the script has been loaded.
- * @category Load
- */
-export declare function loadScriptIfUndefined(windowAttribute: string, url: string): LoadScriptReturns;
-//# sourceMappingURL=load.d.ts.map

package/lib/load.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAChD,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAyG5F;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACP,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CAGjB,GACA,iBAAiB,CAgEnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,OAAO,SAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAerE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAWhE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAK7F"}