ph-utils 0.16.2 → 0.16.4

package/lib/array.d.ts

@@ -59,14 +59,14 @@ export declare function symmetricDifference<T>(...arrs: T[][]): T[];
  * @param a2
  * @returns
  */
-export declare function isSubsetOf<T>(a1: T[] | Set<T>, a2: T[] | Set<T>): any;
+export declare function isSubsetOf<T>(a1: T[] | Set<T>, a2: T[] | Set<T>): boolean;
 /**
  * 返回一个布尔值，指示给定集合中的所有元素是否都在此集合中。
  * @param arr1
  * @param arr2
  * @returns
  */
-export declare function isSupersetOf<T>(arr1: T[] | Set<T>, arr2: T[] | Set<T>): any;
+export declare function isSupersetOf<T>(arr1: T[] | Set<T>, arr2: T[] | Set<T>): boolean;
 /**
  * 返回一个布尔值，指示此集合是否与给定集合没有公共元素。
  *
@@ -76,4 +76,4 @@ export declare function isSupersetOf<T>(arr1: T[] | Set<T>, arr2: T[] | Set<T>):
  * @param arr2
  * @returns
  */
-export declare function isDisjointFrom<T>(arr1: T[] | Set<T>, arr2: T[] | Set<T>): any;
+export declare function isDisjointFrom<T>(arr1: T[] | Set<T>, arr2: T[] | Set<T>): boolean;

package/lib/crypto.d.ts

