@alemonjs/qq-bot 2.1.40 → 2.1.41

package/lib/index.d.ts

@@ -6,7 +6,8 @@ import { QQBotAPI } from "./sdk/api.js";
 import { useClient, useMode, useValue } from "./hook.js";
 import { QQBotGroupEventMap } from "./sdk/message.group.js";
 import { QQBotPublicEventMap } from "./sdk/message.public.js";
+import { QQMarkdown, QQMarkdownMathOptions, QQMarkdownTask } from "./markdown.js";
 //#region src/index.d.ts
 declare const _default: () => any;
 //#endregion
-export { QQBotAPI as API, type ApiRequestData, type ButtonType, type FileType, type GlobalMuteRule, type GroupAction, type JoinApprovalStrategy, type JoinRequest, type KeyboardType, type MarkdownType, type MemberMuteState, type MessageType, type Options, type QQBotArkData, type QQBotAttachment, type QQBotBlacklistUser, type QQBotGroupEventMap, type QQBotGroupMember, type QQBotInteractionResolved, type QQBotMenu, type QQBotMenuItem, type QQBotMessageContent, type QQBotMessageElement, type QQBotMessageResult, type QQBotMessageUser, type QQBotPage, type QQBotPanel, type QQBotPanelCreate, type QQBotPanelRecord, type QQBotPanelScope, type QQBotPublicEventMap, type QQTextSanitizerOptions, type SetMemberMuteState, type StreamMessageData, type StreamMessageResult, type UploadConfig, type UploadPart, type UploadPartFinishData, type UploadPrepareData, type UploadPrepareResult, type VerifyInfo, _default as default, platform, sanitizeQQText, useClient, useMode, useValue };
+export { QQBotAPI as API, type ApiRequestData, type ButtonType, type FileType, type GlobalMuteRule, type GroupAction, type JoinApprovalStrategy, type JoinRequest, type KeyboardType, type MarkdownType, type MemberMuteState, type MessageType, type Options, type QQBotArkData, type QQBotAttachment, type QQBotBlacklistUser, type QQBotGroupEventMap, type QQBotGroupMember, type QQBotInteractionResolved, type QQBotMenu, type QQBotMenuItem, type QQBotMessageContent, type QQBotMessageElement, type QQBotMessageResult, type QQBotMessageUser, type QQBotPage, type QQBotPanel, type QQBotPanelCreate, type QQBotPanelRecord, type QQBotPanelScope, type QQBotPublicEventMap, QQMarkdown, type QQMarkdownMathOptions, type QQMarkdownTask, type QQTextSanitizerOptions, type SetMemberMuteState, type StreamMessageData, type StreamMessageResult, type UploadConfig, type UploadPart, type UploadPartFinishData, type UploadPrepareData, type UploadPrepareResult, type VerifyInfo, _default as default, platform, sanitizeQQText, useClient, useMode, useValue };

package/lib/index.js

@@ -4,6 +4,7 @@ import { QQBotAPI } from "./sdk/api.js";
 import { start } from "./index.websoket.js";
 import { useClient, useMode, useValue } from "./hook.js";
 import { start as start$1 } from "./index.webhook.js";
+import { QQMarkdown } from "./markdown.js";
 import { definePlatform } from "alemonjs";
 
 //#region src/index.ts
