@allahjs/utils 0.0.1

package/dist/esm/browser/domUtils/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * DOM工具函数（仅在浏览器环境中可用）
+ */
+declare const domUtils: {
+    /**
+     * 检查是否在浏览器环境
+     * @returns 是否在浏览器环境
+     */
+    isBrowser(): boolean;
+    /**
+     * 查询元素
+     * @param selector 选择器
+     * @param parent 父元素，默认为document
+     * @returns 元素或null
+     */
+    $(selector: string, parent?: Document | Element): Element | null;
+    /**
+     * 查询所有元素
+     * @param selector 选择器
+     * @param parent 父元素，默认为document
+     * @returns 元素数组
+     */
+    $$(selector: string, parent?: Document | Element): Element[];
+    /**
+     * 添加CSS类
+     * @param element 元素
+     * @param className 类名
+     */
+    addClass(element: Element, className: string): void;
+    /**
+     * 移除CSS类
+     * @param element 元素
+     * @param className 类名
+     */
+    removeClass(element: Element, className: string): void;
+    /**
+     * 切换CSS类
+     * @param element 元素
+     * @param className 类名
+     * @returns 是否添加了类
+     */
+    toggleClass(element: Element, className: string): boolean;
+    /**
+     * 检查是否包含CSS类
+     * @param element 元素
+     * @param className 类名
+     * @returns 是否包含类
+     */
+    hasClass(element: Element, className: string): boolean;
+    /**
+     * 设置元素样式
+     * @param element 元素
+     * @param styles 样式对象
+     */
+    setStyle(element: HTMLElement, styles: Partial<CSSStyleDeclaration>): void;
+    /**
+     * 获取元素样式
+     * @param element 元素
+     * @param property 样式属性
+     * @returns 样式值
+     */
+    getStyle(element: Element, property: string): string;
+    /**
+     * 创建元素
+     * @param tagName 标签名
+     * @param attributes 属性对象
+     * @param children 子元素或文本
+     * @returns 创建的元素
+     */
+    createElement(tagName: string, attributes?: Record<string, string>, children?: (Element | string)[]): HTMLElement | null;
+    /**
+     * 获取元素位置信息
+     * @param element 元素
+     * @returns 位置信息
+     */
+    getElementPosition(element: Element): {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+    /**
+     * 检查元素是否在视口中
+     * @param element 元素
+     * @param threshold 阈值（0-1），默认为0
+     * @returns 是否在视口中
+     */
+    isInViewport(element: Element, threshold?: number): boolean;
+    /**
+     * 平滑滚动到元素
+     * @param element 目标元素
+     * @param options 滚动选项
+     */
+    scrollToElement(element: Element, options?: ScrollIntoViewOptions): void;
+    /**
+     * 复制文本到剪贴板
+     * @param text 要复制的文本
+     * @returns 是否复制成功
+     */
+    copyToClipboard(text: string): Promise<boolean>;
+    /**
+     * 监听元素大小变化
+     * @param element 元素
+     * @param callback 回调函数
+     * @returns 取消监听的函数
+     */
+    observeResize(element: Element, callback: (entry: ResizeObserverEntry) => void): () => void;
+    /**
+     * 导入cdn的方法
+     * @param url 需要导入的文件
+     * @param name 名称
+     */
+    importCDN(url: string, name: keyof Window): void;
+};
+
+export { domUtils as default };

package/dist/esm/browser/domUtils/index.js

@@ -0,0 +1,233 @@
+/**
+ * DOM工具函数（仅在浏览器环境中可用）
+ */
+const domUtils = {
+    /**
+     * 检查是否在浏览器环境
+     * @returns 是否在浏览器环境
+     */
+    isBrowser() {
+        return typeof window !== 'undefined' && typeof document !== 'undefined';
+    },
+    /**
+     * 查询元素
+     * @param selector 选择器
+     * @param parent 父元素，默认为document
+     * @returns 元素或null
+     */
+    $(selector, parent = document) {
+        if (!this.isBrowser())
+            return null;
+        return parent.querySelector(selector);
+    },
+    /**
+     * 查询所有元素
+     * @param selector 选择器
+     * @param parent 父元素，默认为document
+     * @returns 元素数组
+     */
+    $$(selector, parent = document) {
+        if (!this.isBrowser())
+            return [];
+        return Array.from(parent.querySelectorAll(selector));
+    },
+    /**
+     * 添加CSS类
+     * @param element 元素
+     * @param className 类名
+     */
+    addClass(element, className) {
+        if (!this.isBrowser())
+            return;
+        element.classList.add(className);
+    },
+    /**
+     * 移除CSS类
+     * @param element 元素
+     * @param className 类名
+     */
+    removeClass(element, className) {
+        if (!this.isBrowser())
+            return;
+        element.classList.remove(className);
+    },
+    /**
+     * 切换CSS类
+     * @param element 元素
+     * @param className 类名
+     * @returns 是否添加了类
+     */
+    toggleClass(element, className) {
+        if (!this.isBrowser())
+            return false;
+        return element.classList.toggle(className);
+    },
+    /**
+     * 检查是否包含CSS类
+     * @param element 元素
+     * @param className 类名
+     * @returns 是否包含类
+     */
+    hasClass(element, className) {
+        if (!this.isBrowser())
+            return false;
+        return element.classList.contains(className);
+    },
+    /**
+     * 设置元素样式
+     * @param element 元素
+     * @param styles 样式对象
+     */
+    setStyle(element, styles) {
+        if (!this.isBrowser())
+            return;
+        Object.assign(element.style, styles);
+    },
+    /**
+     * 获取元素样式
+     * @param element 元素
+     * @param property 样式属性
+     * @returns 样式值
+     */
+    getStyle(element, property) {
+        if (!this.isBrowser())
+            return '';
+        return window.getComputedStyle(element).getPropertyValue(property);
+    },
+    /**
+     * 创建元素
+     * @param tagName 标签名
+     * @param attributes 属性对象
+     * @param children 子元素或文本
+     * @returns 创建的元素
+     */
+    createElement(tagName, attributes = {}, children = []) {
+        if (!this.isBrowser())
+            return null;
+        const element = document.createElement(tagName);
+        // 设置属性
+        Object.entries(attributes).forEach(([key, value]) => {
+            element.setAttribute(key, value);
+        });
+        // 添加子元素
+        children.forEach(child => {
+            if (typeof child === 'string') {
+                element.appendChild(document.createTextNode(child));
+            }
+            else {
+                element.appendChild(child);
+            }
+        });
+        return element;
+    },
+    /**
+     * 获取元素位置信息
+     * @param element 元素
+     * @returns 位置信息
+     */
+    getElementPosition(element) {
+        if (!this.isBrowser())
+            return { top: 0, left: 0, width: 0, height: 0 };
+        const rect = element.getBoundingClientRect();
+        return {
+            top: rect.top + window.scrollY,
+            left: rect.left + window.scrollX,
+            width: rect.width,
+            height: rect.height
+        };
+    },
+    /**
+     * 检查元素是否在视口中
+     * @param element 元素
+     * @param threshold 阈值（0-1），默认为0
+     * @returns 是否在视口中
+     */
+    isInViewport(element, threshold = 0) {
+        if (!this.isBrowser())
+            return false;
+        const rect = element.getBoundingClientRect();
+        const windowHeight = window.innerHeight;
+        const windowWidth = window.innerWidth;
+        const verticalThreshold = windowHeight * threshold;
+        const horizontalThreshold = windowWidth * threshold;
+        return (rect.top >= -verticalThreshold &&
+            rect.left >= -horizontalThreshold &&
+            rect.bottom <= windowHeight + verticalThreshold &&
+            rect.right <= windowWidth + horizontalThreshold);
+    },
+    /**
+     * 平滑滚动到元素
+     * @param element 目标元素
+     * @param options 滚动选项
+     */
+    scrollToElement(element, options = { behavior: 'smooth', block: 'start' }) {
+        if (!this.isBrowser())
+            return;
+        element.scrollIntoView(options);
+    },
+    /**
+     * 复制文本到剪贴板
+     * @param text 要复制的文本
+     * @returns 是否复制成功
+     */
+    async copyToClipboard(text) {
+        if (!this.isBrowser())
+            return false;
+        try {
+            if (navigator.clipboard) {
+                await navigator.clipboard.writeText(text);
+                return true;
+            }
+            // 降级方案
+            const textArea = document.createElement('textarea');
+            textArea.value = text;
+            textArea.style.position = 'fixed';
+            textArea.style.opacity = '0';
+            document.body.appendChild(textArea);
+            textArea.select();
+            const success = document.execCommand('copy');
+            document.body.removeChild(textArea);
+            return success;
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * 监听元素大小变化
+     * @param element 元素
+     * @param callback 回调函数
+     * @returns 取消监听的函数
+     */
+    observeResize(element, callback) {
+        if (!this.isBrowser() || !window.ResizeObserver) {
+            return () => { };
+        }
+        const observer = new ResizeObserver(entries => {
+            entries.forEach(callback);
+        });
+        observer.observe(element);
+        return () => observer.disconnect();
+    },
+    /**
+     * 导入cdn的方法
+     * @param url 需要导入的文件
+     * @param name 名称
+     */
+    importCDN(url, name) {
+        new Promise(resolve => {
+            const dom = document.createElement('script');
+            dom.src = url;
+            dom.type = 'text/javascript';
+            dom.onload = () => {
+                resolve(window[name]);
+            };
+            if (document.head !== null) {
+                document.head.appendChild(dom);
+            }
+        });
+    }
+};
+
+export { domUtils as default };
+//# sourceMappingURL=index.js.map

package/dist/esm/browser/domUtils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/browser/domUtils/index.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;AAEG;AACH,MAAM,QAAQ,GAAG;AACf;;;AAGG;IACH,SAAS,GAAA;QACP,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW;IACzE,CAAC;AAED;;;;;AAKG;AACH,IAAA,CAAC,CAAC,QAAgB,EAAE,MAAA,GAA6B,QAAQ,EAAA;AACvD,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,IAAI;AAClC,QAAA,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC;IACvC,CAAC;AAED;;;;;AAKG;AACH,IAAA,EAAE,CAAC,QAAgB,EAAE,MAAA,GAA6B,QAAQ,EAAA;AACxD,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,EAAE;QAChC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;AAED;;;;AAIG;IACH,QAAQ,CAAC,OAAgB,EAAE,SAAiB,EAAA;AAC1C,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE;AACvB,QAAA,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC;IAClC,CAAC;AAED;;;;AAIG;IACH,WAAW,CAAC,OAAgB,EAAE,SAAiB,EAAA;AAC7C,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE;AACvB,QAAA,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;IACrC,CAAC;AAED;;;;;AAKG;IACH,WAAW,CAAC,OAAgB,EAAE,SAAiB,EAAA;AAC7C,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,KAAK;QACnC,OAAO,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC;IAC5C,CAAC;AAED;;;;;AAKG;IACH,QAAQ,CAAC,OAAgB,EAAE,SAAiB,EAAA;AAC1C,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,KAAK;QACnC,OAAO,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;IAC9C,CAAC;AAED;;;;AAIG;IACH,QAAQ,CAAC,OAAoB,EAAE,MAAoC,EAAA;AACjE,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE;QACvB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;IACtC,CAAC;AAED;;;;;AAKG;IACH,QAAQ,CAAC,OAAgB,EAAE,QAAgB,EAAA;AACzC,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,EAAE;QAChC,OAAO,MAAM,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,gBAAgB,CAAC,QAAQ,CAAC;IACpE,CAAC;AAED;;;;;;AAMG;AACH,IAAA,aAAa,CACX,OAAe,EACf,aAAqC,EAAE,EACvC,WAAiC,EAAE,EAAA;AAEnC,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,IAAI;QAElC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;;AAG/C,QAAA,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AAClD,YAAA,OAAO,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC;AAClC,QAAA,CAAC,CAAC;;AAGF,QAAA,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAG;AACvB,YAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;gBAC7B,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACrD;iBAAO;AACL,gBAAA,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;YAC5B;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,OAAO,OAAO;IAChB,CAAC;AAED;;;;AAIG;AACH,IAAA,kBAAkB,CAAC,OAAgB,EAAA;AAMjC,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;AAEtE,QAAA,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE;QAC5C,OAAO;AACL,YAAA,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO;AAC9B,YAAA,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO;YAChC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC;SACd;IACH,CAAC;AAED;;;;;AAKG;AACH,IAAA,YAAY,CAAC,OAAgB,EAAE,SAAS,GAAG,CAAC,EAAA;AAC1C,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,KAAK;AAEnC,QAAA,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE;AAC5C,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW;AACvC,QAAA,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU;AAErC,QAAA,MAAM,iBAAiB,GAAG,YAAY,GAAG,SAAS;AAClD,QAAA,MAAM,mBAAmB,GAAG,WAAW,GAAG,SAAS;AAEnD,QAAA,QACE,IAAI,CAAC,GAAG,IAAI,CAAC,iBAAiB;AAC9B,YAAA,IAAI,CAAC,IAAI,IAAI,CAAC,mBAAmB;AACjC,YAAA,IAAI,CAAC,MAAM,IAAI,YAAY,GAAG,iBAAiB;AAC/C,YAAA,IAAI,CAAC,KAAK,IAAI,WAAW,GAAG,mBAAmB;IAEnD,CAAC;AAED;;;;AAIG;AACH,IAAA,eAAe,CACb,OAAgB,EAChB,OAAA,GAAiC,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAA;AAEvE,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;YAAE;AACvB,QAAA,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC;IACjC,CAAC;AAED;;;;AAIG;IACH,MAAM,eAAe,CAAC,IAAY,EAAA;AAChC,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE;AAAE,YAAA,OAAO,KAAK;AAEnC,QAAA,IAAI;AACF,YAAA,IAAI,SAAS,CAAC,SAAS,EAAE;gBACvB,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;AACzC,gBAAA,OAAO,IAAI;YACb;;YAEA,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC;AACnD,YAAA,QAAQ,CAAC,KAAK,GAAG,IAAI;AACrB,YAAA,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO;AACjC,YAAA,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG;AAC5B,YAAA,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YACnC,QAAQ,CAAC,MAAM,EAAE;YACjB,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;AAC5C,YAAA,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;AACnC,YAAA,OAAO,OAAO;QAChB;AAAE,QAAA,MAAM;AACN,YAAA,OAAO,KAAK;QACd;IACF,CAAC;AAED;;;;;AAKG;IACH,aAAa,CACX,OAAgB,EAChB,QAA8C,EAAA;QAE9C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;AAC/C,YAAA,OAAO,MAAK,EAAG,CAAC;QAClB;AAEA,QAAA,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,OAAO,IAAG;AAC5C,YAAA,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;AAC3B,QAAA,CAAC,CAAC;AAEF,QAAA,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;AAEzB,QAAA,OAAO,MAAM,QAAQ,CAAC,UAAU,EAAE;IACpC,CAAC;AAED;;;;AAIG;IACH,SAAS,CAAC,GAAW,EAAE,IAAkB,EAAA;AACvC,QAAA,IAAI,OAAO,CAAS,OAAO,IAAG;YAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;AAC5C,YAAA,GAAG,CAAC,GAAG,GAAG,GAAG;AACb,YAAA,GAAG,CAAC,IAAI,GAAG,iBAAiB;AAC5B,YAAA,GAAG,CAAC,MAAM,GAAG,MAAK;AAChB,gBAAA,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACvB,YAAA,CAAC;AACD,YAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE;AAC1B,gBAAA,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAChC;AACF,QAAA,CAAC,CAAC;IACJ;;;;;"}

package/dist/esm/browser/index.d.ts

@@ -0,0 +1,3 @@
+export { default as cookieUtils } from './cookieUtils/index.js';
+export { default as domUtils } from './domUtils/index.js';
+export { default as urlUtils } from './urlUtils/index.js';

package/dist/esm/browser/index.js

@@ -0,0 +1,4 @@
+export { default as cookieUtils } from './cookieUtils/index.js';
+export { default as domUtils } from './domUtils/index.js';
+export { default as urlUtils } from './urlUtils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/esm/browser/urlUtils/index.d.ts

@@ -0,0 +1,72 @@
+/**
+ * URL工具函数
+ */
+/**
+ * 获取url的参数
+ * @param url - URL字符串，默认为当前页面URL
+ * @returns 参数对象
+ */
+declare function getUrlParams<T = any>(url?: string): T;
+/**
+ * 刷新url的状态
+ * @param data - 需要更新的参数对象
+ */
+declare function refreshUrlState(data: Record<string, string>): void;
+type TSetUrlParams = {
+    pathname: string;
+    query: Record<string, any>;
+};
+/**
+ * 设置URL参数
+ * @param params - 包含路径和查询参数的对象
+ * @returns 完整的URL字符串
+ */
+declare function setUrlParams(params: TSetUrlParams): string;
+/**
+ * 构建查询参数字符串
+ * 该函数接收一个对象，将对象中的键值对转换为URL编码格式的查询参数字符串。
+ * 对于对象中的数组值，采用`repeat`模式，即数组中的每个元素都会单独形成一个键值对。
+ * @param params - 包含查询参数的对象，键为字符串类型，值可以是基本类型（如string、number、boolean等）或数组类型
+ * @returns 拼接好的URL查询参数字符串
+ */
+declare function buildQueryParams(params: any): string;
+/**
+ * 获取页面URL中的查询参数
+ * 该函数通过解析当前页面URL中 `?` 符号后的部分，提取出所有的查询参数，并以对象形式返回。
+ * 如果URL中不存在查询参数部分，则返回一个空对象。
+ * @param queryString - 查询字符串
+ * @returns 解析后的查询参数对象，键为参数名，值为对应的参数值，重复的参数名将被合并到一个数组中
+ */
+declare function getPageQueryParams(queryString: string): any;
+/**
+ * 更新URL中的参数 -> 得到新的url
+ * @param href - 原始URL
+ * @param params - 需要更新的参数
+ * @returns 新的URL
+ */
+declare function getUpdateUrl(href: string, params: Record<string, string>): string;
+/**
+ * 将对象转换为URL参数字符串
+ * @param param - 将要转为URL参数字符串的对象
+ * @param prefix - URL参数字符串的前缀
+ * @param encode - 是否进行URL编码，默认为true
+ * @returns URL参数字符串
+ */
+declare function urlEncode(param: any, prefix?: string, encode?: boolean): string;
+/**
+ * URL工具对象
+ */
+declare const urlUtils: {
+    getUrlParams: typeof getUrlParams;
+    getLocalPath: (url: string, index?: number) => string;
+    getWebLocalPath: (index?: number) => string;
+    refreshUrlState: typeof refreshUrlState;
+    setUrlParams: typeof setUrlParams;
+    buildQueryParams: typeof buildQueryParams;
+    getPageQueryParams: typeof getPageQueryParams;
+    getUpdateUrl: typeof getUpdateUrl;
+    urlEncode: typeof urlEncode;
+    urlToList: (url?: string) => string[];
+};
+
+export { buildQueryParams, urlUtils as default, getPageQueryParams, getUpdateUrl, getUrlParams, refreshUrlState, setUrlParams, urlEncode };

package/dist/esm/browser/urlUtils/index.js

@@ -0,0 +1,248 @@
+/**
+ * URL工具函数
+ */
+/**
+ * 获取url的参数
+ * @param url - URL字符串，默认为当前页面URL
+ * @returns 参数对象
+ */
+function getUrlParams(url) {
+    if (!url && typeof window !== 'undefined') {
+        url = window.location.href;
+    }
+    const theRequest = {};
+    if (!url) {
+        console.error('无效的url');
+        return theRequest;
+    }
+    const queryIndex = url.indexOf('?');
+    if (queryIndex !== -1) {
+        const str = url.slice(queryIndex + 1);
+        const pairs = str.split('&');
+        for (const pair of pairs) {
+            const [key, value] = pair.split('=');
+            if (key) {
+                theRequest[decodeURIComponent(key)] = decodeURIComponent(value || '');
+            }
+        }
+    }
+    return theRequest;
+}
+/**
+ * 从url中获取指定位置的路径字符串
+ * @param url - 需要获取的url
+ * @param index - 如果是-1则是最后一个，如果是0则是第一个
+ * @returns 路径字符串
+ */
+const getLocalPath = (url, index = -1) => {
+    // url要去掉开头的//和后面的参数。然后用剩下的。如果它有的话
+    if (url.startsWith('http')) {
+        // 说明是完整的url。现在只需要pathname
+        url = new URL(url).pathname;
+    }
+    // 去掉开头的/
+    url = url.replace(/^\//, '');
+    // 拆成数组
+    const urlArr = url.split('/');
+    // 如果是-1则返回最后一个
+    if (index === -1) {
+        return urlArr[urlArr.length - 1];
+    }
+    return urlArr[index];
+};
+/**
+ * 从当前页面URL中获取指定位置的路径字符串
+ * @param index - 如果是-1则是最后一个，如果是0则是第一个，默认是最后一个
+ * @returns 路径字符串
+ */
+const getWebLocalPath = (index = -1) => {
+    if (!window) {
+        return '';
+    }
+    return getLocalPath(window.location.pathname, index);
+};
+/**
+ * 刷新url的状态
+ * @param data - 需要更新的参数对象
+ */
+function refreshUrlState(data) {
+    if (!window) {
+        return;
+    }
+    const searchStr = window.location.href;
+    // 问号前面的
+    const url = searchStr.substring(0, searchStr.indexOf('?'));
+    const newUrl = setUrlParams({ pathname: url, query: data });
+    window.history.replaceState(null, '', newUrl);
+}
+/**
+ * 设置URL参数
+ * @param params - 包含路径和查询参数的对象
+ * @returns 完整的URL字符串
+ */
+function setUrlParams(params) {
+    const { query } = params;
+    let { pathname } = params;
+    if (typeof query === 'object') {
+        // 开始拼接
+        Object.keys(query).forEach((key, index) => {
+            // 判断数据是否存在
+            if (query[key] !== undefined && query[key] !== null && query[key] !== '') {
+                if (index === 0) {
+                    pathname = `${pathname}?${key}=${query[key]}`;
+                }
+                else {
+                    pathname = `${pathname}&${key}=${query[key]}`;
+                }
+            }
+        });
+    }
+    return pathname;
+}
+/**
+ * 构建查询参数字符串
+ * 该函数接收一个对象，将对象中的键值对转换为URL编码格式的查询参数字符串。
+ * 对于对象中的数组值，采用`repeat`模式，即数组中的每个元素都会单独形成一个键值对。
+ * @param params - 包含查询参数的对象，键为字符串类型，值可以是基本类型（如string、number、boolean等）或数组类型
+ * @returns 拼接好的URL查询参数字符串
+ */
+function buildQueryParams(params) {
+    const paramPairs = [];
+    for (const key in params) {
+        const value = params[key];
+        if (Array.isArray(value)) {
+            value.forEach(v => {
+                paramPairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(v)}`);
+            });
+        }
+        else {
+            paramPairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`);
+        }
+    }
+    return paramPairs.join('&');
+}
+/**
+ * 获取页面URL中的查询参数
+ * 该函数通过解析当前页面URL中 `?` 符号后的部分，提取出所有的查询参数，并以对象形式返回。
+ * 如果URL中不存在查询参数部分，则返回一个空对象。
+ * @param queryString - 查询字符串
+ * @returns 解析后的查询参数对象，键为参数名，值为对应的参数值，重复的参数名将被合并到一个数组中
+ */
+function getPageQueryParams(queryString) {
+    // 如果没有查询字符串，说明没有查询参数，直接返回一个空对象
+    if (!queryString) {
+        return {};
+    }
+    const queryParams = {};
+    // 将查询字符串按 '&' 分割成多个键值对
+    const pairs = queryString.split('&');
+    pairs.forEach(pair => {
+        // 对每一个键值对按 '=' 分开，分别得到键和值
+        const [key, value] = pair.split('=');
+        // 对键和值进行URL解码
+        const decodedKey = decodeURIComponent(key);
+        const decodedValue = decodeURIComponent(value);
+        // 处理重复参数：如果某个键已经存在于 queryParams 中
+        if (queryParams[decodedKey]) {
+            // 检查它是不是数组
+            if (Array.isArray(queryParams[decodedKey])) {
+                // 如果是数组，直接把新值 push 进去
+                queryParams[decodedKey].push(decodedValue);
+            }
+            else {
+                // 如果不是数组，把它变成数组，再把新值 push 进去
+                queryParams[decodedKey] = [queryParams[decodedKey], decodedValue];
+            }
+        }
+        else {
+            // 如果是新键，直接赋值
+            queryParams[decodedKey] = decodedValue;
+        }
+    });
+    return queryParams;
+}
+/**
+ * 更新URL中的参数 -> 得到新的url
+ * @param href - 原始URL
+ * @param params - 需要更新的参数
+ * @returns 新的URL
+ */
+function getUpdateUrl(href, params) {
+    if (!window) {
+        return '';
+    }
+    const searchStr = href || window.location.href;
+    const oldParams = getUrlParams(searchStr);
+    const newParams = { ...oldParams, ...params };
+    // 问号前面的
+    const url = searchStr.substring(0, searchStr.indexOf('?'));
+    return setUrlParams({ pathname: url, query: newParams });
+}
+/**
+ * 将对象转换为URL参数字符串
+ * @param param - 将要转为URL参数字符串的对象
+ * @param prefix - URL参数字符串的前缀
+ * @param encode - 是否进行URL编码，默认为true
+ * @returns URL参数字符串
+ */
+function urlEncode(param, prefix, encode = true) {
+    if (param === null)
+        return '';
+    let paramStr = '';
+    const t = typeof param;
+    if (t === 'string' || t === 'number' || t === 'boolean') {
+        paramStr += `&${prefix}=${encode ? encodeURIComponent(param) : param}`;
+    }
+    else {
+        Object.keys(param).forEach(key => {
+            key = prefix === null ? key : prefix + (param instanceof Array ? `[${key}]` : `.${key}`);
+            paramStr += urlEncode(param[key], key, encode);
+        });
+    }
+    return paramStr;
+}
+/**
+ * URL转换为路径列表
+ * @param url - URL字符串
+ * @returns 路径数组
+ */
+const urlToList = (url) => {
+    if (!url || url === '/') {
+        return ['/'];
+    }
+    // 去掉协议、域名、查询串和 hash，只保留 pathname
+    let pathname = url;
+    try {
+        // 如果是完整 URL，用 URL 对象解析
+        if (url.startsWith('http://') || url.startsWith('https://')) {
+            pathname = new URL(url).pathname;
+        }
+    }
+    catch {
+        // 如果解析失败，继续用原字符串
+    }
+    // 去掉开头的 /
+    pathname = pathname.replace(/^\/+/, '');
+    // 拆成数组并过滤空串
+    const urlList = pathname.split('/').filter(Boolean);
+    // 逐级拼接返回
+    return urlList.map((_, index) => `/${urlList.slice(0, index + 1).join('/')}`);
+};
+/**
+ * URL工具对象
+ */
+const urlUtils = {
+    getUrlParams,
+    getLocalPath,
+    getWebLocalPath,
+    refreshUrlState,
+    setUrlParams,
+    buildQueryParams,
+    getPageQueryParams,
+    getUpdateUrl,
+    urlEncode,
+    urlToList
+};
+
+export { buildQueryParams, urlUtils as default, getLocalPath, getPageQueryParams, getUpdateUrl, getUrlParams, getWebLocalPath, refreshUrlState, setUrlParams, urlEncode, urlToList };
+//# sourceMappingURL=index.js.map