@zhin.js/core 1.3.2 → 1.3.4

package/lib/built/generic-segment-mapper.js

@@ -0,0 +1,232 @@
+import { createImageSegment, isMediaRef, mediaRefFromLegacyData, mediaRefToLegacyFields, readMentionTarget, } from './segment-contract/index.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readPlatform(seg) {
+    const platform = seg.platform;
+    return platform && typeof platform === 'object' ? platform : undefined;
+}
+function normalizeMention(seg) {
+    const data = seg.data;
+    const target = readMentionTarget(data);
+    const name = typeof data.name === 'string' && data.name ? data.name : undefined;
+    const platform = readPlatform(seg);
+    return {
+        type: 'mention',
+        data: name ? { target, name } : { target },
+        ...(platform ? { platform } : {}),
+    };
+}
+function normalizeImage(seg) {
+    const data = seg.data;
+    const platform = readPlatform(seg);
+    if (isMediaRef(data.media)) {
+        return {
+            type: 'image',
+            data: {
+                media: data.media,
+                ...(typeof data.alt === 'string' ? { alt: data.alt } : {}),
+            },
+            ...(platform ? { platform } : {}),
+        };
+    }
+    const media = mediaRefFromLegacyData(data);
+    if (media) {
+        const mergedPlatform = { ...(platform ?? {}) };
+        for (const key of ['url', 'file', 'src', 'file_id']) {
+            if (typeof data[key] === 'string' && data[key])
+                mergedPlatform[key] = data[key];
+        }
+        const platformKeys = Object.keys(mergedPlatform);
+        const legacyPlatform = platformKeys.length === 0
+            ? undefined
+            : platformKeys.length === 1 && mergedPlatform[platformKeys[0]] === media.value
+                ? undefined
+                : mergedPlatform;
+        return createImageSegment(media, {
+            alt: typeof data.alt === 'string' ? data.alt : undefined,
+            platform: legacyPlatform,
+        });
+    }
+    return seg;
+}
+function normalizeReply(seg) {
+    const data = seg.data;
+    const messageId = String(data.message_id ?? data.id ?? '').trim();
+    if (!messageId)
+        return seg;
+    return { type: 'reply', data: { message_id: messageId } };
+}
+function normalizeLink(seg) {
+    const data = seg.data;
+    const url = String(data.url ?? data.href ?? '').trim();
+    if (!url)
+        return seg;
+    const text = typeof data.text === 'string' && data.text ? data.text : undefined;
+    const platform = readPlatform(seg);
+    return {
+        type: 'link',
+        data: text ? { url, text } : { url },
+        ...(platform ? { platform } : {}),
+    };
+}
+function normalizeForward(seg) {
+    const data = seg.data;
+    const forwardId = String(data.forward_id ?? data.id ?? data.resid ?? '').trim();
+    if (!forwardId)
+        return seg;
+    const title = typeof data.title === 'string' ? data.title : undefined;
+    const messages = Array.isArray(data.messages) ? data.messages : undefined;
+    const platform = { ...(readPlatform(seg) ?? {}) };
+    if (data.resid != null)
+        platform.resid = String(data.resid);
+    return {
+        type: 'forward',
+        data: {
+            forward_id: forwardId,
+            ...(title ? { title } : {}),
+            ...(messages ? { messages: messages } : {}),
+        },
+        ...(Object.keys(platform).length ? { platform } : {}),
+    };
+}
+function isPlatformSticker(seg) {
+    if (seg.type !== 'sticker')
+        return false;
+    const data = seg.data;
+    return data.package_id != null
+        || data.sticker_id != null
+        || data.packageId != null
+        || data.stickerId != null;
+}
+function normalizeFace(seg) {
+    if (isPlatformSticker(seg))
+        return seg;
+    const data = seg.data;
+    const rawId = data.id ?? data.face_id;
+    const name = typeof data.name === 'string'
+        ? data.name
+        : typeof data.text === 'string'
+            ? data.text
+            : undefined;
+    const platform = readPlatform(seg);
+    return {
+        type: 'face',
+        data: {
+            ...(rawId != null ? { id: rawId } : {}),
+            ...(name ? { name } : {}),
+        },
+        ...(platform ? { platform } : {}),
+    };
+}
+function normalizeMarkdown(seg) {
+    const data = seg.data;
+    const content = typeof data.content === 'string'
+        ? data.content
+        : typeof data.text === 'string'
+            ? data.text
+            : '';
+    return { type: 'markdown', data: { content } };
+}
+function normalizeSegment(seg) {
+    if (seg.type === 'at' || seg.type === 'mention')
+        return normalizeMention(seg);
+    if (seg.type === 'image')
+        return normalizeImage(seg);
+    if (seg.type === 'reply')
+        return normalizeReply(seg);
+    if (seg.type === 'forward')
+        return normalizeForward(seg);
+    if (seg.type === 'sticker' && isPlatformSticker(seg))
+        return seg;
+    if (seg.type === 'face' || seg.type === 'sticker' || seg.type === 'emoji')
+        return normalizeFace(seg);
+    if (seg.type === 'link')
+        return normalizeLink(seg);
+    if (seg.type === 'markdown')
+        return normalizeMarkdown(seg);
+    return seg;
+}
+function asMessageSegments(content) {
+    return content.map((item) => {
+        if (typeof item === 'string')
+            return { type: 'text', data: { text: item } };
+        return item;
+    });
+}
+function asCanonicalSegments(content) {
+    if (typeof content === 'string') {
+        return [{ type: 'text', data: { text: content } }];
+    }
+    const items = Array.isArray(content) ? content : [content];
+    return items.map((item) => {
+        if (typeof item === 'string')
+            return { type: 'text', data: { text: item } };
+        return item;
+    });
+}
+/** 通用 IM adapter：legacy wire → canonical Segment[] */
+export function toCanonicalSegments(content) {
+    return asMessageSegments(content).map((seg) => normalizeSegment(seg));
+}
+function mapCanonicalToWire(seg) {
+    if (seg.type === 'image' && isRecord(seg.data) && seg.data.media) {
+        const media = seg.data.media;
+        const legacy = mediaRefToLegacyFields(media);
+        return {
+            type: 'image',
+            data: {
+                ...legacy,
+                media,
+                ...(typeof seg.data.alt === 'string' ? { alt: seg.data.alt } : {}),
+            },
+            ...(seg.platform ? { platform: seg.platform } : {}),
+        };
+    }
+    if (seg.type === 'mention') {
+        const data = seg.data;
+        return {
+            type: 'at',
+            data: {
+                id: data.target,
+                ...(data.name ? { name: data.name } : {}),
+            },
+            ...(seg.platform ? { platform: seg.platform } : {}),
+        };
+    }
+    if (seg.type === 'reply') {
+        const messageId = String(seg.data.message_id);
+        return {
+            type: 'reply',
+            data: { id: messageId, message_id: messageId },
+            ...(seg.platform ? { platform: seg.platform } : {}),
+        };
+    }
+    if (seg.type === 'forward') {
+        const data = seg.data;
+        const resid = seg.platform?.resid ?? data.forward_id;
+        return {
+            type: 'forward',
+            data: {
+                id: data.forward_id,
+                resid,
+                ...(data.title ? { title: data.title } : {}),
+                ...(data.messages ? { messages: data.messages } : {}),
+            },
+            ...(seg.platform ? { platform: seg.platform } : {}),
+        };
+    }
+    if (seg.type === 'link') {
+        const data = seg.data;
+        return {
+            type: 'link',
+            data: { url: data.url, ...(data.text ? { text: data.text } : {}) },
+            ...(seg.platform ? { platform: seg.platform } : {}),
+        };
+    }
+    return seg;
+}
+/** canonical → wire（mention→at；image MediaRef→legacy 字段） */
+export function fromCanonicalSegments(content) {
+    return asCanonicalSegments(content).map((seg) => mapCanonicalToWire(seg));
+}