@@ -12,7 +12,7 @@ export declare function bufferToHex(bf: ArrayBuffer | Uint8Array, upper?: boolea
  * @param algorithm   hash算法, 支持: SHA-1、SHA-256、SHA-384、SHA-512; 默认为: SHA-256
  * @returns
  */
-export declare function sha(message: string, upper?: boolean, algorithm?: string): Promise<string>;
+export declare function sha(message: string | ArrayBuffer, upper?: boolean, algorithm?: string): Promise<string>;
 /**
  * 哈希算法
  * @param message     待进行 hash 的数据
@@ -20,7 +20,7 @@ export declare function sha(message: string, upper?: boolean, algorithm?: string
  * @param algorithm   hash算法, 支持: SHA-1、SHA-256、SHA-384、SHA-512; 默认为: SHA-256
  * @returns
  */
-export declare function hash(message: string, upper?: boolean, algorithm?: string): Promise<string>;
+export declare function hash(message: string | ArrayBuffer, upper?: boolean, algorithm?: string): Promise<string>;
 type HMACAlgorithm = "SHA-256" | "SHA-512";
 /**
  * 使用 HMAC 算法计算消息的哈希值

package/lib/crypto.js

@@ -59,8 +59,11 @@ function base64ToBuffer(data) {
  * @returns
  */
 export async function sha(message, upper = false, algorithm = "SHA-256") {
-    const msgUint8 = new TextEncoder().encode(message);
-    const hashBuffer = await globalThis.crypto.subtle.digest(algorithm || "SHA-256", msgUint8);
+    let msgBuffer = message;
+    if (typeof message === "string") {
+        msgBuffer = new TextEncoder().encode(message);
+    }
+    const hashBuffer = await globalThis.crypto.subtle.digest(algorithm || "SHA-256", msgBuffer);
     return bufferToHex(hashBuffer, upper);
 }
 /**
@@ -190,7 +193,7 @@ export async function aesEncrypt(message, key, encode = "hex", iv = null) {
     else if (typeof iv === "string") {
         iv = hexToBuffer(iv);
     }
-    const encodeData = await encrypt({ ...algorithm, iv }, cryptoKey, message, encode);
+    const encodeData = await encrypt({ ...algorithm, iv: iv }, cryptoKey, message, encode);
     ciphertext = encodeData;
     resIv = bufferToHex(iv);
     return { ciphertext, iv: resIv, key };

package/lib/crypto_node.d.ts

@@ -43,7 +43,7 @@ export declare function aesEncrypt(key: string, input: string, upper?: boolean):
  * @param iv    向量
  * @returns
  */
-export declare function aesDecrypt(input: string, key: string, iv: string): string;
+export declare function aesDecrypt(input: string, key: string | Buffer, iv?: string | Buffer, algorithm?: string): string;
 /**
  * RSA 公钥加密
  * @param input 待加密字符串

package/lib/crypto_node.js

@@ -73,6 +73,16 @@ export function aesEncrypt(key, input, upper = false) {
         iv.toString("hex"),
     ];
 }
+function aesAlgorithm(key) {
+    if (key.startsWith("aes-"))
+        return key;
+    let prefix = "aes-";
+    // 如果 key 不是以数字开头，则加上数字，例如：128，256 等
+    if (!/^\d/.test(key)) {
+        prefix += "256-";
+    }
+    return `${prefix}${key}`;
+}
 /**
  * AES 解密
  * @param input 加密后的数据
@@ -80,8 +90,19 @@ export function aesEncrypt(key, input, upper = false) {
  * @param iv    向量
  * @returns
  */
-export function aesDecrypt(input, key, iv) {
-    const cipher = createDecipheriv("aes-256-cbc", Buffer.from(key, "hex"), Buffer.from(iv, "hex"));
+export function aesDecrypt(input, key, iv, algorithm = "aes-256-cbc") {
+    let ivBuffer = null;
+    if (iv && !Buffer.isBuffer(iv)) {
+        ivBuffer = Buffer.from(iv, "hex");
+    }
+    let keyBuffer;
+    if (Buffer.isBuffer(key)) {
+        keyBuffer = key;
+    }
+    else {
+        keyBuffer = Buffer.from(key, "hex");
+    }
+    const cipher = createDecipheriv(aesAlgorithm(algorithm), keyBuffer, ivBuffer);
     let decryptedData = cipher.update(input, "hex", "utf-8");
     decryptedData += cipher.final("utf-8");
     return decryptedData;

package/lib/dom.d.ts

@@ -10,14 +10,14 @@
 type FormatStyleParam = (string | undefined | null)[] | Record<string, boolean | string | undefined | null> | string;
 type FormatClassParam = (string | undefined | null | boolean)[] | Record<string, boolean | string | undefined | null | boolean> | string;
 type DocumentContext = HTMLElement | ShadowRoot | Document;
-export declare function elem(selector: string | HTMLElement, dom?: DocumentContext): NodeListOf<HTMLElement> | HTMLElement[];
+export declare function elem(selector: string | HTMLElement, dom?: DocumentContext): HTMLElement[];
 /**
  * 根据选择器获取 DOM 元素。
  * @param selector - 选择器字符串或 HTMLElement 实例。
  * @param dom - 可选参数，指定在哪个 DOM 节点下查找元素，默认为 document。
  * @returns 返回匹配到的 HTMLElement 实例。
  */
-export declare function $(selector: string | HTMLElement, dom?: DocumentContext): NodeListOf<HTMLElement> | HTMLElement[];
+export declare function $(selector: string | HTMLElement, dom?: DocumentContext): HTMLElement[];
 /**
  * 创建一个 HTML 元素，支持通过标签名或 HTML 字符串创建。
  * @param tag - 元素标签名或 HTML 字符串。
@@ -46,7 +46,7 @@ export declare function $$(tag: string, option?: {
  * 根据选择器获取匹配的第一个 DOM 元素。
  * @param selector - 选择器字符串或直接的 HTMLElement。
  * @param dom - 可选的父级 DOM 元素，默认为当前文档。
- * @returns 返回匹配的第一个 HTMLElement，如果没有找到则返回 undefined。
+ * @returns 返回匹配的第一个 HTMLElement，如果没有找到则返回 null。
  */
 export declare function $one(selector: string | HTMLElement, dom?: DocumentContext): HTMLElement | null;
 /**
@@ -75,14 +75,15 @@ export declare function hasClass(elem: HTMLElement, clazz: string): boolean;
  * @param clazz - 要切换的类名。
  */
 export declare function toggleClass(el: HTMLElement, clazz: string): void;
+type EventHandler = EventListenerOrEventListenerObject | ((e: CustomEvent) => void);
 /**
  * 为节点添加事件处理
  * @param {HTMLElement} element   添加事件的节点
  * @param {string}      listener  事件名称
- * @param {function}    event     事件处理函数
- * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
+ * @param {function}    fn     事件处理函数
+ * @param {boolean}     option  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
-export declare function on(element: HTMLElement | ShadowRoot | Document | HTMLCollection | NodeListOf<HTMLElement> | HTMLElement[], listener: string, fn: EventListener, option?: boolean | (AddEventListenerOptions & {
+export declare function on(element: HTMLElement | ShadowRoot | Document | HTMLCollection | NodeListOf<HTMLElement> | HTMLElement[], listener: string, fn: EventHandler, option?: boolean | (AddEventListenerOptions & {
     eventFlag?: string;
 })): void;
 /**
@@ -91,7 +92,7 @@ export declare function on(element: HTMLElement | ShadowRoot | Document | HTMLCo
  * @param listener - 事件名称。
  * @param fn - 要移除的事件监听器函数。
  */
-export declare function off(el: HTMLElement | ShadowRoot | Document | HTMLCollection | NodeListOf<HTMLElement> | HTMLElement[], listener: string, fn: EventListener, option?: boolean | EventListenerOptions): void;
+export declare function off(el: HTMLElement | ShadowRoot | Document | HTMLCollection | NodeListOf<HTMLElement> | HTMLElement[], listener: string, fn: EventHandler, option?: boolean | EventListenerOptions): void;
 /**
  * 判断事件是否应该继续传递。
  * 从事件目标开始向上遍历DOM树，检查每个节点上是否存在指定的属性。
@@ -118,7 +119,7 @@ export declare function html(element: HTMLElement, htmlstr?: string): string | u
  * @param textstr 可选，如果传递该参数，则表示设置；否则表示获取
  * @returns
  */
-export declare function text(element: HTMLElement, textstr?: string): string | null | undefined;
+export declare function text(element: HTMLElement, textstr?: string): string | undefined;
 export declare function iterate<T>(elems: T[], fn: (el: T, index: number) => any): void;
 export declare function iterate(elems: NodeList | HTMLCollection | NodeListOf<HTMLElement>, fn: (el: HTMLElement, index: number) => any): void;
 /**

package/lib/dom.js

@@ -55,7 +55,7 @@ export function create(tag, option = {}, ctx) {
                     if (value === true) {
                         $el.setAttribute(key, "");
                     }
-                    else if (typeof value === "string") {
+                    else {
                         $el.setAttribute(key, value);
                     }
                 }
@@ -75,7 +75,7 @@ export function $$(tag, option = {}, ctx) {
  * 根据选择器获取匹配的第一个 DOM 元素。
  * @param selector - 选择器字符串或直接的 HTMLElement。
  * @param dom - 可选的父级 DOM 元素，默认为当前文档。
- * @returns 返回匹配的第一个 HTMLElement，如果没有找到则返回 undefined。
+ * @returns 返回匹配的第一个 HTMLElement，如果没有找到则返回 null。
  */
 export function $one(selector, dom) {
     if (typeof selector === "string") {
@@ -126,8 +126,8 @@ export function toggleClass(el, clazz) {
  * 为节点添加事件处理
  * @param {HTMLElement} element   添加事件的节点
  * @param {string}      listener  事件名称
- * @param {function}    event     事件处理函数
- * @param {boolean}     onceOrConfig  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
+ * @param {function}    fn     事件处理函数
+ * @param {boolean}     option  是否是只运行一次的处理函数或者配置，其中 eventFlag 为 string，如果配置该项，则表明为委托事件
  */
 export function on(element, listener, fn, option) {
     if (element.length != null) {
@@ -527,7 +527,7 @@ export function transition(el, nameOrProperties, dir = "enter", finish) {
             });
         }
     }
-    el.addEventListener("transitionend", (_e) => {
+    el.addEventListener("transitionend", () => {
         if (status === 0) {
             status = 1;
             if (nameClass) {

package/lib/file.js

@@ -41,7 +41,7 @@ export async function write(file, data, opts) {
     if (opts.json === true && typeof data === "object") {
         writeData = JSON.stringify(data, null, opts.format === true ? 2 : 0);
     }
-    return await fs.writeFile(path.resolve(file), writeData);
+    await fs.writeFile(path.resolve(file), writeData);
 }
 /**
  * 根据文件的 stat 获取文件的 etag

package/lib/id.d.ts

@@ -1,3 +1,12 @@
+type SnowflakeIDInfo = {
+    value: string;
+    timeOffset: bigint;
+    timestamp: number;
+    machineId: bigint;
+    sequence: bigint;
+    epoch: number;
+    version: string | undefined;
+};
 /** 雪花ID, 推荐在全局构造一个对象用于生成id */
 export declare class SnowflakeID {
     /** 机器码, 默认为: 1 */
@@ -24,15 +33,7 @@ export declare class SnowflakeID {
      * @throws 如果时钟回退，抛出错误
      */
     generate(): string;
-    parse(snowflakeID: string, epoch?: number, includeVersion?: boolean): {
-        value: string;
-        timeOffset: bigint;
-        timestamp: number;
-        machineId: bigint;
-        sequence: bigint;
-        epoch: number;
-        version: string | undefined;
-    };
+    parse(snowflakeID: string, epoch?: number, includeVersion?: boolean): SnowflakeIDInfo;
 }
 /** 将uuid转换为更简单的唯一标记id */
 export declare class ShortUUID {
@@ -64,3 +65,4 @@ export declare class ShortUUID {
     private _uuidHexToInt;
     private _uuidIntToHex;
 }
+export {};

package/lib/id.js

@@ -76,7 +76,7 @@ export class SnowflakeID {
             machineId: machineId,
             sequence: sequence,
             epoch: epochTime,
-            version,
+            version: version,
         };
     }
 }

package/lib/logger.js

@@ -1,4 +1,4 @@
-import { format } from "./date";
+import { format } from "./date.js";
 /**
  * 日志记录器
  */

package/lib/server.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="node" />
-import type { SpawnOptions } from "node:child_process";
+import type { SpawnOptionsWithoutStdio } from "node:child_process";
 /**
  * 执行命令
  * @param command 待执行的命令
@@ -17,3 +16,18 @@ export declare function exec(command: string, args?: string[], options?: SpawnOp
     stdout: string;
     stderr: string;
 }>;
+type SpawnOptions = SpawnOptionsWithoutStdio & {
+    shell?: 'powershell';
+};
+/**
+ * 执行命令并返回执行结果的Promise
+ * @param command 要执行的命令
+ * @param args 命令参数数组
+ * @param options 执行选项，支持指定shell类型
+ * @returns Promise对象，成功时resolve包含stdout和stderr的对象，失败时reject包含错误信息
+ */
+export declare function spawn(command: string, args?: string[], options?: SpawnOptions): Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export {};

package/lib/server.js

@@ -1,4 +1,4 @@
-import { execFile } from "node:child_process";
+import { execFile, spawn as spawnOri } from "node:child_process";
 import { promisify } from "node:util";
 const execFilePromise = promisify(execFile);
 /**
@@ -27,3 +27,39 @@ export function exec(command, ...params) {
     }
     return execFilePromise(cmd, argvs, opts);
 }
+/**
+ * 执行命令并返回执行结果的Promise
+ * @param command 要执行的命令
+ * @param args 命令参数数组
+ * @param options 执行选项，支持指定shell类型
+ * @returns Promise对象，成功时resolve包含stdout和stderr的对象，失败时reject包含错误信息
+ */
+export function spawn(command, args, options = {}) {
+    return new Promise((resolve, reject) => {
+        let execArgs = [];
+        let cmd;
+        // 根据是否指定powershell shell来设置实际执行的命令和参数
+        if (options.shell === 'powershell') {
+            cmd = 'powershell.exe';
+            execArgs = ['-NoProfile', '-Command', command, ...(args || [])];
+        }
+        else {
+            cmd = command;
+            execArgs = args || [];
+        }
+        delete options.shell;
+        const child = spawnOri(cmd, execArgs, options);
+        let stdout = '', stderr = '';
+        child.stdout.on('data', d => stdout += d);
+        child.stderr.on('data', d => stderr += d);
+        // 监听子进程关闭事件，根据退出码决定resolve或reject
+        child.on('close', code => {
+            if (code === 0)
+                resolve({ stdout, stderr });
+            else
+                reject(new Error(`spawn failed (${code}): ${stderr}`));
+        });
+        // 监听子进程错误事件，发生错误时直接reject
+        child.on('error', reject);
+    });
+}

package/lib/theme.d.ts

@@ -1,17 +1,17 @@
 /** 获取当前系统的主题 */
-export declare function getSystemTheme(): "dark" | "light" | "auto";
+export declare function getSystemTheme(): "light" | "dark" | "auto";
 /**
  * 初始化主题, 让网页能够适应系统主题, 同时根据缓存的主题切换主题
  * @returns 当前应用的主题
  */
-export declare function initTheme(): Promise<unknown>;
+export declare function initTheme(): Promise<"light" | "dark" | "auto">;
 /**
  * 切换主题, 通常用于预览
  * @param theme 切换的主题
  * @param transition 是否使用过渡动画, 注意浏览器必须支持 document.startViewTransition, 默认: true
  * @returns 切换后的主题
  */
-export declare function toggleTheme(theme?: "light" | "dark" | "auto", transition?: boolean): Promise<unknown>;
+export declare function toggleTheme(theme?: "light" | "dark" | "auto", transition?: boolean): Promise<"light" | "dark" | "auto">;
 /** 获取当前主题 */
 export declare function getTheme(): string;
 /**
@@ -21,7 +21,7 @@ export declare function getTheme(): string;
  * @param transition 是否使用过渡动画, 注意浏览器必须支持 document.startViewTransition, 默认: true
  * @returns 应用的主题
  */
-export declare function applyTheme(theme?: "light" | "dark" | "auto", cache?: boolean, transition?: boolean): Promise<unknown>;
+export declare function applyTheme(theme?: "light" | "dark" | "auto", cache?: boolean, transition?: boolean): Promise<"light" | "dark" | "auto">;
 /** 获取当前主题色 */
 export declare function getColorTheme(defaultValue?: string): string | undefined;
 /**

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.16.2",
+  "version": "0.16.4",
   "type": "module",
   "repository": {
     "type": "git",
@@ -95,8 +95,5 @@
     "date",
     "dom",
     "file"
-  ],
-  "scripts": {
-    "build": "node scripts/build.js"
-  }
+  ]
 }