dlsjs 0.1.25 → 1.0.3

package/package.json

@@ -3,7 +3,7 @@
   "author": "林川",
   "license": "MIT",
   "private": false,
-  "version": "0.1.25",
+  "version": "1.0.3",
   "description": "domain-language for js",
   "main": "dist/dlsjs.esm.js",
   "module": "dist/dlsjs.esm.js",

package/src/{core/Browser → Browser}/Dom.js

@@ -125,7 +125,3 @@ function getImageSizeByUrl(url) {
         image.src = url;
     });
 }
-
-export default {
-    movePanel, moveRelate, getTextWidth, getImageSizeByUrl
-}

package/src/{core/Browser → Browser}/File.js

@@ -172,7 +172,3 @@ export function toBase64(str){
     let encode = encodeURI(str);
     return btoa(encode);
 }
-
-export default {
-    chooseFile, requestFile, requestJSON, downloadBlob, file2Json, json2Blob, toBase64, downloadByUrl
-}

package/src/{core/Browser → Browser}/Local.js

@@ -59,12 +59,3 @@ export function sessionSet (key, value) {
 export function sessionRemove (key) {
     window.sessionStorage.removeItem(key)
 }
-
-export default {
-    localGet,
-    localSet,
-    localRemove,
-    sessionGet,
-    sessionSet,
-    sessionRemove
-}

package/src/Browser/Nav.js

@@ -0,0 +1,208 @@
+/**
+ * 检测是否为移动设备
+ * 综合使用User-Agent、屏幕尺寸和触摸支持进行判断
+ * 时间复杂度O(1)：直接访问浏览器属性和正则匹配
+ *
+ * @returns {boolean} 是否为移动设备
+ *
+ * @example
+ * if (isMobileDevice()) {
+ *     console.log('当前在移动设备上');
+ *     // 加载移动端优化样式
+ * }
+ */
+export function isMobileDevice() {
+    // 1. 检查User-Agent
+    const mobileUserAgent = /Mobile|Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i;
+    const isMobileUA = mobileUserAgent.test(navigator.userAgent);
+
+    // 2. 检查屏幕尺寸（移动设备通常宽度小于768px）
+    const isSmallScreen = window.innerWidth <= 768;
+
+    // 3. 检查触摸支持
+    const hasTouchSupport = 'ontouchstart' in window ||
+                           navigator.maxTouchPoints > 0 ||
+                           navigator.msMaxTouchPoints > 0;
+
+    // 4. 检查设备像素比（移动设备通常有较高的DPI）
+    const isHighDPI = window.devicePixelRatio >= 1.5;
+
+    // 综合判断：User-Agent匹配或（小屏幕且支持触摸）
+    return isMobileUA || (isSmallScreen && hasTouchSupport);
+}
+
+/**
+ * 获取设备类型详细信息
+ * 时间复杂度O(1)：直接访问浏览器属性和正则匹配
+ *
+ * @returns {Object} 设备信息对象，包含类型、屏幕尺寸等
+ *
+ * @example
+ * const deviceInfo = getDeviceInfo();
+ * console.log(deviceInfo.type); // 'mobile', 'tablet', 'desktop'
+ * console.log(deviceInfo.screenWidth); // 屏幕宽度
+ */
+export function getDeviceInfo() {
+    const userAgent = navigator.userAgent.toLowerCase();
+    const screenWidth = window.innerWidth;
+
+    let type = 'desktop';
+    let subType = 'unknown';
+
+    // 检测设备类型
+    if (/mobile|android|iphone|ipod/.test(userAgent)) {
+        type = 'mobile';
+        if (/iphone|ipod/.test(userAgent)) subType = 'iphone';
+        else if (/android/.test(userAgent)) subType = 'android';
+    } else if (/ipad/.test(userAgent) || (screenWidth <= 1024 && screenWidth > 768)) {
+        type = 'tablet';
+        if (/ipad/.test(userAgent)) subType = 'ipad';
+    }
+
+    // 根据屏幕尺寸进一步调整
+    if (type === 'desktop' && screenWidth <= 768) {
+        type = 'mobile';
+    }
+
+    return {
+        type,
+        subType,
+        screenWidth,
+        screenHeight: window.innerHeight,
+        pixelRatio: window.devicePixelRatio,
+        userAgent: navigator.userAgent
+    };
+}
+
+/**
+ * 复制文本到剪贴板
+ * 优先使用现代Clipboard API，降级到传统execCommand方法
+ * 时间复杂度O(1)：直接调用浏览器API
+ *
+ * @param {string} text - 要复制的文本内容
+ * @returns {Promise<boolean>} 复制是否成功
+ *
+ * @example
+ * // 使用async/await
+ * const success = await copyText('Hello World');
+ * if (success) {
+ *     console.log('复制成功');
+ * }
+ *
+ * // 使用Promise
+ * copyText('Hello World').then(success => {
+ *     if (success) {
+ *         console.log('复制成功');
+ *     }
+ * });
+ */
+export function copyText(text) {
+    // 输入验证
+    if (typeof text !== 'string') {
+        console.warn('dlsjs: copyText 参数必须是字符串');
+        return Promise.resolve(false);
+    }
+
+    if (text === '') {
+        console.warn('dlsjs: copyText 不能复制空字符串');
+        return Promise.resolve(false);
+    }
+
+    // 优先使用现代Clipboard API（需要安全上下文）
+    if (navigator.clipboard && window.isSecureContext) {
+        return navigator.clipboard.writeText(text)
+            .then(() => true)
+            .catch(error => {
+                console.error('dlsjs: 使用Clipboard API复制失败:', error);
+                return fallbackCopyText(text);
+            });
+    }
+
+    // 降级到传统方法
+    return Promise.resolve(fallbackCopyText(text));
+}
+
+/**
+ * 传统复制文本方法（降级方案）
+ * 时间复杂度O(1)：DOM操作和execCommand调用
+ *
+ * @param {string} text - 要复制的文本
+ * @returns {boolean} 复制是否成功
+ */
+function fallbackCopyText(text) {
+    try {
+        // 创建临时textarea元素（比input更适合多行文本）
+        const textarea = document.createElement('textarea');
+        textarea.value = text;
+        textarea.style.position = 'fixed';
+        textarea.style.left = '-9999px';
+        textarea.style.top = '0';
+        textarea.setAttribute('readonly', '');
+
+        document.body.appendChild(textarea);
+
+        // 选择文本（兼容不同浏览器）
+        if (textarea.select) {
+            textarea.select();
+        } else if (textarea.setSelectionRange) {
+            textarea.setSelectionRange(0, textarea.value.length);
+        }
+
+        // 尝试复制
+        const successful = document.execCommand('copy');
+        document.body.removeChild(textarea);
+
+        if (!successful) {
+            console.warn('dlsjs: 传统复制方法执行失败');
+        }
+
+        return successful;
+    } catch (error) {
+        console.error('dlsjs: 传统复制方法出错:', error);
+        return false;
+    }
+}
+
+/**
+ * 检查剪贴板API是否可用
+ * 时间复杂度O(1)：直接检查浏览器API支持
+ *
+ * @returns {boolean} 剪贴板API是否可用
+ *
+ * @example
+ * if (isClipboardSupported()) {
+ *     // 可以使用现代剪贴板API
+ * } else {
+ *     // 需要使用传统方法
+ * }
+ */
+export function isClipboardSupported() {
+    return !!(navigator.clipboard && window.isSecureContext);
+}
+
+/**
+ * 读取剪贴板文本内容
+ * 需要用户授权，只能在安全上下文（HTTPS）中使用
+ * 时间复杂度O(1)：直接调用浏览器API
+ *
+ * @returns {Promise<string>} 剪贴板中的文本内容
+ *
+ * @example
+ * try {
+ *     const text = await readClipboardText();
+ *     console.log('剪贴板内容:', text);
+ * } catch (error) {
+ *     console.error('读取剪贴板失败:', error);
+ * }
+ */
+export function readClipboardText() {
+    if (!isClipboardSupported()) {
+        return Promise.reject(new Error('dlsjs: 当前环境不支持剪贴板读取'));
+    }
+
+    return navigator.clipboard.readText()
+        .catch(error => {
+            console.error('dlsjs: 读取剪贴板失败:', error);
+            throw error;
+        });
+}

package/src/Browser/Screen.js

@@ -0,0 +1,175 @@
+/**
+ * 切换全屏状态
+ * 如果当前处于全屏模式则退出，否则进入全屏模式
+ * 时间复杂度O(1)：直接调用浏览器API，无循环操作
+ *
+ * @param {HTMLElement} [element=document.documentElement] - 要设置为全屏的元素，默认为整个文档
+ * @returns {boolean} 操作是否成功执行
+ *
+ * @example
+ * // 切换整个文档的全屏状态
+ * toggleFullscreen();
+ *
+ * // 切换指定元素的全屏状态
+ * toggleFullscreen(document.getElementById('myElement'));
+ */
+export function toggleFullscreen(element = document.documentElement) {
+    if (!element || !(element instanceof HTMLElement)) {
+        console.warn('dlsjs: toggleFullscreen 参数必须是有效的HTML元素');
+        return false;
+    }
+
+    if (isFullscreenActive()) {
+        return exitFullscreen();
+    } else {
+        return requestFullscreen(element);
+    }
+}
+
+/**
+ * 请求进入全屏模式
+ * 时间复杂度O(1)：直接调用浏览器API，无循环操作
+ *
+ * @param {HTMLElement} element - 要设置为全屏的元素
+ * @returns {boolean} 操作是否成功发起
+ *
+ * @example
+ * requestFullscreen(document.getElementById('myElement'));
+ */
+export function requestFullscreen(element) {
+    if (!element || !(element instanceof HTMLElement)) {
+        console.warn('dlsjs: requestFullscreen 参数必须是有效的HTML元素');
+        return false;
+    }
+
+    try {
+        // 处理不同浏览器的全屏API
+        const requestMethod =
+            element.requestFullscreen ||
+            element.webkitRequestFullscreen ||
+            element.mozRequestFullScreen ||
+            element.msRequestFullscreen;
+
+        if (requestMethod) {
+            requestMethod.call(element);
+            return true;
+        } else {
+            console.warn('dlsjs: 当前浏览器不支持全屏API');
+            return false;
+        }
+    } catch (error) {
+        console.error('dlsjs: 全屏请求失败:', error);
+        return false;
+    }
+}
+
+/**
+ * 退出全屏模式
+ * 时间复杂度O(1)：直接调用浏览器API，无循环操作
+ *
+ * @returns {boolean} 操作是否成功发起
+ *
+ * @example
+ * exitFullscreen();
+ */
+export function exitFullscreen() {
+    try {
+        // 处理不同浏览器的退出全屏API
+        const exitMethod =
+            document.exitFullscreen ||
+            document.webkitExitFullscreen ||
+            document.mozCancelFullScreen ||
+            document.msExitFullscreen;
+
+        if (exitMethod) {
+            exitMethod.call(document);
+            return true;
+        } else {
+            console.warn('dlsjs: 当前浏览器不支持退出全屏API');
+            return false;
+        }
+    } catch (error) {
+        console.error('dlsjs: 退出全屏失败:', error);
+        return false;
+    }
+}
+
+/**
+ * 检查当前是否处于全屏模式
+ * 时间复杂度O(1)：直接访问浏览器属性，无循环操作
+ *
+ * @returns {boolean} 当前是否处于全屏模式
+ *
+ * @example
+ * if (isFullscreenActive()) {
+ *     console.log('当前处于全屏模式');
+ * }
+ */
+export function isFullscreenActive() {
+    return !!(
+        document.fullscreenElement ||
+        document.webkitFullscreenElement ||
+        document.mozFullScreenElement ||
+        document.msFullscreenElement
+    );
+}
+
+/**
+ * 获取当前全屏元素
+ * 时间复杂度O(1)：直接访问浏览器属性，无循环操作
+ *
+ * @returns {HTMLElement|null} 当前全屏元素，如果没有则返回null
+ *
+ * @example
+ * const fullscreenElement = getFullscreenElement();
+ */
+export function getFullscreenElement() {
+    return (
+        document.fullscreenElement ||
+        document.webkitFullscreenElement ||
+        document.mozFullScreenElement ||
+        document.msFullscreenElement ||
+        null
+    );
+}
+
+/**
+ * 添加全屏状态变化监听器
+ * 时间复杂度O(1)：直接添加事件监听器，无循环操作
+ *
+ * @param {Function} callback - 状态变化时的回调函数
+ * @returns {Function} 移除监听器的函数
+ *
+ * @example
+ * const removeListener = addFullscreenChangeListener(() => {
+ *     console.log('全屏状态发生变化');
+ * });
+ *
+ * // 稍后移除监听器
+ * removeListener();
+ */
+export function addFullscreenChangeListener(callback) {
+    if (typeof callback !== 'function') {
+        console.warn('dlsjs: addFullscreenChangeListener 参数必须是函数');
+        return () => {};
+    }
+
+    const eventName =
+        'fullscreenchange' in document ? 'fullscreenchange' :
+        'webkitfullscreenchange' in document ? 'webkitfullscreenchange' :
+        'mozfullscreenchange' in document ? 'mozfullscreenchange' :
+        'MSFullscreenChange' in document ? 'MSFullscreenChange' : null;
+
+    if (!eventName) {
+        console.warn('dlsjs: 当前浏览器不支持全屏变化事件');
+        return () => {};
+    }
+
+    const handler = () => callback(isFullscreenActive());
+    document.addEventListener(eventName, handler);
+
+    // 返回移除监听器的函数
+    return () => {
+        document.removeEventListener(eventName, handler);
+    };
+}

package/src/{core/Browser → Browser}/Timer.js

@@ -97,7 +97,3 @@ export class Poll {
         this.timer = null
     }
 }
-
-export default {
-    waitValue, Poll, lazyChange, throttleAsync, debounceAsync
-}