@nsnanocat/util 2.6.7 → 2.6.9

package/README.md

@@ -655,9 +655,11 @@ console.log(value); // 1
 
 当前行为：
 - 当 `query` 为 `string` 时：
+  - 支持前导 `?`（会先去掉）。
   - 按 `&` / `=` 切分。
+  - key 与 value 都会先执行 URL 解码（`decodeURIComponent`，并将 `+` 视为空格）。
   - 去掉值中的双引号。
-  - 使用点路径或数组下标路径展开对象。
+  - 支持点路径、数组下标路径，以及方括号 key（如 `a[b]`）展开对象。
 - 当 `query` 为 `object` 时：
   - 将 key 当路径写入新对象（`{"a.b":"1"}` -> `{ a: { b: "1" } }`）。
 - 当 `query` 为 `null` 或 `undefined` 时：
@@ -669,6 +671,9 @@ import { qs } from "@nsnanocat/util";
 console.log(qs.parse("mode=on&a.b=1"));
 // { mode: "on", a: { b: "1" } }
 
+console.log(qs.parse("a%5Bb%5D=c%20d"));
+// { a: { b: "c d" } }
+
 console.log(qs.parse({ "list[0]": "x", "list[1]": "y" }));
 // { list: ["x", "y"] }
 ```

package/lib/notification.mjs

@@ -1,5 +1,5 @@
-import { $app } from "./app.mjs";
 import { Console } from "../polyfill/Console.mjs";
+import { $app } from "./app.mjs";
 
 /**
  * 通知内容扩展参数。
@@ -42,6 +42,7 @@ import { Console } from "../polyfill/Console.mjs";
  */
 export function notification(title = `ℹ️ ${$app} 通知`, subtitle = "", body = "", content = {}) {
 	const mutableContent = MutableContent(content);
+	const bodyLines = body.split(/\r?\n/u);
 	switch ($app) {
 		case "Surge":
 		case "Loon":
@@ -59,7 +60,7 @@ export function notification(title = `ℹ️ ${$app} 通知`, subtitle = "", bod
 			break;
 	}
 	Console.group("📣 系统通知");
-	Console.log(title, subtitle, body, JSON.stringify(mutableContent, null, 2));
+	Console.log(title, subtitle, bodyLines, JSON.stringify(mutableContent, null, 2));
 	Console.groupEnd();
 }
 

package/package.json

@@ -63,5 +63,5 @@
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
-  "version": "2.6.7"
+  "version": "2.6.9"
 }

package/polyfill/Console.d.ts

@@ -92,6 +92,11 @@ export class Console {
 	 * 输出普通日志。
 	 * Print standard log messages.
 	 *
+	 * 说明:
+	 * Notes:
+	 * - 顶层数组参数会按多个独立日志项展开。
+	 * - Top-level array arguments are expanded into multiple log entries.
+	 *
 	 * @param msg 日志内容 / Log payloads.
 	 */
 	static log(...msg: unknown[]): void;

package/polyfill/Console.mjs

@@ -224,11 +224,17 @@ export class Console {
 	 * 输出通用日志。
 	 * Print generic logs.
 	 *
+	 * 说明:
+	 * Notes:
+	 * - 顶层数组参数会按多个独立日志项展开。
+	 * - Top-level array arguments are expanded into multiple log entries.
+	 *
 	 * @param {...any} msg 日志内容 / Log messages.
 	 * @returns {void}
 	 */
 	static log = (...msg) => {
 		if (Console.#level === 0) return;
+		msg = msg.flatMap(log => (Array.isArray(log) ? log : [log]));
 		msg = msg.map(log => {
 			switch (typeof log) {
 				case "object":

package/polyfill/qs.mjs

@@ -31,7 +31,18 @@ export class qs {
 		let result = {};
 		switch (typeof query) {
 			case "string": {
-				const obj = Object.fromEntries(query.split("&").map(item => item.split("=", 2).map(i => i.replace(/\"/g, ""))));
+				const source = query.replace(/^\?/, "");
+				if (!source) break;
+				const obj = Object.fromEntries(
+					source
+						.split("&")
+						.filter(Boolean)
+						.map(item => {
+							const [rawKey = "", rawValue = ""] = item.split("=", 2);
+							const key = qs.#decode(rawKey).replace(/\[([^\[\]]+)\]/g, ".$1");
+							return [key, qs.#decode(rawValue).replace(/\"/g, "")];
+						}),
+				);
 				Object.keys(obj).forEach(key => _.set(result, key, obj[key]));
 				break;
 			}
@@ -139,4 +150,15 @@ export class qs {
 	static #encode(value) {
 		return encodeURIComponent(value);
 	}
+
+	/**
+	 * 解码查询字符串片段。
+	 * Decode a query-string fragment.
+	 *
+	 * @param {string} value 编码值 / Encoded value.
+	 * @returns {string}
+	 */
+	static #decode(value) {
+		return decodeURIComponent(value.replace(/\+/g, " "));
+	}
 }