ph-utils 0.9.13 → 0.9.14

package/README.md

@@ -1,7 +1,7 @@
-## ph-utils
-
-整理了 js 前后端开发(web + nodejs)时常用的一些工具；[详细文档](https://gitee.com/towardly/ph/wikis/Home?sort_id=4035190)
-
-### 包含如下工具文件
-
-`index` 基础工具类、`date` 跟日期相关的工具类、`file` 文件操作相关工具类[**服务端**]、`server` 服务端工具类、`validator` 数据验证、`dom` 浏览器节点操作相关[**前端**]、`web` 一些只适用于前端相关的工具、`color` 颜色相关工具
+## ph-utils
+
+整理了 js 前后端开发(web + nodejs)时常用的一些工具；[详细文档](https://gitee.com/towardly/ph/wikis/Home?sort_id=4035190)
+
+### 包含如下工具文件
+
+`index` 基础工具类、`date` 跟日期相关的工具类、`file` 文件操作相关工具类[**服务端**]、`server` 服务端工具类、`validator` 数据验证、`dom` 浏览器节点操作相关[**前端**]、`web` 一些只适用于前端相关的工具、`color` 颜色相关工具

package/lib/clipboard.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 复制数据, 可以从多种类型的数据
+ *    1. 直接复制文本: await copy("待复制的文本")
+ *    2. 复制节点上的 data-copy-text:
+ *      <button data-copy-text="这是待复制的文本">复制</button>
+ *      await copy(e.target) // or await copy("#a") or await copy(document.querySelector('#a'))
+ *    3. 直接复制节点本身数据: await copy('#a')
+ * @param {string | HTMLElement} source 复制源, 从中解析待复制的数据
+ * @returns {Promise<boolean>} 是否复制成功
+ */
+export declare function copy(source: string | HTMLElement): Promise<boolean>;

package/lib/clipboard.js

@@ -0,0 +1,101 @@
+/**
+ * 创建一个临时节点缓存待复制数据
+ * @param {String} value - 待复制文本
+ * @return {HTMLElement}
+ */
+function createFakeElement(value) {
+    const fakeElement = document.createElement("textarea");
+    fakeElement.style.border = "0";
+    fakeElement.style.padding = "0";
+    fakeElement.style.margin = "0";
+    fakeElement.style.position = "absolute";
+    fakeElement.style.left = "-9999px";
+    fakeElement.style.top = "-9999";
+    fakeElement.setAttribute("readonly", "");
+    fakeElement.value = value;
+    return fakeElement;
+}
+/** 通过执行 execCommand 来执行复制 */
+function copyFromCommand(text) {
+    // 添加节点
+    const fakeEl = createFakeElement(text);
+    document.body.append(fakeEl);
+    fakeEl.focus();
+    fakeEl.select();
+    // 执行复制
+    const res = document.execCommand("copy");
+    fakeEl.remove(); // 删除节点
+    return Promise.resolve(res);
+}
+/** 使用 navigator.clipboard 复制 */
+function copyFromClipboard(text) {
+    const theClipboard = navigator.clipboard;
+    if (theClipboard != null) {
+        return theClipboard
+            .writeText(text)
+            .then(() => {
+            Promise.resolve(true);
+        })
+            .catch(() => Promise.resolve(false));
+    }
+    return Promise.resolve(false);
+}
+/** 解析待复制的文本 */
+function parseCopyText(source) {
+    let copyText = null; // 待复制文本
+    let sourceEl = null;
+    // 获取待复制数据
+    if (typeof source === "string") {
+        // 从节点拿数据
+        if (source.startsWith("#") || source.startsWith(".")) {
+            sourceEl = document.querySelector(source);
+            if (sourceEl == null) {
+                copyText = source;
+            }
+        }
+        else {
+            copyText = source;
+        }
+    }
+    if (source instanceof HTMLElement) {
+        sourceEl = source;
+    }
+    // 从节点获取待复制数据
+    if (sourceEl != null) {
+        if (sourceEl.hasAttribute("data-copy-text")) {
+            copyText = sourceEl.getAttribute("data-copy-text");
+        }
+        else {
+            const tagName = sourceEl.tagName;
+            if (tagName === "INPUT" || tagName === "TEXTAREA") {
+                copyText = sourceEl.value;
+            }
+            else {
+                copyText = sourceEl.textContent;
+            }
+        }
+    }
+    return copyText;
+}
+/**
+ * 复制数据, 可以从多种类型的数据
+ *    1. 直接复制文本: await copy("待复制的文本")
+ *    2. 复制节点上的 data-copy-text:
+ *      <button data-copy-text="这是待复制的文本">复制</button>
+ *      await copy(e.target) // or await copy("#a") or await copy(document.querySelector('#a'))
+ *    3. 直接复制节点本身数据: await copy('#a')
+ * @param {string | HTMLElement} source 复制源, 从中解析待复制的数据
+ * @returns {Promise<boolean>} 是否复制成功
+ */
+export async function copy(source) {
+    // 待复制文本
+    const copyText = parseCopyText(source);
+    if (copyText == null) {
+        return Promise.resolve(false);
+    }
+    const v = await copyFromClipboard(copyText);
+    if (v === false) {
+        return copyFromCommand(copyText);
+    }
+    return Promise.resolve(true);
+}

package/lib/server.js

@@ -7,40 +7,42 @@ import { readFileSync } from "node:fs";
  * @returns
  */
 export function exec(command, ...params) {
-    let argvs = [];
-    const commandItems = command.split(" ");
-    const cmd = commandItems.shift();
-    if (commandItems.length > 0) {
-        argvs = commandItems;
+  let argvs = [];
+  const commandItems = command.split(" ");
+  const cmd = commandItems.shift();
+  if (commandItems.length > 0) {
+    argvs = commandItems;
+  }
+  let opts = {};
+  if (params[0] != null) {
+    if (params[0] instanceof Array) {
+      argvs.push(...params[0]);
+      if (params[1] != null) {
+        opts = params[1];
+      }
+    } else {
+      opts = params[0];
     }
-    let opts = { shell: true };
-    if (params[0] != null) {
-        if (params[0] instanceof Array) {
-            argvs.push(...params[0]);
-            if (params[1] != null) {
-                opts = params[1];
-            }
+  }
+  return new Promise((resolve, reject) => {
+    execFile(cmd, argvs, opts || {}, (err, stdout, stderr) => {
+      if (err) {
+        reject(err);
+      } else {
+        let msg = stdout || stderr;
+        if (
+          stderr != null &&
+          (stderr.includes("error") || stderr.includes("Error"))
+        ) {
+          const error = new Error(stderr);
+          error.type = "StdErr";
+          reject(error);
+        } else {
+          resolve(msg);
         }
-        else {
-            opts = params[0];
-        }
-    }
-    return new Promise((resolve, reject) => {
-        execFile(cmd, argvs, opts, (err, stdout, stderr) => {
-            if (err) {
-                reject(err);
-            }
-            else {
-                let msg = stdout || stderr;
-                if (msg.includes("error") || msg.includes("Error")) {
-                    const error = new Error(msg);
-                    error.type = "StdErr";
-                    reject(error);
-                }
-                resolve(msg);
-            }
-        });
+      }
     });
+  });
 }
 /**
  * 解析环境变量;
@@ -62,38 +64,37 @@ export function exec(command, ...params) {
  * @returns
  */
 export function parseEnvs() {
-    // development, test, production
-    const files = [".env", ".env.local"];
-    let nodeEnv = process.env.NODE_ENV;
-    const { values } = parseArgs({
-        options: {
-            NODE_ENV: {
-                type: "string",
-                short: "n",
-            },
-        },
-        strict: false,
-    });
-    if (values.NODE_ENV != null && typeof values.NODE_ENV === "string") {
-        nodeEnv = values.NODE_ENV;
-    }
-    if (nodeEnv == null) {
-        nodeEnv = "production";
-    }
-    process.env.NODE_ENV = nodeEnv;
-    files.push(`.env.${nodeEnv}`);
-    let envParsed = {};
-    for (let i = 0, len = files.length; i < len; i++) {
-        const file = files[i];
-        try {
-            const envContent = readFileSync(file, { encoding: "utf-8" });
-            const envValue = parseEnv(envContent);
-            envParsed = { ...envParsed, ...envValue };
-        }
-        catch (err) { }
-    }
-    for (const key in envParsed) {
-        process.env[key] = envParsed[key];
-    }
-    return envParsed;
+  // development, test, production
+  const files = [".env", ".env.local"];
+  let nodeEnv = process.env.NODE_ENV;
+  const { values } = parseArgs({
+    options: {
+      NODE_ENV: {
+        type: "string",
+        short: "n",
+      },
+    },
+    strict: false,
+  });
+  if (values.NODE_ENV != null && typeof values.NODE_ENV === "string") {
+    nodeEnv = values.NODE_ENV;
+  }
+  if (nodeEnv == null) {
+    nodeEnv = "production";
+  }
+  process.env.NODE_ENV = nodeEnv;
+  files.push(`.env.${nodeEnv}`);
+  let envParsed = {};
+  for (let i = 0, len = files.length; i < len; i++) {
+    const file = files[i];
+    try {
+      const envContent = readFileSync(file, { encoding: "utf-8" });
+      const envValue = parseEnv(envContent);
+      envParsed = { ...envParsed, ...envValue };
+    } catch (err) {}
+  }
+  for (const key in envParsed) {
+    process.env[key] = envParsed[key];
+  }
+  return envParsed;
 }

package/lib/theme.js

@@ -19,10 +19,10 @@ export async function initTheme() {
     if ($themeStyle == null) {
         $themeStyle = document.createElement("style");
         $themeStyle.id = "theme-style";
-        $themeStyle.innerHTML = `
-      :root{color-scheme:light dark;}
-      html.light{color-scheme: light;}
-      html.dark {color-scheme: dark;}
+        $themeStyle.innerHTML = `
+      :root{color-scheme:light dark;}
+      html.light{color-scheme: light;}
+      html.dark {color-scheme: dark;}
     `;
         document.head.appendChild($themeStyle);
     }

package/package.json

@@ -68,7 +68,7 @@
     },
     "./*": "./lib/*"
   },
-  "version": "0.9.13",
+  "version": "0.9.14",
   "type": "module",
   "repository": {
     "type": "git",