package/lib/built/html-renderer-loader.d.ts

@@ -5,8 +5,9 @@ export interface LoadHtmlRendererOptions {
     getConfig?: () => Record<string, unknown> | undefined;
     warn?: (message: string) => void;
 }
+/** zhin 启动时已创建 renderer 时注入，避免 core 目录下 peer 解析失败 */
+export declare function seedHtmlRenderer(renderer: HtmlRendererForRichSegment): void;
 /** 动态加载 @zhin.js/html-renderer；未安装时 warn 一次并返回 undefined */
 export declare function loadHtmlRenderer(opts?: LoadHtmlRendererOptions): Promise<HtmlRendererForRichSegment | undefined>;
 /** 测试用：重置加载缓存 */
 export declare function resetHtmlRendererLoaderForTests(): void;
-//# sourceMappingURL=html-renderer-loader.d.ts.map

package/lib/built/html-renderer-loader.js

@@ -1,14 +1,19 @@
+import { importOptionalPeerPackage } from './optional-peer-import.js';
 /** 动态 import 时使用的包名（与 @zhin.js/html-renderer package.json 一致） */
 export const HTML_RENDERER_PACKAGE = '@zhin.js/html-renderer';
 let cached;
 let warned = false;
+/** zhin 启动时已创建 renderer 时注入，避免 core 目录下 peer 解析失败 */
+export function seedHtmlRenderer(renderer) {
+    cached = renderer;
+}
 /** 动态加载 @zhin.js/html-renderer；未安装时 warn 一次并返回 undefined */
 export async function loadHtmlRenderer(opts) {
     if (cached !== undefined) {
         return cached ?? undefined;
     }
     try {
-        const mod = await import(HTML_RENDERER_PACKAGE);
+        const mod = await importOptionalPeerPackage(HTML_RENDERER_PACKAGE);
         cached = mod.createHtmlRenderer(opts?.getConfig?.() ?? {});
         return cached;
     }
@@ -26,4 +31,3 @@ export function resetHtmlRendererLoaderForTests() {
     cached = undefined;
     warned = false;
 }
-//# sourceMappingURL=html-renderer-loader.js.map

package/lib/built/html-segment-fallback.d.ts

@@ -7,4 +7,3 @@ import type { SendContent } from '../types.js';
 export declare function coerceHtmlSegmentsToText(content: SendContent): SendContent;
 /** 注册链尾 before.sendMessage：将未转换的 html 段降级为 text */
 export declare function registerHtmlSegmentFallback(plugin: Plugin): () => void;
-//# sourceMappingURL=html-segment-fallback.d.ts.map

package/lib/built/html-segment-fallback.js

@@ -47,4 +47,3 @@ export function registerHtmlSegmentFallback(plugin) {
     plugin.root.on('before.sendMessage', handler);
     return () => plugin.root.off('before.sendMessage', handler);
 }
-//# sourceMappingURL=html-segment-fallback.js.map

package/lib/built/html-to-text.d.ts

@@ -14,4 +14,3 @@ export declare function htmlToPlainTextWithBlockBreaks(html: string, options?: H
  * HTML 卡片出站回退：块级换行 + 语义标题轻量 markdown 前缀。
  */
 export declare function htmlToFallbackText(html: string, options?: HtmlToPlainTextOptions): string;
-//# sourceMappingURL=html-to-text.d.ts.map

package/lib/built/html-to-text.js

@@ -79,20 +79,21 @@ function stripRemainingTags(html) {
     return out;
 }
 function decodeCommonEntities(text) {
-    return text
-        .replace(/ /gi, ' ')
-        .replace(/&/g, '&')
-        .replace(/&lt;/g, '<')
-        .replace(/&gt;/g, '>')
-        .replace(/&quot;/g, '"')
-        .replace(/&#39;/g, "'")
-        .replace(/&apos;/g, "'")
-        .replace(/&#(\d+);/g, (_, code) => {
-        const n = Number(code);
-        return Number.isFinite(n) && n >= 0 && n <= 0x10ffff ? String.fromCodePoint(n) : '';
-    })
-        .replace(/&#x([0-9a-fA-F]+);/g, (_, hex) => {
-        const n = parseInt(hex, 16);
+    return text.replace(/&(#x[0-9a-fA-F]+|#\d+|nbsp|amp|lt|gt|quot|apos);/gi, (entity) => {
+        const key = entity.slice(1, -1).toLowerCase();
+        if (key === 'nbsp')
+            return ' ';
+        if (key === 'amp')
+            return '&';
+        if (key === 'lt')
+            return '<';
+        if (key === 'gt')
+            return '>';
+        if (key === 'quot')
+            return '"';
+        if (key === 'apos')
+            return "'";
+        const n = key.startsWith('#x') ? parseInt(key.slice(2), 16) : Number(key.slice(1));
         return Number.isFinite(n) && n >= 0 && n <= 0x10ffff ? String.fromCodePoint(n) : '';
     });
 }
@@ -163,4 +164,3 @@ export function htmlToFallbackText(html, options) {
         .replace(/\n{3,}/g, '\n\n')
         .trim();
 }
-//# sourceMappingURL=html-to-text.js.map

package/lib/built/inbound-pipeline.d.ts

@@ -4,7 +4,7 @@
  * Extracted from Adapter.emit() override to improve testability and decoupling.
  * Handles: event routing, logging, backpressure, pipeline execution, observer emission.
  */
-import type { Logger } from '@zhin.js/logger';
+import { type Logger } from '@zhin.js/logger';
 import { type Message as MessageType } from '../message.js';
 import type { Plugin } from '../plugin.js';
 export interface InboundPipelineOptions {
@@ -35,4 +35,3 @@ export declare class InboundMessagePipeline {
     bridgeNoticeOrRequest(event: string, args: unknown[], directEmit: () => boolean): boolean;
     private logIncoming;
 }
-//# sourceMappingURL=inbound-pipeline.d.ts.map

package/lib/built/inbound-pipeline.js

@@ -54,7 +54,7 @@ export class InboundMessagePipeline {
         return result;
     }
     logIncoming(message) {
-        this.options.logger.info(formatCompact({
+        this.options.logger.debug(formatCompact({
             recv: `${message.$channel.type}(${message.$channel.id})`,
             endpoint: message.$endpoint,
             preview: truncatePreview(segment.raw(message.$content)),
@@ -62,4 +62,3 @@ export class InboundMessagePipeline {
         }));
     }
 }
-//# sourceMappingURL=inbound-pipeline.js.map

package/lib/built/inbound-runner.d.ts

@@ -20,4 +20,3 @@ export interface InboundRunResult {
  * Agent / 业务逻辑一致。
  */
 export declare function runInboundMessage(options: RunInboundMessageOptions): Promise<InboundRunResult>;
-//# sourceMappingURL=inbound-runner.d.ts.map

package/lib/built/inbound-runner.js

@@ -34,4 +34,3 @@ export async function runInboundMessage(options) {
     emitAdapterObservers();
     return { dispatched: !!dispatcher };
 }
-//# sourceMappingURL=inbound-runner.js.map

package/lib/built/interactive-segment-contract.d.ts

@@ -0,0 +1,6 @@
+import type { InteractivePolicy } from './interactive-segments/types.js';
+/** 契约测试：adapter 须声明 interactivePolicy */
+export declare function assertAdapterDeclaresInteractivePolicy(adapterClass: {
+    interactivePolicy?: InteractivePolicy;
+}): void;
+export type { InteractivePolicy };

package/lib/built/interactive-segment-contract.js

@@ -0,0 +1,9 @@
+/** 契约测试：adapter 须声明 interactivePolicy */
+export function assertAdapterDeclaresInteractivePolicy(adapterClass) {
+    if (!adapterClass.interactivePolicy) {
+        throw new Error('Adapter must declare static interactivePolicy');
+    }
+    if (adapterClass.interactivePolicy !== 'native' && adapterClass.interactivePolicy !== 'text') {
+        throw new Error('interactivePolicy must be "native" or "text"');
+    }
+}

package/lib/built/interactive-segments/action.d.ts

@@ -0,0 +1,17 @@
+import type { Message } from '../../message.js';
+import type { MessageElement } from '../../types.js';
+import { type ActionSegmentData } from './types.js';
+export declare function actionSegment(data: ActionSegmentData): MessageElement;
+export declare function getActionFromMessage(message: Message<any>): ActionSegmentData | undefined;
+/** 入站互动 action（按钮点击等），不应计入用户发言/消息统计 */
+export declare function isActionMessage(message: Message<any>): boolean;
+/** 去掉 @bot、XML at 段、首尾空白（QQ 指令预填文本归一化） */
+export declare function stripInteractiveCommandText(raw: string): string;
+/** 从文本降级输入解析 payload（需在 active session 的 fallback.map 中查找） */
+export declare function resolveTextFallbackPayload(raw: string, map: Record<string, string>): string | undefined;
+/**
+ * 从用户文本入站解析 interactive payload：
+ * 归一化 → 直接匹配 prefix:session:id → fallback 数字映射
+ */
+export declare function resolvePayloadFromText(raw: string, map?: Record<string, string>): string | undefined;
+export declare function formatActionAsRaw(data: ActionSegmentData): string;

package/lib/built/interactive-segments/action.js

@@ -0,0 +1,69 @@
+import { ACTION_SEGMENT_TYPE, isActionSegment, } from './types.js';
+export function actionSegment(data) {
+    return { type: ACTION_SEGMENT_TYPE, data };
+}
+export function getActionFromMessage(message) {
+    for (const item of message.$content ?? []) {
+        if (typeof item === 'string')
+            continue;
+        if (isActionSegment(item))
+            return item.data;
+    }
+    return undefined;
+}
+/** 入站互动 action（按钮点击等），不应计入用户发言/消息统计 */
+export function isActionMessage(message) {
+    return getActionFromMessage(message) != null;
+}
+const PAYLOAD_PATTERN = /^[a-z0-9_]+:[^:\s]+:[a-z0-9_-]+$/i;
+/** 去掉 @bot、XML at 段、首尾空白（QQ 指令预填文本归一化） */
+export function stripInteractiveCommandText(raw) {
+    let text = raw.trim();
+    text = stripXmlAtSegments(text);
+    text = text.replace(/^@\S+\s+/u, '');
+    text = text.replace(/\s+/g, ' ').trim();
+    return text;
+}
+function stripXmlAtSegments(text) {
+    let out = '';
+    let cursor = 0;
+    while (cursor < text.length) {
+        const start = text.toLowerCase().indexOf('<at ', cursor);
+        if (start < 0)
+            break;
+        const end = text.indexOf('/>', start + 4);
+        if (end < 0)
+            break;
+        out += text.slice(cursor, start) + ' ';
+        cursor = end + 2;
+    }
+    return out + text.slice(cursor);
+}
+/** 从文本降级输入解析 payload（需在 active session 的 fallback.map 中查找） */
+export function resolveTextFallbackPayload(raw, map) {
+    const trimmed = raw.trim();
+    if (map[trimmed])
+        return map[trimmed];
+    const match = trimmed.match(/^(?:ttt\s+)?(\d)$/i);
+    if (match && map[match[1]])
+        return map[match[1]];
+    return undefined;
+}
+/**
+ * 从用户文本入站解析 interactive payload：
+ * 归一化 → 直接匹配 prefix:session:id → fallback 数字映射
+ */
+export function resolvePayloadFromText(raw, map) {
+    const normalized = stripInteractiveCommandText(raw);
+    if (!normalized)
+        return undefined;
+    if (PAYLOAD_PATTERN.test(normalized))
+        return normalized;
+    if (map && Object.keys(map).length > 0) {
+        return resolveTextFallbackPayload(normalized, map);
+    }
+    return undefined;
+}
+export function formatActionAsRaw(data) {
+    return data.payload;
+}

package/lib/built/interactive-segments/button-spec.d.ts

@@ -0,0 +1,10 @@
+import type { ButtonData } from './types.js';
+/** 键盘布局单元：`segment.button()` 产物，仅用于组装 `segment.keyboard()` */
+export declare class ButtonSpec {
+    readonly data: ButtonData;
+    constructor(data: ButtonData);
+}
+export type KeyboardRowInput = Array<ButtonSpec | ButtonData>;
+export declare function isButtonLike(value: unknown): value is ButtonSpec | ButtonData;
+export declare function normalizeButton(btn: ButtonSpec | ButtonData): ButtonData;
+export declare function normalizeKeyboardRows(rows: KeyboardRowInput[]): ButtonData[][];

package/lib/built/interactive-segments/button-spec.js

@@ -0,0 +1,21 @@
+/** 键盘布局单元：`segment.button()` 产物，仅用于组装 `segment.keyboard()` */
+export class ButtonSpec {
+    data;
+    constructor(data) {
+        this.data = data;
+    }
+}
+export function isButtonLike(value) {
+    if (value == null || typeof value !== 'object')
+        return false;
+    if (value instanceof ButtonSpec)
+        return true;
+    const v = value;
+    return typeof v.id === 'string' && typeof v.label === 'string' && typeof v.payload === 'string';
+}
+export function normalizeButton(btn) {
+    return btn instanceof ButtonSpec ? btn.data : btn;
+}
+export function normalizeKeyboardRows(rows) {
+    return rows.map((row) => row.map(normalizeButton));
+}

package/lib/built/interactive-segments/handlers.d.ts

@@ -0,0 +1,9 @@
+import type { Message } from '../../message.js';
+import type { MessageMiddleware } from '../../types.js';
+import type { InteractiveHandler, RegisteredInteractiveHandler } from './types.js';
+export declare function registerInteractiveHandler(prefix: string, handler: InteractiveHandler): () => void;
+export declare function getInteractiveHandlers(): readonly RegisteredInteractiveHandler[];
+export declare function resetInteractiveHandlersForTests(): void;
+/** 在根插件上安装一次性 action 路由中间件（幂等） */
+export declare function ensureInteractiveMiddleware(addMiddleware: (mw: MessageMiddleware) => () => void): void;
+export declare function dispatchInteractiveAction(message: Message<any>): Promise<boolean>;

package/lib/built/interactive-segments/handlers.js

@@ -0,0 +1,58 @@
+import { getActionFromMessage } from './action.js';
+const handlers = [];
+let middlewareInstalled = false;
+function findHandler(payload) {
+    let match;
+    for (const entry of handlers) {
+        if (payload.startsWith(entry.prefix)) {
+            if (!match || entry.prefix.length > match.prefix.length) {
+                match = entry;
+            }
+        }
+    }
+    return match?.handler;
+}
+export function registerInteractiveHandler(prefix, handler) {
+    const entry = { prefix, handler };
+    handlers.push(entry);
+    const dispose = () => {
+        const idx = handlers.indexOf(entry);
+        if (idx >= 0)
+            handlers.splice(idx, 1);
+    };
+    return dispose;
+}
+export function getInteractiveHandlers() {
+    return handlers;
+}
+export function resetInteractiveHandlersForTests() {
+    handlers.length = 0;
+    middlewareInstalled = false;
+}
+/** 在根插件上安装一次性 action 路由中间件（幂等） */
+export function ensureInteractiveMiddleware(addMiddleware) {
+    if (middlewareInstalled)
+        return;
+    middlewareInstalled = true;
+    addMiddleware(async (message, next) => {
+        const action = getActionFromMessage(message);
+        if (!action)
+            return next();
+        const handler = findHandler(action.payload);
+        if (!handler)
+            return next();
+        const handled = await handler(message);
+        if (handled)
+            return;
+        return next();
+    });
+}
+export async function dispatchInteractiveAction(message) {
+    const action = getActionFromMessage(message);
+    if (!action)
+        return false;
+    const handler = findHandler(action.payload);
+    if (!handler)
+        return false;
+    return !!(await handler(message));
+}

package/lib/built/interactive-segments/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './button-spec.js';
+export * from './action.js';
+export * from './resolve.js';
+export * from './handlers.js';
+export { KeyboardSegment, InteractiveSegment } from './keyboard-segment.js';
+export * from './onebot-keyboard.js';

package/lib/built/interactive-segments/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './button-spec.js';
+export * from './action.js';
+export * from './resolve.js';
+export * from './handlers.js';
+export { KeyboardSegment, InteractiveSegment } from './keyboard-segment.js';
+export * from './onebot-keyboard.js';

package/lib/built/interactive-segments/keyboard-segment.d.ts

@@ -0,0 +1,12 @@
+import { type KeyboardSegmentData } from './types.js';
+export declare class KeyboardSegment {
+    readonly data: KeyboardSegmentData;
+    readonly segmentType: "keyboard";
+    constructor(data: KeyboardSegmentData);
+    toElement(): {
+        type: "keyboard";
+        data: KeyboardSegmentData;
+    };
+}
+/** @deprecated 使用 {@link KeyboardSegment} */
+export declare const InteractiveSegment: typeof KeyboardSegment;

package/lib/built/interactive-segments/keyboard-segment.js

@@ -0,0 +1,13 @@
+import { KEYBOARD_SEGMENT_TYPE } from './types.js';
+export class KeyboardSegment {
+    data;
+    segmentType = KEYBOARD_SEGMENT_TYPE;
+    constructor(data) {
+        this.data = data;
+    }
+    toElement() {
+        return { type: this.segmentType, data: this.data };
+    }
+}
+/** @deprecated 使用 {@link KeyboardSegment} */
+export const InteractiveSegment = KeyboardSegment;

package/lib/built/interactive-segments/onebot-keyboard.d.ts

@@ -0,0 +1,10 @@
+import type { MessageSegment, SendContent } from '../../types.js';
+import { type KeyboardSegmentData } from './types.js';
+/** OneBot / QQ 系 keyboard 段（各 adapter 在 $sendMessage 中识别） */
+export declare function keyboardToOneBotSegment(data: KeyboardSegmentData): MessageSegment;
+/** @deprecated 使用 {@link keyboardToOneBotSegment} */
+export declare const interactiveToKeyboardSegment: typeof keyboardToOneBotSegment;
+/** 出站前将 core keyboard 段展开为 OneBot keyboard（保留前置 text 等段） */
+export declare function expandKeyboardSegmentsInContent(content: SendContent): SendContent;
+/** @deprecated 使用 {@link expandKeyboardSegmentsInContent} */
+export declare const expandInteractiveSegmentsInContent: typeof expandKeyboardSegmentsInContent;