@@ -15,4 +16,4 @@ const main = () => {
 var src_default = definePlatform({ main });
 
 //#endregion
-export { QQBotAPI as API, src_default as default, platform, sanitizeQQText, useClient, useMode, useValue };
+export { QQBotAPI as API, QQMarkdown, src_default as default, platform, sanitizeQQText, useClient, useMode, useValue };

package/lib/markdown.d.ts

@@ -0,0 +1,25 @@
+//#region src/markdown.d.ts
+/** QQ Markdown 专用扩展。仅生成字符串，不扩展 alemonjs 的通用节点或渲染协议。 */
+type QQMarkdownMathOptions = {
+  block?: boolean;
+};
+type QQMarkdownTask = {
+  text: string;
+  checked?: boolean;
+};
+declare const math: (latex: string, options?: QQMarkdownMathOptions) => string;
+/**
+ * 仅用于支持这些扩展的 QQ Markdown 消息；通过 addContent() 或原始 Markdown 发送。
+ * 不提供跨平台渲染或自动降级，调用方应根据发送平台选择内容。
+ */
+declare const QQMarkdown: {
+  math: typeof math;
+  taskList(...items: QQMarkdownTask[]): string;
+  underline(text: string): string;
+  color(text: string, color: string): string;
+  ruby(text: string, annotation: string): string;
+  boxed(text: string): string;
+  cancel(text: string): string;
+};
+//#endregion
+export { QQMarkdown, QQMarkdownMathOptions, QQMarkdownTask };

package/lib/markdown.js

@@ -0,0 +1,47 @@
+//#region src/markdown.ts
+const latexText = (text) => {
+	const escapes = {
+		"\\": "\\textbackslash{}",
+		"{": "\\{",
+		"}": "\\}",
+		$: "\\$",
+		"&": "\\&",
+		"#": "\\#",
+		"%": "\\%",
+		_: "\\_",
+		"^": "\\textasciicircum{}",
+		"~": "\\textasciitilde{}"
+	};
+	return `\\text{${text.replace(/[\\{}$&#%_^~]/g, (character) => escapes[character]).replace(/\r\n?|\n/g, " ")}}`;
+};
+const math = (latex, options) => options?.block ? `\n\n$$\n${latex}\n$$\n\n` : `$${latex}$`;
+/**
+* 仅用于支持这些扩展的 QQ Markdown 消息；通过 addContent() 或原始 Markdown 发送。
+* 不提供跨平台渲染或自动降级，调用方应根据发送平台选择内容。
+*/
+const QQMarkdown = {
+	math,
+	taskList(...items) {
+		if (items.length === 0) return "";
+		return "\n\n" + items.map((item) => `- [${item.checked ? "x" : " "}] ${item.text.replace(/\r\n?|\n/g, " ")}`).join("\n") + "\n\n";
+	},
+	underline(text) {
+		return math(`\\underline{${latexText(text)}}`);
+	},
+	color(text, color) {
+		if (!/^(?:[a-zA-Z]+|#[0-9a-fA-F]{3}(?:[0-9a-fA-F]{3})?)$/.test(color)) throw new TypeError("QQ Markdown color must be a color name or #RGB / #RRGGBB");
+		return math(`\\color{${color}}{${latexText(text)}}`);
+	},
+	ruby(text, annotation) {
+		return math(`\\overset{${latexText(annotation)}}{${latexText(text)}}`);
+	},
+	boxed(text) {
+		return math(`\\boxed{${latexText(text)}}`);
+	},
+	cancel(text) {
+		return math(`\\cancel{${latexText(text)}}`);
+	}
+};
+
+//#endregion
+export { QQMarkdown };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alemonjs/qq-bot",
-  "version": "2.1.40",
+  "version": "2.1.41",
   "description": "QQ官方平台",
   "author": "lemonade",
   "license": "MIT",
@@ -12,13 +12,14 @@
     "test:send": "yarn build && node tests/use-send.notice.mjs",
     "test:channel": "yarn --cwd ../alemonjs build && yarn build && node tests/channel.contract.mjs",
     "test:qr": "yarn build && node tests/qr-auth.mjs",
-    "test:non-channel": "yarn build && node tests/markdown-buttons.contract.mjs && node tests/non-channel.contract.mjs && node tests/framework.contract.mjs && node tests/non-channel.transport.mjs && node tests/media-upload.contract.mjs && node tests/routing.contract.mjs && node tests/lifecycle.contract.mjs && node tests/http-diagnostics.contract.mjs && node tests/webhook-ingress.contract.mjs && node tests/text-sanitizer.contract.mjs && tsc -p tests/tsconfig.non-channel.json",
+    "test:non-channel": "yarn build && node tests/markdown-buttons.contract.mjs && node tests/markdown-extension.contract.mjs && node tests/non-channel.contract.mjs && node tests/framework.contract.mjs && node tests/non-channel.transport.mjs && node tests/media-upload.contract.mjs && node tests/routing.contract.mjs && node tests/lifecycle.contract.mjs && node tests/http-diagnostics.contract.mjs && node tests/webhook-ingress.contract.mjs && node tests/text-sanitizer.contract.mjs && tsc -p tests/tsconfig.non-channel.json",
     "docs:snapshot": "python3 scripts/snapshot-official.py",
     "test:http": "yarn build && node tests/http-diagnostics.contract.mjs && node tests/webhook-ingress.contract.mjs",
     "test:text": "yarn build && node tests/text-sanitizer.contract.mjs",
     "test:materials": "yarn build && node tests/materials.contract.mjs",
     "test:mention": "yarn build && node tests/everyone.contract.mjs",
-    "test:buttons": "yarn build && node tests/markdown-buttons.contract.mjs"
+    "test:buttons": "yarn build && node tests/markdown-buttons.contract.mjs",
+    "test:markdown-extension": "yarn build && node tests/markdown-extension.contract.mjs && node ../../node_modules/typescript/bin/tsc --noEmit --strict --skipLibCheck --module ESNext --moduleResolution Bundler --target ES2022 tests/markdown-extension.types.ts"
   },
   "dependencies": {
     "@noble/curves": "^1.7.0",
@@ -45,7 +46,12 @@
       "require": "./lib/index.js"
     },
     "./package": "./package.json",
-    "./desktop": "./lib/desktop.js"
+    "./desktop": "./lib/desktop.js",
+    "./markdown": {
+      "types": "./lib/markdown.d.ts",
+      "import": "./lib/markdown.js",
+      "require": "./lib/markdown.js"
+    }
   },
   "alemonjs": {
     "config": [